---
title: "MacのClaude Codeでの“Request timed out” · Kilobatガイド"
url: "https://kilobat.app/ja/guides/claude-code-request-timed-out"
description: "MacのClaude Codeに“Request timed out”と表示されます。期限までにAPIが応答しませんでした。ネットワーク、プロキシ、タイムアウトの設定を確認してください。"
---

# 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に接続できない原因を見つける](https://kilobat.app/ja/guides/recipes/why-cant-it-connect)を参照してください。

## よくある質問

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

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

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

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

## 出典

- [Claude Code: Error reference](https://code.claude.com/docs/en/errors.md)
- [Claude Code: Enterprise network configuration](https://code.claude.com/docs/en/network-config.md)

2026年10月29日に確認。

## 関連ガイド

- [MacのClaude Codeでの“Unable to connect to API”](https://kilobat.app/ja/guides/claude-code-unable-to-connect-to-api): Claude Codeは、リクエストがapi.anthropic.comに届かないと、Unable to connect to APIと表示します。
- [Mac版ChromeのERR_CONNECTION_TIMED_OUT](https://kilobat.app/ja/guides/err-connection-timed-out): Chromiumはこのエラーを「A connection attempt timed out.」と説明しています。Chromeはアドレスを見つけましたが、サーバが時間内に応答しませんでした。
- [バッファブロート：ネットワークが混むと通話が遅れる](https://kilobat.app/ja/guides/bufferbloat-mac): バッファブロートとは、ネットワーク機器がバッファにデータを溜めすぎることで生じる遅延です。
- [Macでpingを使ってパケットロスをテストする](https://kilobat.app/ja/guides/packet-loss-mac): パケットロスがあると、通話が途切れたりページが止まったりします。
