Claude Code拒读AGENTS.md，Shopify的“禁用令”揭开了什么

导语

一个 Markdown 文件，正在成为 AI 编程工具之间的兼容性分水岭。Shopify CEO Tobi Lütke 公开表示，如果 Anthropic 不让 Claude Code读取 AGENTS.md，Shopify 可能在公司内部禁用这款工具。对个人开发者而言，这或许只是改一个文件名；对拥有数千名开发者、采用 monorepo 的企业来说，它却可能变成一项持续支付的“复杂度税”。

争议的核心是什么

AGENTS.md和CLAUDE.md都用于保存项目级指令，例如构建命令、测试要求、编码规范和操作边界。智能体进入某个目录后，会读取目录树中相关的指令文件，通常由更接近当前代码的位置提供更具体的规则。

问题在于，OpenAI推出的AGENTS.md已被Codex、Cursor、Gemini CLI、GitHub Copilot、Jules和VS Code等工具采用，相关格式也被移交给Linux基金会旗下的Agentic AI Foundation。Claude Code则坚持使用CLAUDE.md，目前不会原生读取AGENTS.md。于是，同一个目录可能对多数工具提供完整上下文，却让Claude Code缺少关键规则。

在大型代码库里，这种差异并不容易靠人工解决。团队需要通过导入配置、符号链接、递归查找脚本、文件监控和Git忽略规则，让两套文件保持同步。素材提到的一个Mac自动化方案，甚至需要配置fswatch和launchd。它确实能缓解问题，却也说明企业必须为工具差异额外维护一套工程基础设施。

Anthropic的回应为何没有平息争议

Claude Code团队成员Thariq表示，Anthropic正在提高产品的可定制性，未来会让用户更方便地使用AGENTS.md或修改相关系统提示词。当前的临时方案仍是在CLAUDE.md中写入“@AGENTS.md”，而回应没有明确承诺Claude Code将像其他工具一样默认识别该文件。

Anthropic给出的思路是，不同模型可能需要不同的上下文、Skill和系统提示词。问题在于，模型选择本来就越来越多，企业往往同时使用多种模型。如果每个模型都要求一套单独优化的项目指令，维护成本很快会从产品设计问题转移给开发团队。开发者真正期待的，通常是工具在内部完成模型适配，而不是让仓库承担更多格式和版本管理工作。

意义与影响

这场争议的重点并非某个文件名孰优孰劣，而是谁来承担兼容成本。对于个人用户，符号链接或导入语句可能足够；对于企业，指令文件属于共享工程资产，完整性、递归加载、可观察性和跨工具一致性都应成为平台能力。

Anthropic仍可保留CLAUDE.md，用于Claude Code的专属配置，但更稳妥的产品路径可能是默认兼容AGENTS.md，再为需要特殊模型适配的团队提供扩展入口。否则，开发者面对的就不只是“工具是否支持某个格式”，而是是否愿意为单一工具长期维护一套平行生态。

来源：InfoQ 中文