ハブネコのAIラボ

Codex

Codexの429エラーの原因と対処法|GitHubの429との見分け方も

公開: / 更新: ・読了目安14分

#エラー対処 #レート制限

Codexの429エラーの原因と対処法|GitHubの429との見分け方も

Codexを使っていると、ある日突然「429 Too Many Requests」というエラーで作業が止まることがあります。結論から言うと、原因の大半は「プランの利用上限に達した」か「短時間にリクエストを送りすぎた」かのどちらかで、多くはリセット待ちかリトライ間隔の調整で解決します。ただし、残量が十分あるのに429が出るという報告も一定数あり、その場合は一時的な不具合を疑う必要があります。この記事では、実際にGitHub Issuesで報告されている症状をもとに、パターン別の見分け方と対処法を整理します。

この記事の要点

  • Codexの429エラーは「プランの利用上限到達」か「短時間のリクエスト過多」が主な原因です。
  • Codex CLIの/statusコマンドで、現在の残量とリセットまでの時間を確認できます。
  • APIキー(従量課金)利用時は、ChatGPTプランの利用枠ではなくOpenAI Platform側のレート制限が適用されます。
  • 残量に十分余裕があるのに429が出る場合は、一時的な不具合の可能性があります。
  • 2026年8月には「利用上限が急に減った」という声に対し、OpenAIがサブスクリプションをAPIとして転用・共有する「sub2api」等の利用が不正防止システムの検知対象になっていると公式に説明しました。
  • 2026年8月25日にはPlusプラン向けに5時間ごとの利用上限が復活し、上限到達時の備えとして「Banked Reset」という使用量リセット権も配布されています。
  • 復活への反発を受け、2026年8月末にはCodexリードが有料ユーザー全員の利用上限をリセットし、ハーネス側の修正で「同じ上限内でより多く作業できる」と説明しました(上限自体の恒久的な引き上げではありません)。
  • 2026年9月時点でも「以前より早く上限に達する」という海外の報告は続いていますが、効率改善と上限値の引き上げは別の話として切り分けて読む必要があります。
  • 予防策として、タスクの分割・並列実行数の抑制・リトライ時の指数バックオフが有効です。

429エラーとは何か

429はHTTPのステータスコードで、「Too Many Requests(リクエストが多すぎます)」を意味します。コード自体に問題があるわけではなく、一時的にリクエストを受け付けられない状態を示すエラーです。Codexでは次のようなメッセージで表示されることが多く、GitHub Issues上でも同様の報告が繰り返し上がっています(openai/codex#12775、#9148、#10560など)。

stream error: exceeded retry limit, last status: 429 Too Many Requests

このメッセージは、Codexが内部で自動リトライを繰り返した末に失敗したことを示しています。実際、openai/codex#4840では「429を受け取っても静かにリトライを続けるだけで、ユーザーに分かりやすく通知されない」という設計上の課題も報告されており、ユーザー側からは「何が起きているか分かりにくい」状態になりがちです。まずは焦って何度も再実行するのではなく、以下のどのパターンに当てはまるかを切り分けることが大切です。

429エラーの4つの原因(プラン利用上限への到達、短時間の連続リクエスト、APIキー従量課金のレート制限、一時的な不具合)を整理した図解

発生パターン①: プランの利用上限に到達している

ChatGPT Plus・Pro・Business・Enterpriseなどのサブスクリプションでは、直近数時間単位のローリングウィンドウと、週単位でリセットされる上限の組み合わせで使用量が管理されています。どちらかの上限に達した状態でリクエストを送り続けると、429やレート制限に関するメッセージが表示されます。

codex
# セッション内で実行
/status

一方でopenai/codex#9148のように、「5時間・週次のどちらの上限も大きく下回っているのに429が出た」という報告もあります。/statusで残量に余裕があると分かった場合は、このパターンではなく後述するパターン③・④を疑ってください。Claude Codeの使用制限対策は「Claude Codeの使用制限対策」にまとめています。

2026年9月時点の状況: 「効率改善」と「上限アップ」は別の話

2026年9月時点でも、8月末のハーネス修正のあとに「以前より早く上限に達する」という声が海外の掲示板(Redditのr/codexなど)で続いています。なかにはBusinessプランで同じ作業を続けた自分のログをもとに、週あたりに使えたトークン量が約3億2,300万から約1億7,300万へおよそ半減した、という報告もあります(2026年9月時点・数百件の賛同を集めた投稿)。ただしこれはいずれも個人の利用ログに基づく海外ユーザーの書き込みであり、OpenAIがプランごとの上限トークン数を公表しているわけではありません。数値そのものを鵜呑みにせず、「そういう体感の報告がある」という程度に受け止めてください。

混同しやすいのが、この報告と8月末のアナウンスの関係です。PC Watchの報道(2026年8月31日)によると、Codexリードのティボ・ソティオー氏が説明したのは、圧縮時に古い画像を保持してコンテキストが膨らむ不具合や、重複した要約が週次使用量の最大5分の1を圧迫していた問題などを修正した結果、「使い方によっては以前より10〜50%ほど多く利用できるようになる」というものでした。つまり同じ枠をより効率的に使えるようにする改善であって、上限の数値を引き上げたという発表ではありません。効率が上がっても、扱うコンテキストや並列数を増やせば体感の持ちは元に戻ります。

実務上の対処は変わりません。まず/statusで自分の残量とリセット時刻を実測し、体感と数値がずれる場合はGitHub Issuesで同時期の報告を検索する、という順番が確実です。上限の仕様そのものは公式の料金ページやCodex内の表示で確認してください。

2026年9月時点(Astra切替後): 上限到達が増えたと感じたら

GPT-6 Astraへ切り替えた直後に429や上限到達が増えたと感じる場合、原因の多くはクレジット消費速度の違いです。公式のプラン別上限(learn.chatgpt.com/docs/pricing)では、Plusの5時間枠の目安メッセージ数はGPT-5.6 Solが10〜100件、GPT-5.6 Terraが25〜200件なのに対し、GPT-6 Astraは5〜45件です。

同じ作業量でもAstraのほうが早く上限に達するのは想定内の挙動で、不具合ではありません。対処は、/modelでGPT-5.6 Sol・Terraへ一時的に戻すか、設計判断や難しいバグ調査などここぞという場面だけAstraを使う運用に切り替えることです。消費量の詳しい違いは「Codex GPT-6 Astra対応ガイド」にまとめています。

発生パターン②: 短時間に連続してリクエストを送っている

複数のCodexセッションやサブエージェントを並行して動かしていると、短時間にリクエストが集中してレート制限に触れることがあります。openai/codex#11083では、25個ものサブエージェントを同時に走らせていたユーザーが、以前は問題なかった構成で急に429が出るようになったと報告しています。

1回目の失敗 → 1秒待機
2回目の失敗 → 2秒待機
3回目の失敗 → 4秒待機(以降、上限まで倍々に)

発生パターン③: APIキー(従量課金)利用時のレート制限

OPENAI_API_KEYを使ってcodex login --with-api-keyでサインインしている場合、ChatGPTプランの利用枠ではなく、OpenAI Platform側のレート制限が適用されます。組織のUsage tierによってリクエスト数・トークン数あたりの上限が異なり、Usage limits(支出上限)を設定していると、その金額に達した時点でリクエストが止まる仕様です。

発生パターン④: 一時的な障害・不具合が原因の場合

残量に十分な余裕があり、リクエスト頻度も特に高くないのに429が出るケースも報告されています。openai/codex#12775では「利用枠の99%以上が残っているのにexceeded retry limitが出た」という報告があり、openai/codex#7839ではバージョンアップ後に特定の構成でだけ429が発生するようになったという事例もあります。これらはCodex側やモデルプロバイダ側の一時的な不具合、あるいはインシデント対応に伴う仕様変更が影響している可能性があります。

CodexではなくGitHub本体の429だった場合

「429」はCodex固有のエラーではなく、GitHubのサイトやAPIでも同じ番号のエラーが返ります。どのサービスが429を返しているのかを最初に切り分けると、対処先を間違えずに済みます。

Codex側の枠が原因ならこの記事の①〜④、GitHub側ならリクエスト頻度の調整と待機が対処の中心になります。

予防策

429エラーそのものを完全になくすことは難しいものの、発生頻度を下げる工夫はいくつかあります。

よくある質問

429エラーは何度もリトライすれば直りますか?

短時間の連続アクセスが原因であれば、間隔を空けてから再実行すると解消することがあります。ただし、間隔を空けずに連打すると悪化することがあるため、待機時間を徐々に伸ばしながら試すのが安全です。プランの利用上限に達している場合はリトライしても状況は変わらず、リセットを待つ必要があります。

APIキー利用とChatGPTサブスクで429の原因は違いますか?

はい、適用される上限の仕組みが異なります。ChatGPTサインインではプランごとの利用枠(5時間・週次の組み合わせ)が対象になるのに対し、APIキー認証ではOpenAI Platform側のレート制限やUsage limitsが対象になります。どちらの認証方式を使っているかによって確認すべき場所が変わる点に注意してください。

残量が十分あるのに429が出るのはなぜですか?

GitHub Issuesでは、利用枠にまだ余裕があるにもかかわらず429が発生したという報告が複数あります。この場合はCodex側やモデルプロバイダ側の一時的な不具合が疑われます。時間を置いて再実行し、それでも解消しない場合はGitHub Issuesで同様の報告を検索するか、新規に報告することをおすすめします。

まとめ

Codexの429エラーは、多くの場合「プランの利用上限への到達」か「短時間のリクエスト過多」が原因で、残量確認とリトライ間隔の調整で対応できます。APIキー利用時はOpenAI Platform側のレート制限が対象になる点も押さえておくと切り分けがスムーズです。それでも残量に余裕があるのに発生する場合は、一時的な不具合を疑いGitHub Issuesを確認してみてください。基本的な使い方やエラー全般の対処法は「Codexの使い方完全ガイド」と「Codexが動かない時の対処法」もあわせてご覧ください。