Claude Codeのエラーコード完全解説【2026年最新】：529・401・403・429・503の原因と対処法

Claude Codeのエラーコード完全解説【2026年最新】：529・401・403・429・503の原因と対処法

---

Claude Codeのエラーコードの仕組み

{
  "type": "error",
  "error": {
    "type": "overloaded_error",
    "message": "Overloaded"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

---

529エラー（overloaded_error）：Claude Codeで最も多いエラー

529エラーの対処法：待つしかない場合と、できることの違い

import anthropic

client = anthropic.Anthropic(
    max_retries=3,  # デフォルトは2
)

import time
import random
import anthropic

def call_with_retry(client, messages, max_attempts=5):
    for attempt in range(max_attempts):
        try:
            return client.messages.create(
                model="claude-opus-4-5",
                max_tokens=1024,
                messages=messages
            )
        except anthropic.APIStatusError as e:
            if e.status_code == 529 and attempt < max_attempts - 1:
                # 指数バックオフ + ジッター
                delay = (2 ** attempt) + random.uniform(0, 1)
                print(f"529エラー。{delay:.1f}秒後にリトライします... (試行 {attempt + 1}/{max_attempts})")
                time.sleep(delay)
            else:
                raise

529エラーと429エラーの違い

---

401エラー（authentication_error）：APIキーの問題

• Anthropic Consoleで新しいAPIキーを発行しているか確認する
• 環境変数（ANTHROPIC_API_KEY）に正しく設定されているか確認する
• .envファイルや設定ファイルに余分なスペースや改行が混入していないか確認する
• APIキーが失効・削除されていないかAnthropicのコンソールで確認する

---

400エラー（invalid_request_error）：リクエスト形式の問題

• modelに存在しないモデル名を指定している
• messagesの形式が間違っている（roleやcontentの構造）
• max_tokensを設定していない（必須パラメータ）
• システムプロンプトの指定方法が古い形式になっている
• Opus 4.6でprefill（アシスタントメッセージの事前入力）を使おうとしている

---

403エラー（permission_error）：権限の問題

---

429エラー（rate_limit_error）：レートリミット超過

import anthropic
import time

client = anthropic.Anthropic()

# 複数リクエストを送る場合のレートリミット対策
requests = [...]
results = []

for i, req in enumerate(requests):
    if i > 0:
        time.sleep(1)  # リクエスト間に1秒スリープ
    result = client.messages.create(**req)
    results.append(result)

---

503エラー：サービス一時停止

---

エラーコードの確認とデバッグのベストプラクティス

import anthropic

client = anthropic.Anthropic()

try:
    message = client.messages.create(
        model="claude-opus-4-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Hello"}]
    )
except anthropic.APIConnectionError as e:
    # ネットワーク接続エラー
    print("接続エラー:", e)
except anthropic.RateLimitError as e:
    # 429エラー
    print("レートリミット超過:", e)
except anthropic.APIStatusError as e:
    # その他のAPIエラー（400, 401, 403, 503, 529など）
    print(f"ステータスコード: {e.status_code}")
    print(f"エラー内容: {e.message}")

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)

# リクエストIDをログに記録
print(f"Request ID: {message._request_id}")

エラーが出たときのチェックフロー

1. まずステータスコードを確認する → 4xx か 5xx かで方向性が変わる
2. 4xx の場合 → 自分のリクエストや設定を確認する（APIキー、リクエスト形式、権限）
3. 5xx の場合（529含む） → status.anthropic.com でインシデントを確認する
4. 429 の場合 → レートリミット内に収まるよう実装を調整する
5. 解決しない場合 → request_id を控えてAnthropicサポートに問い合わせる

---

Claude Code CLIのエラーとAPIエラーの違い

---

よくある質問（FAQ）

529エラーは自分の使い方が悪いから出るの？

529エラーが続く場合、どのくらい待てばいいの？

Max 5xプランでも529は出る？

429と529が同時に出るのはなぜ？

500エラーはどうすればいい？

---

まとめ

---

出典

• Anthropic API Errors ドキュメント
• Anthropic ステータスページ