核心用法
Codex Account Switcher 是一款面向 OpenAI Codex 多账号用户的身份管理工具，主要解决个人、家庭、工作等多身份场景下的快速切换需求。核心功能包括：
1. 账号管理：通过 list/add/use 命令完成账号的增删改查与即时切换
2. 智能自动切换：auto 模式基于配额预算评分算法，自动选择最优账号
3. OpenClaw 集成：自动同步所有账号令牌至 OpenClaw 代理的认证配置，支持内部无缝切换
4. 活动日志：记录每次切换事件，支撑下游配额分析
配额评分算法
该工具采用创新的预算追踪机制：
- 计算理想 7 天匀速消耗预算
(elapsed_hours/168)×100% - 评分公式
(实际周使用率-预算%) + 5小时窗口惩罚 - 负分表示未超预算（有空间），正分表示过度消耗
- 对 75%-100% 的 5h 窗口使用率施加阶梯惩罚（+10 到 +200），防止短时阻塞
显著优点
- 多身份原生支持：彻底解决 Codex 单账号限制，适合组织共享、家庭计划等场景
- 智能决策：自动规避即将触顶的账号，减少人工判断成本
- 生态整合：与 OpenClaw 代理系统深度集成，扩展了 Codex 在自动化工作流中的可用性
- 透明可审计：JSONL 活动日志支持精细化配额归因分析
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **文件系统敏感操作** | 直接读写 `~/.codex/auth.json`、账户目录及 OpenClaw 配置，误操作可能导致认证失效 |
| **令牌持久化风险** | 多账号令牌以明文 JSON 存储于本地，需依赖操作系统级文件权限保护 |
| **配额探测副作用** | `auto` 模式需临时切换身份执行探针，可能产生极少量 API 调用开销 |
| **JWT 解析依赖** | 邮件提取、用户 ID 归因依赖令牌格式稳定性，OpenAI 变更可能破坏功能 |
| **无加密传输** | 同步至 OpenClaw 的过程依赖本地文件系统，跨设备场景需额外安全考量 |
适合人群
- 持有多个 OpenAI 组织/家庭计划账号的开发者
- 需要将 Codex 集成至 OpenClaw 自动化代理的高级用户
- 对配额敏感、追求成本优化的团队技术负责人
常规风险提醒
- ⚠️ 备份建议：首次使用前备份
~/.codex/auth.json，避免切换异常导致锁定 - ⚠️ 权限管控：确保
~/.codex/与~/.openclaw/目录仅限当前用户可读 - ⚠️ 令牌轮换：关注 OpenAI 令牌过期策略，定期执行
sync或重新add账号