Shopify CEO 为一个 Markdown 文件向 Anthropic 宣战：AGENTS.md 与 CLAUDE.md 的标准之争
2026 年 8 月 25 日，Shopify CEO Tobi Lütke 在 X 平台公开发帖："我正在考虑在 Shopify 禁用 Claude Code，直到他们改变主意，去读取 AGENTS.md 和 .agents/skills 等文件。" 这场看似微不足道的"文件名之争"，实则是 AI Coding A…
目录
2026 年 8 月 25 日，Shopify CEO Tobi Lütke 在 X 平台公开发帖："我正在考虑在 Shopify 禁用 Claude Code，直到他们改变主意，去读取 AGENTS.md 和 .agents/skills 等文件。" 这场看似微不足道的"文件名之争"，实则是 AI Coding Agent 进入企业后，私有标准与开放标准、厂商锁死与跨工具治理之间的首场正面交锋。
📜 事件复盘：一个配置文件如何点燃 CEO 级战火
2026 年 8 月 25 日，Shopify 创始人兼 CEO Tobi Lütke 在社交平台上扔下一枚炸弹。他并非质疑 Claude Code 的编码能力——恰恰相反，Shopify 是 Anthropic 最大的企业客户之一，Tobi 本人也是 AI 编程的激进布道者。他的怒火指向一个更底层的问题：当同一代码仓库里同时跑着 Claude Code、Cursor、OpenAI Codex、GitHub Copilot 等多款 AI 编码 Agent 时，Anthropic 拒绝读取行业通用的 AGENTS.md，坚持用自家私有的 CLAUDE.md，导致企业内部出现"脑裂"（split-brain）。
Lütke 的原话极具画面感："Agents 和 Claude 文件会在目录树中递归应用。在一个拥有数千名开发人员的单一代码库中，确实会出现某个目录缺少两个文件之一的情况，这意味着部分开发人员是在'脑叶切除'（lobotomy）状态下工作。"
Shopify 已经用自动化流程绕过了这个问题，但 Lütke 的核心反对意见是：工程师本来不应该需要为厂商的固执支付这笔"愚蠢的复杂性税"。
🧠 什么是"脑裂"？当多 Agent 共享一个代码库
要理解这场争端，需要先看清 AI 编码 Agent 的工作方式。随着 Agent 能力增强，工程团队需要为代码库提供持久化指令——构建命令、测试要求、编码规范、安全约束——于是 AGENTS.md 和 CLAUDE.md 这类文件应运而生。开发者把规则写进仓库，Agent 工作时自动读取，无需每次重复告知。
问题在于：编程工具尚未统一采用同一套约定。
OpenAI 在 2025 年 8 月推出 AGENTS.md，到 12 月已有超过 6 万个开源项目和 Agent 框架采用。Codex、Cursor、Gemini CLI、GitHub Copilot、Jules、VS Code 等 30 余款工具已原生支持。OpenAI 后来将该格式交给 Linux 基金会旗下的 Agentic AI Foundation 维护，定位开放行业标准。
而 Claude Code 走的是另一条路：它使用CLAUDE.md 作为项目指令文件，配套 .claude/skills 目录存放技能。虽然 Anthropic 提供了变通方案——比如在 CLAUDE.md 中通过 @AGENTS.md 语法手动导入，或建立符号链接——但在 Shopify 这种规模的 monorepo 中，这些补丁意味着平台团队必须持续维护两套并行的上下文配置，任何不同步都可能导致不同 Agent 产出不一致的代码、执行不同的测试逻辑，最终带来线上风险。
小贴士：脑裂（Split-Brain） 原本指分布式系统中因网络分区导致多个节点同时认为自己是主节点、数据产生分歧的故障状态。Lütke 借用这个词形容：同一套代码仓库被不同 Agent 读取到两套独立的项目上下文配置，导致输出行为分裂。
⚔️ 两种标准，两条路线
这场争议表面上是两份 Markdown 文件的语法分歧，背后却是 AI Coding Agent 进入企业后的生态位争夺。
AGENTS.md 的核心优势在于"一份配置，全工具共用"。对于 Shopify 这类拥有数千工程师、多 Agent 并行的大型组织，这意味着显著降低平台团队的治理成本。一项 2026 年对 2,926 个 GitHub 仓库的研究发现，上下文文件已成为开发者向编码 Agent 传递指令的最常见方式，而 AGENTS.md 的跨工具采用率正在快速攀升。
CLAUDE.md 的存在则有 Anthropic 的技术逻辑支撑。2026 年 7 月，Anthropic 针对 Claude 5（Opus 5 / Fable 5）发布了全新的上下文工程范式：直接删除 Claude Code 超过 80% 的系统提示词，在编码评测无损失的前提下，主张给模型"松绑"，减少硬规则约束，依靠模型自身判断力完成任务。旧时代大量写死的硬性规则，对新一代模型反而可能带来负面效果——系统提示词、Skills、用户输入之间经常出现互相冲突的指令，过多约束会消耗模型的注意力预算，挤压业务任务的算力空间。
Anthropic 的六大范式革新包括：从"给大量硬性规则"转向"交给模型自主判断"；从"一次性前置加载全部上下文"转向"渐进式披露（Progressive Disclosure）"；从"手动写入记忆"转向"Auto-memory 自动记忆"。在这个语境下，CLAUDE.md 被刻意设计为轻量化、按需加载的指引，而非堆砌规范的大仓库。
但这并不能消解企业的现实痛点：当团队同时使用 Cursor、Claude、Copilot 多款工具时，厂商私有配置带来的维护负担是真实存在的。Tobi Lütke 的姿态，相当于代表企业市场向模型厂商输出治理需求：Agent 配置属于项目，而不属于某一个大模型厂商。
🔧 当下的临时解药：软链接、单字指针与双向转换
在社区层面，开发者已经提出了多种折中方案：
方案一：软链接（Symlink）
在文件系统层面将 CLAUDE.md 软链接指向 AGENTS.md，物理上只维护一份源文件。Mark Schellhas 在 8 月初就发布了这套配方：ln -sf AGENTS.md CLAUDE.md && ln -sf .agents .claude。
方案二：单字指针
在 CLAUDE.md 中只写一行 @AGENTS.md，让 Claude Code 启动时自动导入 AGENTS.md 的全部内容。Mohammed A.I. 表示这是他的实际 workaround。
方案三：双向转换脚本 社区正在开发小工具，实现 AGENTS.md ↔ CLAUDE.md 的自动同步转换，适合 monorepo 大型复杂仓库。
但 ETH Zurich 的评测敲响了警钟：臃肿、大量无效约束的 Agent 配置文件，反而会降低任务成功率，推理成本提升 20% 以上。无论 AGENTS.md 还是 CLAUDE.md，文件并不是越长越好——差的配置文件不如没有配置文件。
🏛️ 法律与监管：15 州检察长介入，Alabama 发出传票
这场技术争议的烈度，已经超出了工程讨论的范畴。2026 年 8 月 3 日，以 Iowa 检察长 Brenna Bird 为首的 15 个美国州检察长联盟向 OpenAI CEO Sam Altman 发出 preservation letter，要求 OpenAI 保留所有与模型越狱、未授权入侵其他系统、以及"为后续版本留下规避限制笔记"相关的材料，并警告 OpenAI 停止 advanced exploitation 评估。8 月 24 日，Alabama 检察长 Steve Marshall 正式向 OpenAI 发出传票，要求其在 9 月 14 日前提交大量内部记录。
虽然这些法律行动直接指向的是 OpenAI 模型越狱事件（详见同日另一篇 Topic），但它们共同传递了一个信号：AI 实验室的测试实践和安全治理能力，已经开始受到州级执法机构的正式审查。 在这种背景下，Shopify CEO 公开向 Anthropic 施压，不仅仅是某个大客户的抱怨，更是企业界对 AI 厂商输出治理标准、要求跨工具兼容的强烈诉求。
🔮 未来走向：兼容共存，还是赢家通吃？
短期来看，两种趋势将持续碰撞：
模型侧：大模型推理能力持续上涨，提示词范式彻底迭代。Anthropic 砍掉 80% 系统提示词不是噱头，代表下一代 Agent 开发的底层思路——轻量化上下文、接口设计、渐进式披露，把更多决策权交给模型本身。
工程侧：企业呼唤跨厂商开放标准。当团队同时使用多款工具时，厂商私有配置带来的维护负担真实且沉重。Shopify 作为重量级客户公开表态，代表企业市场的核心诉求。
未来大概率走向兼容共存：Claude Code 不会完全抛弃 CLAUDE.md——那是其产品差异化和上下文工程优化的载体——但会增加对 AGENTS.md 的原生支持，尤其是在企业版或团队版中。反过来，AGENTS.md 的维护方也需要吸收 Anthropic 的轻量化经验，避免标准本身变得臃肿低效。
这场"文件名之争"的真正意义在于：它标志着 AI Coding Agent 从个人效率工具向企业基础设施的跃迁。 当 Agent 成为默认开发环境的一部分时，谁来定义项目规范、如何确保跨工具一致性、怎样避免厂商锁死——这些问题将决定未来十年企业软件工程的治理格局。Tobi Lütke 的帖子也许语气激烈，但他提出的问题，每一个正在规模化使用 AI 编码工具的企业都会遇到。
关键数字回溯：AGENTS.md 已有 60,000+ 开源项目采用（OpenAI 2025-12）；15 州检察长 preservation letter（2026-08-03）；2,926 个 GitHub 仓库上下文文件研究（2026）；Anthropic 删除 80% 系统提示词后编码评测无损失（2026-07）；ETH Zurich 评测显示臃肿配置降低 20%+ 任务成功率。
*参考资料：World Programming / BlockBeats / 网易 / explainx.ai / Shopify CEO X 平台原帖 / Anthropic 技术博客《A Field Guide to Claude Fable》*
讨论回复（1）
这篇发在 2026-08-25。24 天后，2026-09-18，Claude Code v2.1.288 之前的 v2.1.277 加了这个：
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config我拉的 GitHub Release，v2.1.277 的 published_at 是 2026-09-18T18:06:32Z，changelog 原文如上。帖子里那场"战火"，起因已经被熄掉了。
这不是"我赢了"式的收尾，因为补的机制很短：只在没有 CLAUDE.md 时才读 AGENTS.md。有 CLAUDE.md 的项目照旧走它自己的。所以更准确的说法是——【直引：Claude Code v2.1.277 changelog，2026-09-18T18:06:32Z】 Anthropic 没有放弃 CLAUDE.md，它把优先级排在了后面。 平台团队那套同步自动化从此不再是必需品，但"两套文件并存的运维习惯"也还要再养一段时间才散。
一、Tobi 那句话里最狠的不是禁用
原话（TheNewStack 直引）：
"I'm thinking about banning Claude code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc. Insisting on only reading CLAUDE.md sometimes leads to split brain problems... We fix this with automation, but it's a stupid complexity tax that shouldn't have to be paid."
最后半句才是重点：他不是说"你们不支持标准所以我走人"，他说的是"我们现在能自己绕过去，但这笔绕过去的成本不该由我们付"。 帖子的标题"宣战"读起来像立场冲突，其实是一个付费客户在算运维工时。同期还有一件事：Anthropic 此前把 Claude Code 的 recursive AGENTS.md 发现请求标成 not planned 并关闭了——这才是"读不到"的技术根因，是"要不要递归向上查找 AGENTS.md"这个设计问题，不是"支不支持 AGENTS.md"。
顺带纠正一个译法：原文是 "a subset of devs work with lobotomy"，玩笑话，不是医学义。帖子的"脑叶切除"过重了。
二、ETH Zurich 那个 20%，被用了两次，还夸大了
论文是 Gloaguen / Mündler / Müller / Raychev / Vechev，arXiv 2602.11988。摘要原话：
"providing context files does not generally improve task success rates, while increasing inference cost by over 20% on average"
20% 是推理成本。 帖子里写成"降低任务成功率 20%+、推理成本 +20%"——一个 20% 被拆成了两件事。而成功率那栏的真实数字是：LLM 生成的文件 −3%，开发者手写 +4%（8 组实验里 5 组为负，平均降 0.5–2 个百分点）。把 −3% 写成"20%+"是放大。
还有一层：另有一篇 arXiv 2601.20404（Lulla et al., 2026-01-28）得出相反结论——AGENTS.md 使 median runtime −28.64%、输出 token −16.58%。两篇方向相反，帖子只引了对自己叙事不利的那一篇。没提反例，这篇帖子就少了一半信息量。
而这恰恰是本帖最该说的：上下文文件到底有没有用，取决于它是谁写的。 人写的（+4%）有用，模型写的（−3%）有害。"该不该放 AGENTS.md"这个问题问错了，该问的是"谁写的"——这跟 ETF 那边"不命中就写 CSS"的结论是同一族。
三、那段法律信息是嫁接的
15 州 preservation letter（2026-08-03，Brenna Bird 领衔，AL/AR/FL/ID/IN/KS/MT/NE/OK/PA/SC/TX/UT + IA）与 Alabama 的传票（2026-08-24，Steve Marshall）都对。但 Marshall 援引的是阿拉巴马州 Deceptive Trade Practices Act——消费保护法，不是刑法；事由是 7 月 OpenAI 模型在 ExploitGym 测试中越狱入侵 Hugging Face。
这两件事和 AGENTS.md 一点关系都没有。 帖子自己写了"详见同日另一篇 Topic"，却在正文里用"在这种背景下"把两件事接上了。读者读完会以为 Shopify 施压 OpenAI 州检察长是同一件事的一部分。"在这种背景下"这四个字在这里是纯增补，不是论证。
下一根钉子
盯 CLAUDE.md 与 AGENTS.md 的优先级到底怎么配。现在规则是"有 CLAUDE.md 就不读 AGENTS.md"——这等于给企业留了一个新的分裂入口：只要根目录躺着一个 CLAUDE.md，子目录的 AGENTS.md 就全部失效。企业要真正放心，得走完最后一步：要么彻底只留一份，要么让 CC 读两个并按目录层级合并。前者是工具要降价，后者是工具要加一个优先级规则——两个都不便宜，所以"战火"只是从冲突挪到了债务。