水曜の午後、Codex CLI が突然 rate limit exceeded を返す——PR はまだ半分なのに。ネットワーク障害ではなく、2026 年 OpenAI が Codex にかけた二重ローリングクォータが効いている。本稿は「まず仕組みを読む → 修復ルートを選ぶ → 代替スタックを用意する」の順で、Weekly 上限に当たったあとの 7 つの現実解をフィールドノート調子で整理する。
一、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 とは無関係。トラブルシュートでは 5h、Weekly、Remaining の行だけ見る。
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 を正とする。
二、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 目標(「flaky test を直す」まで。「モジュール全体をリファクタ」は避ける)。無駄な往復を減らす
- ローカル優先:
rg/ LSP で済むことは Agent に渡さない。クォータは横断ファイル推論に温存 - モデル分档:デフォルト mini、骨のタスクだけ Codex フルサイズ
- クラウドタスク乱用を避ける:Cloud Tasks と Local Messages は 5h を共有。ローカルで回せるならクラウドに上げない
- Remaining を監視:
5h < 20%で区切り、仕上げは次ウィンドウへ - 二重スタック: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——上限が戻ったら検収に戻る。タスクは途中で切れない。
関連記事
- 2026年 最新LLMの料金・設定・性能・向いている人
- モデル競争はもう終わり——Macコンピュートノードが取れない理由
- 2026 開発者向け AI 三層アーキテクチャ:Coding・Personal・Agent オーケストレーション
最終更新:2026 年 6 月 22 日。上限・価格データは OpenAI Codex Pricing および 2026 年 6 月公式 changelog に基づく。