Anthropic 于美国时间 9 月 18 日发布 Claude Code 2.1.277 版本，更新日志首项就是加入 AGENTS.md 支持。自这一版本起，如果项目里没有 CLAUDE.md，Claude Code 会改为读取 AGENTS.md；用户也可以在 /config 的「Project instructions」选项中，设置为两份文件同时读取。
Anthropic 表示，这项功能暂时不适用于 Amazon Bedrock、Google Vertex AI 与 Microsoft Foundry 这三个云端渠道。
AGENTS.md 已被大量开源项目采用
AGENTS.md 是面向 AI 编程代理的项目说明文件，通常用于写入构建命令、测试方式和代码规范，代理开始执行前会先读取。CLAUDE.md 的用途相同，但原本是 Claude Code 专用。
OpenAI 在 2025 年 8 月推出 AGENTS.md，并在同年 12 月将其捐赠给 Linux 基金会新成立的 Agentic AI Foundation（AAIF）。AAIF 当时披露，已有超过 6 万个开源项目与代理框架采用这一格式，Codex、Cursor、Gemini CLI 和 GitHub Copilot 都已支持。
同一天被捐入 AAIF 的还有 Anthropic 自家的 MCP，即模型上下文协议。Anthropic 也是该基金会的白金会员。按文中时间线计算，从那时起，Claude Code 又过了 9 个月才开始读取 AGENTS.md。开发者早在 2025 年 8 月就已在 GitHub 提案要求支持这一文件。
Shopify CEO 曾公开批评「只认 CLAUDE.md」
Shopify 首席执行官 Tobi Lütke 在 8 月底公开表示，他正在考虑让 Shopify 禁用 Claude Code，「直到他们改变态度，去读 AGENTS.md 和 .agents/skills 这些文件」。他认为，如果只坚持读取 CLAUDE.md，在团队成员使用不同工具时，可能会让大家拿到两套不同规则，「完全没必要」。
Tobi Lütke 随后补充称，Shopify 有数千名开发者在同一个 monorepo（单一大型代码库）中工作，两种说明文件都会沿目录树逐层生效。他说，总会有某个目录漏掉其中一份文件，「这代表有一部分开发者，是在被切除脑叶的状态下工作」。Shopify 目前使用自动化程序来填补这个问题，Tobi Lütke 将其称为「一笔愚蠢的复杂度税，本来就不该付」。
按照文中摘要，这次支持上线距离 Tobi Lütke 在 8 月 25 日放话禁用，仅过去 24 天。
Anthropic 此前称不同模型家族不能互换
在相关讨论中，Claude Code 工程师 Thariq Shihipar 于当天稍晚回应称，团队正在让 Claude Code 更容易定制，之后可以直接使用 AGENTS.md，也能修改其他系统提示词。
他解释，Claude Code 过去只读取 CLAUDE.md，是因为 Anthropic 认为「不同模型家族不能互换，系统提示词对表现影响很大」。Claude Code 内部也会为每个模型准备不同的系统提示词。
Thariq Shihipar 在回复中还附上自己 7 月 24 日的帖文。该帖文提到，Anthropic 在为新一代模型调整 Claude Code 时，删掉了约 8 成系统提示词，并整理出提示词、Skills 与 CLAUDE.md 的写法。他也承认，这需要不少维护，「不见得每个人都觉得值得」。在短期内，他建议用户在 CLAUDE.md 中用「@AGENTS.md」导入 AGENTS.md。
Anthropic 将支持做成内建 mod，并公开源码
Thariq Shihipar 在 9 月 18 日宣布更新时表示，AGENTS.md 支持是通过 Claude Code 的「mods」机制实现的。mods 是 Anthropic 即将推出、用于定制 Claude Code 运行方式的机制。这次的 AGENTS.md 支持属于内建 mod，开发者之后也可以按自身需要，做出不同版本的项目指令加载方式。
根据报道，这则宣布帖文的浏览量已超过 273 万次。
Anthropic 同时在 GitHub 公开了 agents-md mod 的源代码。同一目录下还包括 diff、telemetry 与 sec-default 三个内建 mod。说明文档列出四种模式：
- 只读取 CLAUDE.md
- 没有 CLAUDE.md 时才读取 AGENTS.md（默认）
- 两份文件同时读取
- 只保留企业统一下发的说明文件
文档显示，这一选项需要写入用户或企业的配置文件中，项目目录内的配置文件不会被读取。
默认模式下，存在 CLAUDE.md 就不会读取 AGENTS.md
按照说明文档，在默认模式下，只要从根目录到工作目录之间存在任何一份 CLAUDE.md，Claude Code 就不会读取 AGENTS.md。对于 Shopify 这类两种文件并存的代码库，必须切换到「两份一起读」模式，才能同时应用两边的规则。
这一模式还会跳过已经被 CLAUDE.md 导入或链接的 AGENTS.md，同一份内容不会被加载两次。
常见问题中的官方说明
对于「Claude Code 可以读 AGENTS.md 吗」这一问题，文中给出的答案是可以。自 2.1.277 版本起，项目没有 CLAUDE.md 时，Claude Code 会自动改读 AGENTS.md；用户也可以在 /config 的 Project instructions 中设置为两份一起读取。不过，这项功能暂时不适用于 Bedrock、Vertex 与 Foundry。