Shopify CEO Tobi Lütke 在 8 月 25 日公开表示，正在考虑在公司内部禁用 Claude Code，除非 Anthropic 改主意，让它读取 AGENTS.md 和 .agents/skills 这类文件。他给出的理由是，Claude Code 坚持只读 CLAUDE.md，团队成员用不同工具时会出现”脑裂”，他把这称作一笔本不该交的复杂度税。
争的是一个 Markdown 文件
AGENTS.md 是 OpenAI 在 2025 年 8 月推出的约定：把项目级的构建命令、测试方式、安全规范写进仓库根目录的一个 Markdown 文件，编程 agent 读它来理解代码库。到 2025 年底，公开数据显示已有六万多个开源项目放了这个文件，标准本身后来交给了 Linux 基金会下属的 Agentic AI Foundation。Codex、Cursor、Gemini CLI、GitHub Copilot、Jules、VS Code 都认它。
Claude Code 用的是自己的 CLAUDE.md。对单人项目，这只是多写一个文件的事；对 Shopify 这种上千人共用一个大仓库的组织，问题就变了形：同一个目录下如果只放了其中一份，用另一套工具的同事拿到的上下文就是残缺的。
请求挂了一年
要求 Claude Code 原生支持 AGENTS.md 的 GitHub issue 从 2025 年 8 月就在了，攒到近 5000 个赞，是该仓库里响应最广的兼容性诉求之一。后续几个同类 issue 陆续被关掉，其中一个给的结论是”暂无计划”。开发者在下面留了几百条评论，官方那边一直没有正式说法。
社区的变通办法早就跑通了：把 CLAUDE.md 做成指向 AGENTS.md 的软链接，或者干脆在 CLAUDE.md 里写一句”去读 AGENTS.md”。能用，但每个仓库都要做一遍。
Anthropic 终于给了理由
Lütke 发声当天，Anthropic 的 Thariq 回了帖，说团队正在让 Claude Code 变得更可改造，之后能方便地用 AGENTS.md 或者直接改系统提示，做好了会再讲。他也第一次给出了此前拒绝的理由：他们不认为不同模型家族可以互换，系统提示对性能影响很大——Claude Code 内部是按模型分别维护系统提示的，这部分维护量不小。
这个理由技术上站得住。同一段指令喂给不同厂商的模型，效果确实会差出一截，针对性调过的提示词能拉开明显的表现差距。只是它解释了 CLAUDE.md 为什么该单独存在，没解释为什么不能顺手也读一遍 AGENTS.md，这两件事并不冲突。
上下文文件成了新的兵家必争地
一份覆盖 2926 个 GitHub 仓库的统计显示，上下文文件已经是开发者给编程 agent 下指令最常用的方式。这个位置一旦被某家的私有格式占住，迁移成本就落到使用者头上——今天是多维护一个文件，明天可能是把技能、子 agent、权限配置整套锁进一家的目录结构。
从工程量看，这场僵持有点不成比例。让 Claude Code 在找不到 CLAUDE.md 时回退去读 AGENTS.md，是一段几十行的文件查找逻辑，跟”按模型维护系统提示”完全在两个层面上。真要担心通用指令拉低效果，加一行提示说明就是了。一年时间里社区反复提出的也正是这个折中：默认读 CLAUDE.md，找不到就读 AGENTS.md，两者都在时以前者为准。
Lütke 的公开施压之所以奏效，逻辑也简单。Shopify 是 Claude Code 的规模化用户，一家上市公司的 CEO 在公开平台上说要封杀，分量远高于 5000 个匿名点赞。对 Anthropic 来说，Claude Code 眼下的领先靠的是产品体验，不靠格式绑定；在开发者已经普遍多工具并用的当下，把兼容性做成一个开关，比守住一个文件名划算。
参考来源：The New Stack、GitHub、CocoLoop、Hacker News；AGENTS.md 采用规模、issue 点赞数与 Anthropic 方面表态均按公开可查页面核验。