一份 Markdown 文件，让 Shopify CEO 亲自下场“逼宫” Anthropic。
Tobi Lütke 在 X 上表示，如果 Claude Code 不能原生读取 AGENTS.md 和 .agents/skills，他将考虑在 Shopify 全公司禁用这款工具。问题的核心不是模型能力，而是「脑裂」（split brain）：当同一团队里有人用 Claude Code，有人用 Codex、Cursor、Gemini CLI 或 Copilot 时，不同 Agent 会读到不同的项目规则，同一份代码库在两种指令下运行。
Claude Code 团队成员 Thariq Shihipar 很快回应称，团队正在让 Claude Code 变得更可定制，AGENTS.md 支持已在路上。但这场交锋揭示了一个更大的拐点：编码 Agent 的竞争正从「谁的模型更强」转向「谁的控制平面能被企业现有规则接管」。
AGENTS.md 是什么？为什么一份文件能惊动 CEO？
AGENTS.md 可以理解为写给 AI 程序员的 README。它通常放在仓库根目录或特定子目录下，告诉 Agent 项目结构、安装方式、测试命令、代码规范、安全限制，以及提交前必须完成的检查。它把企业的开发规则写进了代码仓库本身。
目前，OpenAI Codex、Cursor、Gemini CLI、GitHub Copilot、Devin、VS Code 等工具已经支持 AGENTS.md。2025 年 12 月，OpenAI 把它捐赠给 Linux 基金会旗下的 Agentic AI Foundation，由中立组织治理。而 Anthropic 也是该基金会的联合创始方之一，并捐赠了 MCP 协议。
但 Claude Code 采用另一套体系：项目规则写进 CLAUDE.md，技能放进 .claude/skills。Anthropic 的解释是，不同模型家族对 system prompt 的响应差异很大，Claude 对 skills、规则和组织方式有特定偏好，因此 Claude Code 针对性地设计了提示格式。团队把这种做法称为「context engineering」。今年 7 月，Shihipar 曾透露，Claude 5 一代模型已经把 Claude Code 约 80% 的 system prompt 移除，说明这套格式与模型绑定很深。
「脑裂」在大型 monorepo 里有多危险
Lütke 的担忧不是理论问题。Shopify 拥有庞大的 monorepo，并且同时部署多款 AI 编程工具。如果 Codex 读 AGENTS.md，Claude Code 读 CLAUDE.md，同一段代码路径就可能执行不同的约束。
举个例子：支付模块规定「修改账单必须跑完整测试，禁止直接改动数据库迁移文件」。这条规则写在 AGENTS.md 里，Codex 读到了，Claude Code 没读到。结果不是程序崩溃，而是行为在不知不觉中分叉，直到代码审查甚至上线后才暴露。
开发者已经想出了临时方案。最常见的是软链接：ln -s AGENTS.md CLAUDE.md；或者在 CLAUDE.md 顶部写 @AGENTS.md，让 Claude Code 启动时一并加载。这些方案在小仓库里够用，但在 Shopify 这样的 monorepo 里会变成维护噩梦。
Agent 配置和 Claude 配置都会沿目录树递归应用。数千名开发者并行工作时，要保证每个子目录同时维护两套完整文件几乎不可能。一旦某个目录缺少其中一份，部分工程师使用的工具就会拿到不同的上下文。Lütke 把它称为不应由开发者承担的「愚蠢的复杂性税」（complexity tax）。
为什么是 Shopify 出来喊？
Shopify 不是普通用户。去年 Tobi 就在内部备忘录里写明：熟练使用 AI 是所有员工的基本要求，AI 使用情况会进入绩效评价，团队申请加人前必须先证明这件事 AI 干不了。此外，Shopify 今年 7 月开源了内部 Agent 安全扫描系统 Dispatch，让不同 Agent 分别找漏洞、写测试、交叉验证。
这种多 Agent 架构决定了 Shopify 把「配置层」视为真正的基础设施。Lütke 的总结是：真正长期留下来的，是 Agent 运行框架；模型会换，企业自己的规则、流程和安全边界必须保留。
所以文件名之争背后是锁定问题：如果每个模型厂商都坚持自己的配置格式，那么每换一次工具，企业就要重写一遍组织记忆。Lütke 要的是一份可迁移的规则书。
产业影响：控制平面比模型更重要
短期来看，AGENTS.md 正在成为事实标准。6 万多个开源项目采用、中立基金会背书、主流工具纷纷支持，Anthropic 最终接入几乎不可避免，差别只在支持力度。
更深层的信号是模型本身正在商品化，而控制平面的价值在上升。当编码 Agent 变成持续数小时、高频消耗 Token 的工业流水线时，约束它们的规则比单次补全质量更重要。企业会优先选择能接入现有治理、安全和流程体系的工具，而不是要求企业另起一套规则书的工具。
这与 Kubernetes 成为容器编排标准、HTTP 成为 Web 协议的过程类似：中立、厂商无关的控制层，最终会比任何单一产品活得更久。对编码 Agent 来说，这个控制层正在形成。
现在可以做什么
- 把
AGENTS.md作为唯一真相源。 在项目根目录集中写明结构、构建命令、测试命令、lint 规则、安全约束和禁止操作。 - 今天就让 Claude Code 读 AGENTS.md。 在
CLAUDE.md顶部加入@AGENTS.md，把通用规则加载进来，Claude 专属配置保留在单独文件中。 - 让厂商专属文件保持「薄」。 把
CLAUDE.md、.cursorrules等视为AGENTS.md的薄覆盖层，而非并行的第二套规则。 - 检查 monorepo 中的配置覆盖。 扫描子目录，确保没有 Agent 在缺少上下文的情况下运行。
- 为模型轮换设计流程。 如果你的安全或质量流程依赖某一款模型读取特定文件，你已经被锁定。应让策略可以脱离模型而存在。
Shopify 这场风波的真正启示，不是 Claude Code 不好用，而是企业 AI 的下一个护城河不再是模型智商，而是模型互操作性。而仓库根目录那份看似普通的 Markdown 文件，正在成为决定谁能进场的新关卡。
