两份”说明书”的由来

在 AI 编程助手中，项目根目录的一份 Markdown 文件通常用来告诉 AI 该项目的结构、规范和协作约定。Anthropic 的 Claude Code 使用 CLAUDE.md，其中可以放置 Claude Code 特有的工作流、MCP（模型上下文协议）配置、子代理以及命令配置；而 AGENTS.md 的目标则是让不同工具共享同一套项目级基础规则，可以被视作所有 AI 都应遵守的通用规则。

这两种格式相似却不完全一致。过去，同时使用 Claude Code 与 OpenAI Codex 或其他非 Anthropic 工具的开发者，往往要维护两份 Markdown 说明：一份 CLAUDE.md、一份 AGENTS.md。有人用软链接等手段勉强保持两者同步，但终究是额外的负担。

这次更新改了什么

根据希希帕尔的说明，从 2.1.277 版本开始，如果某个文件夹中没有 CLAUDE.md，Claude Code 会自动检查并使用 AGENTS.md。用户也可以在 /config 命令中切换这一行为。

需要强调的是，这只是一种”兜底”：当 CLAUDE.md 存在时，Claude Code 仍优先使用它；AGENTS.md 只在前者缺失时才会被读取。因此，已经依赖 CLAUDE.md 的仓库不会因为这次更新而多出一个相互竞争的指令文件。需要 Claude 专属配置的团队，依然可以把相关内容放在 CLAUDE.md 中。

一个正在成形的通用标准

AGENTS.md 并非 Anthropic 的发明。它由 OpenAI 贡献给 Linux 基金会旗下的 Agentic AI Foundation，目标是建立一套跨工具共享的代理指令标准。截至 2025 年 12 月，已有超过 6 万个开源项目采用了 AGENTS.md；Cursor 背后的 Anysphere、Cline 等同类工具也采用了这一约定，其地位类似于 README.md 之于仓库说明。

消息公布后，OpenAI 核心产品负责人蒂博·索蒂奥（Thibault Sottiaux）在社交平台回应”这才对，欢迎加入”，希希帕尔则以握手表情回应。不少知名开发者也公开对这一决定表示欢迎。

对开发者意味着什么

对普通用户或开发者而言，AGENTS.md 的最大价值在于降低工具切换与配置成本。无论使用哪一款 AI 编程工具，项目都可以只保留一份统一的”给 AI 看的使用说明”；在换工具、接手他人项目或参与开源协作时，不必重新撰写一遍配置。

从更长远看，这次支持也被外界视为 Claude Code 走向可扩展架构的一个信号——据公开信息，AGENTS.md 能力是通过 Claude Code 的”mods”（自定义模块）系统实现的，这一机制未来可能允许开发者自行修改配置解析与上下文加载方式。不过 Anthropic 目前尚未正式公布 mods 的完整文档与发布时间。