Back to News

Shopify CEO considers banning Claude Code over AGENTS.md incompatibility

#ai-coding#claude-code#agents-md#developer-tools

Shopify CEO Tobi Lütke said he is considering banning Claude Code at Shopify until it supports reading AGENTS.md and .agents/skills files, arguing that its reliance on CLAUDE.md could give developers using different AI coding tools inconsistent project rules within the same repository. The comments sparked developer discussion, with suggestions including symlinking AGENTS.md to CLAUDE.md or using @AGENTS.md references, though Lütke noted maintenance challenges in large monorepos.

Coverage timeline

  1. 机器之心机器之心

    Shopify CEO Tobi Lütke 考虑在 Shopify 禁用 Claude Code,直到其支持读取 AGENTS.md 、 .agents/skills 等文件。 他认为,Claude Code 坚持读取 CLAUDE.md ,在团队成员使用不同 AI 编程工具时,可能导致同一个代码仓库里的开发者获得不同的项目规则和操作指令。 随着 AI coding agent 进入软件开发流程,越来越多代码仓库开始加入专门面向 AI 的说明文件。 这些文件通常会写入项目结构、编码规范、测试要求、开发流程以及可调用技能,让 AI 代理在处理代码前获得相对稳定的项目上下文。 AGENTS.md 正在成为其中较常见的一种约定。OpenAI Codex、Cursor、Amp 等工具已经支持相关格式,一些项目还会通过 .agents/skills 目录组织更细化的技能与操作规范。 Claude Code 采用的是另一套体系,包括 CLAUDE.md 以及 .claude/skills 等文件和目录。 当团队成员同时使用多种 AI 编程工具时,两套配置入口便可能产生同步问题。同一个代码仓库中,使用 Codex 的开发者可能读取 AGENTS.md ,使用 Claude Code 的开发者则会获得 CLAUDE.md 中的内容。如果两份文件在某个目录出现差异,AI 获得的项目规则也会随之不同。 这引起了不少共鸣。 开发者社区很快给出了一批现成方案。 最常见的方法之一,是在项目中建立软链接: ln -s AGENTS.md CLAUDE.md 另一种方式利用了 Claude Code 自身的文件引用能力。开发者可以在 CLAUDE.md 中写入 @AGENTS.md ,让 Claude Code 加载团队已经维护的通用规则,同时保留在 CLAUDE.md 中加入 Claude 专属配置的空间。 面对评论区不断出现的解决办法,Lütke 随后再次发帖回应。 「很多人告诉我处理这个问题的技巧——我全都知道。」他进一步解释,agent 和 Claude 相关配置文件都会沿目录树递归应用。在拥有数千名开发者的大型 monorepo 中,很难保证每个目录始终同时维护完整的两套文件。一旦某个目录缺少其中一份配置,部分开发者使用的 AI 工具就可能获得不同的项目上下文。