Codex — Windows 安装配置
本指南帮助你在 Windows 上安装并配置 OpenAI Codex CLI，接入 TinyPx API 服务。
前置要求
- Windows 10 或更高版本
- Node.js 18.0 或更高版本
- npm 包管理器
步骤 1：安装 Node.js
方法一：官方安装包（推荐）
- 访问 nodejs.org
- 下载 LTS 版本的 Windows Installer（
.msi） - 运行安装程序，按默认设置完成安装
方法二：包管理器
powershell
# Winget
winget install OpenJS.NodeJS.LTS
# Chocolatey
choco install nodejs-lts
# Scoop
scoop install nodejs-lts验证安装
powershell
node --version # 应显示 v18 或更高
npm --version步骤 2：安装 Codex CLI
powershell
npm install -g @openai/codex@latest验证安装：
powershell
codex --version步骤 3：创建配置目录
powershell
mkdir $env:USERPROFILE\.codex
cd $env:USERPROFILE\.codex步骤 4：配置 API 端点
用 PowerShell 生成 config.toml：
powershell
@"
model_provider = "tinypx"
model = "填写该 Codex 分组支持的模型名"
model_reasoning_effort = "medium"
[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
"@ | Out-File -FilePath config.toml -Encoding utf8或手动创建 config.toml：
toml
model_provider = "tinypx"
model = "填写该 Codex 分组支持的模型名"
model_reasoning_effort = "medium"
[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"注意端点格式
Codex 必须带 /v1 后缀 —— 使用 https://ai.tinypx.cn/v1。 详见 API 端点说明。
配置说明
| 字段 | 说明 |
|---|---|
model_provider | 使用的提供商名称，这里是 tinypx |
model | 填写模型广场中该 Codex 分组支持的实际 model |
model_reasoning_effort | 推理强度，可选 low、medium、high、xhigh |
env_key | 读取 API Key 的环境变量名 |
wire_api | 接口协议，填 responses |
可用模型
具体可用模型请访问 模型广场 查看该 Codex 分组支持的 model 及价格。
步骤 5：配置 API 密钥
powershell
# 临时设置（当前会话有效）
$env:OPENAI_API_KEY = "粘贴为 Codex 专用分组令牌 key"
# 永久设置（写入用户环境变量）
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "粘贴为 Codex 专用分组令牌 key", "User")重要
请把占位文本替换为你从 TinyPx API 控制台 获取的实际令牌。
步骤 6：验证配置
powershell
codex "你好，请写一个 Python 函数计算斐波那契数列"常用命令
powershell
# 启动交互式编码会话
codex
# 非交互式执行
codex exec "创建一个 Express 服务器"
# 代码审查
codex review --uncommitted
# 查看帮助
codex --helpVSCode 集成（可选）
- 打开 VSCode
- 按
Ctrl+Shift+X打开扩展面板 - 搜索 "Codex" 或 "OpenAI Codex"
- 点击安装
安装扩展后，实际配置继续使用前面的 ~/.codex/config.toml 和 OPENAI_API_KEY 即可，不需要在 VSCode 里单独填写 apiBase 或 apiKey。
高级配置
更多可用配置请参考 codex --help 和官方配置参考。若需临时覆盖配置，可以用 codex -c key=value。
故障排除
命令未找到
powershell
npm config get prefix
$env:PATH添加到 PATH：
powershell
$npmPath = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")API 连接失败
powershell
# 验证密钥
echo $env:OPENAI_API_KEY
# 确认配置文件
Get-Content $env:USERPROFILE\.codex\config.toml
# 测试端点
curl -I https://ai.tinypx.cn/v1权限错误
右键点击 PowerShell，选择「以管理员身份运行」。
编码问题（中文乱码）
确保配置文件为 UTF-8 编码：
powershell
$configContent = Get-Content config.toml -Raw
[System.IO.File]::WriteAllText(
(Join-Path $PWD "config.toml"),
$configContent,
[System.Text.UTF8Encoding]::new($false)
)使用技巧
powershell
# 生成完整文件
codex exec "创建一个 React Todo 应用，并将结果写入 TodoApp.jsx"
# 审查当前未提交改动
codex review --uncommitted
# 审查当前分支相对 main 的改动
codex review --base main
# 生成单元测试
codex exec "为 calculator.js 编写 Jest 单元测试"下一步
获取 API 密钥
访问 TinyPx API 控制台 获取你的 Codex 专用令牌。