核心用法
Codex Account Switcher 是一款用于管理多个 OpenAI Codex 账户的身份切换工具，主要解决个人与工作账户分离、配额优化分配的需求。
主要功能
- 账户列表：
list命令展示已保存账户，支持--verbose显示令牌 TTL 和刷新时间，--json输出结构化数据 - 账户捕获：
add启动交互式向导，强制重新登录确保身份明确，自动提取邮箱本地部分作为默认命名 - 即时切换：
use <account>秒级切换活跃身份 - 智能配额：
auto命令自动检测所有账户的每周配额使用率，切换至剩余配额最多的账户
显著优点
- 零配置切换：直接操作
~/.codex/auth.json，无需修改 Codex CLI 本身 - 配额可视化：清晰的百分比展示，支持自动化决策
- 交互友好：终端会话支持连续添加，非交互环境（如 Moltbot）自动单发模式
- 令牌安全隔离：每个账户独立存储于
~/.codex/accounts/*.json
潜在缺点与局限性
- 令牌暴露风险：必须明文读写包含敏感认证令牌的 JSON 文件，无加密存储
- 单点故障：依赖本地文件系统权限，多设备同步需手动处理
- Codex CLI 绑定：功能紧密耦合 OpenAI Codex 的文件格式，迁移性差
- 配额检测延迟：
auto模式需串行查询多个账户 API，网络抖动时体验下降
适合人群
- 同时拥有个人与工作 OpenAI 账户的开发者
- 需要精细管理 API 配额避免中断的团队
- 频繁切换身份进行测试的自动化工作流用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 令牌泄露 | `~/.codex/accounts/` 目录权限不当可导致账户接管 |
| 误切换 | `auto` 模式可能在关键操作中途切换身份 |
| 版本兼容 | Codex CLI 更新可能破坏 auth.json 格式解析 |