Codex Quota

核心用法

codex-quota 是一个轻量级 Python 脚本，用于检查 OpenAI Codex CLI 的速率限制配额状态。它通过读取本地会话日志（~/.codex/sessions/）中的 rate_limits 数据，展示当前账户的 5 小时短期窗口和 7 天长期窗口配额使用情况。

主要功能

• 本地数据优先：默认读取缓存的最新会话数据，无需网络请求
• 实时刷新：--fresh 选项先 ping Codex 获取最新数据
• 多账户支持：--all --yes 可遍历所有已保存账户，输出聚合 JSON
• 多种格式：支持人类可读格式和 --json 机器解析格式
• 时区友好：自动转换重置时间为本地时区并显示倒计时

显著优点

1. 零配置成本：直接利用 Codex CLI 已有的会话数据，无需额外 API 密钥
2. 隐私安全：数据完全本地处理，不向第三方发送配额信息
3. 跨平台：纯 Python 3 实现，兼容 macOS/Linux/Windows
4. 轻量快速：单文件脚本，启动即查，适合集成到 shell prompt

潜在局限

• 依赖 Codex CLI 使用：必须已有 Codex CLI 生成过会话日志才能获取数据
• 数据时效性：非 --fresh 模式下显示的是上次会话的配额状态
• 账户切换需确认：多账户操作需要显式 --yes 标志，交互稍显繁琐
• 无历史趋势：仅展示当前状态，不提供配额使用趋势分析

适合人群

• 高频使用 Codex CLI 的开发者，需要频繁检查剩余配额
• 拥有多个 OpenAI 账户需要统一管理配额的团队用户
• 希望在 shell 环境中快速集成配额检查到工作流的效率用户

常规风险

• 路径依赖：硬编码依赖 ~/.codex/sessions/ 目录结构，若 Codex CLI 变更存储格式可能失效
• 会话隐私：脚本需要读取本地会话文件，虽然不上传，但在共享环境需确保文件权限正确
• --all 模式生成的 /tmp/codex-quota-all.json 临时文件可能暴露多账户信息，公共机器使用后建议清理

核心功能

codex-quota 是一款轻量级 Python 命令行工具，专为 OpenAI Codex CLI 用户设计。它通过读取本地会话文件（~/.codex/sessions/）解析速率限制数据，无需直接调用 OpenAI API。核心能力包括：

• 配额监控：显示 5 小时（Primary Window）和 7 天（Secondary Window）双窗口速率限制
• 实时刷新：--fresh 模式通过调用 Codex CLI 获取最新数据
• 多账户支持：--all --yes 可切换并汇总多个账户配额
• 灵活输出：支持格式化文本与 JSON 格式（--json）

显著优点

1. 零依赖安全：仅使用 Python 标准库（json, os, sys, datetime, pathlib），无第三方包引入供应链风险
2. 本地优先：数据完全本地处理，不上传用户会话或配额信息至外部服务
3. 权限最小化：无需 API 密钥，依赖用户已授权的 Codex CLI 环境
4. 实现规范：subprocess 调用使用参数列表（非 shell=True），路径处理使用 pathlib，符合 Python 安全最佳实践

潜在局限

• 依赖 Codex CLI：工具本身不直接查询 OpenAI API，需依赖本地安装的 codex 命令行工具
• T3 来源可信度：由个人开发者维护，虽 MIT 开源可查，但相比企业级项目（T1/T2）审查强度有限
• 隐私扫描警告：读取 ~/.codex/ 目录下的会话与账户配置，虽为功能必需，但需用户确保目录权限正确（建议 chmod 700 ~/.codex）
• 临时文件写入：多账户模式下写入 /tmp/codex-quota-all.json，共享环境需注意清理

适合人群

• 高频使用 OpenAI Codex CLI 的开发者
• 需要监控多账户配额的企业/团队用户
• 对供应链安全敏感、倾向零依赖工具的技术用户

常规风险

| 风险项 | 级别 | 说明 |

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

| subprocess 调用 | 低 | 调用本地 codex CLI，参数列表传递，无 shell 注入风险 |

| 敏感数据读取 | 低 | 读取 ~/.codex/ 会话与配置，功能必需，不上传 |

| 来源可信度 | 中 | T3 级别，建议人工审查源码后使用 |

| 临时文件泄露 | 低 | /tmp/ 写入多账户数据，共享环境需定期清理 |

使用建议

首次使用前建议审查 codex-quota.py 源码（348 行，结构清晰），确认本地 codex 命令来源可信，并设置正确的配置文件权限。