根目录认错时改 project_root_markers,空列表等于就地当根

默认向上找到含 .git 的目录。非 Git、嵌套仓、只想盯当前子目录时改这个顶层键。空数组不再往上搜。

Codex 从 cwd 往上走,碰到项目根才加载 .codex/AGENTS.md。默认标记是 .git。在 monorepo 子包、Hg/Sapling 仓、或没有 Git 的一次性目录里,根会认错,表现为项目配置根本没加载。

project_root_markers = [".git", ".hg", ".sl"]

只要当前目录、不要继承父仓:

project_root_markers = []

空列表会跳过父目录搜索,把 cwd 当成根。这是顶层键,不要写进 [tui]

核对:新开会话后看 /status 的工作区路径,以及项目 .codex/config.toml 是否真的进了 /debug-config。父目录有 .git、子目录才是你的任务时,空列表比再写一份 AGENTS.md 更直接。

来源