记清 AGENTS.md 的发现顺序

全局一份,再从 Git 根走到 cwd。每一层优先 override,后出现的更具体规则覆盖前面的。

每次启动(TUI 通常是每个会话一次)重建指令链:

  1. 全局$CODEX_HOME/AGENTS.override.md,否则 AGENTS.md。这一层只取第一份非空文件。
  2. 项目:从项目根(通常是 Git 根)走到当前目录。每一层按 AGENTS.override.mdAGENTS.md → fallback 文件名查找,每层最多一份
  3. 合并:从根拼到 cwd,靠近当前目录的文件更靠后,因此覆盖更通用的规则。

空文件会被跳过。合并大小达到 project_doc_max_bytes(默认 32 KiB)就停止追加。

验证:

codex --ask-for-approval never "列出你加载的指令来源,并按优先级复述规则。"

改完文件要新开会话。运行中的会话不会持续重扫。

来源