作者 | 屠敏
出品 | CSDN(ID:CSDNnews)
一场看似围绕 Markdown 文件的争论,正在演变成 AI 编程 Agent 领域的一次“标准之争”。
8 月 25 日,海外电商平台 Shopify CEO Tobi Lütke 在 X 上剑指 Anthropic,其公开表示,正在考虑在 Shopify 内部禁用 Claude Code。
他并不说 Anthropic 家的产品不好用,而是把问题聚焦在一个 Markdown 文件上。Tobi Lütke 指出,这款 AI 工具拒绝支持已被超过 6 万个开源项目采用的行业标准 AGENTS.md 格式,而是坚持使用其专有的 CLAUDE.md 系统。
“我正在考虑禁止 Shopify 使用 Claude Code,直到 Anthropic 改变做法,支持读取 AGENTS.md、.agents/skills 等文件。 ”
![]()
对于普通开发者来说,这可能只是多维护一个 Markdown 文件。但对于拥有数千名开发者、超大规模的 Shopify 来说,却可能变成一个实实在在的工程管理问题。
而这一次,在 Tobi Lütke 点出问题之后,也等到 Anthropic 的回应。
![]()
Shopify 为什么突然想要“封杀”Claude Code?
Tobi Lütke 的核心抱怨其实非常简单:同一个代码仓库,为什么不同的 AI Agent 不能读取同一套项目规则?
现在,开发者通常会在代码仓库里放置一些专门给 AI Agent 阅读的配置文件,例如项目结构、编码规范、测试命令、构建方式以及各种操作要求。
其中,AGENTS.md 正逐渐成为一种跨工具的通用约定。
OpenAI 在 2025 年推出这一格式后,它迅速被大量开源项目采用。外媒 The New Stack 援引相关信息称,截至 2025 年底,已经有超过 6 万个开源项目和 Agent 框架采用 AGENTS.md,包括 Codex、Cursor、Gemini CLI、GitHub Copilot、Jules 和 VS Code 等工具。
到 2025 年 12 月,OpenAI 将 AGENTS.md 捐给 Linux Foundation 旗下的 Agentic AI Foundation(AAIF),和 Anthropic 的 MCP、Block 的 Goose 一起作为开放的 Agent 基础设施来发展。
问题在于,Claude Code 不这么干,它推出了自己的“项目说明/指令文件”——CLAUDE.md。
Claude Code 会按目录层级加载 CLAUDE.md,开发者可以在不同目录放置不同规则,让 Agent 根据当前处理的代码位置获得相应上下文。
但与 Codex、Cursor 等已经原生支持 AGENTS.md 的工具不同,Claude Code 目前仍不会自动将 AGENTS.md 作为项目指令文件加载。
这就给 Shopify 带来了麻烦。
因为 Shopify 的开发团队并不是所有人都使用同一个 AI 编程工具。有人用 Claude Code,有人可能使用 Codex、Cursor 等其他 Agent。假设一个目录里只有 AGENTS.md,那么支持这一标准的 Agent 能够读取项目规则,但 Claude Code 不会自动读取。如果团队为了 Claude Code 再额外维护一份 CLAUDE.md,两份文件就需要长期保持同步。
代码没变,维护成本却凭空多了一层。
![]()
Tobi Lütke:这就是“没必要的复杂度税”
Tobi Lütke 认为,“这完全没必要。”
他进一步补充说道:
“很多人都在告诉我该怎么解决这个问题——这些技巧我全都知道。
但AGENTS.md和CLAUDE.md都会沿着目录树递归应用。在一个拥有数千个项目的 Monorepo 中,很容易出现某个目录恰好缺少其中一个文件的情况,这就意味着一部分开发者工作时相当于被“切除了大脑”。
我们会通过自动化来解决这个问题,但这本质上是一种很愚蠢的复杂性成本,本来根本不应该付出这样的代价。”
![]()
事实上,这并不是 Shopify 第一次碰到这个问题。
Anthropic 的 GitHub 仓库里,开发者已经围绕 AGENTS.md 提交了大量功能请求。
其中最早的 创建于 2025 年 8 月,要求 Claude Code 原生支持 AGENTS.md。到了 2026 年,这个问题仍然没有得到解决。新的 Issue 也继续要求 Claude Code 同时支持 AGENTS.md 和 .agents/skills/。
![]()
甚至还有开发者直接提交 Issue 指出:如果一个项目同时使用 Codex、Cursor、Claude Code 等多个 Agent,就不应该为了每个工具维护一套高度重复的规则。
![]()
Anthropic 为什么偏偏坚持 CLAUDE.md?
其实,Anthropic 并不是不知道开发者想要什么。
在 Lütke 发帖后不久,Claude Code 团队成员 Thariq 出面在 X 评论区回应。
他表示,Anthropic 正在让 Claude Code 变得更加“可改造(hackable)”,其中就包括让开发者更加方便地使用 AGENTS.md,或者对系统 Prompt 进行其他修改。“等这项功能准备好正式推出时,我会在这里分享更多信息。”
但 Anthropic 此前坚持 CLAUDE.md,其实也有自己的产品考虑。
Thariq 解释称:“我们当初这样设计的考虑是,我们认为不同的模型家族并不能完全互换,而且系统 Prompt 可能会对模型的表现产生很大影响。”
他引用了自己之前写过一篇文章(https://x.com/trq212/status/2080710971228918066),介绍 Claude 模型更喜欢以什么样的格式来组织 Skills、系统 Prompt、CLAUDE.md 等内容加以解释。Thariq 表示:“在 Claude Code 中,我们针对不同模型使用了不同的系统 Prompt。话虽如此,我也知道,对于很多人来说,这意味着大量的维护工作,而且为了这点收益付出这样的成本并不值得。你的反馈我们已经听到了,我会继续跟进,有消息也会及时告诉你。”
「眼下,你也可以直接在自己的 CLAUDE.md 中引用 AGENTS.md」,Thariq 说道。
![]()
![]()
开发者不买账:难道一个模型一个文件?
Thariq 的安抚并没有令众多开发者满意。
有开发者反问,如果按照 Anthropic 的逻辑,不同模型需要不同的上下文配置,那么当一个团队同时使用多个模型时,难道要维护十几个版本的 Agent 指令?
今天是 Claude Opus,明天可能换成其他模型;模型每隔几周又更新一次。
如果每一次模型变化都需要重新调整对应的 Markdown 文件,这显然不是开发团队真正想要的工作。
也有网友指出,「我认为最好还是把它们分开。把所有上下文迁移到 Docs / Skills 中,然后让顶层的 AGENTS/CLAUDE 文件分别保留针对不同模型的指令子集。
比如,Codex 的沙箱机制有一些特殊之处,它不会读取我的 direnv 配置,所以我必须针对 Codex 这个 Harness(运行环境)单独进行一些调整。但我不希望这些针对 Codex 的特殊配置同样影响 Claude。
不过,我确实希望这件事能够自定义。
说实话,Anthropic 至少应该提供这个选项,现在连这个选项都没有,确实挺离谱的。」
![]()
还有开发者劝解道:“以 Claude 作为我的主要模型时,我会把 CLAUDE.md 作为主要的指令文件。AGENTS.md 会引用它,而 Codex、其他 Agent 也能在各自有限的使用场景下正常工作。Skills 稍微麻烦一些,但它们也能自己搞清楚怎么处理。说到底,这只是有点让人烦而已,没必要生气。”
![]()
表面上看,这是 AGENTS.md 和 CLAUDE.md 的争论。但往深一层看,它实际上涉及一个正在快速出现的新问题:AI Agent 到底应该听谁的?
过去,一个代码仓库主要服务的是人类开发者。
项目规则写在 README、CONTRIBUTING、开发文档以及代码注释里,不同 IDE 或编程工具通常都可以按照自己的方式读取这些信息。
现在,AI Agent 成了新的“代码贡献者”。于是,一个新的问题出现了:项目规则究竟应该属于某一家 AI 厂商,还是属于代码仓库本身?
如果每一家 Agent 都维护自己的:CLAUDE.md、CURSOR.md、CODEX.md……
那么随着 Agent 数量增加,开发团队最终可能需要维护一大堆重复配置。
而 AGENTS.md 的意义恰恰在于尝试把这部分信息从具体工具中剥离出来。
这也是为什么这场争论受到如此多开发者关注。
![]()
Shopify 这次的不满,可能只是一个开始
值得注意的是,Shopify 并没有宣布已经正式全面禁用 Claude Code。目前 Lütke 的说法是“正在考虑禁用”,条件是 Anthropic 改变对 AGENTS.md 的支持策略。
而 Anthropic 的回应也没有直接宣布“Claude Code 现在已经原生支持 AGENTS.md”。
Thariq 给出的信息更接近于:未来会让这件事情更容易做到。也就是说,眼下真正发生变化的,是 Anthropic 开始松动此前相对封闭的配置体系。
随着 Codex、Claude Code、Cursor、Gemini CLI、Copilot 等工具同时进入企业开发环境,跨 Agent 的上下文、Skills 和项目规则兼容性,很可能会成为下一个基础设施问题。
Shopify 只是把这个问题提前摆到了台面上。
毕竟,当一个团队里只有一个 Agent 时,CLAUDE.md 还是 AGENTS.md,区别可能并不大。
但当一个单体代码仓库(Monorepo)里同时跑着五六种 Agent,背后站着几千名开发者时,多维护一个 Markdown 文件,就不再只是“多写几行配置”那么简单了。
对此,你有什么样的看法?
参考:https://x.com/tobi/status/2092259436538495186
首次双会并行,干货福利限时放送!
2026 奇点智能技术大会 与 C++及系统软件技术大会,将于 11 月 20—21 日 在北京万达文华酒店举办。
上层 AI 应用的爆发,离不开底层系统软件的支撑——这一次,我们把 AI 与系统软件两大技术脉络放到同一现场,一起看趋势、看实践、看落地。
为了方便大家提前预习大会内容,我们同步开放了资料福利包,包含 OpenAI 资深研究科学家、Transformer 八子之一 Łukasz Kaiser 演讲视频与 PPT、C++ 之父 Bjarne Stroustrup 精选合集、Agent 实战训练营录播课等内容。
扫码即可领取。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.