此前,开发者在项目中切换AI编程工具时会遇到一个障碍:Anthropic的Claude Code与包括OpenAI Codex等其他智能体不在同一位置查找指令文件,但现在这一情况正在改变。

Claude和Codex都接受markdown格式的指令,这是一种以纯文本形式为AI编程智能体提供项目特定行为指令的方式。此前,Claude Code默认在名为CLAUDE.md的文件中查找项目特定指令,而Codex和其他智能体使用AGENTS.md格式,该格式是由Linux Foundation旗下的Agentic AI Foundation倡议管理的开源项目。

Anthropic技术团队成员Thariq Shihipar在周五发布的一篇X帖子中写道:"我们正在为Claude Code添加对AGENTS.md的支持。从今天发布的2.1.277版本开始,如果文件夹中没有CLAUDE.md,Claude将检查并使用AGENTS.md。"

这意味着同时使用多种编程工具与Claude Code的开发者,现在可以在这些智能体之间使用相同的项目指令,而不必为Claude和其他工具分别维护独立的指令文件。

开发者不再需要在两个文件中维护相同或相似的指令,也不必确保项目编码规范、构建命令或其他智能体指令的任何变更都同步更新到两个位置——这种系统此前带来了额外的维护工作,并留下了指令不同步的隐患。现在,只要项目中没有CLAUDE.md文件,开发者就可以使用AGENTS.md作为跨编程工具的通用指令文件。

IT咨询公司Kanerika的AI开发负责人阿米特·库马尔·耶纳(Amit Kumar Jena)表示,能够在Claude Code中使用AGENTS.md,可以为使用多种编程工具的开发团队"消除一些实际的繁琐工作"。

耶纳说:"此前,由于Claude只读取CLAUDE.md,任何在同一代码仓库中运行多种编程智能体的团队都必须手动同步维护AGENTS.md文件,或者用符号链接、一行导入指令来让Claude指向另一个文件来'伪装'兼容。但这种变通方法只在小型项目中还算可行。"

耶纳补充道:"在多层目录结构的单体仓库(通常代表大型代码库)中嵌套指令,就会变成真正的维护债务——这种问题往往在截止日期压力下被忽视,直到各工具的指令悄然失去同步。"

Anthropic此次改动所带来的维护及运营工作量减少,也可能让企业更容易管理开发团队中AI编程智能体的使用方式。

Forrester首席分析师查理·戴(Charlie Dai)表示:"对企业而言,统一的指令格式可以成为编码规范、安全要求、架构护栏以及合规政策的实际管控点。"

不过,耶纳提醒称,统一的指令格式并不意味着AI编程智能体可以完全互换使用:"CLAUDE.md包含一些Claude特有的功能,而AGENTS.md的设计并未涵盖这些功能,因此为其他智能体(如Codex)编写的指令,被Claude Code读取时未必会表现出完全相同的行为。"

耶纳还指出,Claude Code对AGENTS.md的支持还存在一个与部署方式相关的限制,他引用Claude Code文档中的内容:"如果你的会话无法从Anthropic获取功能标志——例如你使用的是Amazon Bedrock或其他第三方提供商,或者你关闭了遥测功能——则会受到影响。"

耶纳表示,对AGENTS.md的支持依赖于工具从Anthropic获取功能标志,如果Claude Code无法获取这些标志,AGENTS.md支持将不可用,Claude Code会退回使用CLAUDE.md。

耶纳补充说,如果企业通过Amazon Bedrock或Google Vertex AI等环境使用Claude Code,或者关闭了遥测功能,开发团队可能无法将AGENTS.md用作通用指令文件——尽管该文件本身是本地文件,读取时并不需要网络连接。

不过,这一限制在一定程度上是可以解决的。

Shihipar表示,Claude Code允许用户配置其读取的文件,包括AGENTS.md、CLAUDE.md或两者都读取。他在X帖子中写道:"用户可以通过/config命令更改这一行为。"

这应该能让团队既可以使用AGENTS.md来存放跨编程工具共享的指令,又能保留CLAUDE.md来存放Claude Code专属的指令。

Q&A

Q1:Claude Code现在支持AGENTS.md格式吗?

A:是的,从2.1.277版本开始,如果文件夹中没有CLAUDE.md文件,Claude Code会自动检查并使用AGENTS.md文件。

Q2:使用AGENTS.md对开发团队有什么好处?

A:开发团队不再需要为Claude和其他编程工具分别维护两套指令文件,减少了重复维护工作,避免指令内容不同步的问题,尤其对使用多种AI编程工具的团队更为便利。

Q3:AGENTS.md支持有没有什么限制?

A:有。该支持依赖于从Anthropic获取功能标志,如果通过Amazon Bedrock、Google Vertex AI等第三方环境使用Claude Code或关闭了遥测功能,可能无法使用AGENTS.md,此时会自动回退到CLAUDE.md。

InfoWorld