Claude Code 开始支持 AGENTS.md，Anthropic 与 OpenAI 统一项目指令标准

Claude Code 成员 Thariq Shihipar 发帖称，Claude Code 开始支持 AGENTS.md 文件。从 2.1.277 版本开始，如果项目目录中没有 CLAUDE.md，Claude Code 会检查并使用 AGENTS.md，用户可以通过 /config 切换这项行为。这项能力建立在 Claude Code 的 mods 机制上，Anthropic 已将 agents-md 做成内置 mod，并公开了相关源码。

AGENTS.md 是项目写给 AI Agent 的说明书，内容涵盖项目结构、依赖安装方式、测试运行命令、代码规范等。官方 AGENTS.md 网站将其称为「README for agents」。Claude Code 的这次改动让这个热门 harness 加入了跨厂商的项目指令标准之中。消息发布后，评论区迅速被「终于统一了」「Thanks」刷屏，OpenAI Codex 负责人 Tibo 也回复：「太好了！这就对了。欢迎来到光明的一边。」

默认回退与配置方式

在默认模式下，Claude Code 会沿项目目录树查找 AGENTS.md，只要项目路径上没有项目级 CLAUDE.md，找到的文件就会作为项目指令加载。当 Agent 读取项目子目录中的文件时，mod 还会按目录层级补充对应的 AGENTS.md；如果同级目录存在 CLAUDE.md，则遵循原有的 CLAUDE.md 规则。相关设置位于 /config 的 Project instructions 中，用户可以选择仅使用 CLAUDE.md，在没有 CLAUDE.md 时回退到 AGENTS.md，也可以同时加载两类文件，具体采用哪种方式可以根据项目的协作模式调整。

团队协作中的配置冲突

当团队成员同时使用 Codex、Cursor 和 Claude Code 时，同一个仓库可能出现不同的配置入口：使用 Codex 的开发者读取 AGENTS.md，使用 Claude Code 的开发者读取 CLAUDE.md。如果两份文件存在差异，不同 Agent 获得的项目规则也会不同。这些文件通常记录项目结构、编码规范、测试要求、开发流程，以及 Agent 可以调用的技能，已经成为 AI coding Agent 理解代码库的重要上下文。

开发者此前给出的解决办法包括建立软链接，或者在 CLAUDE.md 中写入 @AGENTS.md。小型项目比较容易采用这些方案，到了大型 monorepo，配置文件会沿目录树递归生效，维护成本也会迅速上升。Shopify 曾因配置冲突考虑禁用 Claude Code，促使社区推动兼容方案。

Anthropic 的产品考虑

Anthropic 此前也有自己的产品考虑。Thariq 曾解释，不同模型家族具有不同的行为特点，system prompt 会显著影响模型表现，Claude 模型对 skills、system prompt 和 CLAUDE.md 的组织方式有特定偏好，Claude Code 也会针对不同模型调整 system prompt。

这套思路与 Anthropic 关于 context engineering 的讨论相呼应，项目说明、技能文件和 system prompt 共同构成 Agent 完成任务所需的上下文。这种模型专属设计有助于优化 Claude Code 体验，也会增加跨工具协作的维护成本。

兼容不等于完全统一

这次更新首先解决了文件读取入口的问题，对于已经使用 AGENTS.md 的团队，Claude Code 不再需要额外的软链接或引用配置。不过，兼容并不等于完全统一。在默认模式下，只有项目路径上没有 CLAUDE.md 时，Claude Code 才会回退读取 AGENTS.md；如果团队希望同时加载两类文件，还需要在 /config 中调整设置。此外，.agents/skills 和 .claude/skills 仍是两套独立目录，团队依然需要决定哪些规则属于跨工具的共同内容，哪些内容只服务于 Claude Code。

随着 AI coding Agent 进入日常开发流程，项目指令文件正在从工具偏好变成代码库基础设施。Claude Code 此次加入 AGENTS.md，说明跨工具共享项目上下文已经成为开发团队的现实需求。此前 Claude Code 是这个标准最大的缺席者之一，加入以后，主流 AI Coding 工具围绕「Agent README」收敛的趋势就明显得多，不同 Harness 之间的迁移成本也将越来越低。