Claude Code 2.1.277 新增了对开放格式 AGENTS.md 的支持：在项目中找不到 CLAUDE.md 时，Claude Code 会将 AGENTS.md 作为项目说明读取。对采用统一智能体说明文件的仓库来说，这意味着不必先额外创建一份 Claude 专用文件。1

默认规则：回退，而非自动叠加

这次更新的默认逻辑可以简单理解为：

• 项目没有 CLAUDE.md： Claude Code 可读取 AGENTS.md 作为项目指令。1
• 项目已有 CLAUDE.md： CLAUDE.md 仍是既有的项目说明文件。官方更新说明描述的是回退行为，并未表明默认会自动合并两个文件的内容。1

可在 Claude Code 的 /config 中，进入 Project instructions（项目说明） 调整这一行为。Anthropic 同时说明，该功能暂未支持运行在 Amazon Bedrock、Google Vertex AI 或 Azure AI Foundry 上的 Claude Code 部署。1

AGENTS.md 是什么？

AGENTS.md 是面向 AI 编程智能体的开放 Markdown 约定，可以把它看成“给智能体看的 README”。仓库可以在其中放入项目背景、环境搭建步骤、构建与测试命令、代码规范，以及贡献要求等信息，让智能体更稳定、更符合项目约束地工作。1932

这一格式源自 AI 软件开发生态中多方协作，包括 OpenAI Codex、Amp、Google Jules、Cursor 和 Factory；目前由 Linux Foundation 旗下的 Agentic AI Foundation 负责维护。该项目称，已有超过 6 万个开源仓库采用这一约定。1921

其列出的生态工具包括 OpenAI Codex、Google Jules、Cursor、GitHub Copilot 编程智能体、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose 和 OpenCode 等。19 不过，不同工具对文件发现路径、目录层级和冲突处理的规则仍可能不同；仓库中存在同名文件，并不意味着所有工具都会以完全相同的方式加载它。

价值在于减少“多份说明书”

在 Claude Code 原生支持之前，采用 AGENTS.md 的团队若想让 Claude Code 读取同一套规则，往往需要维护额外的 CLAUDE.md、把 CLAUDE.md 设为指向 AGENTS.md 的符号链接，或在 CLAUDE.md 中用导入方式引用共享文件。这些都是 Claude Code 当时并不原生读取 AGENTS.md 时的变通方案。10

现在，只要仓库不需要 Claude 专属的项目说明，AGENTS.md 就能直接成为 Claude Code 的基础指引，也可服务于其他兼容工具。对同时使用多种 AI 编程工具的团队而言，这减少了重复维护和内容不同步的负担。

但“支持同一个文件名”不等于所有指令体系已经统一。团队仍应分别确认各工具如何发现说明文件、是否支持子目录规则，以及同时存在多个文件时如何处理优先级。

AGENTS.md 与 SKILL.md：解决的问题不同

AGENTS.md 和 SKILL.md 是互补关系，并非互相替代。

• AGENTS.md： 仓库级、长期生效的工作说明，定义在某个代码库中协作时应遵循的背景和规则。1932
• SKILL.md： Agent Skill（智能体技能）的一部分，用于打包可复用的专门能力；其中可包含指令、元数据和可选的配套资源。Claude 会在相关任务出现时使用相应技能，获得特定工作流或领域知识。3337

Claude Code 表示其技能遵循跨工具的 Agent Skills 标准。在 Claude Code 文档中，一个项目技能通常是包含 SKILL.md 的目录，例如 .claude/skills/<name>/SKILL.md。3739

仍需注意的限制

此次更新增加的是项目说明文件的回退支持，并不代表 Claude Code 已与所有智能体约定实现完全一致。

首先，Claude Code 文档目前列出的项目技能位置是 .claude/skills/<name>/SKILL.md。2.1.277 的更新公告只涉及 AGENTS.md 项目说明，未宣布支持发现 .agents/skills/ 目录。137

其次，不能把默认回退理解成 CLAUDE.md 与 AGENTS.md 的自动合并规则。如果一个仓库既要保留跨工具通用规则，又有 Claude Code 专属行为，最好明确写出两者的引用或导入关系，而不要只依赖回退机制。

已有 CLAUDE.md 的项目怎么安排？

对已经依赖 CLAUDE.md 的项目，一个稳妥的做法是：

1. 将跨工具通用的仓库规范放入 AGENTS.md。
2. 将仅针对 Claude Code 的指令保留在 CLAUDE.md。
3. 需要共享规则时，在 CLAUDE.md 中显式引用或导入 AGENTS.md，不要假设两个文件会被默认同时加载。

这种分层既能提升跨工具可移植性，也能把 Claude Code 专属工作流清晰隔离。Claude Code 2.1.277 因而是一项重要的互操作性改进：当 CLAUDE.md 缺失时，AGENTS.md 优先的仓库终于可以直接兼容 Claude Code；但这并不意味着所有指令文件和技能发现约定已经完全打通。

Claude Code 2.1.277 新增了对开放格式 AGENTS.md 的支持：在项目中找不到 CLAUDE.md 时，Claude Code 会将 AGENTS.md 作为项目说明读取。对采用统一智能体说明文件的仓库来说，这意味着不必先额外创建一份 Claude 专用文件。1

默认规则：回退，而非自动叠加

这次更新的默认逻辑可以简单理解为：

• 项目没有 CLAUDE.md： Claude Code 可读取 AGENTS.md 作为项目指令。1
• 项目已有 CLAUDE.md： CLAUDE.md 仍是既有的项目说明文件。官方更新说明描述的是回退行为，并未表明默认会自动合并两个文件的内容。1

可在 Claude Code 的 /config 中，进入 Project instructions（项目说明） 调整这一行为。Anthropic 同时说明，该功能暂未支持运行在 Amazon Bedrock、Google Vertex AI 或 Azure AI Foundry 上的 Claude Code 部署。1

AGENTS.md 是什么？

AGENTS.md 是面向 AI 编程智能体的开放 Markdown 约定，可以把它看成“给智能体看的 README”。仓库可以在其中放入项目背景、环境搭建步骤、构建与测试命令、代码规范，以及贡献要求等信息，让智能体更稳定、更符合项目约束地工作。1932

这一格式源自 AI 软件开发生态中多方协作，包括 OpenAI Codex、Amp、Google Jules、Cursor 和 Factory；目前由 Linux Foundation 旗下的 Agentic AI Foundation 负责维护。该项目称，已有超过 6 万个开源仓库采用这一约定。1921

其列出的生态工具包括 OpenAI Codex、Google Jules、Cursor、GitHub Copilot 编程智能体、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose 和 OpenCode 等。19 不过，不同工具对文件发现路径、目录层级和冲突处理的规则仍可能不同；仓库中存在同名文件，并不意味着所有工具都会以完全相同的方式加载它。

价值在于减少“多份说明书”

在 Claude Code 原生支持之前，采用 AGENTS.md 的团队若想让 Claude Code 读取同一套规则，往往需要维护额外的 CLAUDE.md、把 CLAUDE.md 设为指向 AGENTS.md 的符号链接，或在 CLAUDE.md 中用导入方式引用共享文件。这些都是 Claude Code 当时并不原生读取 AGENTS.md 时的变通方案。10

现在，只要仓库不需要 Claude 专属的项目说明，AGENTS.md 就能直接成为 Claude Code 的基础指引，也可服务于其他兼容工具。对同时使用多种 AI 编程工具的团队而言，这减少了重复维护和内容不同步的负担。

但“支持同一个文件名”不等于所有指令体系已经统一。团队仍应分别确认各工具如何发现说明文件、是否支持子目录规则，以及同时存在多个文件时如何处理优先级。

AGENTS.md 与 SKILL.md：解决的问题不同

AGENTS.md 和 SKILL.md 是互补关系，并非互相替代。

• AGENTS.md： 仓库级、长期生效的工作说明，定义在某个代码库中协作时应遵循的背景和规则。1932
• SKILL.md： Agent Skill（智能体技能）的一部分，用于打包可复用的专门能力；其中可包含指令、元数据和可选的配套资源。Claude 会在相关任务出现时使用相应技能，获得特定工作流或领域知识。3337

Claude Code 表示其技能遵循跨工具的 Agent Skills 标准。在 Claude Code 文档中，一个项目技能通常是包含 SKILL.md 的目录，例如 .claude/skills/<name>/SKILL.md。3739

仍需注意的限制

此次更新增加的是项目说明文件的回退支持，并不代表 Claude Code 已与所有智能体约定实现完全一致。

首先，Claude Code 文档目前列出的项目技能位置是 .claude/skills/<name>/SKILL.md。2.1.277 的更新公告只涉及 AGENTS.md 项目说明，未宣布支持发现 .agents/skills/ 目录。137

其次，不能把默认回退理解成 CLAUDE.md 与 AGENTS.md 的自动合并规则。如果一个仓库既要保留跨工具通用规则，又有 Claude Code 专属行为，最好明确写出两者的引用或导入关系，而不要只依赖回退机制。

已有 CLAUDE.md 的项目怎么安排？

对已经依赖 CLAUDE.md 的项目，一个稳妥的做法是：

1. 将跨工具通用的仓库规范放入 AGENTS.md。
2. 将仅针对 Claude Code 的指令保留在 CLAUDE.md。
3. 需要共享规则时，在 CLAUDE.md 中显式引用或导入 AGENTS.md，不要假设两个文件会被默认同时加载。

这种分层既能提升跨工具可移植性，也能把 Claude Code 专属工作流清晰隔离。Claude Code 2.1.277 因而是一项重要的互操作性改进：当 CLAUDE.md 缺失时，AGENTS.md 优先的仓库终于可以直接兼容 Claude Code；但这并不意味着所有指令文件和技能发现约定已经完全打通。