本地查询 OpenAI Codex CLI 速率限制状态，支持多账户切换与实时监控，无需 API 密钥。
说明：
## 核心用法
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/` 目录，多用户系统需注意文件权限 |
