Claude Code 原生支持 AGENTS.md,结束格式分裂
Anthropic 的 Claude Code 从 9 月 19 日起原生支持 OpenAI 主导的 AGENTS.md 格式,此前它只读取自家的 CLAUDE.md。该更新采用回退机制,默认仅在项目无 CLAUDE.md 时加载 AGENTS.md,并提供多种配置模式。此举使 Claude Code 成为最后一个兼容 AGENTS.md 的主流 AI 编程工具,缓解了开发者长期维护两份重复指令文件的负担。
Anthropic 的 Claude Code 从 9 月 19 日起原生支持 OpenAI 主导的 AGENTS.md 格式,此前它只读取自家的 CLAUDE.md。该更新采用回退机制,默认仅在项目无 CLAUDE.md 时加载 AGENTS.md,并提供多种配置模式。此举使 Claude Code 成为最后一个兼容 AGENTS.md 的主流 AI 编程工具,缓解了开发者长期维护两份重复指令文件的负担。
SynthePulse Insight · AI 深度解读会员精读
版本 1 · 1 个来源
从 9 月 19 日起,Claude Code 原生支持 OpenAI 主导的 AGENTS.md,但默认只在项目没有 CLAUDE.md 时才读取它。这不是全面替换,而是一次带条件的回退,也顺带暴露了刚发布的 Mod 插件体系尚未覆盖的场景。
Claude Code 从 9 月 19 日起原生支持 AGENTS.md。这是 OpenAI 在 2025 年 8 月推出的项目指令文件格式,本质上是一个放在仓库根目录的 Markdown 文件,相当于写给 AI 的 README,用来让编程助手读取项目的编码规范、构建步骤和测试要求。此前 Claude Code 一直坚持只读自己的 CLAUDE.md。
问题在于两份文件从格式到内容几乎没什么区别。据一次抽样调查,6.2% 的 GitHub 活跃仓库包含 AGENTS.md,CLAUDE.md 的比例是 5.4%(活跃仓库标准为 90 天内有 push、非 fork、非 archived)。同一项目里 Codex、Cursor 读 AGENTS.md,只有 Claude Code 要求单独的 CLAUDE.md,两份内容约 90% 重合却必须分开维护;一旦一边更新另一边忘了改,不同 agent 就会给出矛盾建议。
社区因此发明了变通方案,但各有代价。最常见的是用符号链接让两个文件名指向同一份内容,可这在 Windows 上需要管理员权限或开发者模式,Git 在 Windows 上默认也不保留符号链接,配置不当时克隆下来的 CLAUDE.md 会变成只含「AGENTS.md」几个字母的空壳文件,Agent 读进去完全无效且不会报错。也有人用导入语法间接读取,但对新成员来说,一个只有一行、指向另一个同名格式文件的指令文件很难理解。
本文主要依据量子位的一篇报道,属二手转述。其中 Claude Code 支持 AGENTS.md 的生效日期、默认回退模式、四种模式选项、Mod 系统发布时间、AGENTS.md 的推出与捐赠时间线,以及文档列出的差异条目,均转引自该报道;6.2% 与 5.4% 的仓库抽样比例、约 90% 内容重合、5 月使用量反超等数字来自该报道引述的调查与说法,未见第一方来源,按来源主张处理。来源对限制成因的解释亦为来源主张。
主报道
主报道来源