Quoting Thariq Shihipar
How-To How to actually use this
What changed: Claude Code 2.1.277 now reads AGENTS.md as project instructions when no CLAUDE.md is present.
How to use it:
- Open your project folder in Claude Code.
- If there is no CLAUDE.md, create an AGENTS.md file in the project root.
- Add your project-specific instructions, context, or preferences to AGENTS.md.
- Claude Code will automatically reference AGENTS.md in future sessions.
Good for: developers who want Claude Code to follow project-specific conventions without a CLAUDE.md file.
We're adding support for AGENTS.md to Claude Code. Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md. AGENTS.md support is built off of Claude Code mods, our upcoming way to customize the Claude Code harness. This is a built-in mod, but you’ll be able to build custom versions of project instructions yourself as you’d like too. You can…
Read original article on Simon Willison's Weblog →
