核心用法
codex-quota 是一款轻量级 Python 工具，用于监控 OpenAI Codex CLI 的速率限制状态。它通过读取本地会话日志文件（~/.codex/sessions/ 下的 JSONL 文件），提取最新的 rate_limits 数据，直观展示 5 小时短期窗口和 7 天长期窗口的配额使用情况。
主要功能
- 离线查询：默认读取本地缓存，无需 API 调用
- 实时刷新：
--fresh模式先触发 Codex 会话获取最新数据 - JSON 输出：
--json便于脚本集成和数据处理 - 友好展示：本地时区转换 + 倒计时显示
显著优点
1. 零配置即用：单文件 Python 脚本，无依赖项（标准库即可运行）
2. 隐私安全：数据完全本地处理，不向第三方发送任何信息
3. 跨平台：Python 脚本天然支持 macOS/Linux/Windows
4. 精准溯源：显示数据来源会话文件及时间戳，便于审计
潜在缺点与局限性
- 依赖 Codex CLI 日志格式：若 OpenAI 更改日志结构，工具可能失效
- 非官方工具：非 OpenAI 官方支持，无 SLA 保障
- 仅支持已登录会话：需先有 Codex CLI 使用记录才能提取数据
- 功能单一：仅做配额查询，无配额预警或自动化管理功能
适合人群
- 高频 Codex 用户：需要随时掌握剩余额度，避免工作流中断
- 多账户开发者：快速切换检查不同账号的配额状态
- 自动化运维：结合
--json输出集成到 CI/CD 或监控脚本
常规风险
- 日志文件权限：需确保对
~/.codex/sessions/目录有读取权限 - 数据时效性：缓存模式可能显示过期配额，关键决策建议用
--fresh - 路径硬编码：若 Codex CLI 更改默认存储路径，需手动调整脚本