codex4ever

Name: codex4ever
Author: ItsOdeLeo

本地服务

codex4ever.comAI 与智能体52 天前更新

代码仓库访问官网

关于 codex4ever

Usage Planner 是用于规划 OpenAI Codex 每周额度的工具，提供网站和 Codex 插件。它在两周时间线上呈现用量、补充额度和备用 reset，并提供 reset 预测及策略选择；不会代为兑换 reset 或消耗额度。

主要功能

01预测额度用尽时间
02展示两周用量时间线
03根据公开历史预测额外 reset
04提供五种用量策略
05纳入备用 reset 和服务中断
06网站与插件采用相同计划

适用场景

01估算当前额度何时用尽
02围绕下次刷新选择用量节奏
03判断是否该使用备用 reset
04在 Codex 对话中查看额度计划

MCP 相关

项目通过 `usage-planner` 包向兼容的 MCP 客户端提供工具。读取本地额度需要同一设备上已登录的 Codex CLI；MCP 工具与网站和插件采用相同的规划规则。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "itsodeleo-codex4ever": {
      "command": "npx",
      "args": [
        "-y",
        "codex4ever"
      ]
    }
  }
}

启动命令npx -y codex4ever

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcodex4ever0.1.3stdio

工具

收录的工具列表 · 更新于 6 天前

参数	类型	必填	说明
language	enum	否	en \| zh-CN
timeZone	string	否

详细介绍

原文在翻译后有更新，译文可能不是最新。

Codex4ever — Codex 配额与重置规划器

在 Codex 中输入“open quota planning”，即可在侧边浏览器中打开 Codex4ever 规划器

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

_{在浏览器中运行 · 无需登录 · 或使用插件向 Codex 提问}

English · 中文简介

Codex4ever 是一款用于规划 OpenAI Codex 每周配额的工具。它会显示按当前使用速度配额何时耗尽、预测的额外重置是否可能先到，以及何时值得兑换已存储的重置。如果它对你有帮助，欢迎点亮 ⭐ 星标。

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

选择策略

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

在保持当前节奏、保持可用、用完所有额度、仅工作日使用和周末集中使用之间切换，会更新时间线

功能

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

规划方式

只有当预测重置在当前生效的刷新之前发生的可能性至少达到 60%时，才会将其计入计划；时间会设为保守时间（即它最可能已经发生的时间），而非概率最高的单个小时。你可以在时间线上将计入次数切换为 0、1 或 2。
每次补充都会重新开始七天周期——无论是已存储的重置、额外重置还是常规刷新。
**已存储的重置：**额外重置用于应对服务中断；按最早到期优先使用；最后一次重置会保留，以应对真正的服务中断（24 小时或更长）；即将到期的重置也可以使用，避免浪费。
**统一规则：**网站、插件页面和插件的 MCP 工具，对相同输入始终给出相同计划。

此预测是未经校准的模型估算，并非保证。Codex4ever 绝不会替你兑换重置或消耗额度。

使用方法

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

codex plugin marketplace add ItsOdeLeo/codex4ever
codex plugin add codex4ever@codex4ever

新建一个 Codex 聊天，并询问："打开额度规划。" 读取你的额度是本地只读操作；无需单独的 API 密钥。

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

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

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

本地运行：

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

数据来源

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

开发

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

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

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

中文简介

Codex4ever 是一款用于 OpenAI Codex 每周额度的本地规划器：它会根据你当前的使用速度显示额度何时耗尽、额外重置是否可能先到，以及何时值得使用备用重置。仅当“在正常刷新前发生的概率 ≥ 60%”时，才会计入预测的重置，并采用保守时间；每次补满都会重新开始 7 天周期；默认至少保留一个备用重置。网页、插件页面和插件的 MCP 工具始终使用同一套规则。这是非官方工具，与 OpenAI 无隶属关系。详细设计见技术说明。