Claude Code终于妥协了。
就在不久前，Claude Code团队核心工程师Thariq在X上发布了一条消息，浏览量在一小时内突破了百万。
从当天上线的2.1.277版本开始，如果项目文件夹中没有CLAUDE.md，Claude会自动寻找并读取AGENTS.md。
GitHub上该版本的更新日志，第一行就记录了这一点。
这一更新，开发者们已经等待了超过一年。GitHub仓库里那条“请支持AGENTS.md”的Issue，自2025年8月提出以来，累计获得了5200多个点赞和300多条评论，是整个Claude Code仓库中票数最高的功能请求，票数是第二名的四倍。
消息发布后，Codex团队负责人Tibo第一时间赶来评论：
Yay! This is the way. Come to the light.
AGENTS.md究竟是什么
CLAUDE.md和AGENTS.md，本质上都是为AI准备的“项目说明书”。
它们存放在代码仓库中，告知编程智能体：这个项目如何编译、测试如何运行、代码应遵循什么规范。每次你与AI开始新一轮对话时，它会先阅读这份说明书，然后再开始工作。
区别在于谁能够识别它们。
CLAUDE.md是Anthropic的专属格式，只有Claude Code能读取。而AGENTS.md是OpenAI在2025年8月推出的通用格式，Codex使用它，Cursor使用它，GitHub Copilot使用它，Gemini CLI使用它，Devin也使用它。
截至目前，全球已有超过六万个开源项目采用了AGENTS.md。
去年12月，OpenAI将AGENTS.md捐赠给了Linux基金会新成立的智能体AI基金会（AAIF）。
有趣的是，该基金会的铂金会员名单中包含了Anthropic的名字，Anthropic也将自家的MCP协议捐赠给了该基金会。
两家公司在同一个基金会内推动开放标准，但各自最热门的编程工具却一直无法读取对方的说明书。
这种尴尬局面持续了十三个月，直到本周才得到解决。
开发者被两份说明书困扰了一年
问题出在哪里？出在现实中，团队并不只使用一个工具。
张三用Claude Code，李四用Codex，王五用Cursor，同一个项目就需要准备两份几乎完全相同的说明书。
更新了这份却忘了那份，AI就会按照过期的说明书工作，写出的代码风格与团队规范大相径庭。
开发者们被迫想出了各种临时办法。有人将CLAUDE.md软链接到AGENTS.md，有人在CLAUDE.md中写一行@AGENTS.md来导入另一份。
还有人设置启动钩子，每次开启会话时，将AGENTS.md的内容打印出来并传递给Claude。
AI能替人类写代码，人类却还得替AI处理说明书的兼容性问题。这个荒诞的场景持续了整整一年多。
现在，这些临时办法都可以取消了。
一个已经为其他编程智能体配置好AGENTS.md的仓库，无需添加CLAUDE.md，无需编写导入语句，也无需修改设置，打开即可使用。
真正的伏笔，藏在mod里
如果故事到这里就结束了，那它最多只能算是一次迟到的兼容性修复。
但Thariq发布了第二条消息，信息量比第一条大得多。
他表示，mods是Anthropic即将推出的定制方式，用于修改Claude Code自身的运行框架harness。
AGENTS.md的支持是通过Claude Code mods实现的。
AGENTS.md是第一个内置mod，其源码已放置在官方仓库的mods/agents-md目录下。
什么是mod？你可以将其理解为为Claude Code安装的“插件”。
这次是官方自己先安装了一个示例，Thariq的原话是：未来项目说明的读取方式，开发者也能根据自己的需求制作一个版本。
也就是说，Claude Code读取什么、如何读取，今后不再完全由Anthropic一家决定。
社区的反应证明了这一点。已经有用户在AGENTS.md上线的当天就开始拆解源码，研究mod的钩子机制和生命周期。
有人精辟地总结道：mods才是这次更新的真正主角，AGENTS.md只是它的第一个演示。
谈到harness的定制化，不能不提一个月前刚开源的DeepSeek Harness。
DeepSeek与V4 Pro模型在同一天发布了Harness开发者预览版，并喊出了一个极具雄心的口号——“Everything is a plugin”（一切皆插件）。
模型、工具、技能、会话、沙箱、界面……全部被拆分为可插拔的组件。它甚至可以将Claude Code和Codex作为自己的子智能体进行调度，它们不是竞争对手，而是零件。
DeepSeek Harness在GitHub上获得了22.9万颗星，开发者社区的热情说明了一件事：大家不仅想要一个好用的编程AI，还想要一个可改装的编程AI。
那么，Claude Code的mods和DeepSeek Harness的插件系统，走的是同一条路吗？
并不完全一致。
DeepSeek Harness是一个从头设计的开源框架，底层基于Cordis内核，整个系统就是一系列插件的集合——包括界面本身也是插件。自由度极高，但学习曲线也较陡。
Claude Code的mods则是另一种思路：在成熟产品上打开窗口。
Claude Code本身是一个完整的、经过打磨的产品，mods是在不拆除外壳的前提下，允许你在特定环节插入自己的逻辑。
一个是“从零搭建积木”，一个是“在成品上开设改装口”。
两条路线各有取舍，但编程智能体的运行框架，开始不再是一个黑箱了。
参考资料：
https://x.com/trq212/status/2101009392611278961
https://code.claude.com/docs/en/changelog
https://code.claude.com/docs/en/memory.md
claude-code/mods/agents-md%20at%20main%20%C2%B7%20anthropics/claude-code
本文来自微信公众号“新智元”，编辑：所罗门，36氪经授权发布。
这一进展也引起了中欧体育相关领域的关注，他们正在评估这种兼容性变化对跨平台开发效率的影响。