Codex の週次上限が一日で枯渇:5 つの対処法と支出を頭打ちにする drop-in API(2026)
(updated )

Codex の週次上限が一日で枯渇:5 つの対処法と支出を頭打ちにする drop-in API(2026)

2026 年 5 月 17 日、Plus ユーザーが Codex の週次メーターを残量 96% から 0% へ 1 日で落ちるのを目撃しました — インシデントを認めた OpenAI の担当者でさえ、自然な週次ウィンドウまでカウンターがリセットされる保証はできませんでした。週次上限が月に 2 回死ぬなら、2026 年の正解は /status をリロードし続けることではなく、Codex CLI をトークン課金エンドポイントへつなぎ、カレンダーではなくウォレットで支出を頭打ちにすることです。

この記事は枯渇した週次上限への具体的な修正パスを通します:OpenAI Responses 互換の drop-in API を ~/.codex/config.toml の 1 ブロックで構成し、月額請求を制限内に保つ 3 つのパターンを添えます。カスタム プロバイダー、ヘッダー、モデル識別子を含む完全な構成リファレンスは カスタム API エンドポイントで Codex CLI を構成する を参照してください。

あなたの Codex クォータは本当に枯渇していますか? 30 秒診断

何かを変える前に、メーターが本当に問題なのか、それともクォータ エラーに見える接続エラーやモデル エラーなのかを確かめます。

症状/status の表示実際の意味最初の手
バナー: “You’ve hit your weekly limit”weekly: 0% remaining週次上限枯渇、5 時間にはまだ余裕があり得る週次外のルート(drop-in API)を試すか、繰越リセットを使う
バナー: “5-hour limit reached”5h: 0% remaining / weekly > 0%短窓のスロットルだけ待つ、非 CLI 作業へ切り替える、または同じプロンプトを drop-in API へ流す
エラー: usage_limit_reachedweekly と 5h の両方が > 0%同期ずれカウンター バグ(2026 年 5 月の既知問題)CLI を再起動;持続するなら OpenAI status へ報告して drop-in フォールバックを使う
エラー: Unsupported wire_apiプロバイダー不一致カスタム プロバイダーが Responses API を話さないモデルを切り替えるか Responses トランスレーターを追加

まず codex で Codex REPL を起動し、最初に /status と入力します。週次メーターは非ゼロなのにセッションを開始できないなら、それは OpenAI の Tibo が 2026 年 5 月に X で公に認めた同期ずれバグです — カウンター調整を待つより drop-in API へ手を伸ばす方が速い場面です。

いつこれらの修正を適用するか(と、ただ待てばいい場合)

すべての枯渇が構成変更に値するわけではありません。config.toml を触る前にこのゲートを通してください。

いま修正する(drop-in API を構成する):

  • 週次メーターが暦月内に 1 回より多く死ぬのに、出荷の最中である。
  • 金曜午後に上限に当たり、自然リセットがスプリント終了後にしか来ない。
  • Plus ユーザーで、リフレッシュ直後に 5h: 0% remaining を見ている — 2026 年 5 月の同期ずれパターン。

待つ:

  • 自然な週次リセットまで 24 時間以内で、作業は緊急ではない。
  • 繰越リセットが使える(サードパーティ報告では 2026 年 6 月 12 日頃から対象アカウントで利用可能)状態で、残りの作業が 1 ウィンドウに収まる。
  • Pro に乗っていて、上限の落ち幅が 25% 未満 — Pro のスループット余裕はシングル スプリントのピークを一般に吸収します。

ストップ ルール: 月次の Codex 課金等価額(サブスク + 超過分)が Pro シート 2 つを超えるなら、サブスク ティア間を行ったり来たりするのではなく、恒久的に従量課金 API へ移るべきです。先に価格計算のセクションを読んでください — 算数で決まるなら以降は飛ばしてかまいません。

Codex の利用上限を理解する:5 時間、週次、クレジット

Codex は 4 つのメーターを重ねていて、どれが先に発火するかで失敗モードが変わります。

メータースコープリセット周期何が消費するか
5 時間ウィンドウCLI + クラウド タスクの両メッセージローリング 5 時間バーストするアクティブ セッション、マルチターン リファクタ
週次上限同じプール、より広い窓ローリング 7 日持続的な日常作業、長時間の自律走行
クレジットプラン依存、アカウント側プラン条項に沿って補充プランが対応するときに週次を延長
繰越レート リミット リセットアカウント側トークン使ったあとはリファラル/プラン付与で補充カウンターをワンショットでクリア

公式ドキュメントが匂わせる程度のディテール:

  • 単一プロンプトの破壊力:2025 年 11 月のコミュニティ スレッド 「single prompt eats 7% of weekly limits」 で、Plus ユーザーは Codex CLI 単発コールがあるモデル バリアントでおよそ週次上限の 7% を消費するのを実測しました。この形は以下の 2026 年 5 月インシデントでも維持されています — 1 週間にこの種のプロンプトを 14 回出せば乾上がります。
  • ローカル オンリーでは救われない:スレッド 「Weekly limit ran out even though I never hit the 5-hour limit」 は 5 時間の動きなしに週次が枯れる様子を記録しています — メーターは独立で、週次は累積で発火します。
  • クレジットは補充ボタンではない:OpenAI はクレジットを「全般的な上限補充」と明示的には位置付けていません。サポート対象のワークフローを延長するもので、すべての安全境界ではありません。

完全なメーター解説は How Codex Usage Limits Work を参照。

週次上限が 5 時間より早く枯れる理由

2026 年の Codex のメーター形状で最も直感に反する点は、不意打ちをくらうのが週次で 5 時間ではないことです。構造的な理由が 3 つあります:

クラウド タスクは数え方が違う。 ローカル ファイルへ素早い編集を投げる Codex CLI セッションは小さな一切れを消費します。同じプロンプトを多段プランニングとツール使用つきのクラウド タスクとしてルーティングすると、5 時間の天井に触れずに週次の課金等価量が何倍にもなり得ます — クラウド タスクの仕事はローカルのローリング ウィンドウの外で起きますが、週次アキュムレーターには載るからです。

推論重めのバリアントは複利で効く。 リファクタ ベンチで最高得点を出す Codex 調整版 — 仕事が重い金曜午後に手を伸ばす連中 — は同時にコールあたり最も燃焼するモデルでもあります。最上位バリアントでの 30 分以上の自律走行 1 本は、週次予算の物差しで通常の Plus メッセージ数十本に等しくなり得ます。

メーターは非同期に整合される。 5 時間はローカルの意図を反映し、週次はクレジット、クラウド タスク、プラン側調整のあとのサーバー側調整を反映します。OpenAI が公に認めた 2026 年 5 月の同期ずれ事件はこの整合の可視化された失敗ですが、通常の日々の利用でも軽微な同期ギャップが発生し、たまに積み重なって「俺の 1 週間の 30% どこ行った?」の瞬間になります。

実戦の結論:5 時間の観察で予算を立てないでください。週次メーターを実際の天井として読み、5 時間はバーストごとのレート リミット ガードとして読みます。最初から週次メーターを計画単位として扱えば、水曜に驚かなくて済みます。

週次上限が枯渇したときの復帰方法(ティア別)

Free / Go ティア

flowchart LR
    A[週次枯渇] --> B{繰越リセットがある?}
    B -->|あり| C[いま使う]
    B -->|なし| D{リファラル ウィンドウ中?<br/>2026 年 6 月 11–24 日}
    D -->|はい| E[最大 3 人を招待]
    D -->|いいえ| F[CLI を drop-in API へ切替]
    C --> G[作業再開]
    E --> G
    F --> G

Go ティアの週次上限は最も小さいです。対象アカウントに同梱される無料の繰越リセットは、最もレバレッジの高い一手 — 後回しにできないセッションで使ってください。

Plus ティア

選ぶタイミング工数
繰越リセットを使う1 回持っていて、残り作業が 1 つの週次ウィンドウに収まる5 秒
対象のクレジットを有効化ダッシュボードにクレジットが表示されている30 秒
drop-in API へ切替月 2 回以上枯渇している一度きりのセットアップ 3 分
Pro へアップグレードリセット後 3 日以内に週次を毎回使い切るOpenAI のプラン ページに準拠

Plus は 2026 年 5 月の同期ずれインシデントに最も弱いメーターで、96%→0% スレッド の報告は Plus が大半を占めます。このパターンが再発するなら、drop-in API はフォールバックではなく主ルートとして扱ってください。

Pro ティア

Pro は週次に最も余裕がありますが、無敵ではありません。同じ 2026 年 5 月インシデントで、ある Pro ユーザーは重い作業なしに週次上限が 1 時間で 100% から 60% に落ちたと報告しました。復帰パスは Plus と同じで、違いは Pro 20x ティアの方が単一プロンプト被害に耐えが長いという点です。

アカウント側状態の確認には、codex を実行して /status でセッション内の 5h / weekly カウンターを見て、platform.openai.com/usage の OpenAI 利用ダッシュボードと比べます。セッション内メーターはクライアント側ビュー、ダッシュボードはサーバー側調整です。両者が 10 ポイントを超えてずれているとき、それは OpenAI の Tibo が 2026 年 5 月に認めた同期ずれパターンです — CLI を再起動し、ギャップが続くならカウンター調整を待たずに以下の drop-in API パスへ切り替えてください。

2026 年 Codex 週次上限インシデント:実際に何が早く枯れたか

日付プラン何が起きたかソース
2026 年 4 月 28 日全有料プランアカウント全体のレート リミット リセット イベント(計画的)OpenAI コミュニティ告知
2026 年 5 月 17 日Plusユーザー afaqak:最小限の利用で週次が 1 日で 96%→0%コミュニティ スレッド #1381172
2026 年 5 月 18 日Proユーザー 3rtech:重作業なしに 1 時間で 100%→60%同じスレッド
2026 年 5 月 18 日Plusユーザー Brian_Henderson:再起動直後の 5 時間ウィンドウで残量 0%同じスレッド
2026 年 5 月 20 日Plusユーザー minifi:1 つの Codex 調整版モデル バリアントだけで枯渇同じスレッド
2026 年 6 月 12 日頃(サードパーティ報告)Go / Plus / Pro / Businessリセット繰越機能の展開開始 — 各アカウントに無料リセット 1 回が付くとされる;一次情報の告知ページは未発見Pasquale Pillitteri ニュース ブリーフ

パターン:メーターはサーバー側で調整され、カウンター同期ずれが最も頻繁に当たる失敗モードです。drop-in API はその失敗モードをまるごと取り除きます — メーターがあなたのウォレットに乗るからです。

drop-in API での修正:Codex CLI を 5 行で構成

2026 年 2 月のワイヤー プロトコル変更がここでは効きます。Codex CLI は Chat Completions サポートを落とし、今や OpenAI Responses API しか話しません。指し示すプロバイダーは /v1/responses を露出する必要があります。ofox.ai のドキュメント化された Codex 統合が wire_api = "responses" を設定しているのは、まさにこの制約のためです。

Step 1:API キーを取得

プロバイダーへサインインし、キーを作成して export します。

export OPENAI_API_KEY="ofx_live_..."

Step 2:~/.codex/config.toml を編集

[model_providers.<id>] ブロックを追加します。プロバイダー id openai は予約されているので、他のラベルを使ってください。

model = "openai/gpt-5.4-mini"
model_provider = "ofox"

[model_providers.ofox]
name = "ofox.ai Responses API"
base_url = "https://api.ofox.ai/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

Step 3:/status と単発コールで検証

REPL を起動してアクティブ モデルとメーターを確認し、続いて非インタラクティブ exec モードで one-shot を送ります:

codex            # REPL を開き、プロンプトで /status を入力
codex exec "print hello in python"

one-shot が成功すればワイヤー プロトコルが噛み合った合図です。Unsupported wire_api が出る場合は選んだモデルが Responses をサポートしません — ofox モデル マーケットプレイスで Responses タグの付いた Codex 調整版バリアントを選ぶか、How to Use Any Model with Codex CLI のより深い解説を読んでください。

Step 4:セッションごとのモデル上書き(任意)

一度きりの複雑なリファクタには、構成を書き換えずにモデルを差し替えます(Codex CLI は -m / --model を受け取り、exec と組み合わせて単発非インタラクティブ実行ができます):

codex exec -m openai/gpt-5.5 "refactor the auth middleware"

各構成ブロックのフィールド解説が必要なら、Codex CLI config.toml 詳説 が標準リファレンス、TOML を避けて環境変数だけのパスを取りたいなら Codex CLI API 構成ガイド を参照してください。

セットアップ中によくあるエラー

エラー原因修正
Unsupported wire_apiモデルが /v1/responses を実装していないCodex 調整版バリアントを選ぶ;マーケットプレイスがサポート モデルにタグを付けています
Authentication failedbase_url の末尾スラッシュ、または環境変数違い厳密に https://api.ofox.ai/v1 を使用;env_key が export 名と一致しているか確認
Provider id reservedブロック ラベルに openaiollamalmstudio を使ったブロック名を変える、例 [model_providers.ofox]
Model not foundプロバイダー プレフィックスが間違いモデル id に常にプロバイダー プレフィックスを含める、例 openai/gpt-5.4-minigpt-5.4-mini ではなく)
Connection resetCLI とエンドポイント間のネット/プロキシテスト時は企業 CA プロキシを外す;VPN なしで再試行

サブスクと drop-in を切り替えるときの落とし穴

モード間を初めて行き来するときだけ現れる微妙な挙動がいくつかあります:

  • /status は依然としてサブスク メーターを報告しますmodel_provider が drop-in を指していても。CLI は drop-in アカウント残高を /status に出しません — プロバイダー ダッシュボードで確認してください。ダッシュボードが健全な残高を示すのに /status が週次 0% を見せるなら、見ているのはサブスク メーターであって drop-in ではありません。
  • 認証トークンは同じ環境変数を共有します。 OPENAI_API_KEY に OpenAI キーを残したまま同じ変数で drop-in キーへ差し替えると、それ以降の CLI 呼び出しはすべて drop-in に行き、戻すまで続きます。警告は出ません。日次で切り替えるなら別個のシェル エイリアス(use-plususe-ofox)を使ってください。
  • プロジェクト単位の構成はグローバルを上書きします。プロジェクト ルートの ./codex.toml~/.codex/config.toml を上書きします。チーム drop-in 構成をプロジェクト レベルでコミットしておけば、共有コードのデバッグ中にエンジニアが個人 Plus 経由でルーティングしてしまう事故を防げます。
  • セッション中のモデル スワップはツールをリフレッシュしません。セッション中に /model を打ってポップアップから別のバリアント(例 openai/gpt-5.5)を選ぶと、新しいモデルは前任が止めた場所から続けますが、キャッシュされたツール記述は再生成されません。旗艦級スワップ後にツール使用にリグレッションが見えるならセッションを再起動してください。

drop-in API で支出を頭打ちにする 3 つのパターン

トークン課金ルートがサブスクに勝つのは、実際に請求を制限内に保てているときだけです。3 つのパターンを強制力の順で並べます。

Pattern 1 — プリペイド ウォレット上限(最強の停止)

アカウントを定額(たとえば $20)でトップ アップします。ウォレットがゼロに達すると API はコールを拒否します。これだけが運用ミスをくぐり抜けて生き残る修正です — 停止がローカル構成ではなく上流で強制されるからです。

トップ アップ前の残高チェックはローカル スクリプトではなくプロバイダー ダッシュボードからやってください — ダッシュボードの数値が正で、ローカル キャッシュとアカウント状態の乖離を避けられます。

Pattern 2 — タスクごとのティア ダウングレード

タスクごとに「使える中で最安」のモデルを使います。Codex CLI のモデル フラグはコール単位なので、コマンド意図でティアを選ぶラッパー スクリプトがコール単価を正直に保ちます。

codex_tiered() {
  case "$1" in
    refactor|migrate) codex exec -m openai/gpt-5.5 "${@:2}" ;;
    *) codex exec -m openai/gpt-5.4-mini "${@:2}" ;;
  esac
}

ダウングレードはコードベースから見えません — 完全にシェル内で完結します。

Pattern 3 — 日次予算 cron

ローカル アキュムレーターで日次支出を頭打ちにします。アキュムレーターは cron で深夜にリセットされ、ラッパーは日次上限に達したらコールを中止します。

# ~/.codex/budget.sh
TODAY=$(date +%F)
SPENT_FILE=~/.codex/spent.$TODAY
DAY_CAP_USD="${DAY_CAP_USD:-3.00}"
spent=$(cat "$SPENT_FILE" 2>/dev/null || echo 0)
awk -v s="$spent" -v c="$DAY_CAP_USD" 'BEGIN{exit !(s<c)}' || {
  echo "Codex daily cap $DAY_CAP_USD reached. Wait or raise DAY_CAP_USD." >&2
  exit 1
}
codex "$@"

この数式が正直なのは、コールごとのコストを $SPENT_FILE に毎回書き戻したときだけ — post-call フックを仕込んでください。

パターン停止が強制される場所オーバーラン リスク向き
プリペイド ウォレット上流アカウントなし(ハード ストップ)ソロ開発、固定月予算
ティア ダウングレードコールごとのモデル フラグ中(総量天井なし)混合タスク ワークロード
日次予算 cronローカル シェル ラッパー高(ローカルのみ、バイパス可)説明責任が必要なチーム共有シェル

3 つから選ぶには

1 つだけ取るならプリペイドを選んでください。これだけがバッド デイをくぐり抜けて残る仕組みです — Slack タブが開きっぱなし、ターミナルを忘れた、休暇前金曜の暴走ループ。ウォレット上限は未来のあなたの規律ではなく、ストレス下の未来のあなたが上書きできない上流強制です。

残りはその上に重ねます:

  • プリペイド ウォレット単独で「メーター見忘れ」失敗モードを止めます。
  • プリペイド + ティア ダウングレードで「このタスクは旗艦じゃなくてよかった」を止め、実運用でウォレットを 3〜5 倍延ばします。
  • 3 つ全部で、その日のうちに驚きを浮かび上がらせる日次ソフト キャップを得ながら、ウォレットをハード バックストップとして信用できます。Codex がミッション クリティカルなチームの推奨スタックです。

ティア ダウングレード固有のメモ:リファクタ タスクで最安モデルを追わないでください。Codex 調整版の最小バリアントと旗艦のコスト差は、応答劣化が引き起こすデバッグ往復 1 回分のコストより小さいことが多いです。リファクタとマイグレーションには旗艦を、ボイラープレート生成、フォーマット、1 行編集には小型バリアントを — そういう場所では差がほぼ出ません。

チーム/マルチ開発者構成

上のパターンは、上限を各エンジニアのシェルではなくプロバイダー アカウントに引き上げることでチームにスケールします。守る価値のある習慣が 3 つ:

  1. チームに ofox アカウント 1 つ、エンジニアごとに別個の API キー — 個人をローテーションなしで失効でき、ウォレット上限がプール全体に適用されます。
  2. チーム config.toml を dotfiles に固定 — 衛生化したバージョンをチームの dotfiles リポジトリへコミットし、全エンジニアの Codex CLI が同じプロバイダー/ワイヤー/モデル既定値に着地するようにします;API キーだけはエンジニアごとに ~/.config/credentials に残し、リポには入れません。
  3. 週次支出ダイジェスト — プロバイダーの利用エクスポートを月曜の Slack ダイジェストに送れば、スパイクは月末ではなく数日内に表面化します。一度配線すれば、幻の $400 請求のデバッグはもう不要です。

共有 Codex プールにエンジニアが 5 人以上いるなら、カスタム API エンドポイントで Codex CLI を構成する方法 は Ansible で展開しやすい環境変数だけのセットアップを扱っています。

スプリント途中の移行をストールなしで行う

現実のチーム状況はこうです:エンジニアの半分は個人 Plus サブスクで Codex CLI を構成してスプリントの真っ最中、チーム アカウントは Pro でついさっき週次に当たった。全員に手を止めて再構成してもらうわけにはいきません。スプリントを生かす 3 手:

  1. チーム API キーを個人環境変数の上書きに昇格 — エンジニアは export OPENAI_API_KEY=$TEAM_OFOX_KEYexport OPENAI_BASE_URL=https://api.ofox.ai/v1 をシェル rc に追加するだけで、config.toml の変更は不要です。Codex CLI の環境変数経路がセッションの間、個人サブスクを上書きします。
  2. 旗艦モデルを最長リファクタのエンジニアに予約 — 残りのチームは Codex 調整版の小型バリアントを使います。1 スプリント日に取れる最安の復帰姿勢です。
  3. 翌朝、どのセッションが本当に超過を必要としていたか監査 — チーム週次枯渇が単発(1 人の自律走行)なら、環境変数を戻してサブスクに残ります。パターン化しているなら、次のスタンドアップで config.toml を dotfiles にコミットし、行き来をやめます。

ほとんどのチームが犯すミスは、drop-in API をパニック手とみなし、週次が戻った瞬間に巻き戻すことです。正しいフレームは逆で、サブスクは予測可能なソロ作業のデフォルト、メータード API は持続的なチーム作業のデフォルトです。週次枯渇は単に「デフォルトを間違えている」というシグナルにすぎません。

drop-in API が落ちているとき:いま使える最良の代替

代替ワイヤー プロトコルCodex CLI 対応選ぶタイミング
ofox.aiResponses + Chat Completions対応、マーケットプレイスが Responses 可能モデルにタグ混合コーディング ワークロード、モデル別価格が見えるトークン課金(Codex 統合ドキュメント
OpenRouterルーター経由の Responses 面対応多プロバイダーを 1 請求にまとめたい、ルーター マークアップを受け入れる
直接 OpenAI APIネイティブ Responses対応ChatGPT と同じモデル ID が欲しい、フル小売価格を受け入れる
セルフホスト(LiteLLM ゲートウェイ)Chat → Responses を翻訳トランスレーター付きで対応すでにゲートウェイを動かしていて任意の Chat-only バックエンドからルートしたい
自然リセットを待つ該当なし該当なし作業が次の週次ウィンドウ(繰越リセット余裕込み)に収まる

クロス プロバイダー フェイルオーバーのルーティング深掘りは、カスタム API エンドポイントで Codex CLI を構成するHow to Use Any Model with Codex CLI を参照してください。

Codex のステータスを監視してアラートを得る方法

3 層、解像度の上昇順で。

  1. 公式ステータス ページstatus.openai.com をブックマーク — メーター同期ずれインシデントはコミュニティ報告から数時間以内にここへ載ります。
  2. セッション内 /status:Codex REPL のプロンプトで(codex 起動後に)入力すると、アクティブ モデル、5hweekly の残量を表示します。コール コストは安いので、長いタスクの前に毎回叩いてください。
  3. アカウント ダッシュボード ポーリング:利用エンドポイントを 5 分 cron で叩けば、/status とサーバー側カウンターのドリフト(2026 年 5 月の同期ずれパターン)を捕まえられます。weekly < 10% で Slack へ流してください。

より深いポーリングには、OpenAI の利用エンドポイントがアカウント単位の累計消費を返すので cron でスクレイプできます — ダッシュボード ビューは platform.openai.com/usage、各メーターが実際に何を表すかは OpenAI ヘルプ センターの Codex プラン上限メモ を参照。ダッシュボードとセッション内 /status の相互チェックが、2026 年 5 月の調整ギャップ パターンを早期に捕まえる単体で最も有用なシグナルです。

この記事が扱わないこと

正しいリファレンスへ案内するためのスコープ境界をいくつか:

週次の Codex 上限が月に 2 回死ぬなら、メータード API に切り替えてプリペイド ウォレットを頭打ちにすることはダウングレードではありません — ビュッフェからテイクアウト メニューへの切替で、実際に注文した皿だけに支払い、出荷した仕事だけにメーターが回る、その違いです。

このリフレッシュで確認したソース