Claude 向 OpenAI 格式投降了。
Claude Code 从 9 月 19 日起原生支持 AGENTS.md。

现在兼容了,隔壁 OpenAI 加的 Tibo 也来围观支持。


也就是说,大量项目的开发者不得不同时维护两个文件。
尽管从格式到内容,两者几乎没什么区别。
没什么区别,但是折磨开发者一年
OpenAI 为自家的 Codex 设计了 AGENTS.md,给 AI 编程助手一个标准化的方式来读取项目的编码规范、构建步骤和测试要求。它本质上就是一个放在代码仓库根目录的 Markdown 文件,相当于写给 AI 的 README。
OpenAI 从一开始就没有把它叫做 OpenAI.md 或者 Codex.md。
这个开放格式迅速获得了行业认可,到 2025 年 12 月,OpenAI 把 AGENTS.md 捐赠给了 Linux 基金会下新成立的 Agentic AI Foundation(AAIF)。


在所有主流 AI 编程工具中,Claude Code 是最后一个。
Claude Code 只认 CLAUDE.md 这件事,已经困扰开发者很久了。
同一个项目里,Codex 读 AGENTS.md,Cursor 读 AGENTS.md,只有 Claude Code 要求一份单独的 CLAUDE.md。两份文件内容 90% 重合,却必须分开维护。
一旦一边更新另一边忘了改,不同 AI agent 就会给出矛盾的建议。
社区被迫发明了各种变通方案。这些变通方案能用,但都有各自的问题。
最常见的是在项目根目录执行 ln -s AGENTS.md CLAUDE.md,用文件系统的符号链接让两个文件名指向同一份内容。
但这在 Windows 上需要管理员权限或开发者模式,Git 在 Windows 上默认也不保留符号链接,没有正确配置的情况下克隆仓库,CLAUDE.md 会变成只包含「AGENTS.md」这几个字母的空壳文件,Agent 读进去完全无效,而且也不会报错,很容易发现不了。
也有人在 CLAUDE.md 第一行写 @AGENTS.md 利用导入语法间接读取。
对于新加入团队的成员来说,看到一个只有一行内容、指向另一个不同名 Markdown 文件的指令文件,很难理解发生了什么。
用多个 AI 编程工具协作的团队受影响最大。
同一个代码仓库要同时维护 CLAUDE.md 和 AGENTS.md,内容高度重复,但又不完全相同,CLAUDE.md 可能包含 Claude 特有的指令,AGENTS.md 则是工具无关的。
两个文件一旦漂移不同步,排查问题会非常头疼。
Claude Code 的下一步:Mod
Claude Code 2.1.277 的实现方式是回退机制,而不是全面替换。
默认模式叫「claude-md-or-agents-md」:只有当项目中不存在任何 CLAUDE.md 的时候,才会去查找并加载 AGENTS.md。如果项目已经有了 CLAUDE.md,哪怕只是一个空文件,AGENTS.md 就不会被读取。
除了默认模式之外,开发者还可以在 /config 中选择另外三种模式:只读 CLAUDE.md、同时读取两种文件、或者只加载组织级别的托管指令文件,整个功能作为一个内置插件(Mod)实现。
Claude Code 的 Mod 系统 9 月刚刚发布,本质上是一套插件系统,允许开发者在 Claude Code 的运行流程中插入自定义逻辑。
每个 mod 可以监听特定的生命周期事件,比如会话启动、上下文构建、工具调用、子 agent 派生等,在这些关键节点上拦截、修改或补充 Claude Code 的默认行为。


文档中列出了一系列「仍然与 CLAUDE.md 存在差异」的条目:
AGENTS.md 的嵌套文件只在文本类型的 Read 操作中触发,不覆盖 IDE 中打开的文件、notebook 和图片等场景;
/memory 命令和 # 快捷键不识别 AGENTS.md 文件;
--add-dir 添加的额外目录不会加载其中的 AGENTS.md;
AGENTS.md 中引用外部路径的 @导入需要借用 CLAUDE.md 的授权对话框才能生效,自身不会触发授权提示。
这些限制来自于当前插件事件体系尚未覆盖到这些场景。
所以总结这一波,Claude Code 在格式上更像 OpenAI 了,在功能上更像 DeepSeek 了。
参考链接:
[ 1 ] https://x.com/trq212/status/2101009392611278961?s=20
[ 2 ] https://github.com/anthropics/claude-code/tree/main/mods/agents-md
一键三连「点赞」「转发」「小心心」
欢迎在评论区留下你的想法!
— 完 —
点亮星标
科技前沿进展每日见