这条路线解决什么
本路线不要求先导入 Cockpit，也不要求先部署 Sub2API。适用商品包括 openai-api-credit、chatgpt-access-service，以及明确交付中转地址和用户 Key 的商品。
接入前先确认五项信息
- Base URL：是否包含 /v1，以供应商交付为准。
- API Key：属于哪个下游用户，是否有有效期和额度。
- 支持的协议：Responses 或 OpenAI-compatible。
- 模型名：从 /v1/models 或供应商控制台读取。
- 额度与并发：避免超限后误判为客户端问题。
完整链路
上游负责账号与 API，下游客户端负责把接口配置给 Codex。
- Base URL + API Key
- CC Switch / Codex++
- Codex
适合哪些用户
- 已有 OpenAI API 额度的开发者
- 购买了直接交付中转地址和用户 Key 商品的用户
- 不需要账号池、只需要把接口配置给 Codex 的用户
开始前准备
- 已收到 Base URL、API Key、协议、模型名、额度和并发信息。
- 已确认 Key 只交给可信任的客户端。
- 已安装 Codex CLI 或 Codex Desktop。
方案 A：Base URL + Key → CC Switch → Codex
CC Switch 管理供应商配置和切换，适合主要使用 Codex CLI 或需要快速切换供应商的用户。
把 Base URL 与 Key 配置到 CC Switch
直接从官方 Release 安装 CC Switch，然后按顺序添加供应商。
从官方 Release 安装 CC Switch
只从 farion1231/cc-switch 的 GitHub Releases 页面下载。
完成标志：CC Switch 安装完成。
打开 Codex 面板并添加自定义供应商
在 CC Switch 中打开 Codex 面板，添加自定义供应商。
完成标志：新供应商卡片已创建。
填入 Base URL
粘贴供应商交付的 Base URL；是否包含 /v1 以供应商交付说明为准。
完成标志：Base URL 已填写。
填入 API Key
粘贴对应 Key，不要把 Key 发到公开渠道。
完成标志：Key 已保存到本机配置。
选择协议
选择 Responses 或 OpenAI-compatible，以供应商支持为准。
完成标志：协议与供应商一致。
填写模型名
模型名以 /v1/models 或供应商控制台为准。
完成标志：模型名来自当前可用列表。
启用供应商并重启 Codex
启用供应商后重启 Codex CLI / Desktop。
完成标志：Codex 已加载新供应商配置。
执行最小请求
发送一个最小请求，确认模型可用和额度扣减符合预期。
完成标志：最小请求成功。
知道如何切回官方
确认 CC Switch 中切换回 OpenAI Official 的方法。
完成标志：你知道如何恢复官方配置。
方案 B：Base URL + Key → Codex++ → Codex Desktop
Codex++ 固定指 BigPizzaV3/CodexPlusPlus，适合 Codex Desktop 中转注入；必须通过 Codex++ 启动入口启动。
把 Base URL 与 Key 配置到 Codex++
先安装官方 Codex Desktop，再安装 Codex++，最后在中转注入中填写配置。
安装官方 Codex Desktop 与 Codex++
先安装官方 Codex Desktop，再按系统版本安装 Codex++。
完成标志：两个程序都已安装。
打开 Codex++ Manager
启动 Codex++ Manager，进入中转注入或供应商配置。
完成标志：你已进入配置界面。
填写 Base URL 与 API Key
粘贴供应商交付的 Base URL 与对应 Key。
完成标志：配置已填写。
选择上游协议并应用配置
按供应商支持的协议选择并应用配置。
- 选择上游协议：上游原生支持 Responses API 时选择 Responses；上游只支持 Chat Completions 时选择 Chat Completions，由 Codex++ 的本地协议代理转换为 Responses。具体名称以当前 Codex++ 版本界面为准。
完成标志：配置已保存。
退出旧 Codex 并通过 Codex++ 启动
退出已经运行的 Codex，从 Codex++ 启动入口重新启动。
完成标志：Codex 已通过 Codex++ 启动，注入配置生效。
执行最小请求
发送最小请求，确认模型和额度正常。
完成标志：最小请求成功。
清除 API 模式恢复官方
按版本说明清除 API 模式或中转注入，恢复官方线路。
完成标志：你已知道如何回滚。
如何确认成功
- 最小请求成功，模型响应符合预期。
- 模型列表可读取。
- 额度或扣量记录与供应商说明一致。
- Key 未写入公开仓库、前端代码或截图。
- 关闭第三方路线后可恢复官方配置。
常见错误
| 问题 | 可能原因 | 处理动作 |
|---|---|---|
| 401 Unauthorized | API Key 错误、过期或不属于该端点。 | 先检查 Key，回到供应商控制台重新复制或重新签发。 |
| 404 Not Found | Base URL 路径或协议不匹配。 | 检查路径是否包含 /v1，并核对 Responses / OpenAI-compatible 协议。 |
| 模型不存在 | 模型名来自旧文档。 | 读取 /v1/models 或供应商控制台，填写当前模型名。 |
| 触发额度或并发限制 | 超出供应商设定的额度与并发。 | 查看供应商控制台的额度、并发和错误码，不要误判为客户端问题。 |
- 问题
- 401 Unauthorized
- 可能原因
- API Key 错误、过期或不属于该端点。
- 处理动作
- 先检查 Key，回到供应商控制台重新复制或重新签发。
- 问题
- 404 Not Found
- 可能原因
- Base URL 路径或协议不匹配。
- 处理动作
- 检查路径是否包含 /v1，并核对 Responses / OpenAI-compatible 协议。
- 问题
- 模型不存在
- 可能原因
- 模型名来自旧文档。
- 处理动作
- 读取 /v1/models 或供应商控制台，填写当前模型名。
- 问题
- 触发额度或并发限制
- 可能原因
- 超出供应商设定的额度与并发。
- 处理动作
- 查看供应商控制台的额度、并发和错误码，不要误判为客户端问题。
安全与隐私
常见问题
使用这个路线需要先安装 Cockpit 吗？
不需要。已经有 Base URL + API Key 时，直接通过 CC Switch 或 Codex++ 配置给 Codex 即可。
Base URL 一定要带 /v1 吗？
以供应商交付说明为准。有的供应商自带 /v1，有的需要手动加上，不要按旧教程硬编码。
API Key 可以写进前端代码吗？
不可以。Key 只应保存在可信任客户端或密钥管理环境中，不能进入公开仓库、前端代码或截图。
第三方中转稳定吗？
不承诺稳定、永久或不会封号。中转服务可能受平台条款、组织政策、地区、网络环境和风控限制。