Codex Quota

核心用法

codex-quota 是一款针对 OpenAI Codex CLI 用户的配额监控工具，通过解析本地会话日志（~/.codex/sessions/）来展示实时用量状态，无需频繁调用 API 即可获取配额信息。

主要功能：

• 默认模式：读取最新会话缓存，即时显示当前配额状态
• `--fresh`：先调用 codex CLI 获取实时数据，再解析更新
• `--all --yes`：遍历多个账户，通过临时改写 ~/.codex/auth.json 查询每个账户配额，结果保存至 /tmp/codex-quota-all.json
• `--json`：JSON 格式输出，便于脚本集成

展示信息：

• Primary Window（5 小时窗口）短期限流配额
• Secondary Window（7 天窗口）周度配额
• 配额重置时间（本地时区）及倒计时
• 数据来源会话文件及其时效

显著优点

1. 零配置即用：纯 Python 脚本，单文件可执行，依赖仅系统 Python3 和已安装的 codex CLI
2. 离线优先：默认读取本地日志，响应极快，不消耗 API 额度
3. 多账户支持：独创的账户切换机制，适合管理多个 OpenAI 账户的开发者
4. 可脚本化：JSON 输出模式便于 CI/CD 或自动化监控集成

潜在缺点与局限性

1. 功能单一：仅聚焦配额查询，无用量预测、历史趋势分析等高级功能
2. 账户切换风险：--all 模式需临时改写认证文件，虽承诺恢复，但异常中断可能导致配置残留
3. 数据时效性：非 --fresh 模式下依赖本地缓存，可能显示过期信息
4. 平台局限：专为 Codex CLI 设计，对直接使用 OpenAI API 的用户无价值

适合人群

• 高频使用 OpenAI Codex CLI 的开发者
• 拥有多个 OpenAI 账户需统筹配额的用户
• 希望在终端快速确认配额状态、避免突发限流的效率型用户

常规风险

| 风险项 | 说明 |

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

| 认证文件操作 | `--all` 模式改写 `~/.codex/auth.json`，建议备份原配置 |

| 隐私泄露 | 工具读取本地会话日志，需确保运行环境可信 |

| 误依赖缓存 | 未使用 `--fresh` 时可能基于过时数据做决策 |