【解決方法】Claude Code で出る「API Error (Request timed out.)」の原因と対処: 10分待っても返事がないときに出る
2026年11月1日
Claude Code で Request timed out が出て、作業が止まることがあります。
Claude Code が決められた時間(設定のままだと10分)待っても、返事が来なかったときのエラーです。遅い回線やプロキシを通しているなら、待つ時間を延ばせます。
出たときの表示と、直るまでにしたことを残しておきます。
環境
- Claude Code 2.1.309
- 2026年11月1日に確認
発生したエラー
古いバージョンでは、次のように表示されていました。
terminalAPI Error (Request timed out.)
今のバージョンでは、次の文です(公式のエラー一覧による)。
terminalRequest timed out
原因
API の返事が、決められた時間内に届きませんでした。待つ時間は設定のままだと10分で、API_TIMEOUT_MS で変えられます。返事が来ないまま待っている間も、Claude Code は何度かやり直しています。やり直しの回数と時間は、接続に失敗したときの再試行の動きにあります。
公式のエラー一覧の「Request timed out」の節には、待つ時間は設定のままだと10分で、API_TIMEOUT_MS で変えられると書かれています。
解決方法
関連するエラー
返事が来ないときに出るエラーには、ほかに次のものがあります。
| 表示される文 | 意味 |
|---|---|
API Error: No response from API | 返事の最初のデータが決められた時間内に届かなかった |
API Error: Stream idle timeout - no chunks received | 返事の途中でデータが一定時間届かなくなった |
Waiting for API response · will retry in … · check your network | 20秒以上データが届かず、やり直す前の待ち時間 |
| `API Error (api.anthropic.com | 504: Gateway time-out)` |
注意点
まとめ
Request timed out は、Claude Code が10分待っても返事が来なかったときに出ます。たまに出るだけなら、同じ指示をもう一度送れば済むことがほとんどです。
遅い回線やプロキシを通していて何度も出るなら、API_TIMEOUT_MS で待つ時間を延ばしてみてください。
参考文献
著書
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも
使い方パスワードが GitHub で丸見えに? 原因は、Claude Code の確認で選んだ「Yes, and don't ask again」
使い方その OpenCode、脆弱性の告知がないからと安心してない? 今のままだと乗っ取られるかも
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも

