usage-planner

Usage Planner — Codex 配额与重置规划器

了解今天可以使用多少 Codex。

如果你觉得它有用，点个 ⭐ 星标可以让更多人发现它。

_{在浏览器中运行 · 无需登录 · 或通过插件询问 Codex}

English · 中文简介

Usage Planner（原名 Codex4ever）是一款用于规划 OpenAI Codex 每周配额的工具。它会显示按当前使用速度何时会耗尽配额、预测的额外重置是否可能先到，以及何时值得兑换已存的重置次数。

非官方项目；与 OpenAI 无关。采用 MIT 许可证。

选择策略

在 Codex 中询问一次，规划器就会在聊天旁边打开。选择一种策略，计划就会随之变化：每日用量、补充额度和耗尽时间点。

功能

• 未来两周的时间线 — 按天显示每日用量、剩余配额、耗尽时间点、服务中断、常规刷新和已存重置次数的使用情况。
• 额外重置预测 — 预测未来 48 小时内自动重置的概率、可能的时间窗口，以及以首次重置为条件预测的第二次重置；预测基于公开的重置历史和 Tibo 的公开帖子。
• 五种策略 — 保持当前节奏（按当前速度使用：查看配额何时耗尽）、保持可用、全部用完（在下一次补充前用完配额）、仅工作日、周末集中使用。
• Codex 插件 — 读取你本地已登录账户的配额和已存重置次数，在对话中制定计划，并打开同一可视化规划器。

规划方式

• 只有在生效的刷新之前，预测重置的发生概率至少达到 60%，才会将其计入；并且会将它安排在一个保守的时间点（即它很可能已经发生的时间），而不是最可能发生的单个小时。你可以在时间线上将计入次数设为 0、1 或 2。
• 每次补充都会重新开始为期 7 天的窗口——无论是已存重置、额外重置还是常规刷新。
• **已存重置次数：**额外次数用于应对服务中断，并优先使用最早到期的次数；最后一次会保留，以应对实际服务中断（24 小时或更长）；即将到期的次数可以使用，而不是白白浪费。
• **处处遵循同一规则：**对于相同的输入，网站、插件页面和插件的 MCP 工具始终给出相同的计划。

预测是未经校准的模型估算，并非承诺。Usage Planner 不会替你兑换重置次数或消耗额度。

使用方法

Codex 插件（Node.js 20+，并且已登录 Codex 应用或 CLI）：

codex plugin marketplace add ItsOdeLeo/usage-planner
codex plugin add usage-planner@usage-planner

开始新的 Codex 对话，并询问：“打开额度规划。” 读取你的额度是本地且只读的；无需单独的 API 密钥。

其他 MCP 客户端（Claude Code、Claude Desktop、Cursor 等）：同一服务已发布到 npm，名为 usage-planner，也已收录于 MCP Registry，名称为 io.github.ItsOdeLeo/usage-planner。读取你的额度仍需在同一台机器上登录 Codex CLI。

{ "mcpServers": { "usage-planner": { "command": "npx", "args": ["-y", "usage-planner"] } } }

网站： usageplanner.com，无需安装。手动输入额度；所有计算都在浏览器中进行，你的输入不会发送到任何地方。

本地运行：

npm install
npm run web          # http://127.0.0.1:4173/
npm test

数据来源

公开的重置数据来自 Codex Resets，包括随附的离线存档（npm run archive:refresh）。感谢其维护者。使用可选的 X API 令牌后，Tibo 的完整时间线会直接从 X 读取。

开发

命令	作用
npm run web	启动本地网站，显示实时重置依据（缓存 30 分钟）
npm run site:build	在 dist/ 中生成静态网站，并在构建时收集依据
npm run plugin:build	生成独立的 Codex 插件，位于 plugins/usage-planner/
npm run mcp	从源代码运行 MCP 服务
npm run backtest:public	按天回放预测，并与公开历史记录进行对比

.github/workflows/deploy-site.yml 每 30 分钟重新构建静态网站，并将其部署到 Cloudflare Pages。可选设置（对帖子进行 LLM 分类、访问 X 时间线）列在 .env.example 中；密钥只会在构建时读取，不会传到浏览器。

设计和算法详情：docs/technical-notes.zh.md（中文）。

中文简介

Usage Planner（原名 Codex4ever）是 OpenAI Codex 每周额度的本地规划器：按你当前的速度显示额度什么时候用完、额外 reset 是否可能先到，以及备用 reset 什么时候值得用。预测的 reset 只在“正常刷新前发生的概率 ≥ 60%”时计入，并放在保守时刻；任何一次补满都会重新开始 7 天周期；备用默认至少保留一个。网页、插件页面和插件的 MCP 工具始终使用同一套规则。非官方工具，与 OpenAI 无隶属关系。详细设计见 技术说明。

作者

由欧的Leo 构建 — X 上的 @ItsOdeLeo · 小红书 ItsOdeLeo。欢迎在上述平台或 GitHub 问题区反馈意见和想法。