如果你是一个同时在 Claude Code 和 Codex 之间来回切、为此维护过两份几乎一样又总是对不上的"项目说明书"的人,今天(9 月 19 日)这条更新,值得你从信息流里停下来三分钟。
Anthropic 的 Claude Code 工程师 Thariq Shihipar(@trq212)在 X 平台发布推文,宣布 Claude Code 开始支持 AGENTS.md。 从 2.1.277 版本开始,项目目录里没有 CLAUDE.md 时,它会自动检查并使用 AGENTS.md,这个行为可以在 /config 里切换。IT之家机器之心
这项功能从 issue 提出到发布,整整等了 393 天。 公告的热度同样惊人,海贝day 的转述是一个小时里浏览量破百万。知乎知乎
这不只是一个文件格式的兼容问题。它意味着"给 AI 看的项目说明书"到底叫什么、归谁定,这场持续一年多的标准之争,最大的一块拼图今天落位了。
一、先补背景:这不是"Anthropic 开窍",是被逼到桌前
今天很多报道的标题是《Anthropic 接受 OpenAI 标准》(机器之心、36氪均以此为核心表述),这个说法并不夸张。
AGENTS.md 是 OpenAI 一方牵头的通用编码指令标准,Codex 早已在每次启动时自动读取它,包括子目录里的分层文件。OpenAI 甚至给 GPT-6 Astra 出了围绕 AGENTS.md 的官方规范,直言别再乱写 AGENTS.md。
就在 8 月 26 日,36氪报道了冲突的爆发:当所有 AI 编程工具都在向行业标准靠拢时,Claude Code 偏要特立独行,Shopify CEO 甚至公开威胁要因此禁用它,Anthropic 的回应换来的却是开发者更气。36氪
9 月 15 日(更新前四天),知乎用户 Github之星 整理了更新前的官方口径:Claude Code 只读 CLAUDE.md、不读 AGENTS.md,想共用一份规则就得在 CLAUDE.md 里写 @AGENTS.md。 微博开发者 AIMIKKKK 描述过他当时的曲线救国方案:为了同时用 Claude 和 GPT 两个客户端,让两份文件都指向同一个真正的说明书。知乎微博
微博号"爱可可-爱生活"把这件事总结成一句话:命名权的终结,Claude Code 向 AGENTS.md 低头。 社区靠软链接和脚本硬撑了一年多的兼容层,今天被官方一句话抹平了。微博

二、但今天流传最广的结论,是误读
微博上有传播量不小的说法流传:Claude Code 现在默认支持 AGENTS.md,不用维护 CLAUDE.md 文件了。 这句话前半句对,后半句会坑人。知乎用户 nano 扒出的默认行为是:微博
你项目里的情况 | 2.1.277 默认行为 |
|---|---|
只有 CLAUDE.md | 一切照旧,完全无感 |
只有 AGENTS.md | |
想让两份同时生效 | 需要手动 `/config` 切到 `claude-md-and-agents-md` 模式 |

这就是为什么 nano 的结论是老项目无感:只要项目路径里存在 CLAUDE.md,Claude Code 默认就不会再读 AGENTS.md。如果你之前听风声把规则复制进 AGENTS.md、但 CLAUDE.md 一直没删,那么这份 AGENTS.md 在 Claude 这边从来没被读过——你的规则其实一直在单腿走路。知乎
三、为什么多工具用户才是这波的最大受益者
武子康在知乎讲了一个典型团队事故:团队交替使用 Codex 和 Claude Code,维护者把测试入口、生成目录、提交要求复制进 AGENTS.md 和 CLAUDE.md 各一份,“似乎就完成了兼容”。后来测试脚本更名,一边改了另一边没改,两边的 Agent 行为开始不一致。而更新前的 @AGENTS.md 引用方案只救得了 Claude,Codex 不认;Codex 侧遇到 `AGENTS.override.md` 时还会优先选 override,不把两份文件当补充段落合并。知乎

合并到单一 AGENTS.md 后,这类漂移从"靠纪律"变成"靠机制"——只有一个真相源,想不同步都难。Codex、Claude Code 两大阵营的主力 Agent 都吃同一份文件之后,微博上的 AI 要闻号铠盒AIBOX 对此的表述是:一套指令可跨不同 AI 编程工具复用,此前各家私有配置文件互不兼容的碎片化局面就此结束。微博
四、今天就能做的动作,按你的用法分三档
只用 Claude Code、有 CLAUDE.md 的人:按兵不动,但做一次体检。 你不需要跟风把文件改名——默认加载结果没有任何区别。真正要做的是打开仓库确认一下:里面有没有一份半途而废、和 CLAUDE.md 早已对不上的 AGENTS.md?现在它有了被加载的通道,僵尸文件反而变成风险。
Claude + Codex(或其他第二工具)双开的人:现在是合并的正确时机。 把全局规则收敛进一份 AGENTS.md,CLAUDE.md 要么删掉、要么留一行指针,要么按上表切 `claude-md-and-agents-md` 模式后把 CLAUDE.md 瘦身成增量。改完别凭感觉,在新会话里确认加载的是哪几份文件、内容对不对,再提交。
团队仓库:合并≠搬家,更不等于加量。 PpiEro 总结的落地坑位很实用:根目录的 AGENTS.md 只装全仓库通用的规矩(构建命令、提交规范、目录总览),模块级规则下沉到子目录。 Kahler 的建议同样克制:真正重要的不是往里写更多内容,而是只保留真正全局的信息,其余规则逐步披露。 Tinywan 在对照 GPT-6 Astra 官方规范后的提醒则是:别把知识、流程、授权三件事混写成一锅清单。
知乎知乎
反证也要听:知乎另一派(闻里坞)已经在说:过去积累的大量 prompt、Skill 和 AGENTS.md 规则,正在开始反过来拖累 Agent。 规则越长,模型越容易在噪声里抓错重点。标准统一省的是维护成本,不是给你的说教欲开绿灯。知乎
五、对中国用户,这一刀还有另一层意义
过去几周,Claude Code / Codex 的额度、封号与断供风险已经让不少人开始重排订阅、改用国产模型跑 harness(在知乎的相关问答里,“工具还是用 Claude 或者 Codex、模型切换成国内的 DeepSeek、Kimi、MiniMax"已经是被反复给出的标准答案)。在这种高切换成本的环境里,把项目说明书从"某家私有文件"迁到"行业标准文件”,等于给你真正能带走的那部分资产上了保险:工具可以换、模型可以换,AGENTS.md 不用重写。知乎
六、下一个要盯的信号
宝玉 xp 今天那条点赞最高的转发,问的是下一场"命名权"战争:AGENTS.md 都支持了,那 .agents/skills 什么时候支持? 规则文件统一了,技能目录标准还在各家私有格式里打架。Codex 侧是否回摆兼容 CLAUDE.md、IDE 阵营是否跟进默认读取,也都值得放进本周观察清单。微博
最后照例问一句:你的 CLAUDE.md / AGENTS.md 现在多少行?里面哪条规则是 AI 最不听话的?评论区晒一下,我挑几个看看这次合并之后还灵不灵。