Codex Quota

核心用法

codex-quota 是一个轻量级 Python 脚本，用于查询 OpenAI Codex CLI 的速率限制状态。它通过读取本地会话日志 ~/.codex/sessions/ 获取配额数据，无需直接调用 OpenAI API 或暴露 API 密钥。

主要功能

• 缓存查询：默认读取最新会话的配额信息，即时响应
• 实时刷新：--fresh 选项先调用 codex CLI 获取最新数据
• 多账户管理：--all --yes 自动遍历多个账户，临时切换 ~/.codex/auth.json 后恢复原配置
• JSON 输出：便于脚本集成和自动化监控

显著优点

1. 零配置安全：仅读取本地日志，不存储或传输 API 密钥
2. 便携性：单文件 Python 脚本，依赖仅 python3 和官方 codex CLI
3. 多账户友好：适合团队共享机器或拥有多个 OpenAI 组织的开发者
4. 时效性：显示 5 小时窗口和 7 天周限制的精确重置时间

潜在局限

• 依赖官方 CLI：必须安装 OpenAI 的 codex 工具，且 --fresh/--all 需要有效登录状态
• 会话日志依赖：若从未运行过 codex，则无缓存数据可用
• 账户切换风险：--all 模式会临时改写 auth.json，虽承诺恢复，但异常中断可能导致配置残留
• 非官方工具：由社区开发者维护（odrobnik），非 OpenAI 官方支持

适合人群

• 高频使用 Codex CLI 的开发者
• 需要监控多账户配额的技术团队
• 希望在批量任务前预判速率限制的用户

常规风险

| 场景 | 说明 |

|------|------|

| 配置残留 | `--all` 中断时 `auth.json` 可能未恢复，需手动检查 |

| 数据时效 | 缓存模式可能显示过期配额，关键决策前建议用 `--fresh` |

| 权限要求 | 需读取 `~/.codex/` 目录，多用户系统需注意文件权限 |