Windows 装 Codex CLI 有两种方式：原生 Windows（推荐）、WSL2（Linux 子系统）。下面给你一步到位的可执行步骤，含国内加速、权限/策略报错处理。

---

一、原生 Windows 安装（最快，推荐）

1. 必须环境：Node.js 22+

Codex 0.130+ 强制要求 Node 22.x，低了会报错。

方式 A：用 winget（微软官方，最省事）

管理员身份打开 PowerShell / Windows Terminal：

# 安装 Node 22 LTS（含 npm）
winget install OpenJS.NodeJS.LTS -e

# 安装 git（可选但建议）
winget install Git.Git -e

装完必须关掉当前窗口，重新开一个终端，验证：

node -v   # 应输出 v22.x.x
npm -v

方式 B：官网下载（winget 不可用时）

1. 访问 https://nodejs.org/
2. 下载 22 LTS（.msi 64位）
3. 安装时务必勾选 Add to PATH，其余默认
4. 重开终端，验证 node -v

2. 解决 PowerShell 执行策略（90% 人卡这里）

报错类似：无法加载文件 …ps1，因为在此系统上禁止运行脚本
管理员 PowerShell 执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

选 Y 确认。

3. 安装 Codex CLI

国内加速（必做，否则慢/超时）

npm config set registry https://registry.npmmirror.com

全局安装

npm install -g @openai/codex

验证

codex --version   # 输出版本（如 0.130.0）即成功

4. 配置 OpenAI Key

首次运行会引导登录/输入 key：

codex

或手动设置环境变量：

$env:OPENAI_API_KEY="sk-..."

---

二、WSL2 安装（Linux 环境，兼容性更好）

适合习惯 Linux 命令或原生装不上的情况。

1. 启用 WSL2（管理员 PowerShell）

wsl --install

自动装 Ubuntu，完成后重启电脑。

2. 进入 WSL，装 Node 22

wsl   # 进入 Linux 子系统

# 装 nvm（管理 Node 版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# 重进 shell 后
nvm install 22
nvm default 22
node -v   # 确保 v22.x

3. 安装 Codex

npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex
codex --version

---

三、常见问题

1. 权限报错 EACCES/EPERM：用管理员终端安装；或改 npm 全局目录：

   npm config set prefix "D:\.npm-global"
   

2. command not found：重开终端；检查 Node 是否加入系统 PATH；重启电脑。
3. 网络慢/超时：一定先切淘宝镜像（上面已给命令）。

---

四、卸载（可选）

npm uninstall -g @openai/codex

要不要我把上面步骤整理成一个一键安装脚本（PowerShell），你直接复制运行就能完成全部配置？