用 CC-Switch 配置 Codex · 接入中转站

## 用 CC-Switch 配置 Codex · 接入中转站
## 一、这篇解决什么问题

CC-Switch 是用来管理 AI 编程工具接入配置的桌面工具，Codex 是它支持得最完整的客户端之一。这篇讲**只用 CC-Switch 给 Codex 换接入地址**这一件事：从建令牌、加供应商、启用，到三种客户端各自怎么验证。

它和另外两篇的分工：

| 文档                    | 场景                                        |
| --------------------- | ----------------------------------------- |
| 本篇                    | 用 CC-Switch 图形界面管 Codex（推荐，配置可视化、可一键切回官方） |
| 《Codex CLI 与插件配置教程》   | 不装任何管理工具，手写 `~/.codex/config.toml`        |
| 《CC-Switch 下载安装与入门教程》 | 还没装 CC-Switch，先看安装与整体功能                   |

**两条路二选一**：本篇第二步（一键导入）和第三步（手动添加）是两条并行路径，任选其一即可，不需要都做。

## 二、准备

- CC-Switch 已安装并能正常打开；
- 本机已装三者之一：**ChatGPT 桌面版**、**VS Code 的 Codex 插件**、或 **Codex CLI**；
- 站内已有一枚 **CODEX 分组**的令牌（下一步建）。

> 说明：这三类客户端读的是同一份 `~/.codex/` 配置，所以配一次就够了，不用分别为插件和 CLI 各配一遍。

## 三、第一步：创建 CODEX 分组令牌

**1. 打开控制台的「令牌管理」**，点新建。

**2. 名称随便填**（例如 `codex`），**令牌分组选 `默认即可`**。

**3. 模型限制列表留空**。这是本篇最容易踩的一处：如果填了模型、而列表里恰好不包含 Codex 实际请求的模型，请求会直接返回 **403**——不是 Key 错，也不是余额问题，只是"这枚令牌不允许用这个模型"。

**4. 提交后回到列表，在「密钥」列表复制**，拿到完整 Key（形如 `sk-...`）。

## 四、第二步（捷径）：一键导入

控制台已支持从令牌直接导入 CC-Switch，能省掉后面所有手填。

该功能重开发中暂停使用

## 五、第三步（手动）：在 CC-Switch 里添加供应商

### 5.1 打开 Codex 页

打开 CC-Switch，左侧栏点 **Codex**：

![](/uploads/editor/20261101/img_6ae6394a2aa003.54785237.png)

进入后点右上角 **「+」添加供应商**：

![](/uploads/editor/20261101/img_6ae63952e0af68.45874598.png)

### 5.2 选预设

添加页顶部有两个标签：**Codex 供应商 / 统一供应商**，这里停在「Codex 供应商」。下方是预设列表，第一项是 **「自定义配置」**，其余是各家服务商的预设。

**1. 推荐做法：点「自定义配置」**，所有字段自己填，地址不会被预设带偏。

**2. 也可以选预设再改地址**：列表里有一个近似的预设，选它之后**必须手动把「API 请求地址」改成新地址**——预设里存的是老域名，不会自动跟着变。

### 5.3 填四个字段

选完预设后，页面下半部分是表单。真正需要确认的只有两项，其余保持默认：

| 字段           | 填什么                                         |
| ------------ | ------------------------------------------- |
| API Key      | 粘贴上一步复制的 CODEX 分组令牌                         |
| API 请求地址     | `https://api.zaimod.com/v1` —— **必须带 `/v1`** |
| 默认模型         | 例如 `gpt-5.5`，以控制台模型列表为准                     |
| 供应商名称 / 官网链接 | 仅用于显示，随意填                                   |

![](/uploads/editor/20261101/img_6ae639b2e5dbd3.88278670.png)

表单下方那行黄色提示写得很明确：**"填写兼容 OpenAI Response 格式的服务端点地址"**。Codex 用的是 Responses 协议，请求发往 `{地址}/responses`，所以地址里那截 `/v1` 不能省——写成纯域名会变成 `https://api.zaimod.com/responses`，直接 404。

### 5.4 高级选项：模型映射先留空

展开「高级选项」，会看到两组东西：

- **上游格式**：保持 `Responses（原生）`。这是"服务商本来就说 Responses 协议"的意思，不经过格式转换，最稳。
- **模型映射**：里面有两个按钮「获取模型列表」「添加模型」，作用是**生成 `model_catalog_json`，让 `/model` 命令里能显示这些第三方模型名**。

这里有一条原文没解释的禁令——**不要开模型映射，否则图片可能无法输入**。原因在表单自己那行小字里：映射表里的条目是**按你填写的内容原样保存**的。也就是说，映射条目不只写了模型名，还承载了该模型的能力声明；条目填得不全，Codex 就不知道这个模型支持图像输入，多模态请求自然就废了。

所以：

- **平时留空**，只填「默认模型」即可；
- 确实需要在 `/model` 里看到多家模型名时再开，并且**按控制台的真实模型 ID 精确填写**；
- 改完映射要**重启 Codex** 才会刷新模型列表（表单里写明了这一点）。

### 5.5 保存

确认无误点右下角 **「+ 添加」**。

## 六、第四步：启用

回到 Codex 供应商列表，新卡片右侧点 **「启用」**：

![](/uploads/editor/20261101/img_6ae639ebe2ef70.85203655.png)

启用后 CC-Switch 会把这张卡片的连接信息写进 Codex 配置目录 `~/.codex/`：

- `auth.json` 写入 Key（字段 `OPENAI_API_KEY`）；
- `config.toml` 写入 `model_providers` 段，大致长这样（段名取自你的卡片名）：

```json
{
  "OPENAI_API_KEY": "sk-你的令牌"
}
```

```toml
model = "gpt-5.5"
model_provider = "cxhao"

[model_providers.cxhao]
name = "cxhao"
base_url = "https://api.zaimod.com/v1"
wire_api = "responses"
requires_openai_auth = true
```

> 切换只替换连接相关的字段（地址、Key、模型）。你自己在这两个文件里加过的 `[mcp_servers]`、审批策略、注释都会保留——这是 CC-Switch 相对"整份覆盖"式工具的区别。
>
> **生效前提**：Codex CLI 要**重开终端**（或退出后台 daemon）；ChatGPT 桌面版要**完全退出再打开**（托盘里也退）。只切卡片不重启，看到的还是旧配置——这是"切了没反应"最常见的原因。

## 七、第五步：启动测试

三种客户端按你在用的选一种验证。

### 7.1 ChatGPT 桌面版

新建对话，发一句：

```console
你好
```

能正常返回即成功。

![](/uploads/editor/20261101/img_6ae63a033d3136.51271847.png)

### 7.2 VS Code 的 Codex 插件

打开 VS Code，在 Codex 面板发同一句，能正常返回即成功。

![](/uploads/editor/20261101/img_6ae63a0eeba8c8.32821815.png)

### 7.3 Codex CLI

终端里直接执行：

```bash
codex
```

能进入对话界面、并且能发请求收到回复即可。启动横幅里有三处值得对照：

```console
>_ OpenAI Codex (v0.137.0)
model:      gpt-5.5 medium     /model to change
directory:  ~
```

![](/uploads/editor/20261101/img_6ae63a1f410994.42630361.png)

- `model:` 后面应是你在 CC-Switch 里填的默认模型；
- 输入框上方的状态栏同样显示模型名（如 `gpt-5.5 medium · ~`）；
- `directory: ~` 说明是在用户主目录启动的——真正写代码前先 `cd` 进项目目录，否则 Codex 会把整个家目录当工作区。

**最硬的判据**还是站内控制台的「使用日志」：有没有出现刚发出的那条请求。界面显示正常但日志没记录，说明请求根本没走中转。

## 八、排错

### 8.1 提示 401 / 余额不足

Key 没复制全、令牌被禁用、或分组选错。检查「API Key」里是否残留空格或引号；确认这枚令牌的分组是 `CODEX`。

### 8.2 提示 403

八成是**模型限制列表**里填了模型、但没包含 Codex 正在请求的那个。把这枚令牌的模型限制清空（留空 = 支持全部模型）再试。

### 8.3 地址写得对不对

在 CC-Switch 里改完，直接打开 `~/.codex/config.toml` 看 `base_url`：

- `https://api.zaimod.com/v1` → 对；
- `https://api.zaimod.com`（少了 `/v1`）→ 会 404；
- 还是老域名 → 说明你选的是预设、但没改地址，或者改了没点保存。

### 8.4 改了配置没反应

按顺序查：卡片是否真的处于启用状态（高亮）；是否重开了终端 / 重开了 ChatGPT 桌面版；是否同时手改过 `~/.codex/config.toml`（手改会被下次切换覆盖）。

### 8.5 图片发不进去

就是 5.4 那条：模型映射开着、条目能力字段不全。把模型映射清空，只留默认模型。

### 8.6 想切回官方账号

在 Codex 供应商列表里选内置的 **OpenAI Official** 卡片点启用，重开终端后执行 `codex login` 重新登录即可。想切回来再选你的中转卡片，不用反复登录。

上一篇：CC-Switch 下载安装{else}上一篇：没有了下一篇：CC-Switch 配置 Claude Code{else}下一篇：没有了