Claude Code 拒绝原生支持 AGENTS.md：一场持续一年的开发者争议

一条在 GitHub 上积累了 6644 个赞的功能请求，最终以一种颇为荒诞的方式收场。这个数字比很多正式产品公告拿到的反馈都多，而它要求的东西并不复杂：让 Claude Code 支持 AGENTS.md 文件。B站UP主亲自去 GitHub 和官方文档把整件事查了一遍，发现真实情况比网上流传的说法更值得玩味。

AGENTS.md 与 CLAUDE.md 的路线之争

AGENTS.md 是由 OpenAI 牵头推动的一个配置标准，Cursor、Google 等公司也参与了生态共建，目前已移交给 Linux 基金会名下的机构托管。按官网自己给出的数字，GitHub 上已有 6 万多个项目在使用这一格式。它的定位很清晰：给各类 AI 编程工具一个统一的、可共享的指令文件。

而 Claude Code 走的是另一条路，一直坚持使用自家的 CLAUDE.md。官方文档写得很直白——Claude Code 读取的是 CLAUDE.md，不是 AGENTS.md。唯一的兼容方案，是在 CLAUDE.md 里写一句导入 AGENTS.md，或者手动建一个软链接。

这看似只是一个文件命名的小分歧，但在多工具协作的现实工程环境中，它带来的摩擦被迅速放大。

AGENTS.md 背后的标准化逻辑，可以类比软件工程里的 .editorconfig：不同编辑器只要认同同一份配置文件，开发者就不必为每款工具单独维护一套设置。AI 编程工具兴起后，同样的问题浮现了——Cursor、GitHub Copilot、Claude Code、Gemini CLI 等工具各自读取不同的指令文件，一个有十几名工程师、混用三四种 AI 工具的团队，要想让所有人拿到一致的代码规范和上下文，就不得不同时维护多份内容高度重叠的文件。AGENTS.md 试图解决的正是这个协调成本问题。移交 Linux 基金会托管，则是为了让这一标准在商业中立的机构背书下推进，避免被某家厂商单边控制——但 Anthropic 选择不参与，本身就是一种明确的生态站队。

Shopify CEO 的公开施压

这场分歧把 Shopify 的项目都卷了进来。据该UP主查证，Shopify CEO Tobi Lütke 在社交媒体上公开表示，正在考虑在公司内部禁用 Claude Code，除非 Anthropic 愿意读取这些文件。

他给出的理由很具体：这两种配置文件都会沿着目录树递归生效，而几千名工程师共用一个代码仓库，难免有些目录会漏掉其中一份。在那些漏掉的地方，使用 Claude Code 的开发者相当于用了一个「被切掉一块脑子的智能体」。

这不是一个普通用户的抱怨，而是拥有数千名工程师的大客户的正式表态。它把一个技术细节上升成了采购决策问题。

那条 issue 究竟是怎么被关闭的

真正荒诞的部分，藏在这条 issue 的原始记录里。

上个月，这条 issue 被标记为「已完成」并关闭。Anthropic 的工程师给出的方案是：建一个只有一句 AGENTS.md 导入语句的 CLAUDE.md，或者建个软链接。问题在于，这和一年前就已经存在的变通办法一字不差。

当场就有开发者反驳：这个方案仍然要求仓库里放一份 CLAUDE.md 才能生效，这是变通，不是真正的采纳。他还追问了一句——「改两行代码就能做到的事，为什么不做？」

更耐人寻味的是，另一位开发者发现，这条 issue 很可能并非被 Anthropic 主动关闭，而是被一个完全不相关的第三方仓库的一次代码提交意外触发的。那次提交的说明里提到了这条 issue 的编号，GitHub 便自动将其关联并关闭。

换句话说，一条积累了六千多个赞、跟了一整年的功能请求，可能是被一次误触碰关掉的。UP主还核实到一个细节：这次关闭没有出现在官方更新日志的任何记录里。

GitHub 的 issue 自动关闭机制是问题的技术根源。当某次代码提交（commit）的说明信息中包含特定关键词加 issue 编号的组合——例如 fixes #1234、closes #1234、resolves #1234——GitHub 会自动将对应 issue 标记为已关闭，且这一操作在默认配置下跨仓库同样有效（需在同一组织内，或通过完整仓库路径引用）。这意味着任何人只要在自己仓库的提交信息里写上「closes anthropics/claude-code#某编号」，就能在不经 Anthropic 审核的情况下关闭对方仓库里的 issue。这个机制的设计初衷是方便开发者在合并 PR 时自动关联并清理 issue，但在此案例中，它的副作用是让一条积累了六千多个公开投票的需求，在没有任何官方确认的情况下悄然消失。

文档里到底改了什么

为了不只依赖「文档说了什么」，UP主把官方更新日志的全文（七千多行）完整拉了下来逐行核对。

他确认官方确实新增了两样东西：

• 导入命令：能把 AGENTS.md 等其他工具的配置一次性拷贝合并进 CLAUDE.md；
• 环境变量：开启后，生成 CLAUDE.md 时会顺带读一次 AGENTS.md。

关键区别在于，这两个都是一次性行为，不是每次对话都原生读取，跟 CLAUDE.md 本身「每次都被加载」的待遇完全不同。而在七千多行更新日志里，搜索 AGENTS.md 和这条「一次性拷贝合并进」的导入命令，都没有搜到——开发者说这次修复没写进更新日志，经核对属实。

此外，这条 issue 并不孤立。另一条类似请求从去年八月拖到现在，反复被机器人自动关闭，至今仍开着，攒了 500 多个赞。

Anthropic 的解释与开发者的反驳

面对质疑，Anthropic 团队成员并非完全沉默。他们在社交媒体上回应称，正在提高可定制性，以后会让开发者更方便地使用 AGENTS.md。

给出的理由是：不同模型需要的上下文和指令并不完全一样。团队还提到一个数字——给最新一代模型，他们已经删掉了大约 80% 的系统提示词。

但有开发者当场算了一笔账反驳：他自己平时就用五种模型，仓库里其他人用的更多。如果每种模型都要一份单独的指令文件，一个项目可能要同时维护十几份，还得跟着每次更新重写。他的原话是：「没有人会这么做。」

还有网友把这件事定性成一个更大的问题：拒绝遵循同行都在用的通用约定、坚持让自己的文件保持特殊地位，传递的是一种「只有我们知道最佳方案」的态度。这位网友最后说，他喜欢 Anthropic 的很多产品，但希望他们意识到这是个文化问题，而它正在让 Anthropic 逐渐失去开发者的关注。

Anthropic 提到「删掉了约 80% 系统提示词」，这一说法的背景是：早期大语言模型需要大量系统提示来约束行为，而新一代模型（如 Claude 3.5 / 3.7 系列）经过更充分的 RLHF 和宪法 AI 训练后，模型本身已内化了更多安全与风格约束，不再依赖外部提示词来「兜底」。这本是模型能力提升的体现，但拿来解释为何 AGENTS.md 不被原生读取，在逻辑上并不直接——是否读取通用配置文件，与系统提示词的长短是两个相互独立的工程决策。开发者的反驳恰好击中了这个错位：他们的诉求从来不是减少提示词，而是让一份文件能被所有工具识别，从而省去多工具环境下的同步负担。

如果你在维护多工具仓库，现在该做什么

抛开站队，对实际维护多 AI 编程工具仓库的开发者来说，眼下有一件事值得立刻去做：检查你的仓库里 AGENTS.md 和 CLAUDE.md 有没有对不上的地方。

最简单的办法，就是按官方文档的建议，在 CLAUDE.md 里写一句导入 AGENTS.md，或者建软链接，保证两份配置内容一致，避免在递归目录里出现「漏掉一份」的盲区。

UP主给出的判断是：这不会是最后一次有大客户公开施压。判据是——现在还有一条类似请求开着、500 多个赞、没有回应。他也立了一个可证伪的标准：如果三个月内 Anthropic 真的让 Claude Code 原生读取 AGENTS.md（不用导入、不用软链接），那就是他判断错了。

这场争议表面是文件命名之争，底层却是一个更根本的问题：在多工具、多模型共存的 AI 编程时代，厂商究竟该拥抱通用约定，还是坚持自家生态的特殊性。答案关乎技术，更关乎开发者的信任。