9 月 18 日，Claude Code 成员 Thariq Shihipar（@trq212）在 X 上官宣：Claude Code 开始支持读取 AGENTS.md。同一天上线的 v2.1.277，更新日志第一条就是它。这条帖子在素材记录时已经拿到 24,365 个赞、292 万浏览，连 OpenAI Codex 负责人 Tibo 都跑来留言：“太好了！这就对了，欢迎来到光明的一边。”机器之心知乎
如果你只在 Claude Code 里写代码，这事跟你关系不大。真正该停下来看完的，是手里同时跑着 Claude Code 和 Codex/Cursor、仓库里 CLAUDE.md 和 AGENTS.md 两份文件并排躺着的人——过去一年多，这群人管这叫"复杂度税"，现在收税的日子理论上到头了。但先别急着删文件。
一、393 天，从一个 issue 说起
这不是临时起意。Claude Code 仓库里的 issue #6235 创建于 2025 年 8 月 21 日，要求官方支持 AGENTS.md，攒下 401 条评论、6,657 个 reaction，直到 2026 年 8 月 17 日才以 completed 状态关闭；从创建到官宣发布，正好 393 天。
压垮"坚持"的是真实客户。2026 年 8 月 25 日，Shopify CEO Tobi Lütke 公开说，考虑在公司内部禁用 Claude Code，直到它愿意读 AGENTS.md 和 .agents/skills。 当团队成员一半用 Codex 一半用 Claude Code，同一个仓库两个配置入口，两份规则文件对不上，不同 Agent 拿到的项目规则就不一样。他把这笔同步工作叫"复杂性税"。Thariq 当天回应：不认为模型家族可以互换，Claude 对 CLAUDE.md、skills、system prompt 的组织方式有自己的偏好，但同时也承认，这套文件维护起来很费事，“对所有人都不值得”。不到一个月，默认行为改了。知乎
顺带纠正一个全网标题党：“Anthropic 接受了 OpenAI 的标准"这个说法是简化。AGENTS.md 早在 2025 年 12 月就捐给了 Linux 基金会旗下的 Agentic AI Foundation，官网称它是"整个 AI 软件开发生态的协作成果”，治理权早就不属于哪一家。Claude Code 是这个标准最大的缺席者，它进来之后，主流工具向"Agent README"收敛的趋势才算成立。知乎
二、"统一"是误会：默认是二选一，不是合读
这是整件事最影响你工程决策、也最多人没看清的一条：
只要项目路径上存在 CLAUDE.md，Claude Code 默认就不读 AGENTS.md。
官方给出的配置项有四个，默认值是 `claude-md-or-agents-md`——路径上有 CLAUDE.md，走原来的加载器；找不到，agents-md 才接手。想让两份文件同时生效，要手动改成 `claude-md-and-agents-md`，入口在 `/config` 的 Project instructions。这也回答了为什么老项目升级后"无感"：你仓库里有 CLAUDE.md，一切照旧，什么都没发生。知乎
更阴的坑在本地文件：CLAUDE.local.md 也算"这个项目有自己的 CLAUDE.md"。团队已经把仓库里的 CLAUDE.md 删干净、准备统一用 AGENTS.md 了，但只要哪位成员机器上还躺着一份 CLAUDE.local.md，他的默认回退就不触发，AGENTS.md 一个字都不会被读——而且全程不报错。
还有三个适用范围限制。Bedrock、Vertex、Foundry 走的企业通道尚未覆盖。 关闭 telemetry 或拿不到 Anthropic feature flags 的会话也不支持。安装或升级后的第一个会话同样不可用，要从下一次会话开始才生效。知乎
三、实现是"外挂"：0.1.0 的 mod，8 项行为差异
Claude Code 没有把 AGENTS.md 写进核心加载器。这次支持是通过一个名为 agents-md 的内置 mod 实现的，走 hooks 机制把文件接进既有的项目指令加载流程，plugin.json 版本号 0.1.0，主模块 hooks/register.ts 一共 9,507 字节，源码公开。做成 mod 的好处是能关、能换、沿用现成扩展机制；代价是插件通道拿不到核心加载器的全部事实——mod 的 README 还列出了 8 项行为差异。 有的只是可见性问题（比如 /memory 里不显示），有的会改变真实行为（嵌套目录里文件的触发时机、上下文压缩后的规则恢复、–add-dir 外部目录、subagent 重复挂载）。知乎
所以"以后两个工具共用一份文件"这句话，要补一个动作才能成立：对依赖嵌套规则、软链、subagent 的项目，改完配置不等于迁移完成，关键流程要拿真实任务跑一遍。至少要验证：根目录指令有没有加载、嵌套目录什么时候生效、上下文压缩后规则还在不在、subagent 是不是拿到了重复规则。本地能跑、流水线出错的坑，通常就藏在这些时机差异里。
另外别忘了评论区那条 100 赞的追问：“所以什么时候支持 .agents/skills？”——现在还没有。.agents/skills 和 .claude/skills 仍是两套独立目录，这一仗只打赢了文件名。
跨工具侧还有一条容易踩反的：Codex 的加载规则是每个目录最多取一份项目指令文件，按 AGENTS.override.md → AGENTS.md → 配置的备用名逐个候选，是"选中一个"而不是"全部相加"。 而"在 CLAUDE.md 里写 @AGENTS.md 导入"是 Claude Code 的语法，Codex 不会帮你展开。想共用正文，让 AGENTS.md 当唯一事实源、CLAUDE.md 只留导入行加 Claude 专属说明，是目前两套加载器都认的走法。知乎
四、文件合并了，效果不会自动来
就在功能落地前后，ETH Zurich 等机构的论文（arXiv:2602.11988）浇了一盆冷水：在 SWE-bench 任务和真实仓库开发者提交的上下文文件上做两类评测，提供上下文文件整体没有提升 coding agent 的任务成功率，平均推理成本反而增加了 20% 以上（token 口径）。 这个结论跨模型、跨 agent、模型生成文件和开发者手写文件都成立。按量计费的人，这 20% 直接出现在账单上；包月用户的边际感受则不一定同比例。知乎
论文里更值钱的是拆解：上下文文件中的指令类内容，agent 会认真遵守；仓库概览类内容对完成任务没有帮助——而后者恰恰是最常被"建议写进去"的部分。知乎
另一组民间统计可以对照着看：有人把 GitHub 上公开的 558 份 AGENTS.md 全部抓下来做了结构化标注（规则标注、宁可漏标不错标，所有覆盖率是下界）。511 份有实质内容的文件里：87% 写了构建/测试/运行命令，66% 写 git/PR 流程。 65% 专门写"禁令"（NO FILE DELETION、Never run cargo build 这种），而最值钱的"坑"——比如"别改 lockfile，bun install 会重写它"——只有 14% 的人写。7 份干脆全文只有一句 “See CLAUDE.md”。人对 AI 的信任不是从授权开始的，是从划线开始的；但大家交出来的上下文，最有用的部分写得最少。知乎
五、动手清单：今天升级之后先做这几步
按你的项目状态对号入座：
新项目、或仓库里根本没有 CLAUDE.md —— 直接用 AGENTS.md，零迁移成本。注意先升级到 2.1.277 之后的版本，且下一个会话才生效。
两份文件并存的老项目 —— 先 diff 再动手，别先删文件靠聊天窗口判断迁移是否成功。共同事实（构建命令、测试入口、硬性规则）合并进 AGENTS.md；两边写矛盾的，回到仓库脚本和 CI 裁决谁对，不是按文件名决定谁天然正确；真正 Claude 专属的操作留在 CLAUDE.md。然后二选一：删掉 CLAUDE.md 吃默认回退，或把配置改成 claude-md-and-agents-md。
企业通道/离线环境用户 —— Bedrock、Vertex、Foundry 这次没份，先别在团队里推，等覆盖更新。
统一之后，按论文和 558 份样本的口径给上下文文件做一次瘦身：保指令和坑，砍 README 复述。省下的每一个 token，都是每场会话都要交的房租。
结语
Anthropic 读你的 AGENTS.md，不等于 CLAUDE.md 已经被替代；标准统一解决的是互操作和"复制粘贴两份"的问题，不保证模型效果同步变好。文件名会统一，效果不会随文件名自动到来——前者是生态的事，后者只能在你自己的项目里测。值得继续盯的信号：agents-md 这个 mod 的版本什么时候从 0.1.0 往上走、Bedrock/Vertex 的覆盖、还有 .agents/skills 那条被点了 100 个赞的追问。
你的仓库是已经动手合并了，还是被 CLAUDE.local.md 坑过一轮？欢迎在评论区晒你的配置。
