Claude Code Adds AGENTS.md Fallback, Aligning With Rival Coding Agents
Anthropic's CLI coding agent will fall back to the cross-tool AGENTS.md convention when a project has no CLAUDE.md, cutting duplicate config files for teams running multiple assistants.
Anthropic's Claude Code will now read an AGENTS.md file when a project lacks its own CLAUDE.md, per a changelog entry for the command-line coding agent. The change makes the tool compatible with a vendor-neutral instruction format that OpenAI's Codex and a widening set of rivals already use. It is a small edit to file lookup, but it removes a recurring chore for teams running more than one coding assistant on the same repository.
AGENTS.md is not Anthropic's creation. The plain-Markdown file emerged over the past year as a shared convention, promoted most visibly by OpenAI, that lets a repository spell out build commands, test procedures, style rules and directory structure in one place. Claude Code previously looked only for CLAUDE.md, its own equivalent. Teams that ran Claude Code alongside Codex, Cursor or Gemini CLI had to keep parallel copies of the same instructions or wire the files together with symlinks.
The ordering of the lookup matters as much as the added support. CLAUDE.md still wins when both files exist, so anyone who has tuned instructions for Anthropic's model keeps the exact behavior they have today. Newcomers arriving from another agent get a working configuration on the first run, without a migration step. Existing Claude Code users are not asked to rename or delete anything.
That design choice points at a shift in how these tools compete. Instruction files have been a quiet lock-in lever: the vendor that owns the filename has a slight edge in keeping teams inside its tool, because switching agents means redoing setup. By accepting a competitor-led standard, Anthropic is betting that model quality, not file naming, is what holds users. It also makes side-by-side trials cheaper, since a developer can point a second agent at the same repository and compare output directly rather than rebuilding the config first.
The company has not published a rationale beyond the terse changelog note, and several details remain open. It is unclear how Claude Code resolves precedence and scope when CLAUDE.md and AGENTS.md both carry instructions, or whether a future release will merge the two rather than pick one. Developers with layered or conflicting instructions across nested directories should watch the next few changelog entries for guidance on how inheritance works. The broader question is whether AGENTS.md keeps consolidating as the default, or whether vendors start adding extensions that fragment it again.