Codex 部署指南
按电脑系统下载 CC Switch，填入贵数智能 API Key，再用 Codex CLI 验证第一条回复。
1. 下载并打开 CC Switch
CC Switch 用来填写 API 配置，Codex CLI 用来在终端里对话。先从下面选一个适合这台电脑的 CC Switch 4.0.25 安装包。
- Windows x64 · 下载 MSI 大多数 Intel、AMD 电脑选这个。双击下载的
.msi完成安装，从开始菜单打开 CC Switch。 - Windows ARM64 · 下载 MSI 打开「设置 → 系统 → 系统信息」，在「系统类型」看到 ARM 处理器时选这个。
- macOS · 下载 DMG Intel 和 Apple 芯片共用。双击
.dmg，把 CC Switch 拖入「应用程序」，再从那里打开。 - Linux · 选择安装包 展开 Assets，按
uname -m的结果选架构（aarch64对应arm64）。Ubuntu、Debian 选.deb，Fedora 选.rpm。
已经下到了别的文件？ v3.12.2-en.md 是版本说明。若解压后只看到 CC-SWITC.14，直接用上面的系统安装包，无需改扩展名。其他版本可在官方发布页查看。
2. 安装 Codex CLI
在 Windows 打开「命令提示符」，在 macOS 或 Linux 打开「终端」。已有 Codex 的读者运行 codex --version，看到版本号即可跳到第 3 步。
首次安装请先装好 Node.js LTS，重新打开终端，依次运行下面两行。第二行应显示 codex-cli 和版本号。
npm install -g @openai/codex@latest
codex --version3. 在 CC Switch 填写贵数智能配置
在左侧选 Codex，打开 直连 标签，点 添加供应商（+），在「全部」里选 自定义配置。
| 界面字段 | 填什么 |
|---|---|
| 供应商名称 | 填「贵数智能」，方便稍后在列表里找到。 |
| API 请求地址 | https://api.llm-token.cn/v1，保留末尾的 /v1。 |
| API Key | 粘贴你在贵数智能获取的完整 API Key。 |
| 默认模型 | 从模型列表复制该 Key 可用且支持 Responses 的模型 ID，例如 gpt-6.1-terra。 |
点页面底部的 添加。回到「直连」列表，在「贵数智能」卡片上点 切换。如果之前使用路由或聚合，按钮会显示「回到直连并使用」。看到卡片标有 使用中 就可以打开 Codex。
4. 在终端验证第一条回复
退出已打开的 Codex，在终端进入你的项目目录，运行 codex。如果还没有项目，可以新建一个空目录：
mkdir my-codex-project
cd my-codex-project
codex在 Codex 里输入「只回复 OK」。收到回复就说明这次请求已完成。测试会使用该 Key 的额度。
没有收到回复？ 遇到 401，重新粘贴 API Key 并检查是否已启用。遇到模型不可用，核对默认模型 ID 和该 Key 的访问权限。若报找不到接口，检查请求地址是否以 /v1 结尾，并在高级选项确认「上游格式」为 OpenAI Responses。
可选：手动填写配置文件
已经通过 CC Switch 收到回复的读者到这里就完成了。想手动配置，可在 Windows 的 %USERPROFILE%\.codex\ 或 macOS、Linux 的 ~/.codex/ 中编辑以下两个文件。目录不存在时先创建，已有配置请先备份并保留其他设置。
config.toml 填入供应商、地址和该 Key 可用的模型。
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json 将示例值换成你的贵数智能 API Key，保存后按第 4 步重新打开 Codex。
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}