shx2005 / codex-account-switcher

# Codex Account Switcher
你是否厌倦了 Codex 多个账号之间来回切换？
用 `codex-account` 给账号起个名字，一条命令查看额度、保存登录、切换账号。账号留在本机，登录交给官方 Codex CLI。
**简体中文** | English
 [code] 
## 项目特性
- **命名账号管理**：保存 ChatGPT OAuth 或 OpenAI API key 登录，标记当前账号，默认脱敏邮箱。
- **跨设备迁移**：导出当前、指定或全部存档账号，在自己的另一台电脑导入，支持改名和冲突检查。
- **官方登录流程**：浏览器授权、设备码、API key 输入和 token 续期由本机官方 `codex` 处理。
- **独立添加账号**：新账号在临时目录登录，成功后保存，不打断当前登录。
- **实时额度查询**：查看当前、指定或全部存档账号的窗口用量、剩余比例、重置时间和服务返回的 Credits。
- **查询无需模型请求**：通过官方 `codex app-server` 查询，不创建对话或发起模型推理。
- **切换保留备份**：同步较新凭据、原子替换当前登录、保留切换前副本，自动备份未命名的当前账号。
- **支持脚本调用**：JSON 输出、每账号超时、明确退出码；批量查询失败后继续处理其余账号。
- **轻量本地运行**：macOS/Linux、Python 3.11+，运行时无第三方 Python 依赖；凭据目录 `700`、文件 `600`。
## 安装
需要 macOS/Linux、Python 3.11+、Git，以及在 `PATH` 中可用的官方 Codex CLI。
推荐使用 pipx：
 [code] 
也可以从源码安装到虚拟环境：
 [code] 
工具支持 Codex 的 **`file` 凭据存储**。如果你决定使用文件存储，请在 `$CODEX_HOME/config.toml` 设置：
 [code] 
现有 keyring 登录不会自动迁移，设置后可通过 `codex-account add main` 重新登录并保存。工具不会自动修改你的配置。
## 快速开始
 [code] 
切换前先退出 Codex CLI 和 Codex/ChatGPT 桌面应用，再从独立终端执行 `codex-account use work`，然后重启 Codex。工具检测到这些客户端仍在运行时会阻止切换；运行中的进程不会热切换。
## 导出到自己的另一台电脑
在这台电脑导出：
 [code] 
将文件通过 SSH/SCP 等可信方式传到自己的另一台电脑，安装 v0.3.0 或更新版本后执行：
 [code] 
导入单个账号时可以改名，也支持直接导入官方 `auth.json`：
 [code] 
导入只写入账号存档，不修改当前 `auth.json`，也不自动切换或联网验证登录。若凭据已失效，请使用 `codex-account login 名称 --replace` 重新登录。相同名称属于不同账号时，必须改名或加 `--replace`；同一账号已用另一名称保存时，需使用已有名称导入。同一身份的凭据优先保留官方 `last_refresh` 较新的版本，无法比较时优先本机已有凭据。
`export --all` 只导出已保存的账号；未存档的当前登录可用不带名称的 `export` 导出，名称为 `current`。导出包含完整登录凭据和账号名，不包含配置、聊天历史或项目。导出时也会选择当前文件和存档中较新的同一账号凭据，不改动原文件。
**导出文件是明文登录凭据，请像密码一样保管，只传到自己的可信设备，导入后删除。** 文件权限为 `600`，内容不会打印到终端；默认拒绝覆盖已有文件，需要覆盖时用 `export ... --replace`。请保存到 `CODEX_HOME` 之外的已有目录。导入限制为 16 MiB，整包校验后才写入，普通写入失败时会回滚已写入的存档。
## 命令速查
| 命令 | 用途 |
| --- | --- |
| `codex-account list` | 本地列表：当前标记、脱敏邮箱、缓存套餐 |
| `codex-account list --usage` | 逐个查询全部存档账号的实时额度 |
| `codex-account show` | 当前账号及实时额度 |
| `codex-account show work` | 指定账号及实时额度 |
| `codex-account show work --local` | 仅查看本地信息，不联网 |
| `codex-account usage work` | `show work` 的同义命令 |
| `codex-account save main` | 保存当前登录 |
| `codex-account add work` | 调用官方登录并保存新账号 |
| `codex-account login work --replace` | 重新登录并更新同名存档 |
| `codex-account use work` | 切换到存档账号 |
| `codex-account remove work` | 删除指定本地存档 |
| `codex-account export --all -o accounts.codex-accounts.json` | 导出全部已保存账号 |
| `codex-account export work -o work.codex-account.json` | 导出指定账号 |
| `codex-account import accounts.codex-accounts.json` | 导入账号存档，保留当前登录 |
| `codex-account status` | 显示当前文件账号名称 |
| `codex-account --version` | 显示版本 |
`remove` 只删除指定存档。当前登录和切换前副本保留，不调用官方 logout，也不撤销远端凭据。
### 登录、JSON 与配置
 [code] 
`--` 后的参数透传给官方 `codex login`。API key 由官方从标准输入读取，请勿将 key 直接写入命令行参数。每次登录使用独立临时 `CODEX_HOME`，失败或取消不会改变当前账号。
`--home` 放在子命令前；默认读取 `CODEX_HOME`，未设置时使用 `~/.codex`。每账号查询默认超时 25 秒，允许大于 0 且不超过 120 秒。`--json` 仅输出筛选后的账号与额度字段，不包含 token、key 或完整凭据。可用 `CODEX_ACCOUNT_CLI=/absolute/path/to/codex` 指定官方 CLI。
退出码：`0` 成功，`1` 操作或查询失败，`2` 参数错误，`130` 用户中断。API key 无 ChatGPT 订阅窗口，查询时会提示并返回 `1`，不会推算 API 账单余额。
## 套餐与额度