Does Claude Code read AGENTS.md now?
Claude Code reads AGENTS.md from version 2.1.277 and up, so one instruction file can serve every agent. If CLAUDE.md also exists, Claude still picks CLAUDE.md.
The main idea
If you use Claude Code with another agent like Codex or Antigravity, you probably ended up with two instruction files. One was CLAUDE.md for Claude. The other was AGENTS.md for everything else. People kept them in sync with symlinks, a one-line CLAUDE.md that says to read AGENTS.md, or copied rules. Most other tools agreed on AGENTS.md a while ago. Claude held out. Anthropic has now added support, and Claude Code reads AGENTS.md.
In the video I test it. First I check that my Claude Code version is above 2.1.277 with claude -v. Then I make a workspace with two files. CLAUDE.md says hello. AGENTS.md says the code word is apple. I ask for a haiku about the code word and Claude only sees hello from CLAUDE.md. Next I remove CLAUDE.md, start a new session, and ask again. Claude shows that no CLAUDE.md was found and AGENTS.md was loaded. It writes a poem about apple.
One thing to remember. If both files exist, Claude still picks CLAUDE.md. Either delete CLAUDE.md or change one setting in /config to load both. I use Codex too, so I no longer have to maintain two files. The docs page linked in the description explains how the AGENTS.md plugin is read and configured.
Key points
- Claude Code reads AGENTS.md in version 2.1.277 and up.
- Check your version with claude -v.
- With only AGENTS.md in the workspace, Claude loads it and picks up the code word apple.
- If both CLAUDE.md and AGENTS.md exist, Claude still picks CLAUDE.md.
- Delete CLAUDE.md or change one setting in /config to load both files.
- One file now works for Claude Code and Codex.
Save my free seat →