---
title: "Mac 上 Claude Code 的 Request timed out · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/claude-code-request-timed-out"
description: "Mac 上的 Claude Code 印出 Request timed out。API 在期限前沒有回應。請檢查網路、代理伺服器和逾時設定。"
---

# Mac 上 Claude Code 的「Request timed out」

當 API 在連線期限前沒有回應時，Claude Code 會印出 Request timed out。預設的請求逾時為 10 分鐘。

**讓你的代理程式來解決**拷貝一則提示詞，適用於 Claude Code、Codex 或任何能使用終端機的代理程式。

我的 Mac 出現了這個問題：Mac 上 Claude Code 的「Request timed out」。請閱讀 https://kilobat.app/zh-hant/guides/claude-code-request-timed-out.md，並和我一起逐步處理。如果缺少 Kilobat CLI，請安裝：brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查，並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於：所有目前 macOS 版本上終端機中的 Claude Code。 · 檢查日期：2026年10月29日

## 症狀

- 等了很久之後，Claude Code 印出 `Request timed out`。
- 在網路很慢、經過代理伺服器或請求很大時會發生。
- 有些重試可以成功。

## 可能原因

- **網路或代理伺服器很慢。**文件指出，網路或代理伺服器很慢可能造成這個問題。
- **連線停滯。**VPN 或防火牆可能扣住封包，因此沒有回應送達。
- **請求很大。**在本機工作階段中，非串流請求有 300 秒的上限。
- **舊版本中的逾時值為零。**在 v2.1.305 之前的版本中，把 API_TIMEOUT_MS 設為 0 可能導致每個請求都失敗。

## 如何檢查

1. 從同一個 shell 測試 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` 執行。請參閱[找出某個網站或 API 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

**預設逾時是多久？**

Claude Code 文件指出請求逾時為 10 分鐘。

**API_TIMEOUT_MS=0 會關閉所有期限嗎？**

不會。首位元組期限和內容閒置逾時仍然有效。

## 資料來源

- [Claude Code：錯誤參考](https://code.claude.com/docs/en/errors.md)
- [Claude Code：企業網路設定](https://code.claude.com/docs/en/network-config.md)

查核日期：2026 年 10 月 29 日。

## 相關指南

- [Mac 上 Claude Code 的「Unable to connect to API」](https://kilobat.app/zh-hant/guides/claude-code-unable-to-connect-to-api): 當請求無法送達 api.anthropic.com 時，Claude Code 會印出 Unable to connect to API。
- [Mac 版 Chrome 的 ERR_CONNECTION_TIMED_OUT](https://kilobat.app/zh-hant/guides/err-connection-timed-out): Chromium 對這個錯誤的描述是：「A connection attempt timed out.」Chrome 找到了位址，但伺服器沒有及時回應。
- [Bufferbloat：網路忙碌時通話延遲](https://kilobat.app/zh-hant/guides/bufferbloat-mac): Bufferbloat 是網路裝置在緩衝區中積存太多資料時所增加的延遲。
- [在 Mac 上用 ping 測試封包遺失](https://kilobat.app/zh-hant/guides/packet-loss-mac): 封包遺失會讓通話斷斷續續、網頁卡住。
