为什么你需要codex-account-switcher?Codex多账号管理的5大痛点与解决方案

原创2026-11-03 23:08:101,632 阅读

为什么你需要codex-account-switcher?Codex多账号管理的5大痛点与解决方案

如果你同时使用多个 Codex 账号,每天都在"退出登录 → 重新登录"之间折腾,那么 codex-account-switcher 正是为你准备的 Codex 多账号管理工具。它让你用 codex-account 一条命令完成:给账号起名字、查看实时额度、保存登录状态、快速切换账号,并支持跨设备导入导出——账号留在本机,登录全程交给官方 Codex CLI 处理。

五大痛点,你中了几个?

痛点一:多账号来回切换,只能反复重新登录 👔

Codex 本身只保存"当前"登录,想在个人号、工作号之间切换,往往得手动退出再登录,既慢又容易登录错。

✅ 解决方案:命名账号 + 一键切换

把每个登录保存为带名字的本地存档,切换只需一条命令:

codex-account save main    # 保存当前登录为 main
codex-account add work     # 通过官方 CLI 登录并保存另一个账号
codex-account use work     # 一键切到 work

切换前工具会自动检测 Codex CLI 或桌面应用是否还在运行,并阻止"热切换",避免状态错乱。

痛点二:不知道哪个账号的额度还剩多少 ⏳

Plus 账号有 5 小时/7 天窗口用量,多个账号混用时根本记不清哪个快用完了。

✅ 解决方案:实时额度查询,不消耗对话额度

codex-account list --usage   # 对比全部存档账号的实时额度
codex-account show work      # 查看指定账号:窗口用量、剩余比例、重置时间

查询走官方 codex app-server 接口,不创建对话、不发起模型推理;其他账号在临时目录中查询,不会顺手切换你的当前登录。

痛点三:换电脑后,账号存档"丢"了 💻

新电脑要重新走一遍登录流程,多个账号更是痛苦。

✅ 解决方案:跨设备导出/导入

# 旧电脑:导出全部已保存账号
codex-account export --all -o accounts.codex-accounts.json

# 新电脑:导入后直接可用
codex-account import accounts.codex-accounts.json
codex-account use work

导入支持改名、冲突检查,也可以直接导入官方的 auth.json。导出/导入只写账号存档,不改动当前登录,不会"导完就连不上"。

痛点四:怕切换翻车,丢了当前登录 😰

手动改凭据文件出一次错,可能就是半天白费。

✅ 解决方案:自动备份 + 原子替换

每次切换前,工具会自动保留切换前副本(previous-auth.json),并以原子方式替换当前登录;未命名的当前账号还会被自动备份。想回退时,用 codex-account use <旧存档名> 再切回来即可。

痛点五:明文凭据,安全隐患不少 🔐

账号凭据本质是明文文件,管理不好等于泄露密码。

✅ 解决方案:最小暴露 + 严格权限

  • 凭据目录权限 700、文件权限 600,默认脱敏显示邮箱(a***@example.com)
  • 导出文件只通过 SSH/SCP 等可信方式传给自己的设备,导入后删除;文件名模式已加入 .gitignore
  • 详细的安全边界见 SECURITY.md

一键安装步骤

环境要求:macOS/Linux、Python 3.11+、Git,以及 PATH 中可用的官方 Codex CLI。

方式一:使用 pipx(推荐)

pipx install 'git+https://gitcode.com/gh_mirrors/co/codex-account-switcher.git@v0.3.0'
codex-account --version

方式二:源码安装

git clone https://gitcode.com/gh_mirrors/co/codex-account-switcher
cd codex-account-switcher
python3 -m venv .venv
.venv/bin/python -m pip install .
source .venv/bin/activate
codex-account --help

⚠️ 小提醒:需要 Codex 使用 file 凭据存储,请在 $CODEX_HOME/config.toml 中确认:

cli_auth_credentials_store = "file"

项目元信息与入口命令定义在 pyproject.toml,核心 CLI 逻辑位于 scripts/codex_account.py。

快速上手:3 条命令搞定

codex-account save main          # 保存当前 Codex 登录
codex-account add work           # 添加第二个账号(官方登录流程)
codex-account list --usage       # 对比两个账号的实时额度

日常高频命令速查:

命令 用途
codex-account list 查看本地账号列表(当前标记、脱敏邮箱、套餐)
codex-account use work 切换到指定存档账号
codex-account login work --replace 凭据失效时重新登录并更新存档
codex-account remove work 删除本地存档(不影响远端凭据)
codex-account show work --local 仅看本地信息,不联网

完整命令说明见 README.md 的"命令速查"章节。

总结

你的困扰 codex-account-switcher 的答案
反复重新登录 命名存档 + 一键切换
额度不明 list --usage 实时查询
换设备丢账号 导出/导入跨设备迁移
切换怕出错 自动备份 + 原子替换
凭据安全 严格文件权限 + 脱敏展示

它是一个轻量、无第三方运行时依赖的本地工具(macOS/Linux,Python 3.11+),MIT 协议开源(见 LICENSE)。如果你也是多账号用户,不妨现在就用 codex-account list 感受一下——切换账号这件事,本不该这么麻烦。

想深入了解或参与开发?可以阅读 CONTRIBUTING.md,测试用例(使用虚构凭据,无需真实登录)位于 tests/ 目录。

登录后查看全文
codex-account-switcher