AGENTS.md
AGENTS.md 是面向 AI 编码代理的 Markdown 项目指令文件，代理在开始工作前会把其中的适用内容载入上下文。
Codex CLI 会在工作前读取它。截至 2026 年 9 月，Codex 先读取主目录中的全局文件，默认位置为 ~/.codex，再从项目根目录一路读取到当前工作目录，并按此顺序组合。因此，离工作位置最近的指令排在最后，也具有更高优先级。同一目录中的 AGENTS.override.md 会替代普通文件，/init 则能生成起始文件。
Codex 对载入量设有上限。文件的合计大小达到 project_doc_max_bytes 后便不再加入内容，默认上限为 32 KiB。超出上限的指令不会送到模型。指令链在 Codex 启动时组装一次，因此文件修改要到下次运行才生效。
Claude Code 2.1.277 及之后的版本，在工作目录及其上层没有 CLAUDE.md 时，会把 AGENTS.md 当作项目指令；也可以通过设置让它同时读取两者。在 CLAUDE.md 中写入 @AGENTS.md 可以明确导入该文件，让多个工具共用一套说明。
共用文件能减少重复维护，却不会降低 token 成本。和其他指令文件一样，AGENTS.md 会进入读取它的代理在该会话中的每次请求，每一行都可能反复计费。适合长期保留的是每项任务都需要的规则，其余说明应放到仅在相关工作中读取的位置。