Claude Code终于不再固执己见。就在刚刚，Claude Code团队核心工程师Thariq在社交媒体上发帖，短短一小时浏览量便突破百万。自2.1.277版本上线以来，如果项目文件夹中缺少CLAUDE.md，Claude会自动寻找并读取AGENTS.md。这一改动在GitHub的更新日志首行便已明确记录。
这条更新，开发者们已经苦苦等待了一年多。在GitHub仓库里，那条“请支持AGENTS.md”的议题从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基金会。颇具讽刺意味的是，该基金会的铂金会员名单中赫然包括Anthropic，Anthropic也将自家的MCP协议捐献其中。两家公司如今坐在同一个基金会里推动开放标准，但自家最火爆的编程工具却长期拒绝读取对方的说明书。这种别扭的局面，在持续了十三个月后，直到本周才迎来终结。
开发者被两份说明书折腾了一年，问题究竟出在哪？现实中，一个团队往往不只使用一个工具。张三可能用Claude Code，李四用Codex，王五用Cursor，同一个项目就需要维护两份几乎一模一样的说明书。一旦修改了这份却忘了那一份，AI就会依据过期的那份文档进行操作，导致生成的代码风格与团队规范南辕北辙。为了解决这个问题，开发者们想出了一系列“土办法”：有人将CLAUDE.md软链接到AGENTS.md，有人在CLAUDE.md中写入一行指令导入AGENTS.md，还有人通过启动钩子将内容强制喂给Claude。AI能替人写代码，人却还得替AI处理说明书兼容性的问题。这种荒诞的场景，持续了整整一年多。如今，这些笨办法可以统统撤下了。
如果故事到此为止，这充其量只是一个迟到的兼容性修复。但Thariq随后发布的第二条帖子，信息量远超第一条。他指出，Mods是Anthropic即将推出的定制方式，用于修改Claude Code自身的运行框架Harness。AGENTS.md的支持正是通过Claude Code Mods实现的，其源码已放置在官方仓库的mods/agents-md目录中。
什么是Mod？你可以把它理解为给Claude Code安装的“插件”。这次官方内置了AGENTS.md作为一个样板，Thariq的原话是：“以后项目说明怎么读，开发者也能按自己的需要做一个版本。”这意味着，Claude Code读什么、怎么读，未来不再完全由Anthropic一家说了算。社区的反应印证了这一点。AGENTS.md上线当天，已有开发者着手拆解源码，研究Mod的钩子机制和生命周期。有人精辟地总结道：Mods才是这次更新的真正主角，AGENTS.md不过是它的第一个演示。
谈到Harness的定制化，不得不提一个月前刚开源的DeepSeek Harness。DeepSeek与V4 Pro模型同日发布了Harness开发者预览版，喊出了极其霸气的口号——“一切皆插件”。模型、工具、技能、会话、沙箱、界面……全部被拆解为可插拔的组件。它甚至可以将Claude Code和Codex当作自己的子智能体进行调度，不再是竞争对手，而是零件。DeepSeek Harness在GitHub上斩获了22.9万颗星，开发者社区的热情表明，大家不只想要一个好用的编程AI，更想要一个能高度改装的编程AI。
那么，Claude Code的Mods和DeepSeek Harness的插件系统，走的是同一条路吗？并不完全是。DeepSeek Harness是一个从头设计的开源框架，底层基于Cordis内核，整个系统就是插件的集合——包括界面本身也是插件。这种自由度极高，但学习曲线也陡峭。Claude Code的Mods则是另一种思路：在成熟产品上开窗口。Claude Code本身是一个打磨完美的产品，Mods是在不拆掉外壳的前提下，让你能在特定环节插入自己的逻辑。一个是“从零搭积木”，一个是“在成品上开改装口”。两条路线各有取舍，但可以肯定的是，编程智能体的运行框架，正在逐渐告别黑箱状态。