Claude Code正式拥抱AGENTS.md，AI编程工具跨厂商协作迈出关键一步

导语：Claude Code从2.1.277版本起正式支持读取AGENTS.md文件，成为最后一个拥抱这一跨厂商项目指令标准的主流AI编程工具。此前Shopify CEO曾公开表示要等到Claude Code兼容AGENTS.md才继续使用，如今这一障碍已被扫除。不同编程工具之间的配置壁垒正在消解，开发者有望告别为同一仓库维护多份指令文件的困境。

Claude Code团队成员Thariq Shihipar在社交平台上宣布，Claude Code从2.1.277版本起加入了对AGENTS.md文件的读取支持。如果项目目录中不存在CLAUDE.md，系统会自动检测并加载AGENTS.md作为项目指令，用户也可以通过/config界面自行切换这两种文件的优先级。

这一功能基于Claude Code的mods机制实现，Anthropic将agents-md封装为内置mod并公开了源码。开发者可以围绕项目指令构建自定义版本，扩展Claude Code的指令加载方式。

AGENTS.md本质上是一份面向AI Agent的项目说明书，涵盖项目结构、依赖安装方式、测试流程、代码规范等内容。官方将其定位为「面向Agent的README」。Claude Code的这次调整使这个热门工具首次纳入了跨厂商的项目指令标准体系。

消息发布后，开发者社区反应热烈，评论区迅速被「终于统一了」「谢谢」等留言刷屏。OpenAI Codex负责人Tibo也公开表示祝贺：「太好了！欢迎加入。」

需要了解的是，AGENTS.md标准最初源自OpenAI的Codex项目。表面上竞争激烈的两家公司，在Agent赛道上找到了共同标准。

在默认模式下，Claude Code会沿项目目录树查找AGENTS.md，只要路径上没有项目级CLAUDE.md，找到的文件就会被加载为项目指令。当Agent读取子目录文件时，mod还会按目录层级补充对应的AGENTS.md。如果同级目录存在CLAUDE.md，则沿用原有的CLAUDE.md规则。

此前Shopify曾将跨工具兼容问题公开化。Shopify CEO Tobi Lütke曾表示考虑在公司内部停用Claude Code，直到它能读取AGENTS.md等通用指令文件。当团队成员同时使用Codex、Cursor和Claude Code时，同一仓库可能需要维护多套不同工具的配置入口，带来额外的同步负担。

Lütke曾把这种状况称为「复杂性税」。此前的替代方案包括建立软链接或在CLAUDE.md中引用AGENTS.md，但项目规模扩大后，配置文件会沿目录树递归生效，维护成本随之上升。

Anthropic此前坚持使用CLAUDE.md有其自身的产品考量。Thariq曾说明，不同模型家族的行为特点各异，system prompt会对模型表现产生显著影响。Claude模型对skills、system prompt和CLAUDE.md的组织方式有特定偏好，Claude Code也会针对不同模型调整system prompt。这与Anthropic关于context engineering的思路一致，但也增加了跨工具协作的维护成本。

本次更新解决了文件读取入口的核心问题，对于已采用AGENTS.md的团队，Claude Code不再需要额外的软链接或引用配置。不过兼容并不等于完全统一：默认模式下，只有项目路径上没有CLAUDE.md时才会回退读取AGENTS.md；同时.agents/skills和.claude/skills仍是两套独立目录。

随着AI编程助手逐步融入日常开发流程，项目指令文件正从工具偏好演变为代码库基础设施。Claude Code此次加入AGENTS.md阵营，表明跨工具共享项目上下文已成为开发团队的现实需求，主流AI Coding工具围绕「Agent README」的收敛趋势愈发明显，未来不同编程工具之间的迁移成本将进一步降低。