CodeX 部署指南

CodeX 是 OpenAI 基于 GPT-5 架构推出的代码生成与优化 CLI 工具，为开发者提供强大的编程辅助能力。

快速导航

前置要求
安装 Node.js
获取 CodeX 专用令牌
方式一：使用 CC-Switch 快速配置（推荐）
方式二：手动命令行配置
- Windows 平台
- macOS / Linux 平台
常见问题

前置要求

在开始之前，请确保已完成以下准备：

Node.js 环境：CodeX 通过 npm 安装，需要 Node.js 环境（见下方安装说明）
CC-Switch 工具（推荐）：请参考 CC Switch 配置教程安装 CC-Switch

安装 Node.js

CodeX 需要通过 npm 安装，因此必须先安装 Node.js。

⊞ Windows

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

访问 https://nodejs.org
下载 LTS 版本的 Windows Installer (.msi)
运行安装程序，按默认设置完成安装
安装程序会自动添加到 PATH 环境变量

方法二：使用包管理器

使用 Winget（Windows 11 或 Windows 10 自带）：

powershell

winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

powershell

choco install nodejs-lts

使用 Scoop：

powershell

scoop install nodejs-lts

🍎 macOS

方法一：使用 Homebrew（推荐）

如果尚未安装 Homebrew：

bash

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

使用 Homebrew 安装 Node.js：

bash

brew install node

方法二：使用官方安装包

访问 https://nodejs.org
下载 LTS 版本的 macOS Installer (.pkg)
运行安装程序，按默认设置完成安装

🐧 Linux

Ubuntu/Debian：

bash

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

bash

sudo dnf install nodejs npm
# 或者
sudo yum install nodejs npm

Arch Linux：

bash

sudo pacman -S nodejs npm

验证安装

bash

node --version
npm --version

提示

建议使用 LTS（长期支持）版本以获得最佳稳定性。安装完成后需重启命令行窗口。

获取 CodeX 专用令牌

重要提示

CodeX 和 Claude Code 使用不同的令牌分组，两者不通用！请务必选择 CodeX 对应的令牌分组。

访问 VBCode.io API 控制台进行以下操作：

点击「添加令牌」
名称：随便填写方便自己区分即可
令牌分组：根据实际需要选择，分组有详细描述（必填项，不能留空）
额度建议：设置为无限额度
其他选项保持默认

创建成功后，复制令牌备用。

方式一：使用 CC-Switch 快速配置（推荐）

1. 全局安装 CodeX

bash

npm install -g @openai/codex@latest
codex --version

2. 使用 CC-Switch 配置

启动 CC-Switch，切换到 Codex 标签
点击「+」按钮添加新配置
填写提供商信息：
- 提供商名称：自定义（如「VBCode」）
- Base URL：https://www.vbcode.io/v1
- API Key：粘贴上一步获取的 CodeX 专用令牌
- Model：gpt-5-codex
保存并启用配置

提示

也可以在 VBCode.io 控制台的令牌管理中，使用一键导入功能将配置自动导入到 CC-Switch。

3. 验证配置

bash

mkdir my-codex-project
cd my-codex-project
codex

输入任意问题，如果能正常收到回复，说明配置成功。

方式二：手动命令行配置

Windows 平台

1. 安装 CodeX CLI

powershell

npm install -g @openai/codex@latest
codex --version

2. 创建配置目录

powershell

mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex

3. 创建配置文件

在 %USERPROFILE%\.codex\ 目录下创建 config.toml 文件，内容如下：

toml

model_provider = "VBCode"
model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "danger-full-access"
collaboration_mode = true
model_supports_reasoning_summaries = true

[model_providers.VBCode]
name = "vbcode"
base_url = "https://www.vbcode.io/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
shell_snapshot = true
collab = false

4. 创建认证文件

在同一目录下创建 auth.json 文件：

重要提示

请将下方的 API Key 替换为您在获取令牌步骤中复制的 CodeX 专用令牌！

json

{
  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
}

5. 初始化工作空间

powershell

mkdir my-codex-project
cd my-codex-project
codex

macOS / Linux 平台

1. 安装 CodeX CLI

bash

npm install -g @openai/codex@latest
codex --version

2. 创建配置目录

bash

mkdir -p ~/.codex
cd ~/.codex

3. 创建配置文件

在 ~/.codex/ 目录下创建 config.toml 文件，内容如下：

toml

model_provider = "VBCode"
model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "danger-full-access"
collaboration_mode = true
model_supports_reasoning_summaries = true

[model_providers.VBCode]
name = "vbcode"
base_url = "https://www.vbcode.io/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
shell_snapshot = true
collab = false

4. 创建认证文件

在同一目录下创建 auth.json 文件：

重要提示

请将下方的 API Key 替换为您在获取令牌步骤中复制的 CodeX 专用令牌！

json

{
  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
}

5. 初始化工作空间

bash

mkdir my-codex-project
cd my-codex-project
codex

常见问题

问题	解答
CodeX 和 Claude Code 的令牌通用吗？	不通用。Claude Code 使用 Claude 令牌组，CodeX 使用 CodeX 专用令牌组，请在 VBCode.io 控制台选择对应的令牌分组。
配置文件放在哪里？	Windows：`%USERPROFILE%\.codex\`；macOS / Linux：`~/.codex/`
API 请求失败怎么办？	检查 API Key 是否正确，Base URL 是否为 `https://www.vbcode.io/v1`，以及网络是否可以正常访问 vbcode.io
如何切换模型？	修改 `config.toml` 中的 `model` 字段即可，可用模型请查看 VBCode.io 模型广场

可用模型：访问 VBCode.io 模型广场查看所有可用模型。

CodeX 部署指南 ​

前置要求 ​

安装 Node.js ​

⊞ Windows ​

🍎 macOS ​

🐧 Linux ​

验证安装 ​

获取 CodeX 专用令牌 ​

方式一：使用 CC-Switch 快速配置（推荐） ​

1. 全局安装 CodeX ​

2. 使用 CC-Switch 配置 ​

3. 验证配置 ​

方式二：手动命令行配置 ​

Windows 平台 ​

1. 安装 CodeX CLI ​

2. 创建配置目录 ​

3. 创建配置文件 ​

4. 创建认证文件 ​

5. 初始化工作空间 ​

macOS / Linux 平台 ​

1. 安装 CodeX CLI ​

2. 创建配置目录 ​

3. 创建配置文件 ​

4. 创建认证文件 ​

5. 初始化工作空间 ​

常见问题 ​

CodeX 部署指南

前置要求

安装 Node.js

⊞ Windows

🍎 macOS

🐧 Linux

验证安装

获取 CodeX 专用令牌

方式一：使用 CC-Switch 快速配置（推荐）

1. 全局安装 CodeX

2. 使用 CC-Switch 配置

3. 验证配置

方式二：手动命令行配置

Windows 平台

1. 安装 CodeX CLI

2. 创建配置目录

3. 创建配置文件

4. 创建认证文件

5. 初始化工作空间

macOS / Linux 平台

1. 安装 CodeX CLI

2. 创建配置目录

3. 创建配置文件

4. 创建认证文件

5. 初始化工作空间

常见问题