Claude Code 2.1.277开始支持AGENTS.md，作为CLAUDE.md缺席时的回退
Thariq Shihipar表示，从 2.1.277 版本起，若文件夹中没有CLAUDE.md，Claude Code会查找并使用AGENTS.md；该支持以一个内置mod的形式实现，基于即将推出的Claude Code mods机制。
AI解读：这条新闻的核心是文件名的优先级：CLAUDE.md仍然是第一选择，只有它不存在时，Claude Code才会去看AGENTS.md。已经写了CLAUDE.md的项目，行为不会因为这次更新而变化。
对跨工具维护项目指令的人来说，这省掉了一份文件两处复制的麻烦。但要注意回退是单向的——AGENTS.md不会覆盖CLAUDE.md，所以两者同时存在时，以CLAUDE.md为准。
实现方式比功能本身更有意思：AGENTS.md支持被做成了一个内置mod，而不是硬编码进Claude Code。按Shihipar的说法，mods是未来定制Claude Code harness的方式，用户之后可以自己构建项目指令的定制版本。
目前公开的信息只有版本号、回退逻辑和mod机制，没有说明多个嵌套目录下如何取舍、mod如何编写或分发，也没有给出实际兼容效果的数据。这些需要等更多文档。
如果你同时使用多个编码代理，这项变化减少的是重复维护成本，不是能力升级；如果你的项目只跑Claude Code，那它基本不会带来可见差别。
Thariq Shihipar于 2026 年 9 月 18 日宣布，Claude Code开始支持AGENTS.md。从版本 2.1.277 起，如果某个文件夹中没有CLAUDE.md，Claude会检查并使用AGENTS.md。
AGENTS.md支持构建在Claude Code mods之上。Shihipar称mods是“我们即将推出的、定制Claude Code harness的方式”。这个AGENTS.md支持是一个内置mod，但用户之后也可以按自己的需要构建定制版本的项目指令。
Shihipar同时提供了该mod的源码链接，并表示还有更多mods可看。