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` 时可能基于过时数据做决策 |

核心用法

codex-quota 是一款轻量级 Python 脚本，用于监控 OpenAI Codex CLI 的 API 配额消耗情况。它通过读取本地 ~/.codex/sessions/ 目录下的会话日志，解析并展示 5 小时短期窗口 与 7 天长期窗口 的剩余配额、重置时间及倒计时。

主要功能

| 命令 | 说明 |

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

| `codex-quota` | 显示基于最新会话的缓存配额数据 |

| `codex-quota --fresh` | 先调用 `codex` CLI 获取实时数据，再展示配额 |

| `codex-quota --all --yes` | 遍历所有已配置账号，汇总配额信息至 `/tmp/codex-quota-all.json` |

| `codex-quota --json` | 以 JSON 格式输出，便于脚本集成 |

显著优点

• 零依赖安全：纯 Python 标准库实现，无第三方包，彻底消除供应链攻击风险
• 隐私友好：仅访问本地文件，不采集敏感用户数据，符合 GDPR 数据最小化原则
• 多账号支持：通过临时切换 ~/.codex/auth.json 实现多账号配额统一监控
• 开发体验优化：重置时间自动转换为本地时区并显示倒计时，直观预判可用时段

潜在缺点与局限性

• 功能单一：仅专注配额查询，不提供充值、调整限制等管理功能
• 间接依赖：依赖本地安装的官方 codex CLI，若 CLI 版本变更可能导致兼容性问题
• T3 来源：由个人开发者维护（Oliver Drobnik），虽代码开源透明，但缺乏企业级 SLA 保障
• --all 模式风险**：临时覆写 auth.json 虽已实现原子备份恢复，仍存在极低概率的文件损坏风险

适合人群

• 高频使用 OpenAI Codex CLI 的开发者，需提前规划工作负载避开限额
• 管理多个 OpenAI 账号的团队，需统一监控各账号配额消耗
• 对供应链安全敏感、倾向使用无依赖工具的用户

常规风险

• subprocess 调用：执行外部 codex 命令（已设 60 秒超时），需确保 CLI 来源可信
• 配置文件读写：多账号模式下操作 auth.json，建议首次使用前手动备份
• 会话日志依赖：若 Codex CLI 更新日志格式，可能导致解析失败