核心用法
Codex Account Switcher 是一款针对 OpenAI Codex CLI 的多账户管理工具，主要解决开发者在个人与工作身份间频繁切换的痛点。其核心工作流程包括：
1. 账户捕获：通过 add 命令启动交互式向导，强制先执行 codex logout && codex login 确保身份明确，保存令牌快照至 ~/.codex/accounts/*.json
2. 快速切换：use <name> 命令即时替换 ~/.codex/auth.json 中的活跃令牌
3. 智能选择：auto 命令自动查询所有账户的周配额使用率，切换至剩余配额最多的账户
4. 列表管理：list 支持简洁/详细/JSON 三种输出格式，便于脚本集成
显著优点
- 场景分离：完美支持个人开发者账户与企业工作账户的物理隔离
- 零配置切换：切换操作瞬间完成，无需重复登录流程
- 配额优化：自动选择策略可避免配额耗尽导致的开发中断
- 非侵入设计：不修改 Codex CLI 本身，仅操作认证文件
- 自动化友好：
--json输出和单点登录模式支持 CI/CD 集成
潜在缺点与局限性
- 安全风险：直接读写敏感认证令牌文件，若权限配置不当可能导致令牌泄露
- 平台限制：依赖本地文件系统操作，暂不支持云端同步或团队共享
- 令牌有效期：未处理令牌自动刷新机制，长期闲置账户可能失效
- 单点故障：
~/.codex/auth.json损坏将导致 Codex CLI 无法使用 - 无加密存储：账户快照以明文 JSON 存储，依赖系统级文件权限保护
适合人群
- 拥有多个 OpenAI 账户的开发者（个人+组织订阅）
- 需要在不同项目/客户间切换身份的 freelancer
- 企业环境中共享开发机但需要隔离 Codex 使用痕迹的团队
- 追求配额利用率最大化的重度 Codex 用户
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| 令牌泄露 | `~/.codex/accounts/` 目录权限过宽 | 设置 `chmod 700` 并避免备份至公共云 |
| 账户误切换 | 自动化脚本中未验证目标账户 | 切换后执行 `codex whoami` 确认 |
| 配额误判 | API 延迟导致配额数据陈旧 | 关键操作前手动 `list --verbose` 复核 |
| 配置文件冲突 | 与 Codex CLI 未来版本存储格式变更 | 关注上游更新，保留配置备份 |