Claude Code Adds AGENTS.md: One File Rules All AI Agents
One AGENTS.md file now keeps Claude Code and other AI coding tools perfectly in sync.
Sep 21, 2026 (Updated Sep 21, 2026) - Written by Christian Tico
Anthropic and Claude are trademarks of Anthropic PBC; this article is an independent editorial piece.
Beyond Basic Links: Turn Your Link-in-Bio Into a Media Hub
Standard link-in-bios do not allow rich native media integration for your followers. Embed YouTube trailers and Spotify tracks directly onto your personal page.
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.
AGENTS.md is less a convenience feature than a power shift: it turns AI instructions into portable infrastructure, which means the real competitive advantage will come from who owns the canonical workflow standard, not who has the best individual coding assistant. But portability also raises the bar for governance, because once instruction files become shared across tools, sloppy repo rules will propagate just as efficiently as good ones.
What is AGENTS.md in Claude Code?