# A note that Claude Code can fall back to AGENTS.md

Canonical: https://cqbase.net/en/entry/maxforai-claude-code-agents-md
Chinese: https://cqbase.net/zh/entry/maxforai-claude-code-agents-md
English: https://cqbase.net/en/entry/maxforai-claude-code-agents-md

> Notes that Claude Code 2.1.277 can fall back to AGENTS.md when CLAUDE.md is missing, with more custom instruction mods said to be coming.

On 19 September 2026 @MaxForAI noted that, from Claude Code 2.1.277, a repository without CLAUDE.md can fall back to AGENTS.md, and that further custom instruction mods might follow. The post also points at a related discussion by @trq212: https://x.com/trq212/status/2101009392611278961 . This is a note about version behavior, not the full official changelog.

After you upgrade, open a repository that has both files and see which one actually loads. If your project rules live in AGENTS.md, confirm that Claude Code will read them, and reference them from CLAUDE.md if you need to be explicit. Likes and reposts were captured on 15 November 2026.

Note (verified 15 November 2026): This post describes how Claude Code reads AGENTS.md. Product behavior may have changed since then. The original post was not reopened in this review, and there was no reputation sample from the past one to three months.

## Catalog record

- Author: MaxForAI
- License: All rights reserved
- Source: https://x.com/MaxForAI/status/2101227493575545329
- Added: 2026-11-15
- Posted: 2026-09-19
- Likes: 15
- Reposts: 1

