トラブルシューティング · 2026-10-20 確認

529 Overloaded が意味すること

2026-10-20 時点の公式エラー文書によると、529 Overloaded は Claude の API が一時的に容量の上限に達している状態で、利用者全員にわたる容量の状況です。利用上限ではなく、クォータにも計上されません。今回の再確認で、公式文書が明文化しているリトライ設定の既定値も加わりました。CLAUDE_CODE_MAX_RETRIES の既定値は 10(2.1.186 以降の上限は 15)、529 リトライの基準遅延の既定値は 500 ミリ秒(CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS、32000 まで引き上げ可)、バックオフ上限の既定値は 32000 ミリ秒(CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS、64000 まで引き上げ可)。コードを直しても解決せず、リトライ戦略を直すと効きます。

更新日 2026-10-20

1 つのキーで Claude、GPT、主要な中国系モデルを利用でき、トークン単位の課金で、数分で使い始められます。

#Claude 529#529#Overloaded#バックオフと再試行上限

4 つの要点

529

事業者側の混雑

サーバー側の容量が逼迫したときに返ります。キーの枠、パラメータ、リクエスト本文とは無関係です。公式エラー文書によると 529 は利用者に共通する容量の状況であり、問題は事業者側にあります。

429

レート制限に当たっている

自分のレートや枠の上限に触れたのはこちらです。529 と 429 は対処が異なるため、同じ分岐で扱わないでください。公式文書の見落としやすい点として、429 が利用上限や消費枠の枯渇を報告した場合、Claude Code は再試行せずに即座に失敗として扱います。529 の場合と正反対の挙動です。

バックオフ

クライアント側で唯一有効な手段

指数バックオフ+ジッター。即座のリトライは混雑を悪化させ、レート制限にも早く当たります。公式文書は 529 リトライの基準遅延の既定値を 500 ミリ秒(CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS)、バックオフ上限の既定値を 32000 ミリ秒(CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS)と明記しています。

多経路

構造的な緩和

同じ作業を別のモデルファミリーに流せるなら、1 社の混雑が停止を意味しなくなります。代償はモデル差の受容です。

529 と 429・503 の違い

2026-10-20 時点で、529 はサーバー全体がいま過負荷であるという容量の問題で、通常は一時的です。公式エラー文書によると、これは利用者に共通する容量の状況で、利用上限ではなくクォータにも計上されません。429 は自分のレートや枠の上限に触れた場合のクォータの問題です。公式文書はさらに、429 が利用上限や消費枠の枯渇を報告した場合は Claude Code が再試行せず即座に失敗として扱うと書いています。

503 は一般にサービス停止や保守中を指します。いずれもリクエストの記述ミスを意味しませんが、対処は異なります。529 はバックオフしてリトライ、429 は速度を落とすか上限を上げる、503 は待機してステータスページを確認。3 つを 1 つの catch にまとめるのが最もよくある誤りです。

議論が周期的に増える理由

新しいモデルが公開されたときや大規模な移行が起きるたびに、事業者側の容量は一時的に逼迫し、529 の話題も増えます。こうした波は容量増強とともに収まるのが通例ですが、締め切りを抱えている人にとって「事業者の増強を待つ」は選べる答えではありません。2026-10 の公式ステータスページには照合できる記録が 2 件あります。

2026-10-07 の消費上限の問題では、上限に達したと誤って判定されて停止した組織があり、Claude API や Claude Code を含む各所でリクエストが拒否されましたが、公式は解決済みとしています。2026-10-13 の platform.claude.com の使用量データに関する記録は、API リクエスト自体は影響を受けないと明記しています。

この 2 件はどちらも消費上限と使用量データの話で、容量不足ではありません。Claude Code は 2026-10-08 と 2026-10-09 に続けて 2 つのバージョンを出し、2.1.295 で無人実行時のリトライ総待ち時間の上限を、2.1.296 で 529 のバックオフ上限をそれぞれ調整できるようにしました。最新バージョンは 2026-10-19 公開の 2.1.304 です。

切り分けの順序

第 1 段階

ステータスコードが本当に 529 で 429 ではないことを確認します。レスポンス本文が異なるため、ログでは分けて集計してください。

第 2 段階

事業者のステータスページを確認します。広範な障害であれば、クライアント側の変更は緩和にとどまります。公式ステータスページは Claude API(api.anthropic.com)と Claude Code を別々のコンポーネントとして掲載しているので、どちらが影響を受けたかを確認します。2026-10-20 時点では、掲載されたすべてのコンポーネントが正常と表示されます。

第 3 段階

自分のリトライが混雑を増幅していないか確認します。ジッターなし、上限なし、即時再送はいずれも増幅要因です。Claude Code なら、バージョン 2.1.292(2026-10-06)から CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS で 529 リトライの基準遅延を長くでき、2.1.295(2026-10-08)からは CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS で無人実行時に 429 と 529 を待つ合計時間を制限でき、2.1.296(2026-10-09)からは CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS でバックオフ上限を引き上げられます。

リトライの前に、どのコードなのかを見分ける

確認できること

529 はサーバー側の容量混雑を示しリクエスト内容とは無関係である、という意味づけは事業者のドキュメントに明記されています。Claude Code 公式エラー文書(2026-10-20 照合)のエラー原文は API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. で、A 529 is not your usage limit and doesn't count against your quota とも書かれています。

つまり 529 は利用上限ではなく、クォータにも計上されません。容量はモデルごとに管理されているため、/model で別のモデルに切り替えれば作業を続けられるとも説明され、529 は利用者に共通する容量の状況とも記されています。同じ文書はリトライ変数の既定値も示しています。CLAUDE_CODE_MAX_RETRIES の既定値は 10(2.1.186 以降の上限は 15)、CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS は 500 ミリ秒(32000 まで引き上げ可)、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS は 32000 ミリ秒(64000 まで引き上げ可)、CLAUDE_CODE_RETRY_WATCHDOG を 1 にすると 429 と 529 の容量エラーは際限なく再試行されます。

Claude Code の CHANGELOG には、2.1.286 から既定の設定で失敗したモデル呼び出しが送るリクエストは最大 14 回になったこと、2.1.292 で CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS が、2.1.295 で CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS が、2.1.296 で CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS が追加されたことが記載されています。ジッター付き指数バックオフは広く検証されたクライアント側の対処です。

事実として扱わないこと

エラー文書が 529 について示す実行可能な手順は 3 つです。ステータスページで容量の公示を確認する、数分後に再試行する、/model で別のモデルに切り替える。同文書は、529 が利用者全員に共通する容量の状況であり、容量はモデルごとに管理されるとも書いています。529 を事業者が利用者を絞っているという考えには根拠がなく、529 と 429 を混同すると誤った対処を選ぶことになります。

2 つの対処

クライアント側のバックオフのみ

実装コストが低く、失敗率を明確に下げられます。ただし事業者側の混雑が続く間、できるのは待つことだけです。

複数のモデルファミリーに流せるようにする

1 社の混雑が停止を意味しなくなります。代償はモデルごとの癖の違いを受け入れることで、どの経路にも固有の障害形態があります。多経路は緩和であって解消ではなく、切り替えの仕組み自体も失敗することがあります。

正しいリトライの書き方

要点は 3 つ。第一に固定間隔ではなく指数バックオフ。まず 1 秒、以降は倍々にします。第二にランダムなジッターを加えること。全クライアントが同じ時間だけ待つと同期したリトライの波が起き、かえって混雑が長引きます。第三に上限を設けること。リトライ回数と総待機時間の両方に上限がないと、一度の混雑でタスクキューが際限なく積み上がります。

加えて、ストリーミングが途中で切れた場合は先頭から闇雲に再送せず、受信済みの内容が継続可能かをまず確認してください。Claude Code を使っている場合:公式ドキュメントによると、エラーを表示する前に一時的な失敗を指数バックオフで最大 10 回自動リトライします(2026-10-20 再確認)。バージョン 2.1.286(GitHub リリース 2026-09-30)ではリトライの数え方が変わり、changelog の原意は 1 つの上限が 1 回のモデル呼び出し全体にかかるということで、既定の設定では失敗した呼び出しが送るリクエストは最大 14 回です。

さらにバージョン 2.1.292(GitHub リリース 2026-10-06)で環境変数 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS が追加されました。これは 529 の再試行でバックオフの基準遅延を長く設定するためのものです。バージョン 2.1.295(GitHub リリース 2026-10-08)では CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS が追加され、無人実行時に 429 と 529 を待つ合計時間を制限できます。

バージョン 2.1.296(GitHub リリース 2026-10-09)では CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS が追加され、529 のバックオフ上限を引き上げられます。公式エラー文書は既定値も明文化しています。CLAUDE_CODE_MAX_RETRIES の既定値は 10(2.1.186 以降の上限は 15)、CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS は 500 ミリ秒(32000 まで引き上げ可)、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS は 32000 ミリ秒(64000 まで引き上げ可)、CLAUDE_CODE_RETRY_WATCHDOG を 1 にすると 429 と 529 の容量エラーは際限なく再試行されます。

QCode にできること、できないこと

できること:混雑時に同じキーで別のモデル系列へ切り替え、一つのモデルの回復を待たずに作業を続けられます。できないこと:私たちはモデルの開発元ではないため、開発元のサーバー容量は変えられません。QCode 経由のリクエストも失敗することがあります。提供できるのはモデル系列を切り替えられる選択肢であって、無障害の約束ではありません。

よくある質問

529 が返ったらリクエストのパラメータを変えるべき?

不要です。529 はリクエスト内容と無関係で、max_tokens やモデルのパラメータを変えても、プロンプトを短くしても消えません。変えるべきはリトライ戦略です。

529 と 429 で同じリトライ処理を使ってよい?

推奨しません。529 はバックオフして同じリクエストを再送すべきですが、429 は送信速度を下げるか上限を上げる必要があり、闇雲な再送は制限に当たり続けます。

どのくらい待つのが適切?

一般的には初回 1 秒、以降は倍々にし、ランダムなジッターを加え、リトライ回数と総待機時間の両方に上限を設けます。具体的な数値は許容できる遅延によります。Claude Code の場合(2026-10-20 時点の公式エラー文書と CHANGELOG):リトライ回数は CLAUDE_CODE_MAX_RETRIES で決まり、既定は 10 です(2.1.186 以降の上限は 15)。2.1.286 からは既定の設定で失敗したモデル呼び出しが送るリクエストは最大 14 回。2.1.292 からは CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS で 529 リトライの基準遅延を長くできます(公式文書の既定値は 500 ミリ秒、32000 まで引き上げ可)。2.1.295 からは CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS で無人実行時に 429 と 529 を待つ合計時間を制限できます。2.1.296 からは CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS でバックオフ上限を引き上げられます(公式文書の既定値は 32000 ミリ秒、64000 まで引き上げ可)。CLAUDE_CODE_RETRY_WATCHDOG を 1 にすると、429 と 529 の容量エラーは際限なく再試行されます。

ストリーミング中に 529 になったら?

まず受信済みの内容が使えるかを確認します。続きから書けるなら続け、無理な場合のみ全体を再送してください。闇雲な再送は課金の重複と混雑の悪化を招きます。

QCode でも 529 は起きますか?

起こり得ます。開発元側の混雑は実在し、私たちも免れません。できるのは同じ作業を別のモデル系列へ移せるようにすることで、失敗しないと約束することではありません。

529 overloaded とはどういう意味ですか。利用枠が変わらないのに、なぜこのエラーが出るのですか?

529 Overloaded はサーバー側の容量の状態です。公式エラー文書は、529 が利用者に共通する容量の満杯であり、利用上限ではなくクォータにも計上されないと明記しているため、利用枠の数字が変わらないのは当然です。容量はモデルごとに管理されているので、/model で別のモデルに切り替えれば作業を続けられます。公式の提案は数分後に再試行し、公式ステータスページで容量の公示を確認することです。上限を引き上げたりパラメータを変えたりしても、この問題には効きません。多経路は「1 つ落ちたら停止」の確率を下げますが、経路ごとに固有の障害形態があり、切り替えの仕組み自体も故障しえます。緩和であって解消ではありません。

情報源

ステータスコードの意味は各社の公式 API ドキュメントに従います。Claude Code のリトライ動作と CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS、CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS は、Anthropic の Claude Code CHANGELOG(2.1.286、2.1.292、2.1.295、2.1.296 の項目)、該当バージョンの GitHub リリースページ、Claude Code のエラー文書と環境変数の説明、公式ステータスページのコンポーネントと記録から取得し、2026-10-20 に照合しました。第三者による可用性のパーセンテージは意図的に引用していません。そうした数値は時間とともに変動し、参照できる権威ある独立測定がないためです。

1 つの経路が混んでも、別の道がある

1 つのキーで複数のモデル系列。ある経路が逼迫したら切り替えて続行できます。

関連記事

暗号資産チャージガイド

9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。

本ページのステータスコードの意味は各社の公式ドキュメントに従い、バージョンにより変更される可能性があります。Claude Code に関する記述は 2026-10-20 に公式 CHANGELOG とドキュメントで照合したもので、公式の記載が優先します。本ページの内容は可用性に関する約束ではありません。

どちらから始めるか迷ったら

まず 1 週間試す

小パック $4(枠 $30、7日間)

毎日使う

スターターは月 $9.00、毎日 $5 の枠付き。$1 の枠あたりわずか $0.060で、中パックは約 $0.113です