这条路线解决什么
Cockpit 和 Sub2API 位于上游:Cockpit 负责本地账号管理与本地 API,Sub2API 负责服务器账号池与 API 分发。CC Switch 和 Codex++ 位于用户客户端侧:CC Switch 负责供应商配置切换与本地路由,Codex++ 负责 Codex Desktop 的外部启动与中转注入。两者通常是二选一,不要求同时安装。
推荐路线
- 你的情况
- 单机、个人、多账号
- 推荐路线
- Cockpit
- 你的情况
- 服务器、多设备、多用户
- 推荐路线
- Sub2API
- 你的情况
- 已经收到 Base URL + Key
- 推荐路线
- API endpoint
- 你的情况
- 只使用官方账号且不需要账号池
- 推荐路线
- 官方直接登录
- 你的情况
- 主要使用 Codex CLI
- 推荐路线
- 优先 CC Switch
- 你的情况
- 主要使用 Codex Desktop 且需要中转注入
- 推荐路线
- 优先 Codex++
接入前先确认四件事
- 账号套餐名称不等于必然拥有 Codex 权限,先到官方页面确认实际权限。
- API 额度商品和直接中转商品不需要先过 Cockpit;只有需要自己做账号池时才考虑 Sub2API。
- Team/K12/Business 席位可能被管理员移除,先确认组织策略和退出路径。
- 不把 Cookie、Token 或 Key 上传给本站或聊天机器人。
完整链路
上游负责账号与 API,下游客户端负责把接口配置给 Codex。
- OpenAI 商品
- 账号/API 服务层
- CC Switch 或 Codex++
- Codex
适合哪些用户
- 购买了 OpenAI 商品后需要真正接入 Codex 的用户
- 需要在本地账号池、服务器账号池和直接 API 之间选择路线的用户
- 需要同时理解 CC Switch 与 Codex++ 定位的用户
开始前准备
- 已确认账号、套餐、席位或 API 额度已经生效。
- 已知道自己收到的是账号、JSON、Base URL 还是 API Key。
- 已阅读 OpenAI 官方 Codex 文档,并接受第三方工具的凭证与条款风险。
个人本地路线:Cockpit 或直接 API → CC Switch → Codex
适合个人电脑、多账号或已有 Base URL + Key 的用户。CC Switch 只保存客户端供应商配置,不代替上游账号池。
通过 CC Switch 接入 Codex
先确认商品生效,再选择 Cockpit 或直接 API 作为上游,最后用 CC Switch 配置供应商。
确认商品已经生效
在 OpenAI 官方页面核对账号、套餐、席位或 API 额度状态;不要只凭商品标题判断。
完成标志:你已确认哪个账号或哪份额度可以使用。
卡住了:仍显示未生效时先联系原商家处理,不要继续配置第三方客户端。
选择上游并取得 Base URL 与 Key
个人电脑和多账号选择 Cockpit 本地账号池;已收到 Base URL + Key 的用户直接使用。
完成标志:你有一组可用的 Base URL 与对应 Key,且知道协议和模型名。
从官方 Release 安装 CC Switch
只从 farion1231/cc-switch 的 GitHub Releases 页面下载,不要使用陌生网盘或同名收费站点。
完成标志:CC Switch 安装完成,版本来源可追溯。
添加自定义供应商
打开 Codex 面板,添加自定义供应商,填入上游 Base URL 与客户端 Key;协议按上游当前接口选择,Codex 通常使用 Responses,模型名优先读取 /v1/models 或上游模型列表。
完成标志:供应商配置保存成功,Key 只填在客户端本机。
卡住了:不确定字段名称时,以当前 CC Switch 版本界面显示为准。
启用供应商并重启 Codex
启用该供应商后重启 Codex CLI / Desktop,使配置和模型目录重新加载。
完成标志:Codex 使用新供应商启动,没有继续走旧配置。
执行最小测试并可切回官方
发送一个最小请求,确认上游日志或用量出现记录;同时确认如何切回 OpenAI Official。
完成标志:最小请求成功,且你知道随时切回官方线路。
Cockpit、Sub2API 或直接 API → Codex++ → Codex Desktop
适合个人本地账号池、服务器账号池或直接 API 用户,需要 Codex Desktop 中转注入时使用。必须通过 Codex++ 启动入口启动 Codex,注入配置才会生效。
通过 Codex++ 接入 Codex Desktop
Codex++ 固定指 BigPizzaV3/CodexPlusPlus。先安装官方 Codex Desktop,再安装 Codex++,最后填写中转注入。
确认商品已经生效
在 OpenAI 官方页面核对账号、套餐、席位或 API 额度状态。
完成标志:你已确认上游可以正常使用。
选择上游并取得 Base URL 与用户 Key
个人电脑可以使用 Cockpit 本地 API 服务,服务器场景使用 Sub2API 的 HTTPS Base URL 与下游用户 Key;已有直接交付的 Base URL + Key 则直接使用。
完成标志:你有一组可用的 Base URL 与 Key,且知道协议和模型名。
安装官方 Codex Desktop
先从 OpenAI 官方渠道安装 Codex Desktop,再安装 Codex++ 对应系统版本。
完成标志:官方 Codex Desktop 与 Codex++ 都已安装。
打开 Codex++ Manager 配置中转注入
进入中转注入或供应商配置,填写 Base URL 与客户端 Key,然后选择上游协议并应用配置。
- 选择上游协议:上游原生支持 Responses API 时选择 Responses;上游只支持 Chat Completions 时选择 Chat Completions,由 Codex++ 的本地协议代理转换为 Responses。具体名称以当前 Codex++ 版本界面为准。
完成标志:配置已保存,但还没有启动 Codex。
卡住了:字段名称随版本变化时,以 Codex++ Manager 当前界面为准。
退出旧 Codex 并通过 Codex++ 启动
退出已经运行的 Codex,必须从 Codex++ 启动入口重新启动,不能继续用普通桌面快捷方式。
完成标志:Codex 通过 Codex++ 启动,注入配置生效。
执行最小请求并准备回滚
发送最小请求确认上游日志出现记录;之后按版本说明清除 API 模式或中转注入,恢复官方线路。
完成标志:最小请求成功,且你知道如何恢复官方线路。
如何确认成功
- 账号、套餐、席位或 API 额度已在官方页面确认生效。
- Cockpit/Sub2API 位于上游,CC Switch/Codex++ 位于客户端侧,两者没有混用。
- Base URL 与 Key 来自对应上游,且 Key 没有被公开。
- CC Switch 与 Codex++ 只选择了其中一条路线,没有同时开启冲突配置。
- 最小请求成功,并在上游日志或用量中看到记录。
- 关闭第三方路线后可以恢复官方配置。
常见错误
| 问题 | 可能原因 | 处理动作 |
|---|---|---|
| 配置后请求返回 401 | Key 错误、Key 未启用或选错了用户 Key。 | 回到上游管理端重新复制 Key,并检查上游日志中的认证结果。 |
| 请求返回 404 | Base URL 缺少 /v1 或协议路径不匹配。 | 以当前上游页面显示的地址为准,不要使用旧文档中的固定端口。 |
| 提示模型不存在 | 模型名来自旧教程或版本列表。 | 读取 /v1/models 或上游当前模型列表,再填回客户端。 |
| 套餐显示生效但 Codex 提示无权限 | 套餐名称不等于必然拥有 Codex 权限。 | 查看 OpenAI 官方 Codex 权限说明,并以官方账号页面为准。 |
- 问题
- 配置后请求返回 401
- 可能原因
- Key 错误、Key 未启用或选错了用户 Key。
- 处理动作
- 回到上游管理端重新复制 Key,并检查上游日志中的认证结果。
- 问题
- 请求返回 404
- 可能原因
- Base URL 缺少 /v1 或协议路径不匹配。
- 处理动作
- 以当前上游页面显示的地址为准,不要使用旧文档中的固定端口。
- 问题
- 提示模型不存在
- 可能原因
- 模型名来自旧教程或版本列表。
- 处理动作
- 读取 /v1/models 或上游当前模型列表,再填回客户端。
- 问题
- 套餐显示生效但 Codex 提示无权限
- 可能原因
- 套餐名称不等于必然拥有 Codex 权限。
- 处理动作
- 查看 OpenAI 官方 Codex 权限说明,并以官方账号页面为准。
安全与隐私
常见问题
必须同时安装 CC Switch 和 Codex++ 吗?
不需要。CC Switch 与 Codex++ 通常是二选一:主要用 Codex CLI 优先 CC Switch,主要用 Codex Desktop 且需要中转注入优先 Codex++。
账号显示 Plus 就一定能用 Codex 吗?
不一定。套餐名称不等于必然拥有 Codex 权限,必须看 OpenAI 官方账号页面和 Codex 权限说明。
API 额度商品需要先导入 Cockpit 吗?
不需要。API 额度商品和直接中转商品可以直接走“Base URL + API Key → CC Switch 或 Codex++”路线。
Team/K12 席位会被管理员撤销吗?
会。工作区管理员可以限制或移除席位,不要在第三方管理的工作区或未授权账号池中处理敏感信息。