9 月 19 日,Claude Code 团队工程师萨里克·希希帕尔在社交平台宣布:当天发布的 2.1.277 版本开始支持 AGENTS.md。规则说得很直白——如果项目文件夹里没有 CLAUDE.md,Claude 会转而去检查并使用 AGENTS.md;这个行为可以在 /config 里切换。改动不大,信号不小:编程智能体之间互不相认的局面,从配置层开始松动了。

Claude Code 2.1.277 的规则文件查找顺序打开项目文件夹准备加载规则文件存在 CLAUDE.md?是:沿用 CLAUDE.md否:检查 AGENTS.md行为可在 /config 中切换设计意图:CLAUDE.md 优先,AGENTS.md 兜底,两套生态各让一步而不是互相取代来源:Claude Code 工程师 9 月 19 日公告,版本 2.1.277
图|AGENTS.md 的回退逻辑:没有 CLAUDE.md 时才启用

先说清楚两份文件各管什么。CLAUDE.md 是 Claude Code 的专属配置,装的是这个工具特有的工作流约定、MCP 服务器接入、子智能体和命令;AGENTS.md 的定位则是项目级的基础规则——不管你用哪家的编程智能体,进这个仓库都该遵守的那部分约定。前者是户口本,后者更像楼里的公约。2.1.277 的做法是公约优先级让位于户口本:有专属配置就沿用,没有才读公约,谁也不推翻谁。

这件事真正的受益人是两类人。一类是同时用好几个编程智能体的开发者:过去换一个工具,就得把项目规则用另一套格式重写一遍,内容大同小异,纯粹是格式税。另一类是开源项目维护者:贡献者用什么工具你管不着,有了通用说明书,仓库里写一份就够,谁的工具认这份文件,谁就能直接读懂约定。AGENTS.md 这套规范出现之后被多家编程智能体工具陆续采纳,Anthropic 此番入列,等于这份公约的覆盖面又大了一圈。

值得留意的是支持方式的选择。Anthropic 没有让 CLAUDE.md 消失,也没有强制迁移,而是做成回退逻辑:专属文件在,就听专属的;不在,才读公约。这既是对自家用户既有工作流的保护,也是对存量生态的体面——大量仓库里已经躺着写好的 CLAUDE.md,一刀切只会制造迁移混乱。从工程演化角度看,这种「先兼容、后趋同」的路径,比直接更换标准温和得多。

CLAUDE.md 与 AGENTS.md 的职责边界CLAUDE.mdClaude Code 特有配置· 工作流约定· MCP 服务器接入· 子智能体与命令AGENTS.md跨工具共享的项目级规则· 所有 AI 都该遵守的基础约定· 换工具、接手项目不必重写· 多家编程智能体先后采纳对开发者的意义:一份通用说明书喂饱所有工具,工具专属能力仍留在各自文件里来源:官方公告与公开资料整理
图|两份规则文件的分工:工具专属与跨工具通用

当然,也别把它当成万能解。两份文件并存,重复内容和优先级冲突就成了新的维护负担——同一条约定写两处,改了一处忘了另一处,智能体读到的是自相矛盾的指令。而且 AGENTS.md 表达不了工具专属能力,比如 Claude Code 的子智能体编排,这些仍然得留在各自的专属文件里。对工具厂商来说,不支持公约也有隐性代价:在开源协作与团队交接场景里,读不懂通用说明书的智能体会被慢慢边缘化。目前官方及行业暂未披露更多细节,后续将持续跟进迭代动态。

把视野拉远一点看,这是配置层出现事实标准的又一步。此前本站教程里讨论过把 CLAUDE.md 改造成可移植 Agent Skills 的思路,方向是把「给 AI 的说明」从单工具资产变成可携带资产;Anthropic 这次等于从官方层面承认了通用层的价值。模型层的竞争还会继续打得难解难分,但配置层正在悄悄互通——对开发者来说,这可能是比又一场模型对决更实惠的消息。