核心用法
codex-quota 是一款用于监控 OpenAI Codex CLI 使用配额的辅助工具。它通过解析 Codex 自动生成的会话日志文件（~/.codex/sessions/），提取最近一次会话中的 rate_limits 数据，以人类可读格式展示当前配额状态。
关键特性：
- 双层窗口监控：区分 5 小时短期限制与 7 天周度限制，附本地时区重置倒计时
- 灵活运行模式：默认读取缓存（快速），
--fresh实时获取，--json机器解析 - 零配置依赖：纯 Python 单文件脚本，仅需标准库
显著优点：
- 无需 API 调用即可查询配额，降低额外请求风险
- 会话文件溯源，数据可审计
- 适合多账户场景快速切换检查
潜在局限：
- 依赖 Codex CLI 的日志写入行为，若日志被清理或禁用则失效
- 缓存模式数据存在滞后性（以最近会话为准）
- 官方未公开 rate_limits 结构，存在格式变更导致解析失败的风险
适合人群：高频使用 Codex CLI 的开发者、多账户管理用户、需要预判配额耗尽风险的自动化工作流构建者。
常规风险：工具本身只读本地日志，无网络请求（除非 --fresh），无敏感数据写入操作。需注意会话文件权限（~/.codex/ 目录通常用户私有）。