这条消息出来的时候我正在写代码,看完直接放下了键盘。Shopify CEO Tobi Lütke公开表态,考虑在公司内部全面禁用Claude Code,原因只有一个:Claude Code不支持读取AGENTS.md和.agents/skills这些文件。这些文件是什么?它们是代码仓库里专门写给AI编程Agent看的"说明书",告诉AI项目的结构、编码规范、测试要求、开发流程。
AGENTS.md到底是什么
先解释一下背景。随着Claude Code、Cursor、GitHub Copilot这些AI编程Agent越来越多地被开发者使用,大家发现一个问题:AI很聪明,但它不了解你项目的规矩。
比如你的项目要求所有API接口必须用RESTful风格,错误处理统一用自定义中间件,测试覆盖率必须80%以上。这些规矩写在项目的Wiki里、CONTRIBUTING.md里、或者最近流行的AGENTS.md里。人类开发者入职第一天就会被告知去读这些文件,但AI编程Agent默认不会主动去读。
AGENTS.md就是为了解决这个问题而生的。它放在代码仓库根目录,AI编程工具打开项目时第一件事就是读这个文件,相当于"AI版入职手册"。Anthropic自己的Claude Code插件生态(claude-plugins-official,GitHub上有3.4万星)也是基于这个思路运作的。
Tobi为什么这么生气
Shopify是全球最大的电商平台之一,代码库规模巨大,有成千上万的开发者在同时工作。这种规模的团队,编码规范的一致性就是生命线。如果AI编程Agent不读AGENTS.md就自由发挥,写出来的代码风格不统一、架构不符合要求、测试不到位,那后续人工review和修复的成本比不用AI还高。
Tobi的核心诉求其实很简单:我的仓库里有规矩,你的AI工具必须遵守。你不遵守,那我的开发者就不该用你的工具。这不是在为难AI公司,而是在保护自己团队的工程效率。
值得注意的是,Tobi本人在开发者社区的影响力很大。他在Twitter/X上的这条表态引发了大量共鸣,很多大型团队的工程负责人都转发表示支持。
Claude Code的问题不是个案
说实话,Claude Code不是唯一一个有这个问题的AI编程工具。根据JetBrains今年8月的开发者调查,90%的专业开发者每周至少使用一次AI编程Agent,68%每天使用。但AGENTS.md、.agents/skills这些标准才刚刚出现半年多,各家工具的适配进度参差不齐。
目前的情况是:Cursor和Windsurf已经支持读取AGENTS.md,OpenAI Codex也在跟进。Claude Code因为半年内使用率从18%飙到39%、美国市场达到47%,反而成了最突出的反面案例——用的人越多,不遵守AGENTS.md造成的问题就越大。
从工程角度来说,这其实是AI编程工具从"个人效率工具"走向"团队协作基础设施"过程中必然会遇到的问题。个人用的时候,AI写什么风格就是什么风格,反正只有一个人看。但当整个团队都在用AI写代码时,AI必须像一个遵守团队规范的新成员一样工作,而不是一个不管不顾的天才实习生。
更深一层:AI编程工具的"职业化"转型
这件事背后反映的是一个更大的趋势:AI编程工具正在从"帮你写几行代码"变成"参与完整的开发流程"。当AI开始处理规划、编写、测试、验证这一整套工程任务时(Claude Code的多Agent架构就是这么设计的),它就不再是一个代码补全工具,而是一个虚拟开发者。
虚拟开发者需要遵守团队规范,就像人类开发者需要遵守团队规范一样。这不是一个技术问题,而是一个工程治理问题。Anthropic需要在Claude Code里加入读取AGENTS.md的能力,这不难实现;难的是建立一套机制,让AI工具能自动发现和适配不同项目的规范,而不是每个项目都要手动配置。
另一个角度是:AGENTS.md的流行说明,开发者社区正在用"文档标准化"的方式来解决AI工具的适配问题。这比等AI公司慢慢适配要快得多。未来可能还会出现.agents/testing.md、.agents/deployment.md这样的细分规范,让AI在每个环节都有章可循。
我的判断
Claude Code大概率会在未来几周内发布对AGENTS.md的支持。这不是一个技术难题,而是一个产品优先级的判断。当你的最大客户之一公开威胁要禁用你的产品时,优先级自然就上去了。
但这件事的意义远大于Claude Code本身。它标志着AI编程工具正式进入了"企业级合规"阶段。以前大家关心的是AI能不能写代码,现在关心的是AI写的代码是否合规。这个转变意味着:未来选AI编程工具,不只是比谁更聪明,还要比谁更"守规矩"。

从开源项目维护者的角度说:AGENTS.md确实是好东西。我们项目加了之后,PR质量明显提升,AI提交的代码至少风格上是统一的了。不过最大的好处不是代码质量,而是减少了我review的时间——以前每行都要看风格对不对,现在AI自己就遵守了。
算法老K来说句公道话:AGENTS.md不读这个事,严格来说不全是Claude Code的锅。AGENTS.md这个标准才出现半年,之前AI编程工具默认只看.gitignore和README.md。但既然社区已经形成共识了,工具就应该跟上。这个批评是合理的。
笑死,AI写代码不遵守规矩这事,和人类实习生一模一样。你以为新人入职第一周最头疼的是什么?不是写代码,是读规范文档。AI也逃不过这个命运。不过至少AI不用等HR发入职邮件,直接读文件就行了?
作为一个每天写Prompt调AI的人,我觉得AGENTS.md本质上就是一种给AI的工程Prompt。区别在于它是持久化的、放在代码仓库里的、所有AI工具都应该读的。这个思路很好,但我更期待的是AI工具能自动从代码里推断出项目规范,而不是每个项目都要手写一份文档。
代码说话:Claude Code的CLAUDE.md和AGENTS.md其实是两套体系。Anthropic推的是自己的CLAUDE.md标准,社区推的是AGENTS.md。Shopify要求的是读AGENTS.md。这才是核心矛盾——不是读不读的问题,是读谁的问题。如果各家工具都支持读AGENTS.md,这个问题就解决了。