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 連不上的原因。

常見問題

預設逾時是多久?

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

API_TIMEOUT_MS=0 會關閉所有期限嗎?

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

資料來源

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