核心用法
codex-quota 是一个轻量级 Python 脚本，用于检查 OpenAI Codex CLI 的速率限制配额状态。它通过读取本地会话日志（~/.codex/sessions/）中的 rate_limits 数据，展示当前账户的 5 小时短期窗口和 7 天长期窗口配额使用情况。
主要功能
- 本地数据优先：默认读取缓存的最新会话数据，无需网络请求
- 实时刷新：
--fresh选项先 ping Codex 获取最新数据 - 多账户支持：
--all --yes可遍历所有已保存账户，输出聚合 JSON - 多种格式：支持人类可读格式和
--json机器解析格式 - 时区友好：自动转换重置时间为本地时区并显示倒计时
显著优点
1. 零配置成本：直接利用 Codex CLI 已有的会话数据，无需额外 API 密钥
2. 隐私安全：数据完全本地处理，不向第三方发送配额信息
3. 跨平台：纯 Python 3 实现，兼容 macOS/Linux/Windows
4. 轻量快速：单文件脚本，启动即查，适合集成到 shell prompt
潜在局限
- 依赖 Codex CLI 使用：必须已有 Codex CLI 生成过会话日志才能获取数据
- 数据时效性：非
--fresh模式下显示的是上次会话的配额状态 - 账户切换需确认：多账户操作需要显式
--yes标志，交互稍显繁琐 - 无历史趋势：仅展示当前状态，不提供配额使用趋势分析
适合人群
- 高频使用 Codex CLI 的开发者，需要频繁检查剩余配额
- 拥有多个 OpenAI 账户需要统一管理配额的团队用户
- 希望在 shell 环境中快速集成配额检查到工作流的效率用户
常规风险
- 路径依赖：硬编码依赖
~/.codex/sessions/目录结构，若 Codex CLI 变更存储格式可能失效 - 会话隐私：脚本需要读取本地会话文件，虽然不上传，但在共享环境需确保文件权限正确
--all模式生成的/tmp/codex-quota-all.json临时文件可能暴露多账户信息，公共机器使用后建议清理