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 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。
症狀
- 等了很久之後,Claude Code 印出
Request timed out。 - 在網路很慢、經過代理伺服器或請求很大時會發生。
- 有些重試可以成功。
可能原因
- 網路或代理伺服器很慢。文件指出,網路或代理伺服器很慢可能造成這個問題。
- 連線停滯。VPN 或防火牆可能扣住封包,因此沒有回應送達。
- 請求很大。在本機工作階段中,非串流請求有 300 秒的上限。
- 舊版本中的逾時值為零。在 v2.1.305 之前的版本中,把 API_TIMEOUT_MS 設為 0 可能導致每個請求都失敗。
如何檢查
從同一個 shell 測試 API 主機。
curl -I https://api.anthropic.com檢查你的版本。
claude --version顯示代理伺服器環境變數。
env | grep -i proxy在 Claude Code 中執行設定檢查。
/doctor
如何修正
重試請求。
如果網路或代理伺服器很慢,請調高逾時值。
export API_TIMEOUT_MS=900000如果你把逾時值設為 0,請更新 Claude Code。
如果經常逾時,請測試另一個網路和 VPN。
使用 Kilobat
Kilobat 的連線診斷會逐層測試 API 主機,並指出失敗或變慢的那一層。
kilobat why https://api.anthropic.com這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以
diagnose_connection和diagnose_network執行。請參閱找出某個網站或 API 連不上的原因。
常見問題
預設逾時是多久?
Claude Code 文件指出請求逾時為 10 分鐘。
API_TIMEOUT_MS=0 會關閉所有期限嗎?
不會。首位元組期限和內容閒置逾時仍然有效。
資料來源
查核日期:2026 年 10 月 29 日。