如果你最近翻过几个用 AI 辅助开发的项目,多半会在仓库根目录看到一些新面孔:CLAUDE.md、.cursorrules、AGENTS.md……它们的用途高度一致,告诉 AI 编程代理这个仓库怎么构建、代码风格是什么、哪些目录不要乱动。问题在于,每家工具都想让你写一份自己的。
事件要点
8 月 19 日,Anthropic 的 Claude Code 仓库里,一条编号 #6235 的 feature request 引起了社区注意:请求原生支持 AGENTS.md。这个看似不起眼的提议随后登上 Hacker News,拿到 80 分和 40 条讨论,对一个文件格式问题来说,热度不算低。
诉求本身很简单:开发者在 issue 中希望 Claude Code 能直接读取 AGENTS.md,而不是只认自家的 CLAUDE.md。这样一份说明就可以被多种代理工具共用,不必在每个仓库里维护两三份内容雷同、措辞微调的文件。
背景:谁先来,谁定规矩
这场争论有个略显讽刺的背景。记忆文件这个模式,恰恰是 Claude Code 用 CLAUDE.md 带火的:/init 命令自动生成项目说明,@路径 语法引入子文档,配合分层记忆机制,成了不少团队上手的默认姿势。Claude Code 客户端近期的性能优化我们此前也介绍过,这个产品线显然在快速迭代。
但把“项目说明”变成开放标准的不是 Anthropic。OpenAI 在 2025 年推出了 AGENTS.md,定位是“AI 编程代理的 README”,一个放在仓库根目录(也支持在 monorepo 子目录中嵌套覆盖)的纯 Markdown 约定。随后 Codex、Gemini CLI、Cursor、Jules、GitHub Copilot 编码代理等陆续宣布支持。也就是说,生态里最有动力推标准的恰恰是 Claude 的竞争对手。
HN 讨论区的反应也颇具代表性:有人贴出用 symlink 把 CLAUDE.md 指向 AGENTS.md 的临时方案,有人写了拼接脚本把多份说明合并成各家格式,也有人指出这些 workaround 恰恰说明问题真实存在,工具中立的项目说明,不该被文件名绑架。
影响:agent 生态开始“分层”
放大一点看,这是 AI 编程工具栈走向模块化的一个信号。工具调用层有 MCP 逐渐统一接口,项目说明层则由 AGENTS.md 争当事实标准,各家私有的记忆、规则文件则面临被归约为“兼容入口”的压力。对开发者的直接好处是迁移成本下降:换一个 agent 工具,不用重写项目说明书;对仓库维护者来说,AGENTS.md 可以随代码一起 review、随版本一起演进,而不是散落在各家 IDE 的配置里。
当然也有反对声音:有人认为 CLAUDE.md 的分层记忆、动态加载等能力超出了一份静态说明书,简单兼容会损失功能;也有人觉得这不过是厂商在争夺“默认习惯”,谁的名字成为约定,谁就掌握了入口。
简短点评
标准之争从来不只是技术之争,README.md 能成为几十年的共识,是因为没有哪家公司能靠它收租。AGENTS.md 目前看正是走的这条路:足够简单、足够中立、足够像基础设施。对 Anthropic 来说,支持它短期看是“给对手的标准站台”,长期看却是降低整个生态的摩擦成本,毕竟 Claude Code 的护城河应该是代理能力本身,而不是一个文件名。这条 issue 最终会不会被采纳还未知,但社区用 80 个赞投的票已经说明:开发者要的不是更多格式,而是更少格式。
参考链接