codex4ever

Usage Planner — Codex の使用量上限とリセット計画ツール

今日どれだけ Codex を使えるかを把握しましょう。

役に立ったと思ったら、⭐ スターを付けて、より多くの人に知ってもらいましょう。

_{ブラウザーで動作 · サインイン不要 · またはプラグインを使って Codex に尋ねてください}

英語 · 中国語の概要

Usage Planner（旧称 Codex4ever）は、OpenAI Codex の週間使用量上限を計画するツールです。現在のペースで上限に達する時期、予測される追加リセットが先に発生しそうかどうか、蓄積したリセットをいつ使うのが有効かを表示します。

非公式のツールであり、OpenAI とは関係ありません。MIT ライセンスです。

戦略を選ぶ

Codex で一度尋ねると、チャットの横にプランナーが開きます。戦略を選ぶと、日ごとの使用量、補充、上限到達時点が変わります。

できること

• 今後2週間のタイムライン — 1日につき1列で、日ごとの使用量、残りの使用量上限、上限到達時点、障害、通常の更新、蓄積したリセットの使用を表示します。
• 追加リセットの予測 — 今後48時間以内に自動リセットが発生する可能性、発生しそうな時間帯、最初のリセットを条件とした2回目のリセットを、公開されているリセット履歴とTiboの公開投稿に基づいて表示します。
• 5つの戦略 — ペースを維持（現在のペースで使用し、上限に達する時期を確認）、利用可能な状態を維持、すべて使い切る（次の補充直前に上限を使い切る）、平日のみ、週末に集中。
• Codex プラグイン — ローカルのサインイン済みアカウントの使用量上限と蓄積したリセットを読み取り、会話内で計画を立て、同じビジュアルプランナーを開きます。

計画の仕組み

• 予測リセットは、適用中の更新より前に発生する可能性が60％以上の場合にのみ計上され、最も発生しやすい単一の時刻ではなく、発生済みである可能性が最も高い保守的な時刻に配置されます。タイムラインでは、計上数を0、1、2に切り替えられます。
• 補充のたびに7日間の期間が再スタートします — 蓄積したリセット、追加リセット、通常の更新のいずれも対象です。
• 蓄積したリセット： 余分な分は障害に備えて確保し、有効期限が最も早いものから使用します。最後の1つは実際の障害（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 チャットを開始し、"Open quota planning." と入力してください。使用量の読み取りはローカルで行われ、読み取り専用です。別途 API キーは必要ありません。

その他の MCP クライアント（Claude Code、Claude Desktop、Cursor など）：同じサーバーが npm の usage-planner として、また MCP Registry の 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 の週間使用量を計画するローカルツールです。現在の使用ペースに基づいて、使用量がいつ尽きるか、追加のリセットが先に発生する可能性があるか、予備のリセットをいつ使う価値があるかを表示します。リセットの予測は、「通常の更新より前に発生する確率が 60% 以上」の場合にのみ含め、保守的な時刻に設定します。使用量が満タンになるたびに 7 日間のサイクルが再開され、予備の使用量はデフォルトで少なくとも 1 つ残します。ウェブサイト、プラグインページ、プラグインの MCP ツールは、常に同じルールを使用します。非公式ツールであり、OpenAI とは関係ありません。詳しい設計については技術ノートをご覧ください。

作者

欧的Leo が開発 — X の @ItsOdeLeo · Xiaohongshu の ItsOdeLeo。フィードバックやアイデアは、こちらまたは GitHub の issue でお寄せください。