Vuncloud ブログ
← フィールドノートに戻る

Codexの週間上限に達したら:7つの対処法・上限の仕組み・代替API(2026)

Codex週間上限 · 5時間ウィンドウ · リセットトークン · Credits · GPT-5.4-mini · Claude Code · API Key代替 ·約11分

ターミナル上のコードとCLI——Codex週間上限枯渇後のトラブルシュートと代替API選定

水曜の午後、Codex CLI が突然 rate limit exceeded を返す——PR はまだ半分なのに。ネットワーク障害ではなく、2026 年 OpenAI が Codex にかけた二重ローリングクォータが効いている。本稿は「まず仕組みを読む → 修復ルートを選ぶ → 代替スタックを用意する」の順で、Weekly 上限に当たったあとの 7 つの現実解をフィールドノート調子で整理する。

2 層
ローリング:5 時間ウィンドウ + Weekly
7 種
待機から API 切替までの修復パス
30 日
保存型リセットトークン有効期間(2026.06)

一、Codex 上限の仕組み:どの層に当たった?

「メッセージ数だけ」だと思っている人が多いが、ChatGPT サブスク内の Codex(CLI、IDE 拡張、クラウドタスク)は独立した 2 つのローリング上限の下にある。公式は OpenAI Codex Pricing を参照。

1.1 5 時間ローリングウィンドウ

ローカル CLI メッセージ(Local Messages)とクラウドタスク(Cloud Tasks)は同じ 5 時間ウィンドウを共有する。カレンダー日ではなく、最初の消費から 5 時間がロールする。リポが大きい、Agent 推論が長い、クラウド経由——1 タスクあたりの負荷が大きいほど早く減る。

上限の症状:CLI で rate limit、IDE 拡張の送信ボタンがグレーアウト、クラウドタスクがキュー待ちまたは拒否。日常開発で最もよく当たる層

1.2 Weekly(週上限)

5 時間ウィンドウの上に、7 日ローリングの Weekly クォータがある。1 週間の高強度利用を抑えるための層。各 5h ウィンドウを「節約」していても、週累計で Weekly が 0% になることがある。

症状:5h には余裕があるのに突然全体がレート制限;CLI に Weekly 0% と明示。本稿タイトルの「Weekly 上限到達」はここ。

Context Window % とは別物

サードパーティ拡張がコンテキストを数千 % と表示することがある——それは現在セッションの token 占有率で、5h / Weekly とは無関係。トラブルシュートでは 5hWeeklyRemaining の行だけ見る。

1.3 CLI / IDE の % の読み方

Codex CLI と IDE 拡張はだいたい次のような表示:

Rate Limits Remaining: 5h 96%, Weekly 94%

キーワードは Remaining(残量)

  • Weekly 94% = 週クォータの 94% が残っている。94% 使い切った意味ではない
  • 5h 12% = 現在の 5 時間ウィンドウが 12% しか残っていない。まもなく上限
  • 0% または明確な rate limit エラーが出たときだけ、下記の修復策を使う

1.4 プラン別の目安(2026.06)

公式は固定整数ではなく「メッセージ数レンジ」で示す。同じ 1 メッセージでもリポ規模で作業量が桁違い。下表は GPT-5.3-Codex 档、5 時間 Local Messages のおおよそ(価格ページより):

プラン GPT-5.3-Codex / 5h(目安) GPT-5.4-mini / 5h(目安) 備考
ChatGPT Plus 10–60 60–350 Weekly も別途制約
Pro 5x Plus の約 5 倍 Plus の約 5 倍 2026 年 $100/月 档
Pro 20x Plus の約 20 倍 Plus の約 20 倍 並列・大規模向け
Business(非フレキシブル) Plus に近い Plus に近い シート課金
API Key 5h / Weekly サブスク枠なし token 課金 + レート制限

2026 年上半年、OpenAI は Plus / Pro を再編:$100 Pro(5x)、上位 20x を維持し、上限到達後はCredits 購入で続行可能に。数字は chatgpt.com/codex/pricing を正とする。

マトリックス風バイナリ背景——Codex の 5 時間ウィンドウと Weekly の二重クォータ
二層は独立してロールする。5h か Weekly かを切り分けてから修復策を選ぶ。

二、Weekly 上限到達:7 つの修復策

以下 7 つはコストの低い順。上から試し、いきなりプラン変更は避ける。

策 1:Weekly か 5h かを特定

「完全に使えない」ように見えても、5h だけ 0% で Weekly は余裕(またはその逆)のことがある。CLI で codex を実行して rate limit 行を確認するか、VS Code Codex 拡張のステータスバーを見る。

  • 5h 0% のみ → 5 時間ロール回復を待つ、またはリセットトークン(策 3)
  • Weekly 0% のみ → 7 日ロール回復、または Credits / アップグレード(策 5・6)
  • 両方 0 → 待機 + Credits の組み合わせと、策 7 の代替スタック計画

策 2:ローリング自然回復を待つ

ゼロコスト:新規タスクを止める。時間がウィンドウをロールさせる。

  • 5 時間ウィンドウ:最も早い消費から 5 時間後に枠が戻る
  • Weekly:7 日ロール。月曜 0 時一斉リセットではない

向く場面:緊急でない bug 修正、Code Review やドキュメントに切り替えられる時間帯。向かない場面:CI 前夜、リリースウィンドウ——策 3〜7 を検討。

策 3:保存型リセットトークンを使う

2026 年 6 月、OpenAI は Go / Plus / Pro / Business 向けに保存可能な rate limit reset を導入。固定時刻の一括クリアではなく、必要なとき手動で発火し、標準用量ウィンドウを即復帰させる「リセットコイン」。

  • ロールアウト時、対象アカウントに最低 1 枚の無料リセット
  • 各枚の有効期限 30 日。期限切れで失効
  • プロモ期間中、招待で追加リセット(詳細は公式告知)

注意:changelog は主に「標準用量ウィンドウ」の復帰を説明。Weekly 同時クリアは明記されていない。実務では5 時間ウィンドウの急救と割り切る。Weekly はロール回復か Credits に頼る。

策 4:GPT-5.4-mini に切替えて消費を抑える

同一プラン内でGPT-5.4-mini のメッセージ上限は GPT-5.3-Codex フルサイズより大幅に高い(Plus 档 mini 約 60–350 / 5h、Codex 約 10–60)。CLI または IDE でモデル切替:

# 例:モデル切替対応セッションで mini 档を指定
/model gpt-5.4-mini

向く:単ファイルリファクタ、テスト追加、lint 修正、PR コメント返信。向かない:モジュール横断アーキテクチャ移行、複雑な並行 bug——mini で試行錯誤が増え、逆にクォータを食う。

策 5:Credits を購入して続行

2026 年からChatGPT Plus / Proはサブスク枠枯渇後に追加 Credits で Codex 継続可能。即アップグレード不要。Business / Enterprise のフレキシブル課金ワークスペースは workspace credits も可。

経路:ChatGPT アカウント設定 → 使用量 / Billing → Credits 購入(地域で文言差あり)。

向く:発版週やハッカソンなど偶発的な集中週。来月も Codex 続けるならツールチェーン変更を避けられる。向かない:毎月 Weekly に当たる——プランアップまたは API(策 6・7)を検討。

策 6:サブスク階層をアップグレード

毎週 Weekly を 0% にするなら、現プランと作業量が合っていない。2026 年の目安:

  • Plus:断続利用向け
  • Pro 5x(約 $100/月):Codex 用量は Plus の約 5 倍。フルタイム日常開発
  • Pro 20x:複数リポ・複数 Agent 並列のヘビーユーザー

アップ前に試算:Credits の月支出が上位档との差に近いなら、升档の方が手間が少ないことが多い。

策 7:API Key または代替 Agent へ

サブスク枠がハードボトルネックになったときの 2 ルート:

A. OpenAI API Key モード——Codex は API Key ログインに対応。このモードに ChatGPT の 5h / Weekly はない。token 課金、残高と RPM/TPM で制限。GPT-5.3 Codex API(2026.06):入力約 $1.75 / 100 万 token、出力約 $14 / 100 万 token。

B. ツールチェーン変更——Claude Code、Cursor Agent、Gemini CLI、LangGraph + API など。クォータ体系はそれぞれ独立。「Codex メイン + Claude Code 予備」の二重化で単一点限流を避けるチームが増えている。

意思決定クイックリファレンス

  • 今日 PR をマージしたい → 策 3 または 5
  • 今週 3 回目の Weekly 到達 → 策 6 または 7
  • 自社プロダクトに組み込む → 策 7A(API Key)
  • Apple プラットフォーム、夜通しタスク → 策 7B + 安定 Cloud Mac(第五节参照)

三、代替 API・ツール対照

Weekly 上限はツールスタック見直しのきっかけになりやすい。2026 年 6 月時点の公開情報から、クォータモデル・Agent 形態・典型コストで対照:

クォータモデル Agent 形態 向いている人
Codex(ChatGPT サブスク) 5h + Weekly ロール CLI / IDE / クラウドタスク Plus/Pro 契約済み、OpenAI エコシステム深度利用
Codex(API Key) token 課金、Weekly なし 同上、請求予測しやすい チーム統合、CI パイプライン
Claude Code Pro/Max セッション枠 または API token ターミナル Agent + CLAUDE.md 長チェーン推論、多ファイルリファクタ
Cursor Agent サブスクリクエスト数 + モデル加算 IDE 内蔵 日常コーディング + 軽量 Agent
Gemini CLI / API 無料档 + token 課金 CLI / Google エコシステム マルチモーダル、大コンテキスト RAG
DeepSeek API 純 token、低価格 Agent フレームワーク自前 コスト敏感、中国語ビジネス

モデル単価の詳細は 2026年 最新LLMの料金・設定・性能・向いている人 を参照。ツールを替えても安定した macOS / Linux 実行面は別問題——コンパイルとテストは Agent の足場。

四、予防:1 週間持たせる

一度の上限対応は簡単。毎週やるならワークフローを変える:

  1. タスク粒度を小さく:1 セッション 1 目標(「flaky test を直す」まで。「モジュール全体をリファクタ」は避ける)。無駄な往復を減らす
  2. ローカル優先rg / LSP で済むことは Agent に渡さない。クォータは横断ファイル推論に温存
  3. モデル分档:デフォルト mini、骨のタスクだけ Codex フルサイズ
  4. クラウドタスク乱用を避ける:Cloud Tasks と Local Messages は 5h を共有。ローカルで回せるならクラウドに上げない
  5. Remaining を監視5h < 20% で区切り、仕上げは次ウィンドウへ
  6. 二重スタック:Codex メイン、Claude Code または API 予備。限流時にシームレス切替

五、実行ノード:上限が戻ってもタスクは切らすな

クォータ問題が解けても、もう一つの断点がある——実行環境。Codex クラウドタスク、CLI 一晩コンパイル、Xcode UI テスト。個人ノートで回すと、フタ閉じスリープ、VPN 揺れ、ディスク満杯で Agent が途中で止まる。

2026 年の実務解:モデルクォータと実行ノードを分けて設計。サブスク / API が「脳」、Cloud Mac が「身体」——専用 macOS ノードを 24 時間オンにし、tmux で長タスク。Codex や Claude Code の枠が戻ったら戻って検収する。

「モデルが足りない」とは別次元。実行ノードで希少なのは安定して予測可能な macOS 算力。詳しくは モデル競争はもう終わり——Macコンピュートノードが取れない理由

FAQ

Codex の Weekly と 5h 上限の違いは?

5 時間ウィンドウは短期バーストを制約。Weekly は週累計を制約。独立ロールし、どちらかが尽きればレート制限。

CLI の Weekly 94% はもうすぐ切れる? それとも余裕?

Remaining = 残量。94% は 94% 残っている意味。94% 消費済みではない。

Weekly 上限後に Credits は買える?

買える。Plus / Pro は追加 Credits。Business フレキシブル課金 WS は workspace credits。

保存リセットトークンは Weekly もクリアする?

公式未明記。5h ウィンドウ急救と見なす。Weekly はロール回復か Credits。

GPT-5.4-mini に切替えるとクォータは伸びる?

伸びる。同一プランで mini 档の 5h メッセージ上限は大幅に高い。軽めのタスク向け。

API Key に Weekly 上限はある?

サブスク内の 5h / Weekly はない。token とレート制限で課金。

Claude Code は Codex の代替になる?

ターミナル Agent 体験は近い。クォータは独立。iOS / macOS 開発は安定 Cloud Mac で長時間実行を推奨。

おわりに

Codex の Weekly 上限到達はアカウント障害ではない。OpenAI が 2026 年に「ライト試用」と「フルタイム Agent 開発」をより明確に分けた結果。5h と Weekly の二層を読み、リセットトークンと mini 節約、必要なら Credits や升档、API / Claude Code の予備線——多くのチームは 1 週間以内にリズムを取り戻せる。

クォータはリセットする。リリース日は待ってくれない。長タスクは落ちない実行ノードに載せた方が、徹夜でロールを待つより得。

Codex が限流された? まず Agent を安定 Mac ノードで回せ

Vuncloud 専用 Mac mini M4 Cloud Mac:Codex / Claude Code 長時間実行、Xcode ビルド、tmux 夜間タスク。US East / West / APAC——上限が戻ったら検収に戻る。タスクは途中で切れない。

Cloud Mac プランを見る · LLM API 価格ガイド

最終更新:2026 年 6 月 22 日。上限・価格データは OpenAI Codex Pricing および 2026 年 6 月公式 changelog に基づく。

フィールドノート · AI

Agent配額を週単位で設計

Codex · Claude Code · API Key · Cloud Mac実行ノード

Cloud Macプランを見る
期間限定 プランを見る