MacのClaude Codeでの“Request timed out”

Claude Codeは、接続の期限までにAPIが応答しないと、Request timed outと表示します。リクエストのタイムアウトの初期値は10分です。

エージェントで解決するClaude Code、Codex、またはターミナルを使えるエージェント向けのプロンプトをコピーします。

私の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、現在のすべてのmacOS。確認日:2026年10月29日

症状

  • Claude Codeが、長く待ったあとにRequest timed outと表示します。
  • 遅いネットワーク、プロキシ経由、または大きなリクエストで起こります。
  • 再試行で成功することもあります。

考えられる原因

  • 遅いネットワークまたはプロキシ。ドキュメントには、遅いネットワークやプロキシが原因になりうると書かれています。
  • 接続の停滞。VPNやファイアウォールがパケットを保留し、応答が届かないことがあります。
  • 大きなリクエスト。ストリーミングでないリクエストには、ローカルセッションで300秒の制限があります。
  • 古いバージョンでのタイムアウト0。v2.1.305より前のバージョンでAPI_TIMEOUT_MSを0にすると、すべてのリクエストが失敗することがあります。

確認方法

  1. 同じシェルからAPIホストをテストします。

    curl -I https://api.anthropic.com
  2. バージョンを確認します。

    claude --version
  3. プロキシ環境変数を表示します。

    env | grep -i proxy
  4. Claude Code内でセットアップのチェックを実行します。

    /doctor

解決方法

  1. リクエストをやり直します。

  2. ネットワークまたはプロキシが遅い場合は、タイムアウトを延ばします。

    export API_TIMEOUT_MS=900000
  3. タイムアウトを0にしていた場合は、Claude Codeをアップデートします。

  4. タイムアウトが頻繁に起きる場合は、別のネットワークとVPNを試します。

Kilobatを使う場合

  1. Kilobatの接続ドクターは、APIホストを層ごとにテストします。失敗した層や遅い層を示します。

    kilobat why https://api.anthropic.com
  2. これらのKilobatのチェックは無料です。AIエージェントはMCPを通じてdiagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。

よくある質問

タイムアウトの初期値はいくつですか?

Claude Codeのドキュメントでは、リクエストのタイムアウトは10分とされています。

API_TIMEOUT_MS=0にすると、すべての期限が無効になりますか?

いいえ。最初のバイトの期限と、本文のアイドルタイムアウトは有効なままです。

出典

2026年10月29日に確認。