Codex CLI 安装成功但运行不了，最常见的 8 个原因

npm 显示安装成功，并不代表 Codex 已经能正常运行。真正启动时还会受到 Node 版本、npm 全局目录、PATH、shell 配置、权限和 CLI 版本影响。尤其一台机器上安装过 nvm、fnm、Volta 等多套 Node 管理工具时，很容易出现“装在 A 环境，运行在 B 环境”。

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

• 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
which node
which npm
which codex
echo $PATH
source ~/.zshrc

四、使用建议

不要第一反应使用 sudo npm -g。更推荐用 Node 版本管理器把全局包放在用户目录，权限更干净。