为什么你需要codex-account-switcher?Codex多账号管理的5大痛点与解决方案
为什么你需要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/ 目录。