反代教程
本教程介绍如何将已有的账号 JSON 转换为 Cockpit 可识别的格式，再导入 Codex 账号。账号较多时，还可以使用 Cockpit 的 API 服务统一调度，减少手动切换账号的次数。
准备工作
开始前确认已经准备好：
- 平台兑换后下载的账号 JSON 文件，常见来源格式为 CPA 或 sub2api；
- 已安装并至少启动过一次 Codex；
- 与当前系统和处理器架构匹配的 Cockpit 安装包。
Cockpit 的界面和功能会随版本更新。本文截图用于说明操作位置，按钮名称或布局与当前版本略有差异时，以软件实际界面为准。
一、转换 JSON 格式
不同工具使用的 JSON 结构并不完全相同。导入 Cockpit 前，先把已有文件转换为 Cockpit 格式。
- 打开 ChatGPT Session Converter。
- 在输出格式中选择 Cockpit。
- 点击 选择文件，导入一个或多个 JSON 文件。
- 确认转换结果后，点击 下载 JSON。
转换文件仍然是敏感凭据
转换完成后，把源文件和输出文件保存在可信设备中。用完后关闭共享、同步或临时上传渠道，避免会话凭据泄露。
二、下载并安装 Cockpit
- 打开 Cockpit Tools Releases。
- 根据操作系统和处理器架构选择安装包。例如，Windows 64 位通常选择名称中带有
x64-setup.exe的文件。 - 优先选择当前稳定版本；如果新版本出现兼容问题，再根据发布说明回退。
- 安装完成后启动 Cockpit，确认可以进入仪表盘。
三、导入 Codex 账号
1. 打开账号管理
在左侧导航中选择 Codex，进入账号总览，然后点击右上角的 加号。
2. 从本地文件导入
在“添加 Codex 账号”窗口中：
- 切换到 导入。
- 点击 从本地文件导入。
- 选择第一步转换后的 JSON 文件。需要导入多个账号时可以批量选择。
3. 配置 Codex 路径并启动
导入完成后，账号会显示在列表中。首次启动前进入 Cockpit 设置，确认 Codex 启动路径正确；无法确定路径时，可以先使用软件提供的自动检测或默认选择。
需要使用单个账号时，点击对应账号卡片底部的 启动按钮。
启动后仍提示登录
先检查 Codex 启动路径是否正确，并确认账号 JSON 已成功导入。如果单账号启动仍反复要求登录，可以改用下一节的 API 服务集中管理账号。
四、配置 API 服务
当账号较多时，逐个关闭 Codex、切换账号再重新启动会打断工作流。API 服务可以把多个已导入账号加入同一个服务，由 Cockpit 根据可用状态进行调度。
1. 添加服务成员
在 Codex 账号页面找到 API 服务卡片，点击卡片底部的 添加成员按钮。
2. 选择账号并保存
- 勾选要加入服务的账号，也可以使用全选。
- 如果需要包含 Free 账号，保持 限制 Free 账号使用未勾选。
- 点击 保存集合。
3. 启动 API 服务
保存后回到账号总览，在 API 服务卡片底部点击 启动。卡片显示“运行中”后，再通过 Cockpit 启动或连接 Codex。
API 服务卡片可能提供“标准”和“快速”等模式。模式可用性、实际速度和账号限制由 Cockpit 版本及账号状态决定，请以当前界面说明为准。
五、避免会话记录不可见
单账号模式和 API 服务会使用不同的启动与会话管理流程。确定一种工作方式后，尽量不要频繁来回切换，以免历史会话暂时不可见。
如果会话没有显示：
- 打开 Codex 账号页面顶部的 会话管理。
- 勾选需要恢复的会话；需要批量处理时可以全选。
- 点击 修复可见性，完成后刷新列表。
不要直接清理 .codex 目录
恢复会话可能在 %USERPROFILE%\.codex 中生成重复的本地记录。删除前先备份整个目录并退出 Codex；不了解文件用途时不要手动删除，以免永久丢失聊天记录。
完成检查
完成配置后逐项确认：
- JSON 已转换为 Cockpit 格式，并保存在可信设备中；
- Cockpit 已识别全部需要使用的 Codex 账号；
- Codex 启动路径正确，单账号或 API 服务可以正常启动；
- API 服务成员和 Free 账号限制符合实际需求；
- 历史会话可见，且本地
.codex目录已有备份。
如果界面与截图不同，先核对 Cockpit 版本和发布说明，再根据当前按钮名称完成对应操作。