Waiting for API response · will retry in の原因と直し方 | Claude Code

エラー文字列

Claude Code

Waiting for API response · will retry in

⚠️ これはエラーではありません。 応答ストリームにデータが届かない時間が続いたため、再試行までのカウントダウンを表示している状態です。

接続はまだ失敗していません。 データが再び流れ始めるか、再試行が成功すれば、この表示は自然に消えます。

条件	待ち時間
通常	データが 20秒届かないと表示
アドバイザーによるレビュー中	90秒

⭐ 一度きりなら、何もしなくて構いません。 問題なのは「毎回出る」場合です。

繰り返し表示されるなら、それは「遅い」のではなく「届いていない」状態です。Unable to connect to API と同じ切り分けをしてください。

とくに疑うべきは、ストリーミングを妨げる中間機器です。

疑うもの	なぜ問題になるか
バッファリングするプロキシ	応答全体を受け取ってから中継するため、途中のデータが届かない
TLSインスペクション製品	復号・検査・再暗号化の間、データが止まる
ウイルス対策ソフトの通信スキャン	同上
帯域制限・QoS	転送が細切れになる

⭐ 「企業ネットワークだと毎回出るが、テザリングだと出ない」なら、中間機器で確定です。

VPN やプロキシを切って試す

これで出なくなるなら、原因は中間機器です。

別回線で試す

テザリングなどに切り替えて比較します。

プロキシ設定を確認する

env | grep -i proxy

Get-ChildItem Env: | Where-Object Name -match 'proxy'

利用者側でできることは限られます。

⚠️ 待ち時間の上限（API_TIMEOUT_MS）を延ばしても、この表示は減りません。 上限に達したのではなく、途中でデータが止まっているためです。混同しないでください。

表示	状態	対処
`Waiting for API response · will retry in`	まだ失敗していない。再試行待ち	多くの場合は不要
`Request timed out`	上限に達して打ち切った	分割する／上限を上げる
`Socket is closed`	接続が切られた	再送する／回線を確認
`Unable to connect to API`	そもそも繋がっていない	DNS・プロキシを確認

この4つは症状が似ていますが、対処はまったく違います。 表示されている文言をそのまま読んでください。