Codex 速率限制实时监控工具

本地查询 OpenAI Codex CLI 速率限制状态，支持多账户切换与实时监控，无需 API 密钥。

基本信息

• 技能名称?Codex Quota
• 中文名称?Codex 速率限制实时监控工具
• 作者?odrobnik
• 分类?专业技能
• 版本?1.2.2
• 标签?openai, codex, cli, rate-limit, quota, python, automation, multi-account

使用方法

使用说明
核心用法
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/ 目录，多用户系统需注意文件权限 |