Claude Code 正式向行业标准妥协。
Claude Code 核心工程师 Thariq 在 X 平台宣布，自 2.1.277 版本起，若项目根目录缺失 CLAUDE.md，系统将自动读取 AGENTS.md 文件。这一更新迅速引发开发者社区热议，单条帖子浏览量一小时破百万。
GitHub 更新日志首行即明确了此项变更。
该功能请求在 GitHub 仓库中悬挂逾一年，累计获 5200 余点赞及 300 多条评论，是 Claude Code 仓库中呼声最高的特性，票数远超第二名四倍。
消息发布后，Codex 团队负责人 Tibo 随即留言表示欢迎：
Yay! This is the way. Come to the light.
AGENTS.md：从对立走向统一
CLAUDE.md 与 AGENTS.md 本质均为面向 AI 的“项目说明书”，用于指导编程智能体理解项目的编译、测试及代码规范。区别在于生态兼容性：
- CLAUDE.md：Anthropic 私有标准，仅 Claude Code 识别。
- AGENTS.md：OpenAI 于 2025 年 8 月推出的通用格式，已被 Codex、Cursor、GitHub Copilot、Gemini CLI 及 Devin 等主流工具广泛采用。
目前全球已有超六万个开源项目部署 AGENTS.md。去年 12 月，OpenAI 将该标准捐赠给 Linux 基金会旗下新成立的智能体 AI 基金会（AAIF）。颇具讽刺意味的是，Anthropic 不仅是该基金会铂金会员，也将自家 MCP 协议捐入其中。两大巨头虽共推开放标准，其核心编程工具却长期互不兼容，这一僵局直至本周才被打破。
终结开发者的“双份文档”困境
此前，由于工具链不统一，开发团队常需维护两份内容近乎相同的说明书。一旦同步滞后，AI 便依据过期文档生成不符合规范的代码。开发者被迫采用软链接、文件导入或启动钩子等变通方案，人为解决 AI 间的兼容问题。
此次更新后，只要仓库已配置 AGENTS.md，Claude Code 即可直接读取，无需额外设置或重复编写 CLAUDE.md。这一改变彻底消除了长达一年的冗余工作流。
深层变革：Mods 机制开启框架定制时代
支持 AGENTS.md 仅是表象，Thariq 随后披露的"Mods"机制才是本次更新的核心。Mods 是 Anthropic 推出的全新定制方式，允许开发者修改 Claude Code 的运行框架（Harness）。
AGENTS.md 的支持正是通过首个内置 Mod（源码位于mods/agents-md）实现的。这意味着未来开发者可自定义 Claude Code 读取何种文档、如何解析，打破了由厂商单一定义规则的局限。
社区反应迅速，已有开发者开始逆向分析 Mod 的钩子机制与生命周期。舆论普遍认为，Mods 才是真正的主角，AGENTS.md 仅为其首个演示案例。
此举也让人联想到一个月前开源的 DeepSeek Harness。后者提出"Everything is a plugin"理念，将模型、工具、沙箱等全部组件化，甚至可将 Claude Code 作为子智能体调度。DeepSeek Harness 凭借极高的自由度斩获 GitHub 22.9 万星，证明了市场对“可改装”编程 AI 的强烈需求。
两者路径虽有差异——DeepSeek Harness 是从零构建的插件化框架，而 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 at main · anthropics/claude-code
编辑：所罗门