Claude Code 2.1.277 支持 AGENTS.md:AI 编程工具开始共享项目级说明书
据 IT之家消息,Anthropic 旗下 Claude Code 团队工程师 Thariq Shihipar(网名 @trq212)在 X 平台发文称,今天发布的 Claude Code 2.1.277 版本已加入对 AGENTS.md 的支持。按照来源信息,从该版本开始,当项目文件夹中不存在 CLAUDE.md 时,Claude Code 会检查并使用 AGENTS.md;用户也可以在 /config 中切换这一行为。对于使用 AI 编程助手的开发者来说,这意味着项目中可以出现一份更偏通用的“给 AI 看的说明书”,用于在不同工具之间复用基础规则。
AGENTS.md 与 CLAUDE.md 的分工
在 Claude Code 生态中,CLAUDE.md 原本承担的是面向 Claude Code 的项目说明与工作流配置角色。来源显示,它可用于 Claude Code 特有的工作流、MCP、Sub-agent 或命令配置,更像是面向某一工具的专属说明文件。
而 AGENTS.md 的定位不同。它的目标是让不同 AI 工具共享项目级基础规则,可被理解为项目目录中一份更通用的 AI 使用说明。也就是说,开发者可以把“这个项目如何构建”“代码风格有什么要求”“哪些目录不要改动”“提交前需要注意什么”等项目级约束放在同一份文件里,让支持该规范的工具读取。
此次 Claude Code 的调整并不是废弃 CLAUDE.md,而是在没有 CLAUDE.md 时检查并使用 AGENTS.md。这种处理方式保留了 Claude Code 自身的专属配置能力,也为跨工具协作留下了入口。
- CLAUDE.md:更偏 Claude Code 专属,适合放置该工具相关的工作流、MCP、Sub-agent 或命令配置。
- AGENTS.md:更偏项目通用规则,目标是让不同 AI 编程工具共享同一套基础说明。
- 配置控制:用户可在 /config 中切换相关行为,避免项目规则被自动读取带来的不确定性。
对开发者:降低工具切换与项目接手成本
AI 编程工具越来越多,开发者在同一个项目中可能同时使用 Claude Code、其他代码助手或自动化代理。过去,每换一个工具,往往就需要重新写一套“提示词式项目说明”,甚至把同样的约束复制到不同配置文件中。这会带来维护成本,也容易出现规则不一致。
AGENTS.md 的价值在于把项目级共识沉淀为文件,而不是依赖某个对话窗口里的上下文。对普通用户和开发者而言,统一说明文件可以降低工具切换成本和配置成本。当团队成员接手项目,或外部开发者参与开源项目时,也能更快理解 AI 助手应遵守的边界与习惯。
对于开源项目,这种文件还有潜在的协作意义。维护者可以把 AI 参与贡献时的注意事项写入仓库,例如测试要求、代码结构约束、生成内容的审查流程等。即使不同贡献者使用的 AI 工具不同,至少能围绕同一份项目说明开展工作。
从工具竞争到规则互通,AI 编程进入新阶段
Claude Code 支持 AGENTS.md 反映出一个趋势:AI 编程工具的竞争,正在从单纯模型能力和交互体验,延伸到项目上下文管理、工程规范读取和自动化协作流程。对 AI 代理来说,能否正确理解一个项目,不仅取决于模型本身,也取决于它能否稳定读取项目中的约束、命令和工作方式。
从产业角度看,AGENTS.md 更像是 AI 编程场景中的“约定入口”。它未必立即成为统一标准,但如果更多工具支持类似机制,开发者就可以减少重复配置,把精力放在项目规则本身,而不是为每个 AI 助手分别维护一套说明。
当然,通用说明也不能替代人工审查。AI 工具读取项目规则后,仍可能理解不完整或执行偏差。因此,开发团队在引入 AGENTS.md 这类文件时,仍需要明确哪些任务可交给 AI,哪些修改必须人工确认。总体来看,Claude Code 2.1.277 的这项更新并不算庞大,却切中了 AI 编程工具落地中的高频痛点:让项目规则可复用、可迁移、可被不同 AI 工具共同理解。