下面把 Codex CLI（OpenAI 那个 codex 命令行）最常见的几类安装报错，按现象+原因+一键修复给你整理好，照着对号入座即可。

---

---

**Windows:**：https://pan.quark.cn/s/1ed5727cd602

---

一、装完后：codex: command not found（最常见）

现象：
npm install -g @openai/codex 成功，但敲 codex --version 提示找不到命令。

原因：npm 全局 bin 目录不在系统 PATH 里。

修复（Linux/macOS）

# 1. 查看 npm 全局 prefix
npm config get prefix

# 2. 把 bin 目录加入 PATH（bash）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 或 zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 3. 验证
codex --version

修复（Windows PowerShell）

$p = [Environment]::GetEnvironmentVariable('PATH','User')
[Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')

重启终端再试。

---

二、npm 安装报权限错误：EACCES / EPERM

现象：

npm ERR! code EACCES
permission denied

原因：全局目录权限不足，不要用 sudo（会引发更多问题）。

推荐修复（用 nvm）

# 1. 安装 nvm（如果没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc

# 2. 装 LTS node（推荐 20+）
nvm install --lts
nvm use --lts

# 3. 再装 codex（此时不用 sudo）
npm install -g @openai/codex

备选：改 npm 全局目录

npm config set prefix ~/.local
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

npm install -g @openai/codex

---

三、SyntaxError: Unexpected reserved word await

现象：启动报错含 await / top-level await。

原因：Node 版本太低，必须 ≥ 16，推荐 20+。

修复

node -v
# 若 v12 / v14：
nvm install 20
nvm use 20
npm uninstall -g @openai/codex
npm install -g @openai/codex

---

四、macOS：Bad CPU type in executable（架构不匹配）

现象：

Bad CPU type in executable
arch: posix_spawnp: codex: Bad CPU type in executable

原因：Apple Silicon（arm64）装了 Intel（x86_64）二进制，或反过来。

修复

# 检查架构
uname -m
file $(which codex)

# 卸载重装对应架构
brew uninstall codex
# Apple Silicon
arch -arm64 brew install codex
# 或 Intel
arch -x86_64 brew install codex

---

五、macOS：“无法验证开发者”/被 Gatekeeper 拦截

现象：系统提示不信任开发者，直接阻止运行。

修复

# 移除隔离属性
sudo xattr -rd com.apple.quarantine /opt/homebrew/bin/codex

或在：
系统设置 → 安全性与隐私 → 通用 → 仍要打开。

---

六、Windows：安装后闪退 / code=3221225781

现象：一闪而过，报错码 0xC0000135。

原因：缺少 Visual C++ 运行时。

修复

1. 下载安装 vc_redist.x64.exe（微软官网）
2. 重启电脑
3. 再运行 codex --version

---

七、Windows：用户名中文/空格导致各种诡异报错

现象：安装成功但运行报错、路径乱码、sandbox 失败。

原因：Windows 用户目录有中文或空格。

稳妥方案

新建一个纯英文本地账户（不要改现有用户名），登录后重装：

设置 → 账户 → 家庭和其他用户 → 添加本地账户

---

八、Linux 安装被 Killed（OOM）

现象：安装中途突然终止，提示 Killed。

原因：内存不足，至少 4GB RAM。

临时加 swap（低内存服务器）

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 重新安装
curl -fsSL https://chatgpt.com/codex/install.sh | sh

---

九、登录/鉴权类：402 Payment Required / 401 Unauthorized

现象：运行时提示 401/402。

原因：

• 没登录：codex login
• Key 过期或余额不足
• 网络/代理问题

修复

codex login
# 粘贴 OpenAI API Key

检查：

• 是否有 GPT-4 访问权限
• 账户是否欠费/额度用尽

---

十、彻底重装（万能兜底）

# 卸载
npm uninstall -g @openai/codex
rm -rf ~/.codex ~/.cache/codex

# 用 nvm 切到 node 20
nvm use 20

# 重装
npm install -g @openai/codex

# 验证
codex --version