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/ 目录数据

核心用法

codex-quota 是一款专为 OpenAI Codex CLI 用户设计的速率限制查询工具。用户可通过 ./codex-quota.py 或安装到 PATH 后直接运行 codex-quota 命令。支持 --fresh 实时获取数据、--all --yes 批量查询多账户、--json JSON 输出等模式。

显著优点

• 零依赖安全：纯 Python 标准库实现（json, os, subprocess 等），无第三方包，CVE 风险为零。
• 本地数据优先：默认读取 ~/.codex/sessions/ 缓存数据，无需频繁调用 API。
• 多账户支持：通过临时切换 ~/.codex/auth.json 实现多账户配额监控，操作后自动恢复。
• 清晰可视化：区分 5 小时（短期）和 7 天（每周）两个限制窗口，显示本地时区重置倒计时。

潜在局限

• T3 来源风险：由 ClawHub 个人开发者维护，非知名开源基金会，更新验证流程弱于 T1/T2 来源。
• 功能单一：仅支持速率限制查询，无配额预警、自动切换等高级功能。
• 裸异常捕获：部分代码使用裸 except，健壮性有待提升。
• 依赖 codex CLI：需预装 OpenAI Codex 命令行工具，无法独立运行。

适合人群

• 高频使用 Codex CLI 的开发者，需监控多账户配额消耗
• 对工具安全性敏感、偏好零依赖方案的技术用户
• 需在 CI/CD 或自动化脚本中集成配额检查的团队

常规风险

• 配置文件访问：需读取 ~/.codex/ 目录下的 sessions、auth.json、accounts，建议用户了解权限范围。
• 子进程调用：通过 subprocess.run 调用本地 codex CLI，参数固定无注入风险，但依赖外部工具完整性。
• 版本锁定建议：T3 来源更新验证较弱，建议固定使用 1.1.3 版本，升级前重新审查。