用过 Claude Code 的人都知道 CLAUDE.md：把项目的规矩写在里面，每次开工它自己会读。
AGENTS.md 是同一件事，但它不属于任何一家。
它是一个公开约定
AGENTS.md 是一个开放约定，八家以上的 AI 工具都认它——Codex、Gemini CLI、Cursor、GitHub Copilot 等等。
好处很直接：
规矩写一次，换工具不用重写。
今天用 Codex，明天试别的，说明书原样搬过去就行。
和 CLAUDE.md 可以并存
两份文件放在一起没有冲突。 Claude Code 读 CLAUDE.md，Codex 读 AGENTS.md，各读各的。
但这里有一个真的坑：
⚠️ 两份文件说了相反的话，你不会收到任何提示。
只会表现为「同一个项目，用 Claude 干和用 Codex 干，出来的东西不一样」，而你要花很久才想到是说明书打架了。
处理办法有两种，挑一种：
① 只留一份，另一份指过去。 比如 CLAUDE.md 里只写一句「规矩全在 AGENTS.md」。
② 分工写。 AGENTS.md 写两家都适用的（项目是什么、命令怎么跑、红线在哪），CLAUDE.md 只写 Claude 独有的部分。
别两份都写全。 那等于同一件事记两遍，而两遍早晚会说得不一样。
里面该写什么
一句话：只写「不写下来就会做错」的东西。
值得写的：
- 这个项目是干什么的（一句话）
- 常用的命令、文件放在哪
- 这个项目独有的规矩
- 明确不做的事，以及为什么
不值得写的：
- 通用的编程建议（它本来就会）
- 「注意代码质量」这种没法检验对错的话
- 今天做了什么（那是日志，不是说明书）
最后一条最重要。 说明书一旦开始记「今天做了什么」，几个月后就会长成一份没人愿意读的流水账，然后所有人都不看它了。
它有大小上限
Codex 默认最多读 32 KiB，超过的部分直接不读，也不报错。
这是个安静的失败——你写了但它没看见，而你不会知道。所以：短比全重要。
具体的加载顺序和多层目录怎么写，在 AGENTS.md 怎么写、按什么顺序加载。
本节事实查证日期：2026-09-10。 依据：OpenAI 官方文档 Custom instructions with AGENTS.md。