---
title: "Claude の overloaded エラー 529 とレート制限エラー 429 を解決する"
description: "529 の overloaded_error は、Claude API が全ユーザーに対して混み合っている状態です。429 の rate_limit_error は、あなたの組織が制限に達した状態です。どちらもバックオフを入れて再試行します。"
canonical: "https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Claude の overloaded エラー 529 とレート制限エラー 429 を解決する

529 の `overloaded_error` は、Claude API が全ユーザーに対して混み合っている状態です。429 の `rate_limit_error` は、あなたの組織が制限に達した状態です。どちらもバックオフを入れて再試行します。

2026年11月10日 に Claude Code 2.1.319、@anthropic-ai/sdk 1.7.0 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error

## 各クライアントが再試行の前に待った時間

|  | 各再試行の前の秒数 | 再試行回数 | 合計時間 |
| --- | --- | --- | --- |
| Claude Code、応答はすべて 529 | 0.6 · 1.1 | 2 | 2.4 秒 |
| Claude Code、応答はすべて 429 | 0.5 · 1.2 · 2.5 · 4.1 · 8.8 · 18.8 · 34.2 · 35.4 · 36 · 39.9 | 10 | 182 秒 |
| `maxRetries: 5` の TypeScript SDK、応答はすべて 529 | 0.4 · 1 · 1.9 · 3.5 · 7.4 | 5 | 14.3 秒 |

## Claude Code で解決する

### Claude のステータスページを確認する

status.claude.com に容量に関するお知らせがあれば、問題は Anthropic 側にあり、時間が経つのを待つしかありません。

### 待ってから再試行する

`API Error: Repeated 529 Overloaded errors` は、Claude Code がすでに再試行したことを示します。529 は使用量の上限にカウントされません。

### 別のモデルに切り替える

Anthropic はモデルごとに容量を管理しています。Opus が混んでいるときは Sonnet など、別のモデルを選びます。

```bash
/model
```

### スクリプト用にフォールバックモデルを設定する

print モードでは、`--fallback-model` を指定すると 529 エラーが続いたあと 2 つ目のモデルに切り替わります。検証では 3 回のリクエストのあとに切り替わりました。

```bash
claude -p "Run the tests" --fallback-model sonnet
```

### 無人の実行を止めない

CI など誰も見ていない実行では、この設定で容量が戻るまで 529 と 429 のエラーを再試行し続けます。

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## 自分のアプリで解決する

### バックオフを入れて再試行する

公式の Claude SDK は、429、529、その他の 5xx エラーを既定で 2 回、指数バックオフで再試行し、`retry-after` ヘッダーに従います。アプリがもっと待てるなら `maxRetries` を増やします。

```bash
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 5 });
```

### エラーとリクエスト ID をログに残す

再試行を使い切ると、SDK は `OverloadedError` か `RateLimitError` を投げます。Anthropic のサポートがリクエストを見つけられるよう、`error.requestID` を保存します。

```bash
try {
  await client.messages.create(request);
} catch (error) {
  if (
    error instanceof Anthropic.OverloadedError ||
    error instanceof Anthropic.RateLimitError
  ) {
    console.warn("Claude API busy", error.status, error.requestID);
  }
  throw error;
}
```

### トラフィックはゆっくり増やす

自分のトラフィックが急に増えると、429 の急増制限にかかることがあります。トラフィックは段階的に増やし、一定に保ちます。

## 実際に試して確認したこと

本物の 529 を意図的に起こすことは誰にもできません。そこで Claude Code と TypeScript SDK を、すべてのリクエストに 529 か 429 を返すローカルのテストサーバーに向けました。Claude Code はこのようなサーバーをゲートウェイとして扱うため、実際の API でのセッションとは動きが異なる場合があります。

Claude Code は 529 が返るリクエストを 3 回送り、2.4 秒後に `Repeated 529 Overloaded errors` を表示して止まりました。`--fallback-model sonnet` を付けると、その 3 回のあと Sonnet に切り替わり、約 3 分かけてさらに 10 回再試行しました。429 では 182 秒の間に 10 回再試行し、待ち時間は 0.5 秒から 40 秒まで延びたあと、`Request rejected (429)` になりました。`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定すると、150 秒後に実行を止めた時点でも、Claude Code は 529 を再試行し続けていました。

既定の設定では、SDK は最初の 1 回と再試行 2 回の計 3 回リクエストを送り、1.3 秒後に `OverloadedError` を投げました。`maxRetries: 5` では 14.3 秒で 6 回送りました。429 に `retry-after: 3` が付いていると、SDK は再試行のたびに 3 秒待ち、Claude Code は最初の 3 回の再試行の前にそれぞれ 3 秒待ちました。

## 529 と 429 は別のエラーです

529 の `overloaded_error` は、API が全ユーザーに対して混み合っている状態です。あなたの上限ではなく、割り当て量にもカウントされません。

429 の `rate_limit_error` は、あなたの組織に関するエラーです。レート制限、利用ティアの月間支出上限、Claude Code ワークスペースの支出制限のどれかに達しています。支出上限による 429 には `retry-after` ヘッダーがなく、アクセスが戻るまで失敗し続けるため、再試行しても解決しません。

## Claude Code のプラン上限は API エラーではありません

`You've hit your session limit` と `You've hit your weekly limit` は Claude のプランから来るメッセージです。セッション上限は、よく 5 時間制限と呼ばれるローリングウィンドウです。`/usage` を実行すると、両方の上限とリセット時刻を確認できます。

`Server is temporarily limiting requests (not your usage limit)` はサーバー側の短い制限で、Claude Code が自動で再試行します。`Request rejected (429)` は、API キー、Amazon Bedrock のプロジェクト、Google Cloud のプロジェクトのどれかが独自のレート制限に達したことを示します。

シェルに `ANTHROPIC_API_KEY` があるとプランより優先されるため、Claude Code がキー側の低い上限に達することがあります。`/status` を実行すると、どのログインが有効かを確認できます。

1,499 件のコメントが付いた #16157 では、Max ユーザーがほぼすぐに上限に達すると報告されています。2026年1月、Anthropic のエンジニアは、チームにはまだ納得のいく説明がないと書きました。#29579 は使用率 16% での `Rate limit reached`、#6457 は 90 分未満での 5 時間制限到達を報告しています。3 件とも、まだ開いています。

## よくある質問

### 529 エラーは Claude の使用量上限にカウントされますか？

いいえ。Claude Code のドキュメントには、529 は使用量の上限ではなく、割り当て量にもカウントされないと書かれています。

### Claude の overloaded エラーはどのくらい続きますか？

Anthropic によると、通常は一時的なものです。status.claude.com で、進行中の障害と最新情報を確認してください。

### Claude Code に rate limit reached と表示されるのはなぜですか？

プランの上限を使い切ったか、サーバーが短時間リクエストを制限したか、API キーがレート制限に達したかのどれかです。`/usage` と `/status` でどれに当たるかがわかります。

### Claude Code の上限はいつリセットされますか？

メッセージに時刻が出ます。たとえば `resets 3:45pm` です。`/usage` でも確認できます。

### アプリは 529 エラーを再試行すべきですか？

はい、指数バックオフで再試行します。公式 SDK は既定で 2 回再試行します。検証では、TypeScript SDK は `retry-after` が指定した時間ちょうどだけ待ちました。

## アプリのすべての Claude API エラーを確認する

アプリから Claude API を呼んでいる場合、LogBrew は繰り返し起きる 529 と 429 のエラーを 1 つの問題にまとめ、それぞれの発生頻度を表示します。十分な無料プランで始められ、カードは不要です。

[無料で始める](https://logbrew.co/ja)

## 出典

- [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors)
- [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits)
- [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors)
- [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157)
- [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579)
- [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457)

## AI コーディングエージェントのその他のガイド

- [Claude Code と Codex に MCP サーバーを追加する](https://logbrew.co/ja/guides/mcp-server-claude-code-codex)
- [Claude Code と Codex で AGENTS.md を使う](https://logbrew.co/ja/guides/agents-md)
- [Claude Code、Codex、ブラウザー JavaScript のエラーを解決する](https://logbrew.co/ja/guides)