新智元报道
Claude Code 终于向行业标准低头。刚刚，Claude Code 团队核心工程师 Thariq 在 X 平台宣布：从 2.1.277 版本起，若项目文件夹中不存在 CLAUDE.md，系统将自动读取 AGENTS.md。
GitHub 更新记录首行即确认了此项变更。这一功能让开发者等待了一年多。相关 Issue 自 2025 年 8 月提出至今，已获 5200 多个点赞和 300 多条留言，成为该仓库呼声最高的功能请求，热度超出第二名四倍。
消息发布后，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 等主流工具广泛采用。目前，全球已有超六万个开源项目使用该格式。
值得注意的是，OpenAI 已于去年 12 月将 AGENTS.md 捐赠给 Linux 基金会旗下的智能体 AI 基金会（AAIF）。讽刺的是，Anthropic 不仅是该基金会的铂金会员，也将自家的 MCP 协议捐赠其中。两家巨头虽在基金会内共推开放标准，其核心编程工具却长期互不兼容，这一僵局直至本周才得以打破。
开发者被两份说明书折腾了一年
痛点在于现实开发环境中工具链的多样性。同一项目中，不同成员可能分别使用 Claude Code、Codex 或 Cursor，导致必须维护两份内容几乎一致的说明书。一旦同步不及时，AI 便可能依据过期规范生成代码，引发风格冲突。
为此，开发者曾摸索出多种临时方案：建立软链接、在文件中导入另一份内容，或通过启动钩子强制注入数据。这种"AI 替人写代码，人替 AI 做兼容”的荒诞局面持续了一年有余。随着此次更新，这些冗余操作将成为历史：只需配置 AGENTS.md，所有兼容该标准的智能体即可直接运行。
真正的伏笔，藏在 Mod 中
支持 AGENTS.md 仅是表象，Thariq 随后披露的"Mods"机制才是此次更新的核心。Mods 是 Anthropic 即将推出的定制框架，允许开发者修改 Claude Code 的运行逻辑（Harness）。
AGENTS.md 的支持正是通过首个内置 Mod 实现的，其源码已公开在官方仓库的 mods/agents-md 目录中。
所谓 Mod，可理解为 Claude Code 的“插件”。官方此举意在释放控制权：未来项目说明书的读取逻辑不再由 Anthropic 独断，开发者可根据需求自定义。社区反应迅速，已有技术人员开始拆解源码研究其钩子机制与生命周期。
这一趋势与一个月前开源的 DeepSeek Harness 遥相呼应。DeepSeek 提出"Everything is a plugin"理念，将模型、工具、沙箱等全部组件化，甚至能将其他 AI 作为子智能体调度。其 GitHub 星标数迅速突破 22.9 万，印证了市场对“可改装编程 AI"的强烈需求。
Claude Code 的 Mods 与 DeepSeek Harness 路径略有不同：后者是从零构建的纯插件化框架，自由度极高但学习陡峭；前者则是在成熟产品上开辟“改装接口”，在不破坏原有体验的前提下赋予用户定制能力。无论哪种路线，都标志着编程智能体的运行框架正从“黑箱”走向开放。
参考资料：
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
编辑：所罗门