Codex account switching CLI

Codexs Codex Switch，把本地登录态同步成可切换账号库。

把当前 ~/.codex/auth.json 收进账号库 ~/.codex/codex-accounts.json ，再用 codexs add 登录更多账号。 codexs list 查额度， codexs use N 按编号切换当前账号。

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

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

Codexs 不要求你重新整理配置。它把多份登录态保存到 ~/.codex/codex-accounts.json ，当前生效账号仍回写到 ~/.codex/auth.json 。

从当前账号开始

第一次运行 codexs i ，会把本机正在使用的 Codex 登录态同步到 ~/.codex/codex-accounts.json 。

不用手动命名

Codexs 从登录态里解析邮箱作为账号名；没有邮箱时回退到 account_id 前 8 位。

列表只查额度

codexs list / codexs l 展示账号、套餐、5 小时额度和周额度，不发起模型生成请求。

状态一眼能看懂

绿色 * 表示当前账号；黄色、灰色、红色分别提示 limited、cooling、offline。

Quick Start

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

你已经登录过 Codex 时，先运行 codexs i 。这一步会把当前账号登记进 ~/.codex/codex-accounts.json ，后续的新增、列表和切换才有目标。

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

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

~/.codex/codex-accounts.json 保存多份登录态； codexs use / codexs u 只把目标账号的 auth.json 写回当前 Codex 槽位。

01
初始化

codexs init / codexs i 检查 Codex 环境，把当前登录态保存到 codex-accounts.json ，并迁移旧账号库。

02
添加账号

codexs add / codexs a 调用 codex login 登录另一个账号，并保存到同一个 codex-accounts.json 账号库。

03
查看和切换

codexs list / codexs l 查看编号和额度。 codexs use 2 / codexs u 2 按编号切换；不带账号的 codexs use 会在当前账号 limited / cooling / offline 时自动切到第一个 available 账号。

切换会更新 ~/.codex/auth.json 。VS Code Codex 可能需要 Reload Window 或重启 VS Code 后生效。
04
清理离线账号

codexs remove / codexs r 可以删除指定账号；无参时只提示清理明确离线的账号。