Windows 安装 Codex CLI 后提示 codex 不是内部或外部命令怎么办

Windows 上最常见的并不是 Codex 包没安装，而是 npm 全局目录没有进入 PATH，或者 nvm-windows 切换 Node 版本后全局包发生变化。PowerShell、CMD 与 IDE 终端看到的环境变量也可能不同。

一、为什么会出现这个问题

• Codex 当前工作目录、仓库范围或项目规则不明确。
• 一次任务给得太大，导致读取上下文、修改文件和运行命令的范围失控。
• AGENTS.md、Git 状态、测试命令和危险操作边界没有提前定义。
• CLI、Node.js、终端环境变量或第三方兼容层与预期不一致。

二、推荐的排查顺序

1. 先确认工作目录和 Git

每次启动任务前执行 pwd、git status、git remote -v。先知道自己在哪里、工作区是否干净，再让 Agent 动手。

2. 把任务边界写清楚

明确允许修改哪些目录、禁止修改什么、测试命令是什么、怎样算完成。比“帮我优化一下”有效得多。

3. 先 Plan 再 Edit

大型任务先让 Codex 列出涉及文件和计划，再进入修改。任务中途也要看 diff，避免最后一次性出现几十个无关改动。

三、可以直接复制的排查示例

node -v
npm -v
npm prefix -g
where.exe node
where.exe npm
where.exe codex
$env:Path -split ';'

# 使用 nvm-windows 时
nvm list
nvm current

四、使用建议

修改 PATH 后要关闭并重新打开终端。切换 Node 版本后 Codex 消失，也可能只是当前版本没有重新安装全局包。