Codex 不执行 AGENTS.md 里的规则时，先检查启动目录和文件层级，不要反复改提示词。Codex 会从全局配置开始，再从项目根目录一路读取到当前工作目录；离当前目录更近的规则优先，且指令链在每次运行或 TUI 会话开始时重新建立。
先确认文件真的在搜索路径上
项目规则应放在 Git 仓库根目录或当前工作目录的上级目录中。如果从仓库外启动，或实际工作目录位于另一个子目录，Codex 可能根本不会经过你编辑的文件。可以从目标目录启动：
codex --cd services/api "列出当前生效的指令文件"如果项目不是 Git 仓库，Codex 通常只检查当前目录，因此不要把 AGENTS.md 放在无关的父目录后期待它自动生效。
再排查覆盖关系
同一目录中，AGENTS.override.md 会优先于 AGENTS.md，Codex 每层最多读取一个文件。全局目录 ~/.codex 也可能存在 override 文件；它适合临时覆盖，但忘记删除时会让项目规则看起来失效。嵌套目录里的规则排在根目录规则之后，冲突时以更靠近当前目录的内容为准。
内容太长也会被截断
Codex 默认只加载有限大小的项目指令，合并内容达到上限后，后续规则可能没有进入上下文。把通用规范留在根目录，把服务专属命令放进对应子目录，通常比把所有要求堆进一个大文件更可靠。
修改后必须新开一次运行
AGENTS.md 不是运行中持续热更新的配置。改完文件后重启 Codex，或结束当前 TUI 会话再启动；如果更改的是自定义备用文件名，也要确认它已经写入 project_doc_fallback_filenames。最后让 Codex复述生效规则，并核对项目根目录、全局 CODEX_HOME 和最近的 override 文件，三处一致后再开始正式任务。
