碎碎念:如何优雅搞定 Codex 多账号无感切换(附避坑实战)
前段时间为了应对额度和并发限制,注册了好几个 Plus / Business 账号。但官方工具本身没有多账号体系,每次切号都得退了登、登了退,不仅麻烦,还经常把之前的 Session 给搞挂。
后来找到了开源的 codex-auth 这个小工具,体验瞬间顺畅了不少。不过最近 Codex 和该工具都做了重构升级,旧用法(如 use 命令)容易踩坑,这里整理一份最新、最稳的多账号录入与切换指南。
核心避坑:千万不要执行 codex logout!
很多人切号时习惯先 codex logout,这是最大的坑。
logout 会直接向 OpenAI 服务端发送吊销请求,导致本地即便备份了该账号的凭证,也会直接失效报 401 unauthorized_unknown。
正确的核心逻辑:通过临时移走本地凭证文件 ~/.codex/auth.json,让本地客户端误以为处于“全新未登录”状态,而服务端的 Session 依然保持存活有效。
可以,给你一个日常够用的精简版:
# 1. 查看所有账号
codex-auth list
# 2. 查看当前账号
codex-auth list --active
# 3. 登录并添加新账号
codex-auth login
# 4. 把当前已有的 auth.json 保存进账号库
codex-auth import "${CODEX_HOME:-$HOME/.codex}/auth.json"
# 5. 导入旧的 auth.json,并设置别名
codex-auth import /path/to/auth.json --alias plus1
# 6. 交互式切换账号
codex-auth switch
# 7. 直接切换到指定账号
codex-auth switch plus1
# 8. 切回上一个账号
codex-auth -
# 9. 给账号设置别名
codex-auth alias set user@example.com main
# 10. 实时查看多个账号额度
codex-auth list --live
# 11. 不调用 API,只读本地信息
codex-auth list --skip-api
# 12. 导出备份
codex-auth export ~/codex-auth-backup最常用其实就这几个:
codex-auth list
codex-auth list --active
codex-auth switch
codex-auth switch <alias>
codex-auth -
codex-auth import <auth.json> --alias <name>推荐你的日常流程:
查看额度 → codex-auth list
切账号 → codex-auth switch xxx
启动 Codex → codex
确认身份 → /status另外,切换账号后最好重启当前 Codex 进程,避免旧会话还缓存着之前的登录态。