Claude Code拒绝支持AGENTS.md，Shopify为何考虑禁用它？

Claude Code与AGENTS.md之间的兼容争议，正在从开发者社区的功能请求，升级为大型企业必须处理的工程问题。

Shopify CEO Tobi Lütke公开表示，正在考虑公司内部禁用Claude Code，直到它能够读取AGENTS.md及相关技能目录。争议表面上是两种Markdown文件的选择，核心却是不同AI编程工具能否获得一致的项目规则。

一份配置文件为何影响大型团队？

AGENTS.md和CLAUDE.md的用途相近，都是向编程智能体提供长期有效的仓库说明，例如：

• 项目的安装、构建与测试命令；
• 代码风格和目录组织规范；
• 哪些文件可以修改，哪些区域禁止操作；
• 提交代码前必须执行的检查；
• 子项目特有的框架、依赖与部署要求。

开发者把这些内容写入仓库后，代码智能体便能自动读取，不必在每次对话中重复说明。

问题在于，Claude Code主要使用CLAUDE.md，而Codex、Cursor等工具已经支持AGENTS.md。当一个团队同时使用多款工具时，两份文件必须保持同步，否则不同开发者获得的规则可能并不一致。

在monorepo中，差异会被迅速放大

Shopify拥有大量开发者，并共同维护规模庞大的单体代码库。这类仓库通常采用分层指令：

• 根目录保存全局开发规范；
• 业务目录保存模块规则；
• 更深层的子目录补充测试命令和操作边界；
• 距离当前代码最近的指令优先生效。

如果某个目录只有AGENTS.md，没有对应的CLAUDE.md，Claude Code就可能缺少部分上下文。它仍然能够生成代码，但可能使用错误的构建命令、忽略局部规范，甚至修改不应触碰的文件。

这正是Tobi Lütke所说的“被切掉一块脑子”：工具不是完全不能工作，而是在不易察觉的情况下少读了关键规则。

团队真正承担的是“复杂度税”

为了兼容Claude Code，开发者目前可以在CLAUDE.md中导入AGENTS.md，也可以创建符号链接。但在大型仓库中，这些方法并非一次设置就能永久解决。

常见的额外维护工作

1. 递归查找各级目录中的AGENTS.md；
2. 在相同目录创建CLAUDE.md或符号链接；
3. 监控新增、删除和移动的指令文件；
4. 防止自动生成的文件被误提交到Git；
5. 确保Windows、macOS和Linux环境表现一致；
6. 在持续集成流程中检查两份文件是否同步。

单个开发者可以用脚本完成这些操作，但企业需要考虑权限、跨平台、异常恢复和长期维护。脚本越多，故障点越多，这些本可避免的工作就是所谓的复杂度税。

从平台工程角度看，真正的问题不是能否找到临时方案，而是企业是否应该为一项基础兼容能力持续投入人力。

Anthropic为何没有直接采用AGENTS.md？

Claude Code团队的回应显示，他们正在增强产品的可定制性，让开发者更方便地使用AGENTS.md或调整其他系统提示词。现阶段的典型方法，仍是在CLAUDE.md中引用AGENTS.md。

Anthropic认为，不同模型适合的上下文和指令可能存在差异，因此更倾向于围绕Claude模型优化系统提示词、Skills和CLAUDE.md。这一思路有技术上的合理性，但也引出了新的成本问题。

如果每个模型都需要专属指令，使用多种模型的团队就要维护多套文件。模型频繁升级后，还需要重新测试和调整规则。对普通项目来说，这种维护方式很难长期执行。

更现实的分工应该是：

• 仓库维护一份通用的项目指令；
• 工具厂商在产品内部完成模型适配；
• 专属文件只用于确有必要的模型优化；
• 工具明确显示本次任务读取了哪些规则。

企业当前可以怎样降低风险？

在Claude Code是否原生支持AGENTS.md尚未明确之前，团队可以采用以下过渡方案。

小型项目：使用显式导入

在仓库根目录保留AGENTS.md，再通过CLAUDE.md进行引用。这样配置简单，也便于人工检查。团队需要在贡献指南中注明两者关系，避免成员重复编辑。

大型仓库：建立自动检查

对于多层目录结构，可以在CI中检查每个AGENTS.md是否存在对应的Claude入口，并在缺失时阻止合并。相比依赖开发者本机运行监控脚本，CI检查更统一，也更容易审计。

多工具团队：确定唯一信息源

团队应明确哪份文件是规则的唯一来源。其他配置文件只负责引用，不应复制完整内容。否则同一条编码规范可能在多处出现，更新时很容易遗漏。

增加可观测性

无论使用哪款工具，都应确认它实际读取了哪些文件。理想状态下，智能体在开始任务前列出已加载的规则、作用目录和优先级，让开发者能够及时发现上下文缺失。

这场争议不只是格式之争

AGENTS.md能否成为稳定的行业约定，仍取决于工具厂商和开源社区的共同选择。但对企业而言，统一入口的价值已经十分明确：减少重复配置，降低行为差异，并让不同智能体遵循同一套安全与开发规范。

Claude Code可以继续保留CLAUDE.md，用于Claude模型的特殊优化；同时原生读取AGENTS.md，作为跨工具的基础兼容入口。二者并不冲突。

Shopify的公开质疑之所以受到关注，是因为它揭示了AI编程落地的新难题：模型能力固然重要，但兼容性、可维护性和团队治理同样决定一款工具能否进入大型研发体系。对企业来说，少维护一套重复规则，往往比增加一个炫目的功能更有价值。