一个 Markdown 文件，把 Claude Code 和 Shopify CEO 隔在了两边

一个 Markdown 文件，把 Claude Code 和 Shopify CEO 隔在了两边

8 月 26 日，Shopify 的 CEO Tobi Lütke 在 X 上公开表态：如果 Anthropic 的 Claude Code 不支持读 AGENTS.md，Shopify 内部就考虑禁用 Claude Code。

Claude Code 团队的工程师 Thariq 当天就回了一条评论。承认会跟进，但也明确说：CLAUDE.md 是 Claude「上下文工程」的一部分，短期内不会与 AGENTS.md 完全等价。

一桩看上去只关乎「AI 工具改名」的争论，5 天内升级成生态阵营问题。

一份配置文件，怎么会变成公司层面的事

按工程师的直觉，「项目根目录放个说明文件让 AI 读」这件事应该无足轻重——反正都是 Markdown，工具读不到，用户复制一份另存为也不费事。

Shopify 不是这样工作的。Shopify 是 monorepo，仓库被切成几百个子目录，几千个工程师并行提交，每个目录都可能有自己的 AGENTS.md。Lütke 把这叫「开发者不该交的复杂税」：用 Codex 的同事读 AGENTS.md，用 Claude Code 的同事读 CLAUDE.md，一旦两份文件在某个角落出现差异，不同人手里的 AI 助手就会拿到不同的项目规则。

更极端的场景里，被调用的 Skills（技能包）也按目录分散——.agents/skills 和 .claude/skills 是两套目录体系，团队每改一项规范都要同步两份。Lütke 说这种「复杂税」愚蠢，应该被自动化修复。但他接着承认，自动化修复本身就是另一种工程负担。

公开贴下面排得最靠前的两条解法，被评论区点了上百次：

ln -s AGENTS.md CLAUDE.md

或者在 CLAUDE.md 顶部写 @AGENTS.md，让 Claude Code 把团队已经维护的规则带进来，自己再加 Claude 专属配置。

Lütke 回复了，扔下一句话：「这些技巧我都知道。」¹

他在意的不是个人项目能不能解决，是规模放大之后这件事根本无法彻底自动化。

Vercel 用真评测给出了事实层面的答案

就在 Lütke 发难的两个多月前，Vercel 工程团队已经把同一件事的答案做到了评测里。²

他们在为 Codex / Claude Agent 补 Next.js 16 的新 API 知识——'use cache'、connection()、forbidden()——这些 API 还没进入模型训练数据，Agent 写出来的代码经常是错的。Vercel 想看看，是把文档打包成 Skills 让 Agent 按需调用更好，还是直接塞进 AGENTS.md 默认加载更好。

四条对照评测，结果很反直觉：

配置	通过率	vs Baseline
Baseline（不放任何文档）	53%	—
Skills，默认行为	53%	+0pp
Skills + 在 AGENTS.md 中显式指令「必须调用 Skill」	79%	+26pp
8KB 压缩后的 docs 索引直接放进 AGENTS.md