# Claude Code 接入 AGENTS.md：这不是低头，是底盘战争开场
9 月 19 日，Claude Code 团队工程师 Thariq Shihipar 发了一条帖子，一小时内浏览量破百万。从 2.1.277 版本起，项目目录里如果没有 CLAUDE.md，Claude Code 会自己去读 AGENTS.md。
大多数解读停留在「Anthropic 终于低头了」。这个判断没错，但它错过了真正重要的东西。
低头只是表象。这次更新的深层含义是：**编程智能体的竞争重心，正在从模型层转移到 harness 层；而 harness 之间的第一道标准化，没有发生在模型上，先发生在了「说明书」上。**
谁控制项目上下文的读取方式，谁就卡住了开发者迁移的第一道闸口。这道闸口，刚刚被拆掉了。
## 一、一场拖了十三个月的别扭
先把事情捋清楚。
CLAUDE.md 和 AGENTS.md 本质上是同一个东西：写给 AI 的项目说明书。躺在代码仓库里，告诉智能体这个项目怎么编译、测试怎么跑、代码按什么规矩写。
区别在于谁认。CLAUDE.md 是 Anthropic 的自留地。AGENTS.md 是 OpenAI 在 2025 年 8 月推出的通用格式，Codex 用它，Cursor 用它，GitHub Copilot 用它，Gemini CLI 用它，Devin 也用它。到今天，全球超过六万个开源项目已经用上了 AGENTS.md。
去年 12 月，OpenAI 把 AGENTS.md 捐给了 Linux 基金会新成立的智能体 AI 基金会（AAIF）。搞笑的是，这个基金会的铂金会员名单里有 Anthropic——它把自家 MCP 协议也捐了进去。两家坐在同一个基金会里搞开放标准，自家最火的编程工具却一直不读对方的说明书。
这个别扭的代价是真实的。GitHub 上那条「请支持 AGENTS.md」的 Issue 从 2025 年 8 月挂到现在，累计 5200 多个赞、300 多条留言，是整个 Claude Code 仓库票数最高的功能请求，高出第二名四倍。
开发者被逼出了一堆土办法：把 CLAUDE.md 软链接到 AGENTS.md，在 CLAUDE.md 里写一行 @AGENTS.md 导入，或者挂启动钩子把 AGENTS.md 内容打印一遍塞给 Claude。AI 能替人写代码，人却得替 AI 处理说明书的兼容问题。
Shopify CEO Tobi Lütke 曾把这个问题摆上台面：他考虑在公司内部禁用 Claude Code，除非它支持读取 AGENTS.md。他给这类跨工具同步负担起了个名字——「复杂性税」。团队不该长期替工具厂商的门户之争买单。
## 二、为什么 Anthropic 之前死守 CLAUDE.md
不是固执那么简单。
Thariq 此前解释过：不同模型家族行为特点不同，system prompt 会显著影响模型表现。Claude 对 skills、system prompt 和 CLAUDE.md 的组织方式有特定偏好。项目说明、技能文件、system prompt 共同构成 Agent 工作所需的上下文——这是 Anthropic 的 context engineering 打法，模型专属设计确实能优化体验。
换句话说，CLAUDE.md 是护城河的一部分：上下文进出的格式由我定义，你迁移到别家 harness 就要重写整套约定。
那为什么现在放？因为这道护城河已经守不住了，而且守下去的成本在上升。
守不住，是因为现实是团队不只用一个工具。张三用 Claude Code，李四用 Codex，王五用 Cursor。同一个仓库备两份几乎一模一样的说明书，改了这份忘了那份，AI 就照着过期那份干活。当六万个开源项目都认 AGENTS.md，一家工具不认它，不再是「保护自家生态」，而是「给用户添堵」。
成本上升，则藏在这条新闻的第二层里——mod。
## 三、真正的主角不是 AGENTS.md，是 mods
Thariq 发了第二条帖子，信息量比第一条大得多。
他说，mods 是 Anthropic 接下来要推出的定制方式，用来改 Claude Code 自身的运行框架（harness）。AGENTS.md 的支持就是用一个 mod 实现的——它是第一个内置 mod，源码已经放在官方仓库 mods/agents-md 目录。以后项目说明怎么读，开发者可以按自己的需要做一个版本。
这句话值得逐字读：**Claude Code 读什么、怎么读，往后不全由 Anthropic 一家说了算了。**
顺着这个口径看，AGENTS.md 兼容只是 mods 机制的第一个演示品。Anthropic 用官方姿态告诉开发者：harness 的关键环节可以插拔了。
这不是孤立事件。一个月前 DeepSeek 开源了 Harness 开发者预览版，口号是「Everything is a plugin」——模型、工具、技能、会话、沙箱、界面全部拆成可插拔组件，甚至能把 Claude Code 和 Codex 当成子智能体调度。它在 GitHub 拿下了 22.9 万颗星。
两条路线不完全一样。DeepSeek Harness 是从零搭积木：基于 Cordis 内核，整个系统就是一堆插件的集合，连界面都是插件，自由度极高，学习曲线也陡。Claude Code 的 mods 是在成熟产品上开窗：不拆外壳，在特定环节插入自己的逻辑。
一个从零搭积木，一个在成品上开改装口。取舍不同，但方向一致——**编程智能体的运行框架，开始不再是一个黑箱了。**
## 四、一个框架：Agent 竞争的三层栈
把这两年编程智能体的竞争放在一起看，可以提出一个框架：Agent 竞争发生在三层，每层的护城河强度完全不同。
**第一层是模型。**编码、推理、智能体能力的差距在快速收敛，基准分数越来越难构成护城河。各家旗舰在你追我赶中互相抹平优势。
**第二层是说明书（项目上下文）。**这一层刚刚完成标准化。AGENTS.md 被捐给 Linux 基金会、六万项目采用、Claude Code 加入——「README for agents」成了代码库基础设施，和 .gitignore 一个待遇。谁也不能再用格式锁人。
**第三层是底盘（harness）。**真正的战场在这里：执行循环怎么设计、工具怎么调度、上下文怎么管理、以及——现在新增的——**可改装度**。黑箱 harness 是产品，可改装 harness 是平台。产品锁用户靠习惯，平台锁用户靠生态。
用这个框架回看就清楚了：Anthropic 放弃说明书层的锁，是因为那一层已经无利可图、只剩复杂性税；同时用 mods 抢占第三层的新高地——与其守一个注定失守的格式，不如第一个宣布「我的底盘可以改装」。
历史上有现成的先例。编辑器大战打了十年，最后终结它的不是某个编辑器赢，而是 LSP（语言服务器协议）把「编辑器」和「语言支持」解耦——从此编辑器层竞争的是体验，不是语言锁定。AGENTS.md 正在说明书层复刻 LSP 的剧本，mods 和插件化则在底盘层重演同一幕。
迁移成本一降，比较的对象就从「我用 Claude Code 还是 Codex」变成「哪个底盘更好用、更好改装」。这对所有厂商都是压力测试。
## 五、所以，你该怎么做
**如果你是技术管理者**：把 AGENTS.md 作为团队唯一的项目指令真相源，删掉双份维护，省下的复杂性税是实打实的工程时间。同时把「.agents/skills 和 .claude/skills 还是两套目录」记在账上——兼容不等于统一，还有最后一公里。
**如果你是一线开发者**：现在可以撤掉软链接和 @AGENTS.md 的土办法了。升级到 2.1.277 后，用 /config 决定回退读取还是双份加载。更值得花时间的是去读 mods/agents-md 的源码——第一个官方 mod 的钩子机制和生命周期，就是 Anthropic 给出的扩展性蓝图。
**如果你在做 Agent 工具**：说明书层别再自建格式了，接入 AGENTS.md，把工程资源押在第三层——执行循环质量、上下文管理、可扩展机制。未来的问题不再是「你支持哪家模型」，而是「你能不能被改装」。
一份说明书，四种土办法，十三条个月的别扭，最后换来一句共识：上下文是共享的基础设施，不是任何一家的护城河。
真正的战争，现在才在底盘上开打。
---
来源备注：Claude Code 2.1.277 更新记录（code.claude.com/docs/en/changelog）；Thariq Shihipar (@trq212) 于 X 的发帖；anthropics/claude-code 仓库 mods/agents-md 源码目录；AGENTS.md 由 OpenAI 捐入 Linux 基金会 AAIF；本文素材源自新智元、机器之心的报道（经 36氪 转载）。