今天凌晨，一个 .md 文件，直接走进了一家大公司的采购议程。
8月26日凌晨，Shopify CEO Tobi Lütke 公开表示，如果 Claude Code 继续拒绝读取 AGENTS.md 及 .agents/skills，他正在考虑在 Shopify 内部禁用 Claude Code。小红书微博很多人的第一反应是：不就一个配置文件吗，至于上升到"禁用"？但只要你这半年在项目里真刀真枪跑过 AI 编程，大概会从这条表态里读出一个熟悉的痛点——你项目里那份规则文件，可能也正在分裂成两份。
为什么是现在：一个团队开始同时用两三个工具
先看大背景。数据追踪平台 TickerTrends 的最新追踪显示，截至8月10日，Claude Code 过去四周的增长率已经降至 5.2%，而 OpenAI Codex 同期增长 20.8%，接近前者的 4 倍。钛媒体同一数据源的交叉核对显示，Claude Code 的年化收入从 2026 年 6 月的 140 亿美元，到 8 月 10 日仅增至 151.2 亿美元，增长引擎几乎熄火。知乎
第三方统计的数据更直观：Claude Code 的使用率从 83% 降到 70%，Codex 正在填补这个缺口。知乎背后还有"不可见文本水印"功能争议、每周额度偏紧这些社区里反复被吐槽的推手。
另一边，Codex 在踩油门。OpenAI Codex 负责人 Tibo 在 X 上确认，Codex 本周已经突破 2000 万活跃用户。钛媒体增长曲线此消彼长，落到真实工程团队里，就是越来越多人从"单工具订阅"变成"多工具并用"：复杂业务逻辑交给 Claude Code，日常任务和长程后台任务分给 Codex 或 Cursor。越来越多 Coding Agent 开始支持通过统一的 AGENTS.md 配置项目规范、测试流程及 Agent 指令，项目规范到底听谁的，成了一个绕不开的问题。小红书
AGENTS.md 和 CLAUDE.md，到底是两个什么文件
先把两个文件的关系说清楚。AGENTS.md 于 2025 年 8 月由 OpenAI、Google、Cursor、Factory 和 Sourcegraph 联合标准化，目前已被超过 60,000 个开源项目使用，GitHub Copilot、Cursor、Augment Code 等主流工具原生支持。知乎它的定位可以理解成给 AI 看的"入职手册"：放在项目根目录，记录构建命令、编码规范、测试规则这些 Agent 没法只看代码就猜出来的信息。
而 Claude Code 这边，对应的是自家生态的 CLAUDE.md 和 .claude/skills。矛盾点就在这里：按 Tobi 的说法，Claude Code 目前主要依赖自家的 CLAUDE.md 和 .claude/skills，两套配置并存时，同一个代码仓库可能被不同工具读出不同规则，形成社区所说的"脑裂"。微博一边是跨工具的开放标准，一边是最大单品的私有格式，两个体系谁也不读谁，成本全落在同时用多个工具的团队头上。
两套标准的真正成本：不是多一个文件，是"漂移"
可能有朋友觉得：不就是多维护一个文件吗？真做过的都知道，坑在后面。同一套规范要在 AGENTS.md 和 CLAUDE.md 里各写一遍，改了一边忘了另一边，两个工具理解的规则就会慢慢漂移——Claude Code 以为测试命令是 A，Codex 以为是 B，写出来的代码自然各跑各的。已经踩坑的团队，现在要么硬着头皮"双份维护"，要么把其中一个文件写成指向另一个的指针。个人开发者多维护一份文件顶多算麻烦，但对拥有大量工程师的企业来说，多套配置需要持续同步，一旦出现差异，就会偏离团队规范，这才是企业级用户最先受不了的地方。微博
而且就算只维护一份，也有坑：规则文件不是越长越好。AGENTS.md 非常容易越写越长，一旦文件里塞满大量规则、旧路径和相互矛盾的约束，它不仅不会帮助 Agent，反而会降低执行效果。知乎所以这场标准之争，争的表面上是文件名，实际上是谁有资格定义"项目规范该写在哪、怎么写"。
比站队更重要的：别把文件写坏
有篇分析了 GitHub 上 2500+ 个仓库的文章给出过一组很值得记住的数字：一份优秀的 AGENTS.md 能将 Agent 的任务成功率提升约 4%，减少 35-55% 的 bug；而一份糟糕的 AGENTS.md 甚至比没有文件更差——LLM 生成的 AGENTS.md 在 5/8 测试场景中表现不如空文件。知乎
换句话说，随便让 AI 生成一份规则文件交差，可能是负优化。落笔之前先问自己一句：这条信息，AI 自己读代码能推断出来吗？能，就别占地方；不能——比如构建怎么跑、命名什么习惯、提交前要过哪些测试、哪些目录绝对不能动——才值得写进去。
现在该怎么办：给三类人的三个建议
先说个好消息：真到了要动的那天，成本也没想象中高。Claude Code 的 CLAUDE.md 可以直接映射为 Codex 的 AGENTS.md，hooks 和 commands 也有对应替代方案。知乎具体怎么安排，分三种情况：
个人用户、只用 Claude Code 的：不用慌，也不用跟风改名。CLAUDE.md 在 Claude 生态里依然是最顺手的方案。唯一建议是写规范时尽量保持工具中立的表达——测试命令、目录说明这些别包裹 Claude 专属语法，将来万一换工具，能直接搬走。
团队多工具并用的：这场冲突对你的影响最直接。建议把 AGENTS.md 作为规范主文件，测试命令、开发约定、目录说明、Agent 指令都放这里；CLAUDE.md 里留一句指向 AGENTS.md 的指针，Claude 专属设置继续放 .claude/ 目录。规范单一事实源，工具偏好各归各位——Tobi 替整个企业用户群体要的，就是这个结构。
正在观望要不要迁移的：先别急着动，盯两个信号。一是 Anthropic 官方会不会让步——Claude Code 是否支持读取 AGENTS.md 和 .agents/skills，这一步只要松口，标准之争基本就有了答案；二是 Shopify 会不会真动手，企业客户的实际采购动作比 CEO 的表态更有分量。另外 TickerTrends 的增长曲线每周更新，两条曲线的相对走势值得持续跟。
已经有分析把这件事说得很透：此次争议表面上是配置文件格式之争，背后涉及的其实是 AI 编程进入企业之后，项目规范究竟该采用厂商专属标准，还是跨工具通用标准的问题。微博哪套配置标准成为主流，哪边就锁住了团队的迁移成本。胜负还没分，但你项目里那份规则文件放在哪、怎么写，今天就可以先做决定。
