Claude APIの529 Overloadedエラーの原因と対処法を切り分ける手順

529 OverloadedはAnthropic側のサーバー混雑を示すエラー

「API Error: 529 Overloaded」は、Claude Codeが呼び出すAnthropicのAPIサーバーが一時的に混雑し、応答を返せない状態を示すエラーです。原因はあなたの手元ではなく、ほぼAnthropic側にあります。だから最初にやるべきは設定変更ではなく、混雑が単発か継続かを見極めて、必要なら少し待つことです。

Claude Codeはサーバーエラーや過負荷応答を自動でリトライします。単発の529なら手を止めて待てば自動回復するケースが大半で、繰り返す場合だけ後述の手順に進めば十分です。設定をいじる前に、まずこの切り分けから始めてください。

529が単発か数分続くかをまず確認する

確認すべきは一点だけ。同じ529が数分続いているのか、一度きりで自動回復したのか。単発なら後述の自動リトライが処理してくれるので、手を止めて待てば済みます。

数分にわたって「Repeated 529 Overloaded errors」のように繰り返し表示される場合は、混雑が長引いているサインです。この場合は待っても短時間では戻らないことがあるため、更新や自己診断へ進みます。いずれにせよ、キーの再発行や課金設定の変更から手を付けるのは順序が逆です。

APIキー・利用枠・課金設定は529の原因ではない

529は認証やクレジット残高とは無関係です。キーが無効なら401、利用枠の超過なら429、残高不足なら「Credit balance is too low」といった別のメッセージが出ます。529が出ている間にキーを再発行しても、課金設定を見直しても、モデル指定を疑っても徒労に終わります。

エラーコードごとに原因の場所が違う、という前提を押さえておくと切り分けが速くなります。529＝サーバー側の混雑、429＝リクエスト過多や利用枠、401＝認証。この対応関係を頭に入れておけば、529に対してやっても意味のない操作に時間を使わずに済みます。

待っても回復しない529への対処手順

待っても回復しない、あるいは529を繰り返す場合の手順を、コストの低い順に示します。

529を目にした時点で自動リトライは使い果たされている

Claude Codeは、サーバーエラーや過負荷応答を指数バックオフ（再試行の間隔を徐々に伸ばす方式）で最大10回まで自動リトライし、それでも失敗したときにはじめて画面へエラーを表示します。つまり529を目にした時点で、自動リトライはすでに使い果たされています（ただし応答の途中で発生した失敗など、リトライ対象外のケースは除きます）。

この挙動を理解しておくと、画面に529が出た瞬間に慌ててコマンドを連打する意味がないと分かります。表示された時点でClaude Code側の再試行は尽きているので、次の一手は連打ではなく、更新と自己診断です。

最新版（2.1.220）へ更新してリトライ挙動の改善を取り込む

最新版（2.1.220）へ更新してください。リトライやストリーミング中断時の挙動は版ごとに改善が入っており、古い版のまま報告しても状況は変わりません。だからこそ更新が最初の一手になります。

更新は数分で終わり、副作用もほとんどありません。529に限らず、接続断や応答の途中終了といった周辺の不安定さも版の更新でまとめて改善されることがあるため、対処に入る前にまず現在のバージョンを確認しておくと無駄がありません。

/doctorで自分の環境かAnthropic側かを切り分ける

更新しても続くなら、Claude Code内で/doctor（起動しない場合はシェルからclaude doctor）を実行し、インストールと設定を自己診断します。ここで異常が出なければ、問題はほぼAnthropic側とみて間違いありません。

自己診断で問題がなく、それでも529が続く場合は、Claude Code内の/feedbackコマンドでAnthropicに直接報告するか、GitHubリポジトリで既知の問題として報告されていないかを確認します。自分の環境に原因がないと確認できていれば、待つ以外にできることは限られる、と割り切れます。

Claude Codeのプラン変更は意味がある？

結論から言えば、529に対してプラン変更は効きません。529はAnthropicのサーバーが混雑している状態を示すもので、あなたの利用枠や契約プランとは無関係だからです。利用枠に関わるのは「session limit」や「weekly limit」、あるいは429といった別系統のエラーで、これらとプランは関係しますが、529はそのどれにも該当しません。

つまり、上位プランへ変えても混雑そのものは解消しないため、529の対策としてプランを見直すのは筋が違います。プラン変更を検討すべきなのは、利用枠の超過（429や利用制限のメッセージ）が繰り返し出ているときです。表示されているメッセージが529なら、まずは単発か継続かの確認、更新、/doctorという順で切り分けるのが正解です。