Claude Code 学会读 AGENTS.md 了：一份项目说明文件，管住你手上所有 AI 编程工具

最近 72 小时内，Claude Code 悄悄跟进了一项跨工具的开放标准：**AGENTS.md**。 9 月 18 日，Anthropic 的 Claude Code 团队成员 Thariq 在 X 上宣布：从版本 2.1.277 开始，如果某个目录里没有 CLAUDE.md，Claude Code 会自动去找并使用 AGENTS.md。这条消息随后被 InfoWorld、Hacker News、runtimeWire 等多家媒体转述印证，官方 changelog（9 月 19 日的 2.1.278 版本）也记录了这项改动。 基于多家媒体转述整理，核心事实是一致的：**Claude Code 开始支持 OpenAI 等工具通用的 AGENTS.md 开放标准**。

背景：两个说明文件的各自为战

AI 编程工具需要读“项目说明书”，不同工具各认各的文件名：

• Claude Code 认 CLAUDE.md
• OpenAI Codex、Copilot、Cursor 等认 AGENTS.md

AGENTS.md 不是 OpenAI 一家的事——它现在由 Linux 基金会下的 Agentic AI Foundation（Agentic AI 基金会）作为开放标准维护，是多个编程 Agent 的通用"仓库约定文件"。 结果是：同时用两套工具的开发者，同一个仓库要维护两份内容几乎一样的说明，改一处忘了另一处，AI 行为就会不一致。

这次更新具体做了什么

根据官方宣布和 changelog：

• 从 v2.1.277 起，Claude Code 在目录里找不到 CLAUDE.md 时，会回退去读 AGENTS.md
• 这是回退（fallback）而非替代：如果你还有 CLAUDE.md，它仍然优先
• 行为可以在 /config 的 "Project instructions" 里开关
• 该能力尚未覆盖 Bedrock、Vertex、Foundry 等平台托管版本
• 注意：AGENTS.md 的读取不包含 .agents/skills 目录

对谁有用

• 同时用 Claude Code + Codex + Copilot + Cursor 的团队：仓库里只维护一份 AGENTS.md，所有工具共享同一份约定，不再改二处漏一处
• 已有 CLAUDE.md 的老用户：不用动，行为不变
• 新项目：可以直接用 AGENTS.md 起步，一套说明驱动全家桶

需要注意什么

• 官方没有说未来会不会把 CLAUDE.md 和 AGENTS.md 彻底合并，目前是"共存 + 回退"
• 托管版（Bedrock/Vertex/Foundry）要等后续更新
• 如果你的项目同时放了两类文件，优先读 CLAUDE.md；想统一成 AGENTS.md 的话需要自己删掉 CLAUDE.md