这条路线解决什么
Cockpit Tools 是本地账号管理和本地 API 服务，属于上游；CC Switch 和 Codex++ 是客户端侧配置，属于下游。先完成账号导入和 API 服务启动，再配置 CC Switch 或 Codex++，不能把下游配置放在账号导入前。
Cockpit 共同步骤
- 打开 Cockpit Tools。
- 左侧选择 Codex。
- 点击右上角 +。
- 根据交付选择：OAuth 授权、Token / JSON、API Key 或导入。
- 检查账号邮箱、套餐和额度。
- 把目标账号加入 Cockpit API 服务账号池。
- 启动本地 API 服务。
- 创建或复制客户端 Key。
- 复制 Base URL，以你当前 Cockpit API 服务页面显示的地址为准。
- 先通过模型列表或最小请求确认服务可用。
- 再进入 CC Switch 或 Codex++。
完整链路
上游负责账号与 API，下游客户端负责把接口配置给 Codex。
- OpenAI 账号或 JSON
- Cockpit 本地账号池
- CC Switch / Codex++
- Codex
适合哪些用户
- 个人电脑、单机用户
- 有多个 OpenAI 账号需要本地管理的用户
- 收到 JSON、OAuth 或 API Key 交付后需要导入 Cockpit 的用户
开始前准备
- 已安装 Cockpit Tools，且安装来源为项目官方 Release。
- 已确认账号、套餐或席位可用。
- 若收到 JSON，可先使用 /tools/json-to-cockpit 完成本地转换。
- 本地端口未被占用，且用户知道真实 Base URL 和客户端 Key。
方案 A：Cockpit → CC Switch → Codex
CC Switch 负责供应商配置、切换和本地路由，消费 Cockpit 提供的 Base URL 与客户端 Key。
把 Cockpit 接口配置到 CC Switch
从 Cockpit 复制 Base URL 与客户端 Key 后，再按顺序配置 CC Switch。以你当前版本界面实际显示的 Base URL、客户端 Key、模型列表和字段名称为准，不要按本文示例端口或旧版字段硬编码。
先把非 Cockpit JSON 转换成 Cockpit 格式（如适用）
如果商家交付的是 CPA、Sub2 或其他非 Cockpit JSON，先在浏览器本地打开站内转换工具，下载转换后的 Cockpit JSON；没有收到 JSON 时直接跳过。
完成标志：需要转换的文件已转换为 Cockpit JSON，且转换页只在本机处理文件。
卡住了：转换只改变文件结构，不会修复过期令牌或缺失字段；转换失败时先查看跳过原因，再联系原商家。
从官方 Release 安装 CC Switch
只从 farion1231/cc-switch 的 GitHub Releases 页面下载对应系统版本。
完成标志：CC Switch 安装完成。
打开 Codex 面板
在 CC Switch 中打开 Codex 面板，准备添加自定义供应商。
完成标志：你已进入 Codex 供应商管理界面。
添加自定义供应商
点击添加自定义供应商，填写供应商名称。
完成标志：新供应商卡片已创建。
填入 Cockpit Base URL
粘贴从 Cockpit API 服务页面复制的 Base URL。正文不硬编码端口，以你当前 Cockpit 页面显示的地址为准。
完成标志：Base URL 已填写，路径是否包含 /v1 以当前页面为准。
填入 Cockpit 客户端 Key
粘贴 Cockpit 生成的客户端 Key，不要把真实 Key 发到公开渠道。
完成标志：客户端 Key 已保存到本机配置。
卡住了：Key 丢失时回到 Cockpit 重新创建或复制，不要在旧截图里找。
选择协议
协议按 Cockpit 当前接口选择，Codex 通常使用 Responses。
完成标志：协议与上游当前接口一致。
填写模型名
模型名优先读取 /v1/models 或 Cockpit 当前模型列表，不要使用旧教程的固定值。
完成标志：模型名来自当前可用列表。
启用供应商
把该供应商设为启用状态。
完成标志：供应商已启用。
重启 Codex CLI / Desktop
重启 Codex CLI 或 Codex Desktop，使配置和模型目录重新加载。
完成标志：Codex 已加载新供应商配置。
执行最小测试
发送一个最小请求，确认 Cockpit 日志或用量出现记录。
完成标志：最小请求成功，且上游出现对应记录。
知道如何切回 OpenAI Official
确认 CC Switch 中切换回 OpenAI Official 的方法，并记录当前配置。
- 若当前 CC Switch 版本提供“保留官方登录”或“Codex App 增强”选项，只有需要同时保留官方插件/远程能力时才开启。
- 不要假设所有版本的开关名称和默认值相同。
完成标志：关闭第三方路线后可恢复官方配置。
方案 B：Cockpit → Codex++ → Codex Desktop
Codex++ 固定指 BigPizzaV3/CodexPlusPlus，通过中转注入把 Codex Desktop 请求指向 Cockpit 的 Base URL 与客户端 Key。
把 Cockpit 接口配置到 Codex++
必须从 Codex++ 启动入口启动 Codex，相关增强和中转配置才会生效。
先把非 Cockpit JSON 转换成 Cockpit 格式（如适用）
如果商家交付的是 CPA、Sub2 或其他非 Cockpit JSON，先在浏览器本地打开站内转换工具，下载转换后的 Cockpit JSON；没有收到 JSON 时直接跳过。
完成标志：需要转换的文件已转换为 Cockpit JSON，且转换页只在本机处理文件。
卡住了：转换只改变文件结构，不会修复过期令牌或缺失字段；转换失败时先查看跳过原因，再联系原商家。
确认项目来源
Codex++ 固定使用 BigPizzaV3/CodexPlusPlus，从官方仓库或官方 Release 获取。
完成标志：你已确认使用正确的项目，而不是同名 loader 项目。
安装官方 Codex Desktop
先从 OpenAI 官方渠道安装 Codex Desktop。
完成标志：官方 Codex Desktop 已安装。
安装 Codex++ 对应系统版本
按操作系统和架构选择 Codex++ 对应版本完成安装。
完成标志：Codex++ 安装完成，可打开 Codex++ Manager。
打开 Codex++ Manager
启动 Codex++ Manager，进入中转注入或供应商配置。
完成标志：你已进入配置界面。
填写 Cockpit Base URL 与客户端 Key
粘贴 Cockpit API 服务页面显示的 Base URL 与客户端 Key，字段名称以当前版本为准。
完成标志：配置已填写，没有使用固定端口或旧字段名。
选择上游协议
按 Cockpit 当前接口选择协议，然后应用配置。
- 选择上游协议：上游原生支持 Responses API 时选择 Responses；上游只支持 Chat Completions 时选择 Chat Completions，由 Codex++ 的本地协议代理转换为 Responses。具体名称以当前 Codex++ 版本界面为准。
完成标志：协议与上游接口一致，具体名称以当前 Codex++ 版本界面为准。
应用配置
保存并应用中转注入配置。
完成标志：配置已生效并等待重启。
退出已经运行的 Codex
完全退出当前运行的 Codex，避免旧进程继续占用配置。
完成标志：没有正在运行的旧 Codex 进程。
通过 Codex++ 启动 Codex
必须使用 Codex++ 的启动入口重新启动 Codex，不要用普通桌面快捷方式。
完成标志：Codex 已通过 Codex++ 启动，注入配置生效。
执行最小请求
发送一个最小请求，确认 Cockpit 日志或用量出现记录。
完成标志：最小请求成功，且上游出现对应记录。
准备回滚
按版本说明清除 API 模式或中转注入，恢复官方线路。
完成标志：你知道如何恢复官方配置。
如何确认成功
- Cockpit 账号状态正常。
- API 服务在运行。
- Base URL 可访问。
- Key 未被公开。
- /v1/models 或模型列表正常。
- Codex 请求出现在 Cockpit 日志或用量中。
- 实际扣减的是目标账号或账号池额度。
- 关闭第三方路线后可恢复官方配置。
常见错误
| 问题 | 可能原因 | 处理动作 |
|---|---|---|
| API 服务没有启动 | 账号池为空或服务状态未运行。 | 回到 Cockpit API 服务页面确认账号已加入并启动服务。 |
| 填入 Base URL 后请求失败 | 端口或 /v1 路径来自旧教程。 | 以 Cockpit 当前 API 服务页面显示的地址为准，不要硬编码端口。 |
| 客户端 Key 无效 | 复制了账号 Token 而不是客户端 Key。 | 在 Cockpit 中创建或复制客户端 Key，只把 Key 给本机客户端。 |
| 模型列表为空 | 账号池中没有可用账号或账号被限制。 | 检查账号状态、套餐、额度和筛选条件。 |
- 问题
- API 服务没有启动
- 可能原因
- 账号池为空或服务状态未运行。
- 处理动作
- 回到 Cockpit API 服务页面确认账号已加入并启动服务。
- 问题
- 填入 Base URL 后请求失败
- 可能原因
- 端口或 /v1 路径来自旧教程。
- 处理动作
- 以 Cockpit 当前 API 服务页面显示的地址为准，不要硬编码端口。
- 问题
- 客户端 Key 无效
- 可能原因
- 复制了账号 Token 而不是客户端 Key。
- 处理动作
- 在 Cockpit 中创建或复制客户端 Key，只把 Key 给本机客户端。
- 问题
- 模型列表为空
- 可能原因
- 账号池中没有可用账号或账号被限制。
- 处理动作
- 检查账号状态、套餐、额度和筛选条件。
安全与隐私
常见问题
Cockpit 和 CC Switch 是同一个工具吗？
不是。Cockpit 是本地账号池和 API 服务（上游），CC Switch 是客户端供应商切换（下游），两者职责不同。
端口必须使用 12178 吗？
不一定。正文不硬编码永久端口，以你当前 Cockpit API 服务页面显示的地址为准。
收到的 JSON 不是 Cockpit 格式怎么办？
先使用本站 /tools/json-to-cockpit 在浏览器本地完成转换，再导入 Cockpit；不要把原文件交给陌生人。
本地 API 服务会公开我的账号吗？
Cockpit 是本地工具，但仍要保管好 Base URL 与客户端 Key；不要把本地地址和 Key 上传到公开渠道。