Codex Quota

核心用法

codex-quota 是一个本地 Python 工具，用于监控 OpenAI Codex CLI 的 API 配额消耗情况。它通过解析 ~/.codex/sessions/ 目录下的会话日志文件，提取并展示短期（5 小时）和长期（7 天）两个时间窗口的用量限制、剩余配额及重置倒计时。

主要功能模式：

• 默认模式：读取本地最新会话缓存，快速展示配额
• --fresh：主动调用 codex CLI 获取实时数据
• --all --yes：遍历多个账户，通过临时替换 ~/.codex/auth.json 查询每个账户配额，结果保存至 /tmp/codex-quota-all.json
• --json：机器可读输出

显著优点

1. 本地优先：无需额外 API key，直接读取 Codex CLI 已生成的会话数据
2. 多账户管理：独创性地通过 auth 文件切换实现多账户配额聚合查询
3. 便携性：单 Python 脚本，依赖仅 python3 和官方 codex CLI
4. 实用场景明确：适合重度 Codex 用户在长时间编码前快速评估可用额度

潜在缺点与局限性

1. 依赖 Codex CLI：必须安装并配置好官方 CLI，无法独立查询
2. 私有格式依赖：解析的是未公开的内部会话日志格式，未来可能因 Codex 更新而失效
3. 账户切换风险：--all 模式涉及临时覆盖 auth.json，虽声称事后恢复，但存在并发或异常中断导致配置损坏的理论风险
4. 功能单一：仅监控配额，无预警、无自动化管理功能

适合人群

• 高频使用 OpenAI Codex CLI 的开发者
• 拥有多个 OpenAI 账户需要统筹配额的用户
• 需要在本地终端快速检查 rate limit 的 CLI 重度用户

常规风险

• 隐私风险：工具读取本地会话数据，但不上传外部服务器，数据留在本地
• 配置风险：多账户切换机制涉及敏感凭证文件的临时修改，建议在非生产环境或备份后使用
• 维护风险：依赖 Codex CLI 内部实现细节，官方变更可能导致工具失效

核心用法

codex-quota 是一款轻量级 Python 工具，用于监控 OpenAI Codex CLI 的 API 配额使用情况。它通过读取本地 ~/.codex/sessions/ 目录下的会话日志文件，提取并展示关键速率限制信息，包括 5 小时短期窗口 和 7 天周度窗口 的剩余配额、重置时间倒计时及数据源文件年龄。

支持多种运行模式：

• 默认模式：显示缓存的最新会话配额
• --fresh：先调用 codex exec 获取实时数据
• --all --yes：遍历所有已保存账户查询配额，结果保存至 /tmp/codex-quota-all.json
• --json：JSON 格式输出，便于自动化集成

显著优点

1. 绝对纯净：仅依赖 Python 标准库（json、os、pathlib、subprocess 等），零 pip 依赖，彻底杜绝供应链攻击风险
2. 完全离线：不直接发起任何网络请求，所有数据来自本地文件系统，隐私零泄露
3. 多账户友好：通过临时切换 ~/.codex/auth.json 实现多账户配额监控，操作后自动恢复原配置
4. 代码透明：开源单脚本，逻辑清晰可审计，适合安全敏感环境
5. 精准信息：本地时区转换 + 倒计时显示，用户体验优于原始日志

潜在局限

• 依赖 Codex CLI：必须使用 --fresh 或 --all 才能获取最新数据，离线时仅能看到历史会话记录
• 多账户切换风险：虽自动恢复 auth.json，极端情况下（进程中断）可能导致配置异常，需手动修复
• 平台绑定：专为 Codex CLI 设计，不适用于其他 OpenAI API 客户端或第三方工具
• T3 来源：个人开发者维护，更新频率和长期支持存在不确定性

适合人群

• 高频使用 Codex CLI 的开发者，需实时监控周度配额避免工作中断
• 拥有多个 OpenAI 账户的团队/个人，需集中管理配额分配
• 安全敏感环境用户，拒绝安装含网络依赖的第三方监控工具
• CI/CD 流程集成者，需 JSON 输出自动化检查配额余量

常规风险

| 风险项 | 等级 | 说明 |

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

| 子进程执行 | 低 | 硬编码调用 `codex exec`，无注入风险 |

| 文件覆盖 | 低 | `--all` 模式临时修改 auth.json，有 try-except 恢复保护 |

| 供应链 | 无 | 零外部依赖 |

| 数据外泄 | 无 | 纯本地工具，无网络通信 |

使用建议：运行 --all --yes 前确保已备份账户配置；定期审查代码更新防止后续版本引入网络行为。