Claude Code now reads AGENTS.md: keep one instruction file for every agent
Since version 2.1.277, Claude Code reads AGENTS.md when a project has no CLAUDE.md. If you also use Codex or another agent, one AGENTS.md file can hold the rules for all of them.
Why it matters
Before this, people who used Claude Code with Codex kept two files: CLAUDE.md for Claude and AGENTS.md for the rest.
The workarounds were a symlink, or one line in CLAUDE.md that said to read AGENTS.md.
Claude Code's changelog for 2.1.277 says: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead.
Do this
- Check your version with the command below. You need 2.1.277 or newer.
- Move your rules into AGENTS.md at the root of the project.
- Delete CLAUDE.md, or leave it out of new projects.
- Start a new Claude Code session. The start screen says AGENTS.md loaded when it worked.
Check your Claude Code version
claude -v
One thing to keep in mind: If both files exist, Claude Code still reads CLAUDE.md, not AGENTS.md. Delete CLAUDE.md, or change the setting under "Project instructions" in /config to load both.
A later release made AGENTS.md support also work on Amazon Bedrock, Google Vertex AI, Microsoft Foundry and LLM gateways. Source: Claude Code changelog, version 2.1.277: "Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under Project instructions in /config".
Ask me anything about AI and cloudA paid call on your own setup: your agents, your bill, your plan.Book a call →All tips in: Claude Code tips from the team that builds Claude Code