Anthropic 的编程工具 Claude Code 从 2.1.277 版起支持 AGENTS.md。规则不复杂：一个目录里没有 CLAUDE.md 时，Claude Code 会去找同目录下的 AGENTS.md，当作项目指令读进上下文；有 CLAUDE.md 的地方，照旧只认 CLAUDE.md。
这个版本 9 月 18 日在 GitHub 发布。Claude Code 团队成员 Thariq 在社交平台上宣布了这项改动：
“Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md.”
（从今天的 2.1.277 版开始，文件夹里没有 CLAUDE.md 时，Claude 会查找并使用 AGENTS.md。）
四档开关
AGENTS.md 支持是以内置插件的方式做的，代码公开在 Claude Code 的 GitHub 仓库里。用户在 /config 的”Project instructions”里切换，一共四档：
| 模式 | 行为 |
|---|---|
| claude-md | 只读 CLAUDE.md，相当于关掉这项功能 |
| claude-md-or-agents-md（默认） | 同一目录有 CLAUDE.md 就忽略那里的 AGENTS.md，没有才读 |
| claude-md-and-agents-md | 整棵目录树里两种文件都读 |
| managed-only | 丢掉仓库里提交的和个人私有的指令文件，只保留组织统一下发的文件与记忆 |
默认档是回退，不做合并。已经给 Claude Code 写好 CLAUDE.md 的仓库，升级后行为不变；只有从没写过 CLAUDE.md、此前只为其他工具准备了 AGENTS.md 的仓库，会第一次把这份文件读进来。同一份文件如果按路径或内容判定为重复，不会被加载两次。
和 CLAUDE.md 还差几处
插件说明里列出了几条与 CLAUDE.md 的差别。子目录里的 AGENTS.md 只在 Agent 用 Read 读取该目录下的文本文件时才附带进来，IDE 选区、Notebook、图片和 PDF 都不会触发；附带进来的文件不登记在已读状态里，上下文压缩之后不会自动恢复。/memory 命令和 # 快捷记忆都碰不到 AGENTS.md，用 —add-dir 加进来的目录也不贡献 AGENTS.md，符号链接路径按字面比对、不做解析。
渠道上，AWS Bedrock、Google Vertex 和微软 Foundry 暂不支持。同一个版本里还有一项和指令文件相关的改动：SDK 和无界面模式启动时，第一轮对话不再等待 CLAUDE.md 查找完成。
一个仓库，几家 Agent
AGENTS.md 相当于写给编程 Agent 看的 README：怎么构建、怎么跑测试、代码风格有什么约定、哪些目录别碰。这个格式最早由 OpenAI Codex 等几家工具在 2025 年一起推动，后来交给 Linux 基金会旗下的 Agentic AI Foundation 托管，Cursor、GitHub Copilot 等工具都能识别。Claude Code 一直只认自家的 CLAUDE.md，混用工具的团队只好同时维护两份内容几乎一样的文件，社区里常见的办法是用软链接让两者指向同一份。
国内团队的工具组合往往更杂：Claude Code 之外，常见的还有 Kimi Code、Qwen Code、Cursor 和 Codex，其中不少默认读 AGENTS.md，或者允许改指令文件名。默认档下，老仓库一行不用改；想只维护一份 AGENTS.md 的团队，可以删掉 CLAUDE.md 把说明集中过去，但上面那几条限制要先对一遍，尤其是长会话里压缩之后子目录指令不再自动回来。
managed-only 这一档面向企业管理员。仓库里提交进来的指令文件会被 Agent 当作指令执行，本身就是一个可被投毒的入口，管理员可以借这一档只放行组织统一下发的规则。这一档在大团队里用起来效果如何，目前还没有公开的使用数据。
参考来源：Claude Code GitHub 版本说明、CocoLoop、Anthropic 工程师 Thariq 公开帖；agents-md 插件文档核对四种模式、加载顺序与限制条款。