核心用法
codex-quota 是一款轻量级 Python 工具，用于查询 OpenAI Codex CLI 的 API 配额使用情况。它通过读取本地会话日志（~/.codex/sessions/）中的 rate_limits 数据，无需直接调用 API 即可展示配额状态。
主要功能：
- 显示 5 小时窗口期（短期限制）和 7 天窗口期（周限制）的配额
- 本地时区重置时间 + 倒计时
- 数据来源会话文件及数据时效标注
- 多账户支持（
--all --yes模式） - JSON 结构化输出（
--json） - 实时刷新模式（
--fresh，先触发 Codex 请求获取最新数据）
显著优点
1. 零 API 调用开销：直接读取本地缓存的日志文件，不消耗额外 API 配额
2. 开箱即用：纯 Python 单文件脚本，仅需 python3，无需依赖安装
3. 隐私优先：数据完全本地处理，不上传任何信息到第三方服务
4. 多账户友好：支持扫描 ~/.codex/accounts/*.json 管理多个 OpenAI 账户配额
5. 安全意识设计：账户切换操作需显式 --yes 确认，防止误操作
潜在缺点与局限性
1. 数据时效依赖：默认模式读取缓存数据，可能滞后（需用 --fresh 获取实时状态，但这会消耗一次 API 调用）
2. Codex CLI 依赖：仅适用于 OpenAI 官方 Codex CLI 用户，其他 AI 编程工具（Claude Code、Aider 等）不兼容
3. 日志路径硬编码：依赖 ~/.codex/sessions/ 标准路径，若用户自定义日志位置则失效
4. 无持久化历史：仅展示最新状态，无配额使用趋势分析或历史记录功能
5. 平台局限：需类 Unix 路径结构（~ 展开），Windows 原生支持未经明确说明
适合人群
- 高频 Codex CLI 用户：需要频繁监控配额避免工作流中断
- 多账户开发者：管理个人与工作 OpenAI 账户配额分配
- 自动化/CI 场景：通过
--json输出集成到监控脚本 - 隐私敏感用户：不愿使用需要 API key 的在线配额查询工具
常规风险
| 风险类型 | 评估 | 说明 |
|---------|------|------|
| 数据泄露风险 | 极低 | 纯本地处理，无网络传输 |
| 恶意代码风险 | 低 | 单文件 Python 脚本，可人工审计；建议检查 `subprocess` 调用（`--fresh` 模式调用 `codex` 命令） |
| 误操作风险 | 低 | 账户切换需 `--yes` 确认，设计合理 |
| 依赖风险 | 中 | 依赖 Codex CLI 日志格式稳定性，若 OpenAI 更改日志结构会失效 |