一、部署方式对比
表格
二、WSL2 部署（官方推荐）
1. 安装 WSL2 环境
管理员 PowerShell 执行（Win+X+A）：
powershell
wsl --install等待安装完成后重启电脑OpenAI
设置默认 WSL 版本：
powershell
wsl --set-default-version 2安装 Ubuntu 发行版：
Microsoft Store 搜索 "Ubuntu" 并安装（推荐 22.04 LTS）
首次启动设置用户名和密码
2. 安装依赖与 Codex CLI
更新 Ubuntu 并安装依赖：
bash
运行
sudo apt update && sudo apt upgrade -y sudo apt install -y git curl build-essential安装 Node.js 22（官方推荐）：
bash
运行
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs切换国内镜像（解决下载慢）：
bash
运行
npm config set registry https://registry.npmmirror.com/安装 Codex CLI：
bash
运行
npm install -g @openai/codex验证安装：
bash
运行
codex --version
3. 配置认证与模型
创建配置目录：
bash
运行
mkdir -p ~/.codex配置 API 密钥（两种方式）：
方式 A：环境变量（临时）
bash
运行
export OPENAI_API_KEY="你的OpenAI API密钥"方式 B：配置文件（永久）
bash
运行
# 创建auth.json文件 echo '{"OPENAI_API_KEY": "你的OpenAI API密钥"}' > ~/.codex/auth.json
创建 config.toml 配置文件：
bash
运行
cat > ~/.codex/config.toml << EOL model_provider = "openai" model = "gpt-4" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "api_key" EOL
4. 验证功能
bash
运行
# 查看帮助
codex --help
# 测试代码生成
codex generate "写一个Python函数计算斐波那契数列"
# 测试代码解释
codex explain "def fib(n): return n if n<=1 else fib(n-1)+fib(n-2)"
三、Windows 原生安装（无需 WSL）
1. 安装依赖
安装 Git for Windows：
安装时勾选 "Add Git to PATH"
安装 Node.js 22：
下载：https://nodejs.org/en/download/current/（Windows Installer 64-bit）
安装时勾选 "Automatically install the necessary tools..."
验证 Node.js 安装：
powershell
node --version npm --version
2. 安装 Codex CLI
安装 Codex CLI（管理员 PowerShell）：
powershell
npm install -g @openai/codex验证安装：
powershell
codex --version
3. 配置认证与模型
创建配置目录：
powershell
mkdir -p $env:USERPROFILE\.codex配置 API 密钥：
powershell
# 创建auth.json文件 echo '{"OPENAI_API_KEY": "你的OpenAI API密钥"}' | Out-File -Encoding UTF8 $env:USERPROFILE\.codex\auth.json创建 config.toml 配置文件：
powershell
@" model_provider = "openai" model = "gpt-4" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "api_key" "@ | Out-File -Encoding UTF8 $env:USERPROFILE\.codex\config.toml
4. 验证功能
powershell
# 查看帮助
codex --help
# 测试代码生成
codex generate "写一个Python函数计算斐波那契数列"
三、Windows 桌面应用安装（极简）
安装方式（二选一）：
方式 A：Microsoft Store 安装
打开 Microsoft Store
搜索 "Codex"，找到官方应用（应用 ID：9plm9xgg6vks）
点击 "获取 / 安装"
方式 B：命令行安装（winget）
powershell
winget install 9plm9xgg6vks
登录与使用：
安装后直接打开应用
使用 ChatGPT 账号（Plus/Pro/Business/Enterprise/Edu 订阅）登录
免费 / Go 方案限时也有额度
四、关键配置说明
1. config.toml 核心参数
表格
2. 国内 API 配置（可选）
如果无法访问 OpenAI 官网，可以配置国内 API 提供商：
toml
model_provider = "univibe"
model = "gpt-5.1"
[model_providers.univibe]
name = "UniVibe"
api_base = "https://api.univibe.ai/v1"
auth_method = "api_key"
同时在 auth.json 中添加 API 密钥：
json
{
"UNIVIBE_API_KEY": "你的UniVibe API密钥"
}
五、常见问题解决
1. 安装失败 / 依赖缺失
Node.js 版本错误：必须使用 22.x 版本，卸载旧版本后重装
权限不足：使用管理员 PowerShell/WSL，避免普通用户权限
网络问题：切换国内镜像，或使用代理
WSL 与 Windows 通信：WSL 中启动后，Windows 浏览器访问
http://localhost:8080
2. 认证问题
API 密钥无效：检查密钥是否正确，是否有足够余额
OAuth 登录失败：确保网络可以访问 OpenAI 官网，清除浏览器缓存后重试
环境变量未生效：重启终端或重新加载配置文件（
source ~/.bashrc）
3. 功能异常
模型响应慢：切换到更轻量的模型（如 gpt-4-turbo），或调整
model_reasoning_effort为 low代码生成质量低：提高
model_reasoning_effort为 high，或使用更强大的模型命令执行失败：检查 Node.js 版本是否符合要求，或重新安装 Codex CLI
六、后续操作
1. 更新 Codex
CLI 版本：
bash
运行
npm update -g @openai/codex桌面应用：
自动更新，或在 Microsoft Store 中手动检查更新
2. 常用命令
bash
运行
# 查看版本
codex --version
# 查看帮助
codex --help
# 生成代码
codex generate "你的代码需求"
# 解释代码
codex explain "你的代码"
# 优化代码
codex optimize "你的代码"
# 调试代码
codex debug "你的代码"
总结
推荐使用WSL2 部署方式，兼容性最好，问题最少；纯新手可选择Windows 桌面应用，一键安装，操作简单；熟悉 Node.js 的用户可尝试Windows 原生安装（CLI），功能完整且资源占用少。无论哪种方式，都需要有效的 API 密钥或 ChatGPT 账号登录才能使用完整功能。