OPENAI CODEX

CodeX - Windows 安装配置

在 Windows 系统安装和配置 OpenAI CodeX，并使用千模岛 API 服务。

#前置要求

Node.js 18 或更高版本与 npm
Windows 系统与管理员或 sudo 权限
千模岛 API 账户和 CodeX 专用分组令牌

#步骤 1：安装 Node.js

#方法一：使用官方安装包（推荐）

访问 https://nodejs.org
下载 LTS 版本的 Windows Installer（.msi）。
运行安装程序并按默认设置完成安装。
安装程序会自动把 Node.js 加入 PATH。

#方法二：使用包管理器

Winget（Windows 11 或 Windows 10 自带）：

winget install OpenJS.NodeJS.LTS

Chocolatey：

choco install nodejs-lts

Scoop：

scoop install nodejs-lts

#验证安装

node --version
npm --version

#步骤 2：安装 CodeX CLI

# 全局安装
npm install -g @openai/codex@latest

# 验证安装
codex --version

#步骤 3：创建配置目录

mkdir $env:USERPROFILE\.codex
cd $env:USERPROFILE\.codex

#步骤 4：配置 API 端点

编辑 %USERPROFILE%\.codex\config.toml：

model_provider = "qianmodao"
model = "自行选择一个该CodeX分组支持的model（在模型广场查看）"
model_reasoning_effort = "medium"

[model_providers.qianmodao]
name = "千模岛 API"
base_url = "https://www.qianmodao.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

配置字段说明：

model_provider：提供商名称，本页使用qianmodao。
model：填写模型广场中 CodeX 分组支持的实际 model。
model_reasoning_effort：可选 low、medium、high、xhigh。
env_key：读取 API Key 的环境变量名。

#步骤 5：配置 API 密钥

$env:OPENAI_API_KEY = "粘贴为CodeX专用分组令牌key"
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "粘贴为CodeX专用分组令牌key", "User")

替换令牌

将示例中的占位文本替换为千模岛控制台生成的 CodeX 专用分组令牌。

#步骤 6：验证配置

codex "你好，请写一个Python函数计算斐波那契数列"

如果配置正确，CodeX 会生成代码并响应。

#常用命令

# 启动交互式编码会话
codex

# 非交互式执行
codex exec "创建一个Express服务器"

# 代码审查
codex review --uncommitted

# 查看帮助
codex --help

#VSCode 集成（可选）

#安装 CodeX 扩展

打开 VSCode。
按 Ctrl+Shift+X打开扩展面板。
搜索 “CodeX” 或 “OpenAI CodeX” 并安装。

#配置 VSCode

安装扩展后，继续使用 %USERPROFILE%\.codex\config.toml 与 OPENAI_API_KEY，无需在 VS Code 中单独填写 apiBase 或 apiKey。

#快捷键

Ctrl+Shift+X：打开 CodeX 面板
Ctrl+Shift+I：内联代码生成
Ctrl+Shift+E：解释选中代码
Ctrl+Shift+O：优化选中代码
Tab：接受代码建议
Esc：拒绝代码建议

#高级配置

#额外配置

可用配置以 codex --help 和官方配置参考为准；需要临时覆盖时，使用 codex -c key=value。

#故障排除

#问题：命令未找到

npm config get prefix
$env:PATH

#问题：API 连接失败

echo $env:OPENAI_API_KEY
Get-Content $env:USERPROFILE\.codex\config.toml

#问题：权限错误

请以管理员身份运行 PowerShell。

#问题：编码问题

Get-Content config.toml | Out-File -FilePath config.toml -Encoding utf8

#使用技巧

#1. 代码生成

# 生成完整文件
codex exec "创建一个React Todo应用，并将结果写入 TodoApp.jsx"

# 生成函数
codex exec "写一个排序算法，使用 Python"

#2. 代码审查

# 审查当前改动
codex review --uncommitted
codex review --base main

#3. 单元测试生成

codex exec "为 calculator.js 编写 Jest 单元测试"

#下一步

获取 API 密钥：访问千模岛 API 控制台获取你的 CodeX 专用令牌。