Claude Code Adds AGENTS.md: One File Rules All AI Agents

Claude Code Adds AGENTS.md Support, Making One Shared Instruction File Work Across Multiple AI Coding Tools

Claude Code now supports the open AGENTS.md format, so developers can keep one repository instruction file that works across Claude Code and other AI coding tools such as Codex, Cursor, and Jules. The update reduces setup friction for teams that use more than one coding agent and want consistent project instructions in a single place.

What AGENTS.md Means for AI Coding Workflows

AGENTS.md is a community-driven Markdown convention for project-level instructions for coding agents. Claude Code 2.1.277 can read AGENTS.md when a project does not have a Claude-specific CLAUDE.md file, which makes it easier to reuse the same guidance across different tools.

This matters because many teams now switch between multiple AI assistants in the same codebase. A shared instruction file helps keep style rules, repository conventions, and workflow preferences aligned.

How Claude Code Uses AGENTS.md

In the default setup, Claude Code reads AGENTS.md only when no CLAUDE.md exists in the project path. If both files are present, CLAUDE.md remains the primary instruction source unless the configuration is changed in Project instructions through /config.

• Claude Code 2.1.277 adds native AGENTS.md support.
• The file is used as a fallback when CLAUDE.md is missing.
• The behavior can be adjusted in Claude Code settings.
• The support is not currently available on Bedrock, Vertex, or Foundry deployments.

Why This Matters for Developers

The biggest benefit is consistency. Instead of maintaining separate instruction files for each AI coding assistant, teams can rely on a shared AGENTS.md file to communicate repository-specific rules, coding standards, and preferred practices.

This also lowers maintenance overhead. Updating one file is simpler than syncing multiple tool-specific instruction files across a large project or organization.

Benefits of a Shared Instruction Standard

• Reduces duplication across AI coding tools.
• Keeps repository guidance aligned across different assistants.
• Improves onboarding for new contributors using AI tools.
• Makes project rules easier to update and audit.
• Supports a more portable AI development workflow.

What Teams Should Know Before Adopting It

Teams using Claude Code should verify which instruction file takes priority in their setup, especially if a CLAUDE.md file already exists. They should also confirm whether their deployment environment supports AGENTS.md, since some cloud-hosted Claude Code options do not yet include the feature.

For teams standardizing on a shared file, AGENTS.md can serve as a useful cross-tool layer for instructions, while tool-specific files can still be used where needed.

Conclusion

Claude Code’s support for AGENTS.md is a practical step toward a more unified AI coding workflow. By making one open instruction format work across multiple agents, Anthropic is helping developers reduce duplication, simplify maintenance, and keep repository guidance consistent across tools.