Claude API timeout（タイムアウト・応答が返らない）
現在、障害は発生していますか？
Claude API の公式ステータスは正常です。このエラーが続く場合は、実装・環境側の要因の可能性が高いです。
Claude API の稼働状況を見る →エラーの意味
リクエストが制限時間内に完了しない状態。長い生成・大きい入力・ネットワーク不安定・サーバー過負荷・クライアント/プロキシの短いタイムアウトが要因です。
よくある原因
- •生成が長く時間内に終わらない
- •入力が大きい（長コンテキスト/多トークン）で処理が遅い
- •API との間のネットワーク不安定
- •Anthropic 側の過負荷（529 を伴うことも）
- •クライアントやプロキシ/ゲートウェイのタイムアウトが短すぎる
対処法
- 1.ストリーミング（stream: true）で生成と同時に受け取る
- 2.max_tokens を下げ、入力/コンテキストを削る
- 3.クライアントとプロキシのタイムアウトを延ばす
- 4.指数バックオフでリトライ
- 5.ネットワークと API 前段のゲートウェイ/プロキシを確認
待つべきケース／待っても直らないケース
過負荷が原因なら時間で改善します。恒常的に出るならストリーミング化とタイムアウト延長を。非ストリーミングの長い生成はゲートウェイ上限に当たりやすいです。
Claude API が使えないときの代替
関連するエラー
よくある質問
Timeout (request timed out) とは何ですか？
リクエストが制限時間内に完了しない状態。長い生成・大きい入力・ネットワーク不安定・サーバー過負荷・クライアント/プロキシの短いタイムアウトが要因です。
Timeout (request timed out) の対処法は？
ストリーミング（stream: true）で生成と同時に受け取る、max_tokens を下げ、入力/コンテキストを削る、クライアントとプロキシのタイムアウトを延ばす、指数バックオフでリトライ、ネットワークと API 前段のゲートウェイ/プロキシを確認