Claude Code API エラー 529 過負荷: 原因と修正

エラーテキスト

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

意味

API はキーとリクエストを受け付けましたが、モデルが過負荷で処理できませんでした。ピークは短く、特定のモデルに依存するため、通常はモデルを切り替えるか 1 分待つと解決します。

段階的な修正手順

1. 1. 再試行

   少し待ってからメッセージを再送します。Claude Code は会話を保持するため、失われるものはありません。

2. 2. モデルを切り替える

   /model を実行し、別の Claude モデル（例: Opus の代わりに Sonnet）を選んでタスクを完了し、後で戻します。

3. 3. チャネルを切り替える

   aicodewith では、各モデルページにチャネルの健全性が表示されます。1 つのチャネルが混雑している場合は、キー用に別のチャネルを選択してください。

4. 4. エンドポイントを確認する

   /status を実行し、エンドポイントが api.aicodewith.ai であることを確認します。誤ったエンドポイントでは別のエラーが表示されますが、除外する価値はあります。

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

回避する方法

• •日常的な作業には Sonnet または Haiku を使い、難しい問題には Opus を取っておきます。混雑のピークは最大のモデルに最初に影響します。
• •ピーク時間帯は並列サブエージェントの実行数を減らします。
• •CI ジョブでは、最初の 529 でジョブを失敗させるのではなく、バックオフ付きで再試行します。

失敗したリクエストは課金されますか？

失敗したリクエスト（4xx/5xx、タイムアウト、切断された接続）は課金されません。課金されるのは正常に完了したリクエストのみです。上流の失敗が自動的に再試行されて成功した場合、課金は 1 回だけです。

まだ失敗しますか？

• •aicodewith のモデルページを確認します。各チャネルの最近の健全性が表示されます。
• •ダッシュボードの使用記録でリクエストを検索し、モデル、ステータス、コストを確認します。
• •support@aicodewith.com に、エラー発生時刻、モデル、エラーテキストを送信してください（完全な API キーは決して送らないでください）。

モデルのステータスと価格サポートに問い合わせるドキュメント

FAQ