用 Cockpit Tools，快速切换 Codex 账号

适合在自己有权使用的多个 Codex 账号之间切换，省去反复退出和重新登录的操作。

1. 先理解使用顺序

   首次使用：安装工具，逐个添加账号并完成浏览器授权。之后切换：在账号列表选目标账号，点击切换并启动，再回 Codex 核对。

2. 准备好现有账号和客户端

   确认自己能正常登录每个账号，电脑上已有 Codex 客户端。切换前保存文件，等待当前任务结束。

3. 认识工具管理的内容

   Cockpit Tools 是第三方账号管理工具，会在本机管理登录状态。切换账号不会把一个账号的订阅、额度或云端数据转给另一个账号。

以 Windows 为例，选择自己方便的安装位置。已经安装好工具，可以直接进入下一步。

1. 方式一：自己从发布页下载

   打开项目的 GitHub Releases，选择适合系统与架构的安装包。Windows 普通安装可选 .msi 或 .exe；便携包可选 x64-portable.zip，解压到自己的目录后运行主程序。不要把 Source code 源码压缩包当成安装包。

2. 方式二：让 Codex 协助安装

   把下面的请求发给本机可操作文件的 Codex。F:\cockpit-tools 只是示例路径；没有 F 盘就改成实际存在的磁盘。安装完成后，自己接手登录授权。

3. 确认工具能打开

   启动 Cockpit Tools。安装目录不等于账号数据目录，移动便携程序文件夹也不等于迁移账号配置。Windows 缺少 WebView2 时，按安装提示补齐运行环境。

帮我从项目发布页 https://github.com/jlcodes99/cockpit-tools/releases/latest 安装 Cockpit Tools 到 F:\cockpit-tools。先检查我的 Windows 架构与目录，选择匹配的官方发布安装包或便携包；核对来源，若发布页提供 SHA256 则核对校验值。不要使用第三方下载站，不要覆盖已有账号配置。安装后确认程序能启动，然后停止，把添加账号和浏览器登录授权交给我操作。

每个准备切换的账号都要先添加。添加账号与切换账号是不同的操作。

1. 打开左侧 Codex

   进入 Cockpit Tools 后，点击左侧「Codex」。先确认正在管理 Codex，避免添加到其他平台。

2. 点击账号列表工具栏的「+」

   图中的加号在右侧工具栏。点击后会出现「添加 Codex 账号」窗口。

3. 选择 OAuth 授权

   窗口中有 OAuth 授权、Token / JSON、API Key 等选项。本篇按原帖走 OAuth 授权，不需要把 Token 或账号文件复制到本站。

优先按原帖使用 OAuth 授权。账号登录、验证码及确认授权，由你在自己的电脑上完成。

1. 点击「在浏览器中打开」

   保持工具里的 OAuth 授权页面打开，点击蓝色按钮。浏览器会进入登录或账号选择界面。

2. 确认这次要添加的账号

   浏览器可能自动选中上次登录的账户。若不是目标账号，点击「登录至另一个账户」，再按页面提示登录并确认授权。

3. 回到工具，检查账号卡片

   授权完成后切回 Cockpit Tools，等待账号出现在列表。核对邮箱、账号标识与套餐；确认无误后，再为另一个账号重复添加流程。

4. 没有自动回到工具时

   如果浏览器没有弹出，可用工具内的复制按钮，把本次生成的授权链接粘贴到浏览器打开。网页授权后仍未完成时，再按窗口的「手动输入回调地址」「我已授权，继续」提示处理；只在自己的工具窗口粘贴。

先保存当前文件，等待正在运行的任务结束，再开始切换；启动过程可能重启 Codex。

1. 确认当前工作已保存

   先结束正在运行的任务，保存代码与文档。切换可能停止或重启客户端，避免在任务执行到一半时操作。

2. 在目标账号卡片上点「切换」

   找到这次准备使用的账号。卡片底部的三角按钮悬停后显示「切换」，点击打开 Codex 启动预览。

3. 核对账号和目标实例

   预览上方会显示目标账号与实例。普通单客户端使用先保持默认实例，确认不是另一张账号卡片后再继续。

4. 点击右下角「切换并启动」

   点击后等待程序执行。左边单独的「切换」只做切换操作；跟着本篇使用右边「切换并启动」，让工具一起启动 Codex。

工具提示成功后，再从 Codex 自身的账号菜单核对邮箱或账户信息。

1. 等待实例启动完成

   看到「实例启动完成」或进度到 100% 后，检查配置写入与客户端启动步骤。还在加载时不要连续重复点击。

2. 到 Codex 菜单核对真实账号

   打开启动后的 Codex，进入账号菜单，检查邮箱或账户信息是否与目标账号一致。有多个窗口时，核对刚启动的那个窗口。

3. 做一次小任务验证

   发一条简单的问题，确认客户端能正常回复。套餐与用量以当前账号实际显示为准，工具的缓存显示不能替代客户端核对。

4. 仍是原账号时

   先排除看错窗口，再检查工具预览的目标实例和应用路径。自定义安装目录或 CODEX_HOME 时要指向同一实例；必要时更新工具，再重新授权对应账号。

首次授权完成后，日常只需选目标账号并切换。授权失效时，再为对应账号重新登录。

1. 下次从账号卡片直接切换

   已经授权的账号无需每次重新添加。选目标账号，点击切换，再点击切换并启动；授权失效时才重新登录该账号。

2. 给账号加清楚的备注

   可按个人、工作或用途标记，帮助自己识别账号。截图里显示的套餐和百分比只代表小佛爷当时的状态。

3. 遇到更新，先查看项目说明

   界面和支持平台会变化。Claude、Antigravity 等各有自己的登录流程，本篇只演示 Codex，不把所有平台都套成相同操作。

4. 需要求助时，只分享排查信息

   带上工具版本、当前步骤与报错，遮挡邮箱、用户 ID、授权地址和 Token。auth.json 应像密码一样保管，不要贴进群聊或公开仓库。