CodeX 部署指南
OpenAI 企业级 AI 编程助手，支持终端内智能编码与代码生成。
💡 前置条件
- Node.js 18+ 运行环境（Windows 安装 | macOS 安装 | Linux 安装）
- TokenSwitch 账号及有效的 CodeX 令牌（创建 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 令牌 |
| 模型 | gpt-5.4 |
- 保存配置，即可开始使用
手动安装与配置
Windows
安装 CodeX
powershell
npm install -g @openai/codex@latest创建配置文件
- 创建配置目录：
powershell
mkdir "$env:USERPROFILE\.codex"- 创建
config.toml文件（路径：%USERPROFILE%\.codex\config.toml）：
toml
model_provider = "openai"
model = "gpt-5.4"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"- 创建
auth.json文件（路径：%USERPROFILE%\.codex\auth.json）：
json
{
"OPENAI_API_KEY": "你的CodeX令牌"
}macOS
安装 CodeX
bash
npm install -g @openai/codex@latest创建配置文件
- 创建配置目录：
bash
mkdir -p ~/.codex- 创建
~/.codex/config.toml：
toml
model_provider = "openai"
model = "gpt-5.4"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"- 创建
~/.codex/auth.json：
json
{
"OPENAI_API_KEY": "你的CodeX令牌"
}Linux
安装 CodeX
bash
npm install -g @openai/codex@latest创建配置文件
- 创建配置目录：
bash
mkdir -p ~/.codex- 创建
~/.codex/config.toml：
toml
model_provider = "openai"
model = "gpt-5.4"
base_url = "https://tokenswitch.cc/v1"
wire_api = "responses"- 创建
~/.codex/auth.json：
json
{
"OPENAI_API_KEY": "你的CodeX令牌"
}配置文件说明
config.toml 参数
| 参数 | 说明 | 值 |
|---|---|---|
model_provider | 模型提供商 | openai |
model | 使用的模型 | gpt-5.4 |
base_url | API 接口地址 | https://tokenswitch.cc/v1 |
wire_api | API 协议格式 | responses |
auth.json 参数
| 参数 | 说明 |
|---|---|
OPENAI_API_KEY | 你的 CodeX 专用令牌 |
验证安装
配置完成后，在终端中运行：
bash
codex如果成功进入 CodeX 交互界面，说明部署完成。
常见问题
codex: command not found
| 可能原因 | 解决方法 |
|---|---|
| 未正确安装 | 重新执行 npm install -g @openai/codex@latest |
| PATH 未配置 | 检查 npm 全局 bin 目录是否在 PATH 中 |
| 终端未刷新 | 重启终端窗口 |
连接失败 / 鉴权错误
| 可能原因 | 解决方法 |
|---|---|
| API Key 错误 | 检查 auth.json 中的令牌是否正确 |
| Base URL 错误 | 确认 config.toml 中 base_url 为 https://tokenswitch.cc/v1 |
| 令牌组不匹配 | 确认使用的是支持 OpenAI 系列模型的令牌组 |
| 余额不足 | 登录 TokenSwitch 控制台检查余额 |
配置文件不生效
- 检查文件路径是否正确：
~/.codex/config.toml和~/.codex/auth.json - 检查 TOML 和 JSON 格式是否正确（注意引号和逗号）
- 重启终端后重试
下一步
✅ CodeX 部署完成！
- CC-Switch 配置工具 — 图形化管理多个服务商
- 常见问题 — 更多疑难解答