Codex CLI 安装教程（Windows）

在 Windows 上使用 Codex CLI 有两条路径：一是直接在 PowerShell 里安装并写配置文件，二是开启 WSL2 后按 Linux 流程操作。本文主要讲方案 A。

0. 前置：安装 Node.js

从 nodejs.org 下载 LTS 安装包（要求 22 或更高版本），默认选项安装即可。安装完毕在 PowerShell 中验证：

node -v
npm -v

若提示命令不存在，请重新打开 PowerShell 或重启系统，让 PATH 生效。

方案 A：PowerShell 原生安装

1) 安装 Codex

npm install -g @openai/codex
codex --version

若安装速度慢，可临时切换 npm 国内镜像：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

2) 配置 Codex 接入 AI通道

2.1 配置文件在哪里

Codex 读取两个文件：

• %USERPROFILE%\.codex\config.toml —— 模型与服务端配置
• %USERPROFILE%\.codex\auth.json —— API Key

2.2 创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

2.3 写入主配置 config.toml

$config = @'
model = "gpt-5-codex"
model_provider = "aitongdao"
approval_policy = "on-request"

[model_providers.aitongdao]
name = "aitongdao"
base_url = "https://ai.aitongdao.com/v1"
wire_api = "responses"
'@
Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Value $config -Encoding UTF8

对应的 TOML 内容为：

model = "gpt-5-codex"
model_provider = "aitongdao"
approval_policy = "on-request"

[model_providers.aitongdao]
name = "aitongdao"
base_url = "https://ai.aitongdao.com/v1"
wire_api = "responses"

2.4 写入认证文件 auth.json

把 sk-你的密钥 替换为实际值：

$auth = @'
{
  "OPENAI_API_KEY": "sk-你的密钥"
}
'@
Set-Content -Path "$env:USERPROFILE\.codex\auth.json" -Value $auth -Encoding UTF8

3) 启动并验证

codex --version
cd C:\path\to\your\project
codex

进入交互界面后输入一句问候，若能正常回复说明已打通。

方案 B：WSL2（推荐）

在 WSL2（Ubuntu）里跑我们的一键脚本最省心。几个要点：

• 没装过 WSL：用管理员权限打开 PowerShell，执行 wsl --install，按提示重启电脑，之后会自动打开 Ubuntu 让你设置用户名密码。
• 已装好 WSL：开始菜单搜 "Ubuntu" 打开即可。
• 进 Ubuntu 后按 Linux 安装教程 的一键脚本跑就行。

WSL 内的 ~/.codex/ 与 Windows 主机下的 .codex 互不共享，需要单独配置。

常见问题

PowerShell 里 curl 报 "找不到 fsSL 参数"

PowerShell 的 curl 是 Invoke-WebRequest 别名，不是真 curl，也没有 bash。一键脚本请在 Ubuntu 终端里跑，别在 PowerShell 里。

Ubuntu 终端粘贴不了（Ctrl+V 没反应）

Linux 终端粘贴快捷键是 Ctrl+Shift+V，或者直接鼠标右键点击窗口内部。

重开终端后 codex 命令找不到 / 报 "Missing OPENAI_API_KEY"

脚本会把环境变量写入 ~/.bashrc，必须关掉当前 Ubuntu 窗口重新打开（或执行一次 source ~/.bashrc）才能生效。

npm 或 codex 命令不识别（方案 A）

全局 npm bin 目录可能未在 PATH。运行 npm config get prefix 查看前缀，把 前缀\ 路径加入用户环境变量 PATH，再开一个新 PowerShell 窗口。

Set-Content 写入的文件乱码

请显式加 -Encoding UTF8 参数。Codex 对 BOM 敏感，建议保持 UTF-8（无 BOM）。

模型调用返回 401

确认 Key 完整复制，且令牌分组选择了 codex。

想切换默认模型

修改 config.toml 的 model 字段即可，比如换成 gpt-5.2-codex 或 gpt-5。