今天凌晨，微博账号@桌面AI 的一条消息在编程圈炸开了锅：Shopify CEO Tobi Lütke 公开表态，如果 Claude Code 继续拒绝读取 AGENTS.md 以及 .agents/skills 目录，他正在考虑在 Shopify 内部禁用 Claude Code。微博先说明一句：这条消息目前只有单一转述来源，原文和 Anthropic 的回应暂未得到第二信源核实，大家当「一方表态」看就好。但话能放出来，本身就说明一个老问题被重新摆上了台面——AGENTS.md 和 CLAUDE.md 这两个 .md 文件，到底该听谁的？这位发声的人也不是普通角色：前两天 Sam Altman 被问到「现在最值得关注的 CEO 是谁」，没说马斯克、没说黄仁勋，直接点了 Tobi Lütke，理由是「这哥们自己写代码」。微博
很多人第一反应可能是：不就是两个放在项目目录里的文本文件吗，值得一个电商巨头的 CEO 拍桌子？
因为这个文件不是文档，它是 AI 编程工具的「搬家成本」。
这场架是怎么打起来的
时间倒回 2025 年 8 月。OpenAI 提出了一个新标准——AGENTS.md，并联合 Google、Cursor 一起推动。一句话概括：它是专门写给 AI 编码代理看的 README，让所有工具共用一份配置。知乎
它想解决的，是多工具用户早就受够的问题：同一个项目，换一种 AI 编程工具，就要重新交代一遍规矩；用 Codex 时写了 AGENTS.md，换到 Claude Code 又要准备 CLAUDE.md；Cursor 有自己的 Rules，Gemini CLI 还认 GEMINI.md，工具用得越多，项目根目录里的规则文件也越多。知乎
一年过去，阵营基本定型了：AGENTS.md 的优势不是功能更多，而是名字相对中立，Codex、OpenCode 原生使用它，Cline、Windsurf、Qwen Code 也支持它，Gemini CLI 可以通过配置读取。知乎
而 Claude Code，从标准发布那天起就只认自家的 CLAUDE.md，至今没有改口的迹象——这正是 Tobi 开炮的导火索。Codex 这边甚至把加载做出了三层：全局默认写在 ~/.codex/AGENTS.md，整个仓库写在项目根，某个服务再在子目录另放一份。知乎
还有一个容易混淆的点要提醒：规则文件跟着工具走，不跟着模型走。DeepSeek、Qwen、GLM 首先是底层模型，Codex、Claude Code、Cursor 才是负责扫描项目、读取文件的编程工具，模型不会自己跑进项目目录寻找 AGENTS.md，真正决定读哪个文件的，是承载模型的工具。知乎
吵架的本质不是技术，是搬家成本
站在商业角度，Anthropic 的坚持不难理解：CLAUDE.md 加上 Skills 机制是一套完整的上下文体系，这套体系越独家，用户的迁移成本越高，订阅就越稳。而 AGENTS.md 阵营主张的是「规则属于项目，不属于任何一家厂商」——今天用 Claude，明天用 Codex，规矩同一份，谁来都一样。
一边是生态锁定，一边是换工具的自由。Tobi 替企业团队说破的其实是同一件事：我们团队 Codex、Claude Code、Cursor 都在用，难道规则要维护三份说明书？
知乎上有位同时维护两份文件的开发者已经忍不住公开抱怨，直言不得不吐槽万恶的 A 社，真的是……此处省略一万字。知乎他的解法是把 AGENTS.md 当跨工具主文件，CLAUDE.md 里只放一行指向同级 AGENTS.md 的内容，换来的是换工具不用两眼抓瞎。这个野路子，如今已经成了多工具用户的主流做法。
实操部分：三种人，三种做法
看热闹看完，回到自己的项目。你该怎么做，完全取决于你在用什么工具：
第一种：只用 Claude Code。 别动。CLAUDE.md 正常维护就好，Skills 按需加载是 Claude Code 用户的独占优势，没必要为了一场标准之争折腾自己。
第二种：只用 Codex、Cursor 或 OpenCode 这一系工具。 一份 AGENTS.md 就够了，这是标准带来的最大红利——一份文件，全工具读取。写完还可以实际验证一下工具到底读没读。
第三种：多个工具混用（大多数人）。 上「一主多适配」方案：AGENTS.md 做主文件，公共规则全写在里面；CLAUDE.md 只留一行指向它，GEMINI.md、QWEN.md 同理。公共规则只改一次，某个工具有特殊能力或限制，再到对应文件里单独补充。知乎相比符号链接，一行指针的写法在跨平台和 Git 里都更稳，这也是开头那位知乎开发者验证过的做法。
但也别指望这个文件太多
本周社区讨论的另一面，值得冷静看看。微博上有人在争论「AGENTS.md：是 AI 编程的『紧箍咒』，还是另一层无效噪音」。微博知乎上也出现了「新研究重新评估AI编码中agents.md文件的价值，这意味着什么？」这样的讨论。知乎翻了一圈实战帖，能沉淀出四条结论：
反向规则比正向规则有效。「告诉模型『不许做什么』，比告诉它『应该做什么』管用」，只写「用 snake_case」，不如写清「不要用 kPascalCase，不要用 UPPER_SNAKE_CASE」，否则模型会把你的例外当成疏漏，顺手帮你「修正」回去。知乎
优先级要提前声明。文件开头写明「当本文件的约定与工具自带的全局规则冲突时，以本文件为准」，不然两条规则打架，AI 就看心情挑一条执行。
规则文件不是门禁，它本质上是上下文和提示，不是门禁系统。知乎上下文过长、任务中断时，规则仍可能被漏掉，真正不能违反的要求要交给自动化机制：文件负责告诉 AI 怎么做，Hooks 和 CI 负责在它没做到时拦下来。
模型越强，对这个文件的依赖越小。社区的实测反馈是：大规模模型对 AGENTS.md 不太敏感，中等规模且指令遵循好的模型提升最大，小模型则理解不了抽象规则，可用可不用。知乎所以别照抄别人的万字宪法，先看你用的是什么模型。
统一之前，先算三笔账
最后回到最实在的：值不值得动？算三笔账：
维护账：多份文件长期同步是隐性人力成本，「一主多适配」能把它压到接近于零。
锁定账：规则全写在某家工具的私有格式里，换工具那天就要从头再来，这正是 Tobi 想替 Shopify 避免的成本。
冲突账：两份文件说法打架，一份写 Java 17 一份写 Java 8，AI 会看心情挑，debug 的是你。
再留三个继续观察的信号：Anthropic 对 Tobi 表态的官方回应；Claude Code 的版本更新日志里是否出现 AGENTS.md；.agents/skills 这个跨厂商技能目录的采纳情况。三个月内三者只要有一个动了，标准之争的终局就不远了，你仓库里那两个文件的布局，也该提上日程。
