Anthropic 在 2026 年 9 月 18 日向开发者推送了 Claude Code 2.1.277 版本更新，正式支持读取跨智能体标准指令文件 AGENTS.md。在此之前，开源社区为了让不同 AI 编程辅助工具理解同一个代码仓库，不得不常年在根目录并列维护 CLAUDE.md、OpenAI Codex 专用的 AGENTS.md 以及 Google Gemini CLI 的 GEMINI.md。
这次更新表面上顺应了行业建立统一规范的呼声，但它并不是许多人预期的全局融合。Anthropic 采用了一套极具防守色彩的设计：新规范在工具链内部仍处于次席，既无法通过团队配置文件强制启用，也在底层交互上遭遇了功能裁剪。
互斥而非合并：排他性回退背后的工程逻辑
2.1.277 版本的核心变动，是通过内置的 agents-md 插件读取标准化指令，以此正式关闭了社区跟踪已久的 GitHub issue #6235。但如果开发者认为更新后可以把两套指令合并执行，实际部署时就会立即遭遇规则落空。
在默认的 claude-md-or-agents-md 模式下，系统执行的是严格的互斥回退逻辑。检测机制会先寻找根目录或层级中的 CLAUDE.md、.claude/CLAUDE.md 以及本地个人覆盖文件 CLAUDE.local.md。只要检测到上述任何一个专属私有文件存在，Claude Code 就会把同级目录下的 AGENTS.md 彻底弃置，不会做任何追加解析。
虽然用户可以在终端通过 /config 菜单将加载模式手动切换为并存的 claude-md-and-agents-md，但这个开关无法写入仓库级配置文件 .claude/settings.json。这意味着它只能作为开发者个人的本地参数或 CLI 启动项生效，项目管理者根本无法借助 Git 版本控制来确保整个团队在协作时获得一致的系统上下文。
- 风险.团队若试图通过切换全局模式兼顾两套标准，容易因个人本地环境差异导致 AI 生成的代码标准出现分歧。
缺失的交互生态：次席标准的现实代价
除了读取逻辑上的互斥，AGENTS.md 在 Claude Code 现有的运行环境中还面临严重的功能断层。Anthropic 并没有将它接入核心特性链路，而是仅仅作为只读文本注入。
当子目录中出现嵌套的 AGENTS.md 时，它只会在 Claude 调用基础文本读取工具（Read）时被临时载入。一旦涉及交互层操作，其劣势便暴露无遗：它既不支持在 IDE 中直接开启上下文映射，也无法在对话中通过 @ 符号手动提及。不仅 Jupyter Notebook 和 PDF 解析对该文件视而不见，Claude 体系中最具特色的 /memory 交互菜单与 # 快捷键也全面对其关闭。
企业级用户的限制更为直接。这一兼容能力最初并未在云托管平台上线，使用 Amazon Bedrock、Google Vertex AI 以及 Microsoft Foundry 部署的托管实例无法享用这项回退特性。对于高度依赖公有云合规集群的机构而言，依然只能老老实实维护私有的 CLAUDE.md。
群雄割据下的落地选择与演进阻碍
横向审视整个辅助编码赛道，不同工具对指令标准的理解早已四分五裂。OpenAI Codex 不仅将 AGENTS.md 列为第一公民，还支持利用 AGENTS.override.md 进行层级覆盖，并原生实现了向上递归检索；Gemini CLI 依然依赖 context.fileName 参数进行手动指定；而 GitHub Copilot 更加碎片化，其命令行、云端 Agent 与代码评审界面对上述标准的支持程度各有不同。
更致命的障碍在于引用语法的脱节。部分工程师习惯在指令文件中使用 @file 引入架构设计或规范片段，但这并非跨工具通用标准。一旦将带有私有引用语法的规则文件直接重命名为 AGENTS.md，其他工具读取时只会将其作为普通字符串解析，导致预想的上下文装载彻底失效。
工具商妥协的是文件名，保留的是私有生态的护城河。
面对这种技术现状，维护多工具协作仓库的团队切忌贸然清空已有的私有配置文件。目前在生产环境中阻力最小的折中方案，并不是让 Claude Code 裸奔依赖 fallback，而是在保留 CLAUDE.md 的前提下，在文件内部使用 @AGENTS.md 语法执行显式导入。
- 建议.采用显式导入既能让通用规范归拢于一处，又能让 Claude 继续调用本地内存管理与规则扩展，规避配置失效的风险。
这种表面互通、底层设障的态势表明，AI 编程工具离真正的通用协议时代仍有相当距离。只要各大厂商的交互特性与云端支持无法对齐，任何被冠以事实标准的规范，在实际运行中都难免要打上几层防守的补丁。