Codex Quota

核心用法

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 处于快速迭代期，日志格式可能随时变更

核心用法

codex-quota 是一款轻量级 Python 脚本工具，用于监控 OpenAI Codex CLI 的 API 速率限制状态。用户可通过 ./codex-quota.py 直接运行，或安装至 PATH 后使用 codex-quota 命令调用。工具支持 --fresh 获取实时数据、--all 多账户汇总、--json JSON 输出等选项。

显著优点

1. 零依赖架构：完全基于 Python 标准库实现，无第三方包依赖，彻底规避供应链攻击风险
2. 隐私优先设计：仅读取本地 ~/.codex/sessions/ 目录下的会话日志，不收集或外发任何敏感数据
3. 功能精准聚焦：专精单一场景——解析 Codex CLI 生成的 token_count 事件中的 rate_limits 对象，呈现 5 小时短期窗口与 7 天长期窗口的配额状态
4. 安全编码实践：静态分析无危险函数、无硬编码密钥；subprocess 调用已设置 60 秒超时保护

潜在缺点与局限性

• 功能边界受限：仅支持已安装 Codex CLI 的环境，无法独立获取配额信息
• 数据来源依赖：依赖本地会话文件的存在与完整性，若日志被清理则无法显示历史状态
• 跨平台兼容性：虽为 Python 脚本，但未明确说明 Windows 路径处理等细节
• 无持续维护信号：未识别到公开 GitHub 仓库，长期维护可持续性存疑

适合人群

• 高频使用 OpenAI Codex CLI 的开发者
• 需在批量任务前预判配额余量的 DevOps 工程师
• 多账户管理场景下的团队技术负责人

常规风险

• 低: subprocess 调用本地 codex 命令存在理论上的命令注入可能，但当前实现仅执行固定指令，风险可控
• 低: 会话文件路径遍历需依赖操作系统权限隔离，建议确保 ~/.codex/ 目录权限正确配置