发生了什么
Anthropic 的 Claude Code 团队工程师 Thariq Shihipar 于 9 月 18 日宣布，当日发布的 Claude Code 2.1.277 版本开始支持 AGENTS.md。规则很直接：如果某个文件夹里没有 CLAUDE.md，Claude 将检查并使用 AGENTS.md 作为该项目的指令文件；该行为可以在 /config 的 Project instructions 中关闭。判断按目录逐级进行，这对把指令分散在多个子目录的仓库尤其有用。若同一目录下两个文件同时存在，CLAUDE.md 仍具有更高优先级。
- 检测逻辑：先找 CLAUDE.md，缺失时回落 AGENTS.md，二者皆无则不加载项目指令。
- 可关闭：在 /config 的 Project instructions 中切换，适合刻意对不同工具保留差异化指令的团队。
- 实现方式：以内置 Mod 形式落地并公开源码，CLAUDE.md 仍是 Claude Code 特有的工作流、MCP、子智能体与命令配置载体。
- 渠道限制：该回落机制目前不适用于通过 Amazon Bedrock、Google Vertex 或 Microsoft Foundry 调用 Claude 的场景。
AGENTS.md 是什么，为什么这件事重要
AGENTS.md 是一份约定命名的纯 Markdown 文件，用来描述项目的基础规则：如何构建、如何跑测试、代码风格约定、安全注意事项。它源自 OpenAI Codex 团队与 Google Jules、Cursor、Amp、Factory 等的共同工作，现由 Linux 基金会旗下的 Agentic AI Foundation 维护，被 Codex、Cursor、Gemini CLI、GitHub Copilot 编码智能体、Devin、Windsurf 与 JetBrains Junie 等工具读取。截至 2025 年 12 月，已有超过 6 万个开源项目采用该格式。
在此之前，同时使用 Claude Code 与其他编码智能体的团队必须维护两套指令文件，或用一个指针文件把两者互相链接，保持同步本身成为额外负担。Shihipar 宣布这一变更后，OpenAI 核心产品负责人 Thibault Sottiaux 公开回应表示欢迎，Shihipar 以握手表情回应，这也是两大阵营少见的公开互动。对企业团队来说，实际收益是工具切换成本与接手成本的下降：一份 AGENTS.md 即可让项目在不同编码智能体之间迁移时保留同一套上下文规则，项目指令文件正从单一工具偏好变成代码库基础设施的一部分。
边界与注意事项
- 兼容不等于统一：.agents/skills 与 .claude/skills 仍是两套独立目录，能力层并未打通。
- CLAUDE.md 的优先级更高，若要迁移到 AGENTS.md 需先删除或重命名原文件。
- 该版本同时带来企业网关能力：环境变量 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 可让所有出站请求直接交给正向代理而不在本地解析主机名，并支持为网关上游请求附加静态请求头。
- 2.1.277 还修复了多项稳定性问题，包括 claude -p 与 Agent SDK 会话在内部错误后挂起、以及 Windows 上回复完成后出现内存溢出错误导致工具未执行的问题。
需要留意的是，Anthropic 与 OpenAI 在项目指令格式上的互认，并不代表编码智能体在上下文管理、工具调用与权限模型上的差异正在收敛。对企业采购方而言，可迁移性的提升确实降低了被单一工具锁定的风险，但真正决定生产可用性的仍是可观测性、权限边界与失败恢复机制。