Claude Code

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.

3 min · 2026-09-23 · Watch on YouTube

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

Free live lesson · Nov 24Stop Measuring AI by Tokens. Measure What It EarnsOne hour, live, with Saurav. Bring your own bill. Free.
Save my free seat →
Get new videos and tips by emailOne short email when there is something new. Unsubscribe any time.

More CloudYeti videos