Codex Quota

核心用法

codex-quota 是一个轻量级 Python 工具，用于监控 OpenAI Codex CLI 的速率限制状态。它通过读取本地会话日志（~/.codex/sessions/）中的 rate_limits 数据，无需网络请求即可展示配额信息。

主要功能

• 本地缓存模式：默认读取最新会话文件，即时显示 5 小时（Primary）和 7 天（Secondary）窗口的配额
• 实时刷新：--fresh 调用 codex CLI 获取最新数据
• 多账户管理：--all --yes 自动切换多个账户查询，临时修改 ~/.codex/auth.json 后恢复
• JSON 输出：--json 便于脚本集成

显著优点

1. 零配置：直接读取 Codex CLI 已生成的日志，无需额外 API 密钥
2. 轻量便携：单文件 Python 脚本，依赖仅 python3 和 codex
3. 实用场景明确：适合重度 Codex 用户在工作前快速确认配额，避免因额度耗尽中断工作流
4. 多账户友好：自动化切换账户查询，解决多账号配额监控痛点

潜在缺点与局限性

• 依赖 Codex CLI 内部格式：会话日志结构可能随 Codex 更新变化，存在失效风险
• 本地数据滞后：非 --fresh 模式依赖最后一次会话的时间点，无法反映实时消耗
• 多账户操作风险：自动切换账户时需覆盖 auth.json，虽有恢复机制，但异常中断可能导致配置残留
• 权限敏感：需读取 ~/.codex/ 下的认证和会话文件

适合人群

• 每日频繁使用 OpenAI Codex CLI 的开发者
• 拥有多个 OpenAI 账户需统筹配额的用户
• 希望在终端快速检查配额、避免工作中断的效率导向用户

常规风险

• 隐私泄露风险：会话日志可能包含代码片段上下文，工具本身只读取 rate_limits 字段，但用户需确认日志安全性
• 认证文件操作风险：--all 模式对 auth.json 的读写需确保异常处理可靠
• 供应链风险：作为本地脚本，需确认来源可信，避免植入恶意代码窃取 ~/.codex/ 目录数据