Codex account switching CLI

Codex ID 把 Codex 登录态变成可切换账号库。

统一管理 ~/.codex/auth.json 、 ~/.codex/codex-id.json 和访问令牌账号。 cid a 添加， cid l 看额度， cid u 切换。

开始使用 查看能力 GitHub
cid — zsh
Account Library

把本机已有登录态，变成可管理账号。

多份登录态保存到 ~/.codex/codex-id.json ，当前账号写回 ~/.codex/auth.json 。

从当前账号开始

cid i 把当前 Codex 登录态同步到 ~/.codex/codex-id.json 。

不用手动命名

优先用邮箱；没有邮箱时用 account_id 前 8 位，访问令牌账号用邮箱或 pat-短标识 。

列表先刷新再查额度

cid l 先续期临期 access_token ，再显示 Plan、Next、Total。

状态一眼能看懂

绿色 * 是当前账号；黄色、灰色、红色分别是 limited、cooling、 offline。无参 cid r 只清理明确离线账号。

Quick Start

第一步，先同步本地 Codex 账号。

cid i 登记当前账号到 ~/.codex/codex-id.json ，之后再添加、查看、切换。

先同步当前本地账号 cid init | i
添加账号 cid add | a cid add | a at-...
还没安装时 npm install -g codex-id
临时运行 npx codex-id init
quickstart
$ cid init 环境检查通过，已同步当前 Codex 账号：a@example.dev，已写入：~/.codex/codex-id.json $ cid add 已添加账号：b@example.dev $ cid add at-... 已添加访问令牌账号：token@example.dev $ cid use 2 已切换 Codex 账号：b@example.dev，已更新：~/.codex/auth.json
Slot Model

切换账号，本质是替换当前 auth.json。

~/.codex/codex-id.json 保存多份登录态； cid u 只把目标账号的 auth.json 写回当前槽位；目标可以是序号、邮箱、短 ID 或 pat-短标识 。

01
初始化

cid i 检查环境并保存当前登录态到 codex-id.json 。

02
添加账号

cid a 调用 codex login 登录； cid a at-... 验证访问令牌并保存到 codex-id.json 。

03
查看和切换

cid l 用 refresh_token 刷新临期登录态，再显示编号和额度。 cid u 2 按编号切换，也支持邮箱、短 ID 和 pat-短标识 ；不带账号的 cid u 在 limited / cooling / offline 时切到第一个 available 账号。

切换会更新 ~/.codex/auth.json ；如果 cid l 续期当前账号，也会同步更新它。VS Code Codex 可能需要重载。
04
清理离线账号

cid r 带参数删除指定账号；无参只清理 offline，跳过 unknown。