核心用法
codex-quota 是一款轻量级 Python 脚本,用于解析 Codex CLI 本地会话日志中的速率限制元数据。它自动定位 ~/.codex/sessions/ 目录下最新的 .jsonl 文件,提取 rate_limits 对象,并以易读格式展示当前额度状态。
显著优点
- 零 API 调用:完全依赖本地日志,不消耗任何 API 配额
- 开箱即用:单文件脚本,无需依赖(仅使用 Python 标准库)
- 多账户支持:
--all模式可同时追踪多个 Codex 账户的配额 - 灵活输出:支持纯文本、JSON 格式,便于脚本集成
- 实时与缓存兼顾:默认使用缓存数据实现瞬时响应,
--fresh可强制触发新会话获取最新状态
潜在局限
- 依赖 Codex CLI 日志结构:若 OpenAI 更改日志格式或路径,工具将失效
- 非官方工具:属于社区逆向工程实现,无官方支持保障
- 权限敏感:需要读取用户主目录下的隐藏文件夹
- 功能单一:仅支持配额查询,无法修改或重置限制
适合人群
- 高频使用 Codex CLI 的开发者(日均调用数百次以上)
- 需要监控多账户配额的工作流/团队管理员
- 对 API 成本敏感、希望避免意外超限的用户
常规风险
- 隐私泄露:脚本读取的会话日志可能包含代码片段上下文,在多用户环境需注意权限设置
- 误判风险:日志解析可能存在时序偏差,
--fresh虽更准确但会触发一次轻量 API 调用 - 依赖过时:Codex CLI 处于快速迭代期,日志格式可能随时变更