81 次实测：AGENTS.md 和 CLAUDE.md 到底写哪个？答案是——写哪个都行，但得写

玩 AI 编程的同学一定纠结过：仓库根目录放 CLAUDE.md 还是 AGENTS.md？两份都写会不会打架？

背景：文档自己都说不清

先看个数据：有人统计了 GitHub 上 2200 个仓库，发现四成的 CLAUDE.md 里面只有一句话：去看 AGENTS.md。再看官方文档：Claude Code 说“有 CLAUDE.md 就不读 AGENTS.md”；Codex 的文档只列了 AGENTS.md 和备选列表，压根没提 CLAUDE.md。

那 Codex 会读 CLAUDE.md 吗？开发者 Nazmul Hasan 做了 81 次对照实测。

实测：文件名基本不重要

实验设计很实在：给两个 agent 六条不寻常的“家规”（比如特定的提交格式、禁止事项），分别放在 CLAUDE.md、AGENTS.md、两个都放、都不放，看 81 次运行里遵守了几条。

结果：

• 有任意指令文件时：63 次运行里，两个 agent 六条家规全部遵守，63/63，全中。包括那些按文档“应该失败”的组合——比如 Codex 读了它文档里没提过的 CLAUDE.md，照样全遵守。
• 没有指令文件时：遵守率掉到 33%-47%。

机制很简单：两个 agent 都会先列文件，把看起来像指令的东西都读了，叫什么名字无所谓。在 2014 个文件的大仓库里重测，agent 照样找得到。

唯一发现文件名有影响的，是个细节：Claude 通过“读到”规则 vs 其他途径发现规则，行为有细微差异，不影响大局。

实操建议

1. 二选一写透就行，别纠结文件名，也别两份都维护（迟早打架）。
2. 写具体、可执行的规则，别写“写高质量代码”这种空话，写“提交信息用中文、50 字以内”这种。
3. 放仓库根目录，agent 找得到的地方。
4. 定期删过时规则——这条比“写”更重要。过期的指令比没指令更害人。

一句话：agent 不在乎你的文件叫什么，在乎的是你到底有没有把规矩讲清楚。