Codex Quota

核心用法

codex-quota 是一款用于监控 OpenAI Codex CLI 使用配额的辅助工具。它通过解析 Codex 自动生成的会话日志文件（~/.codex/sessions/），提取最近一次会话中的 rate_limits 数据，以人类可读格式展示当前配额状态。

关键特性：

• 双层窗口监控：区分 5 小时短期限制与 7 天周度限制，附本地时区重置倒计时
• 灵活运行模式：默认读取缓存（快速），--fresh 实时获取，--json 机器解析
• 零配置依赖：纯 Python 单文件脚本，仅需标准库

显著优点：

• 无需 API 调用即可查询配额，降低额外请求风险
• 会话文件溯源，数据可审计
• 适合多账户场景快速切换检查

潜在局限：

• 依赖 Codex CLI 的日志写入行为，若日志被清理或禁用则失效
• 缓存模式数据存在滞后性（以最近会话为准）
• 官方未公开 rate_limits 结构，存在格式变更导致解析失败的风险

适合人群：高频使用 Codex CLI 的开发者、多账户管理用户、需要预判配额耗尽风险的自动化工作流构建者。

常规风险：工具本身只读本地日志，无网络请求（除非 --fresh），无敏感数据写入操作。需注意会话文件权限（~/.codex/ 目录通常用户私有）。

核心功能

codex-quota 是一款轻量级命令行工具，用于解析 OpenAI Codex CLI 的本地会话日志，实时展示用户当前的双层速率限制状态：5 小时短窗口与 7 天周窗口配额、剩余额度、重置倒计时及会话来源。

显著优点

• 零依赖安全设计：仅使用 Python 标准库（json、os、sys、datetime、pathlib、subprocess），无第三方包引入供应链攻击风险。
• 双模式数据获取：默认读取本地缓存的最新会话文件实现毫秒级响应；--fresh 模式调用本地 codex exec 获取实时数据，灵活适配不同场景。
• 友好可视化：本地时区格式化输出，附带倒计时提醒，便于开发者快速判断能否启动重度任务。
• 极简部署：单文件脚本，复制到 PATH 即可使用，MIT 开源许可。

潜在局限

• 功能单一：专注 Codex CLI 配额查询，不支持其他 OpenAI API 产品（如 ChatGPT API、DALL-E）的用量监控。
• 格式依赖：解析逻辑绑定 Codex CLI 的 token_count 事件 JSONL 格式，若官方更新日志结构可能导致失效，需定期维护。
• T3 来源可信度：由个人开发者维护，无大型组织背书，虽经代码审计安全，但长期维护承诺弱于企业级项目。
• 间接网络行为：--fresh 模式的网络请求实际由 Codex CLI 发起，工具本身无法精细控制超时、重试或代理设置。

适合人群

• 高频使用 Codex CLI 的专业开发者与团队，需在多账户或多项目间监控配额消耗；
• CI/CD 流水线维护者，希望在自动化任务前预检配额避免中断；
• 对供应链安全敏感、偏好零依赖工具的技术洁癖用户。

常规风险

• subprocess 调用：--fresh 模式通过 subprocess.run 执行本地 codex 命令，虽已硬编码参数并设 60 秒超时，仍建议确保 codex 二进制来源可信，避免 PATH 劫持。
• 会话文件权限：工具读取 ~/.codex/sessions/ 目录，需确保该目录权限设置合理，防止本地其他进程篡改会话数据导致误报。
• 数据滞后性：默认缓存模式可能显示过期配额，重度依赖前务必使用 --fresh 确认最新状态。