CodeX 部署指南
OpenAI 企业级 AI 编程助手，支持终端内智能编码与代码生成。
前置条件
- Node.js 18+ 运行环境（Windows 安装 | macOS 安装 | Linux 安装）
- TokenSwitch 账号及有效的 CodeX API Key（创建 Key）
- 推荐安装 CC-Switch 配置工具
CC-Switch 快速配置（推荐）
第一步：安装 CodeX
bash
npm install -g @openai/codex@latest验证安装：
bash
codex --version第二步：CC-Switch 配置
- 打开 CC-Switch 配置工具
- 切换到 Codex 标签页
- 点击 添加服务商，填写以下信息：
| 配置项 | 值 |
|---|---|
| 名称 | TokenSwitch（或自定义名称） |
| Base URL | https://tokenswitch.cc/v1 |
| API Key | 你的 CodeX API Key |
| 模型 | gpt-5.5 |
| API 协议 | responses |
- 保存配置，即可开始使用
手动安装与配置
CodeX 需要两个配置文件：
| 文件 | 作用 |
|---|---|
config.toml | 配置模型、Provider、接口地址和协议 |
auth.json | 保存 OPENAI_API_KEY |
Windows
安装 CodeX
powershell
npm install -g @openai/codex@latest创建配置文件
- 创建配置目录：
powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"- 创建
config.toml文件（路径：%USERPROFILE%\.codex\config.toml）：
toml
model_provider = "tokenswitch"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.tokenswitch]
name = "tokenswitch"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"
requires_openai_auth = true- 创建
auth.json文件（路径：%USERPROFILE%\.codex\auth.json）：
json
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}将示例中的 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key。
macOS
安装 CodeX
bash
npm install -g @openai/codex@latest创建配置文件
bash
mkdir -p ~/.codex
cd ~/.codex
cat > config.toml << 'EOF'
model_provider = "tokenswitch"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.tokenswitch]
name = "tokenswitch"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
cat > auth.json << 'EOF'
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}
EOF将示例中的 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key。
Linux
安装 CodeX
bash
npm install -g @openai/codex@latest创建配置文件
bash
mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
model_provider = "tokenswitch"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.tokenswitch]
name = "tokenswitch"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}
EOF将示例中的 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key。
配置文件说明
config.toml 参数
| 参数 | 说明 | 值 |
|---|---|---|
model_provider | 当前使用的模型提供商 | tokenswitch |
model | 使用的模型 | gpt-5.5 |
model_reasoning_effort | 推理强度 | xhigh |
network_access | 是否允许网络访问 | enabled |
disable_response_storage | 禁用响应存储 | true |
model_providers.tokenswitch.base_url | OpenAI 兼容接口地址 | https://tokenswitch.cc/v1 |
model_providers.tokenswitch.wire_api | API 协议格式 | responses |
model_providers.tokenswitch.requires_openai_auth | 使用 OpenAI API Key 鉴权 | true |
auth.json 参数
| 参数 | 说明 |
|---|---|
OPENAI_API_KEY | 你的 CodeX API Key |
验证安装
配置完成后，在终端中运行：
bash
codex如果成功进入 CodeX 交互界面，说明部署完成。
常见问题
codex: command not found
| 可能原因 | 解决方法 |
|---|---|
| 未正确安装 | 重新执行 npm install -g @openai/codex@latest |
| PATH 未配置 | 检查 npm 全局 bin 目录是否在 PATH 中 |
| 终端未刷新 | 重启终端窗口 |
连接失败 / 鉴权错误
| 可能原因 | 解决方法 |
|---|---|
| API Key 错误 | 检查 auth.json 中的 OPENAI_API_KEY 是否正确 |
| Base URL 错误 | 确认 config.toml 中 base_url 为 https://tokenswitch.cc/v1 |
| Provider 错误 | 确认 model_provider = "tokenswitch"，并存在 [model_providers.tokenswitch] 配置块 |
| 协议错误 | 确认 wire_api = "responses" |
| 令牌组不匹配 | 确认使用的是支持 OpenAI / CodeX 模型的 API Key |
| 余额不足 | 登录 TokenSwitch 控制台检查余额 |
配置文件不生效
- 检查文件路径是否正确：
~/.codex/config.toml和~/.codex/auth.json - 检查 TOML 和 JSON 格式是否正确（注意引号和逗号）
- 重启终端后重试
下一步
CodeX 部署完成！
- CC-Switch 配置工具 — 图形化管理多个服务商
- 常见问题 — 更多疑难解答