MacのClaude Codeでの“Request timed out”
Claude Codeは、接続の期限までにAPIが応答しないと、Request timed outと表示します。リクエストのタイムアウトの初期値は10分です。
私のMacでこの問題が起きています:MacのClaude Codeでの“Request timed out”。https://kilobat.app/ja/guides/claude-code-request-timed-out.mdを読んで、一緒に進めてください。Kilobat CLIがなければインストールしてください:brew install seifip/kilobat/kilobat。ガイドにあるターミナルとkilobatのチェックはあなた自身で実行し、わかったことを教えてください。私にしかできない手順は一覧にしてください。設定を変更する前に必ず確認してください。
症状
- Claude Codeが、長く待ったあとに
Request timed outと表示します。 - 遅いネットワーク、プロキシ経由、または大きなリクエストで起こります。
- 再試行で成功することもあります。
考えられる原因
- 遅いネットワークまたはプロキシ。ドキュメントには、遅いネットワークやプロキシが原因になりうると書かれています。
- 接続の停滞。VPNやファイアウォールがパケットを保留し、応答が届かないことがあります。
- 大きなリクエスト。ストリーミングでないリクエストには、ローカルセッションで300秒の制限があります。
- 古いバージョンでのタイムアウト0。v2.1.305より前のバージョンでAPI_TIMEOUT_MSを0にすると、すべてのリクエストが失敗することがあります。
確認方法
同じシェルからAPIホストをテストします。
curl -I https://api.anthropic.comバージョンを確認します。
claude --versionプロキシ環境変数を表示します。
env | grep -i proxyClaude Code内でセットアップのチェックを実行します。
/doctor
解決方法
リクエストをやり直します。
ネットワークまたはプロキシが遅い場合は、タイムアウトを延ばします。
export API_TIMEOUT_MS=900000タイムアウトを0にしていた場合は、Claude Codeをアップデートします。
タイムアウトが頻繁に起きる場合は、別のネットワークとVPNを試します。
Kilobatを使う場合
Kilobatの接続ドクターは、APIホストを層ごとにテストします。失敗した層や遅い層を示します。
kilobat why https://api.anthropic.comこれらのKilobatのチェックは無料です。AIエージェントはMCPを通じて
diagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
タイムアウトの初期値はいくつですか?
Claude Codeのドキュメントでは、リクエストのタイムアウトは10分とされています。
API_TIMEOUT_MS=0にすると、すべての期限が無効になりますか?
いいえ。最初のバイトの期限と、本文のアイドルタイムアウトは有効なままです。
出典
2026年10月29日に確認。