Codex配额

技能简介

Codex配额（codex-quota）用于检查 OpenAI Codex CLI 的速率限制状态（日/周配额）。使用本地会话日志，便携式 Python 脚本，支持多账号查询。

业务背景

开发团队使用Codex CLI时，常因配额耗尽导致工作中断。该工具让业务人员无需技术背景即可随时查看OpenAI Codex的日/周用量余额、重置时间及倒计时，提前规划编码任务，避免关键节点因配额不足而停滞，保障AI辅助开发的连续性。

落地案例：某产品经理周一安排本周代码审查计划，运行codex-quota发现主窗口（5小时）配额已用80%，次窗口（7天）剩余充足。结合显示的周三重置时间，他将高消耗的重构任务调整至周四执行，确保每日核心需求不受限，团队交付节奏稳定可控。

能做什么

• 显示当前配额（从最新会话缓存）
• 实时查询配额（–fresh）
• 更新所有账号配额（–all）
• JSON 格式输出
• 显示主窗口（5小时）和次窗口（7天）配额
• 显示重置时间和倒计时

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install codex-quota

运行脚本：

./codex-quota.py 或 codex-quota（如已安装到 PATH）

选项：

codex-quota — 显示当前配额（缓存）

codex-quota --fresh — 先 ping Codex 获取实时数据

codex-quota --all --yes — 更新所有账号，保存到 /tmp/codex-quota-all.json

codex-quota --json — JSON 格式输出

codex-quota --help — 显示帮助

显示内容：

• 主窗口（5小时）— 短期速率限制
• 次窗口（7天）— 周速率限制
• 重置时间（本地时区）和倒计时
• 来源会话文件和年龄

使用场景：开始大量 Codex 工作前检查周配额，Codex 变慢时检查是否被限速，监控多账号配额。

注意：读取 ~/.codex/sessions/ 获取配额数据。使用 –all –yes 时临时切换账号（覆盖 ~/.codex/auth.json，之后恢复）以查询每个账号。

输入与输出

见下方输入与输出表格。

风险提示

• 需要 Python 3 和 codex CLI
• 读取 ~/.codex/sessions/ 中的会话数据
• –all 模式临时修改 ~/.codex/auth.json（会自动恢复）
• 配额数据基于本地会话日志，可能不是实时

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/odrobnik/codex-quota/SKILL.md

来源类型：GitHub