需要一个可登录的 Sub2API 账号。不要在截图、聊天或工单中公开完整 API Key。
安装 CCSwitch 与桌面版 Codex
CCSwitch 用来管理 Codex 的供应商配置。先安装并打开 CCSwitch，再安装桌面版 Codex。
- 打开 CCSwitch Latest Release。
- Windows 下载当前版本的
.msi，macOS 下载对应架构的.dmg。 - 从 OpenAI Codex App 页面安装桌面版 Codex。
- 打开 CCSwitch，确认顶部能够切换到 Codex 页面。
教程不固定写死版本号。始终选择带 Latest 标记的稳定版本，并核对发布者或仓库地址。
在 Sub2API 创建 Codex 专用 API Key
- 访问 Sub2API 控制台并登录。
- 在左侧菜单进入“API 密钥”。
- 点击右上角“创建密钥”。
- 名称建议填写
ccswitch-codex，便于识别用途。 - 选择你实际可用的 Codex 分组，再完成创建。
不要把完整 Key 写进教程截图。需要演示时只保留前缀并遮挡后续字符。
点击“导入到 CCS”
在 API 密钥列表右侧点击“导入到 CCS”。浏览器会尝试唤起 CCSwitch，确认后将供应商配置写入本机。
- 浏览器询问是否打开 CCSwitch 时，选择允许。
- 在 CCSwitch 的 Codex 页面确认出现新的 Sub2API 供应商。
- 选中新供应商并启用，避免仍使用旧配置。
如果浏览器没有反应，先确认 CCSwitch 已安装并运行，再重试一次。仍无法唤起时，使用下方的手动配置。
打开 Codex 并发送最小测试
- 完全退出并重新打开桌面版 Codex，使新的供应商配置生效。
- 选择一个空文件夹或现有项目。
- 在输入框发送：
请只回复 sub2api-ok。 - 收到正常回复后，再在输入区右下角切换模型和推理强度。
不要一开始就切换多个模型。默认请求成功后，再逐个检查目标模型，可更快定位分组或模型权限问题。
在 CCSwitch 手动添加供应商
打开 CCSwitch 顶部的 Codex 标签，点击右上角 +，按下表填写。
| 供应商名称 | Sub2API BImage |
|---|---|
| API Key | 粘贴刚创建的 sk-... 密钥 |
| 请求地址 | https://sub2api.bimage-sysu.com/ |
| 应用页面 | Codex |
供应商名称：Sub2API BImage 请求地址：https://sub2api.bimage-sysu.com/ 应用页面：Codex
CCSwitch 的“请求地址”按上表填写根地址。只有当其他客户端明确要求“OpenAI Base URL”时，才填写 https://sub2api.bimage-sysu.com/v1。
用接口检查 Key 是否有效
如果 Codex 报错，可先在 PowerShell 中读取模型列表。把占位符替换成自己的 Key；命令历史可能保存密钥，测试完成后请清理或改用临时终端。
curl.exe https://sub2api.bimage-sysu.com/v1/models ` -H "Authorization: Bearer sk-请替换为你的密钥"
返回 JSON 模型列表说明域名和 Key 基本可用。返回 401 通常是 Key 错误或已停用；返回 403 通常需要检查分组权限。
常见问题
点击“导入到 CCS”没有反应怎么办？
先启动 CCSwitch，再刷新 API 密钥页面重试。浏览器可能在地址栏附近提示“打开外部应用”，需要允许该操作。
供应商已出现，但 Codex 仍然使用旧配置？
确认 CCSwitch 中新供应商处于启用状态，然后完全退出并重新打开 Codex。必要时只保留一个启用的 Codex 供应商进行排查。
为什么模型列表和别人的不一样？
模型可用性由所选分组及后台配置决定。应以你的 Sub2API 分组和客户端实际返回为准，不要照搬其他站点的模型名称。