昨天AI编程圈出了条挺特别的新闻：Shopify CEO Tobi Lütke公开表示，考虑在Shopify内部禁用Claude Code。不是因为它写代码不行，也不是因为贵——是因为它不读AGENTS.md。微博
先给不熟悉背景的朋友补个课。现在越来越多的代码仓库里会放一份专门"写给AI看"的文件：项目结构、编码规范、测试要求、禁止事项都写在里面，Agent开工前先读它，相当于入职先领员工手册。但这本手册目前分裂成了两套互不认账的体系：
AGENTS.md：OpenAI Codex、Cursor、Amp等工具读它，正在成为跨工具的通行约定
CLAUDE.md和.claude/体系：Claude Code只认自己这套
如果你的团队从头到尾只用一个工具，这事完全不叫事。但只要同一个仓库里有人用Codex、有人用Claude Code，问题就来了：同一份代码，两本手册，AI会因为使用工具不同而读到不同的规则。机器之心
Lütke的痛点就在这。Shopify是数千名开发者的monorepo，这类规则文件还会沿目录树递归生效。同时维护两套文件，意味着每个目录都得保证两份齐全且同步——哪个目录漏了一份，一部分开发者的AI拿到的就是和另一部分人不同的规则，生成的代码各埋各的雷。36氪
社区很快给他递了方案：建软链接 `ln -s AGENTS.md CLAUDE.md`，或者在CLAUDE.md里写一行 `@AGENTS.md` 直接引用通用规则。机器之心Lütke的回应很直接：这些技巧我全知道，自动化也能修，但这是"一种不应该由开发者承担的愚蠢的复杂性税"。36氪
Claude Code这边也回应了。团队成员Thariq表示，相关功能准备发布后会分享进展，同时解释了为什么坚持自己的体系：不同模型家族有不同的行为特点，system prompt会显著影响模型表现，Claude模型对CLAUDE.md和skills的组织方式有特定偏好。36氪这和Anthropic最近主推的"上下文工程"思路一致——7月Thariq分享过，团队在最新一代模型里移除了约80%的Claude Code system prompt，把更多能力放进了模型本身，而不是提示词。机器之心
所以仔细看，双方吵的其实不是同一件事。Lütke谈的是工程治理：规则就该有唯一事实源，重复维护就是债务。Anthropic谈的是模型效果：规则文件不是中性文本，是模型调优的一部分，强行统一格式可能牺牲效果。两套逻辑各自成立，这架短期内吵不完。
但社区已经开始用脚投票了。知乎上相关问题浏览量已经超过10万，有位高赞作者翻了近190个仓库的规则文档，发现真正独立双写CLAUDE.md和AGENTS.md的项目不到一半，大多数要么内容完全一致（软链接），要么CLAUDE.md里只写一行 `@AGENTS.md` 占位。知乎据他盘点，grafana、n8n、strapi这类项目也是这么玩的。思路很朴素：我不知道该单独给Claude写什么，但我知道不该写两份——双重维护是债务，总有一份会更腐化。（说明：这是该作者个人抽样盘点，不代表全生态统计，但方向和社区实践吻合。）
另一位长期维护两份文件的资深开发者说得更直白：AGENTS.md放跨工具通用规则，子目录里的CLAUDE.md只有一行，指向同级的AGENTS.md。他的原话是：谁家好用谁家，项目不应该被一个AI模型或一家AI厂商绑架。知乎
那普通开发者到底该怎么办？看你属于哪一种：
第一种，个人项目、只用Claude Code。不用动。继续写你的CLAUDE.md，这场仗跟你没关系。
第二种，个人项目，但想在Claude Code、Codex、Cursor之间随时切换。以AGENTS.md为事实源，CLAUDE.md里写一行 `@AGENTS.md` 引用，有Claude专属要求再补在下面。一份规则喂所有工具，换工具零成本。
第三种，中小团队，成员用不同工具。同第二种，但CI里加一道检查：校验每个目录的两个入口是否齐全、是否同步。Lütke的坑就在"新目录忘建文件"，只是他有几千个目录，你的几十个目录靠检查还拦得住。
第四种，大型monorepo。别急着自建同步自动化。Thariq已经放话官方支持在路上，值得等；过渡期用一行指针方案顶着。Lütke已经替你验证过：自动化本身也是长期维护债。
最后说两个值得继续盯的信号：
一是规则文件不是万能的。社区早就在讨论"AGENTS.md写得越长，Agent是否越听话"，结论可能恰恰相反；还有一位维护规则文件维护到翻车的开发者总结，所有规则生效都有个前提——AI真的去读了文件，所以连"动手前先查文档"都要写进规则。别指望写一份文件就一劳永逸。
二是盯住Claude Code的版本更新。等它官方支持读取AGENTS.md，双文件的最大理由就消失了。在那之前，一行指针是多数人性价比最高的解法。
这场争吵的本质是：AI编程时代，"项目规则文件"正在变成和README同等重要的基础设施，而标准之争才刚开始。历史最后站哪边，过几个月再回来验证。
