Claude Code 出現「Connection error」「fetch failed」(連線錯誤)的原因與解決方法

現在有故障嗎?

Claude Code 官方狀態正常。若此錯誤持續出現,多半是實作或你的運作環境問題。

查看 Claude Code 的運作狀態

錯誤含義

Claude Code 無法連線到 Anthropic API(api.anthropic.com)。原因包括網路、企業代理/防火牆、DNS、TLS(時鐘偏差),或 API 端異常。

常見原因

  • 網路不穩定或離線
  • 企業代理/防火牆封鎖 api.anthropic.com
  • 經 VPN / 零信任被封鎖
  • DNS 解析失敗
  • 系統時間偏差導致 TLS 驗證失敗
  • Anthropic API 端異常

解決方法

  1. 1.檢查網路並重新連線
  2. 2.在代理環境下正確設定 HTTPS_PROXY / HTTP_PROXY
  3. 3.在防火牆/VPN 中放行到 api.anthropic.com 的連線
  4. 4.更換 DNS 或重新連線
  5. 5.校正系統日期時間
  6. 6.稍候並重試
  7. 7.在本頁頂部及 Claude API 確認是否有異常

何時該等待 / 等待也無濟於事的情況

若是 API 端異常,會隨時間恢復。多數情況是你這端的網路/代理設定問題,等待也無濟於事,請檢查上述項目。

Claude Code 當機時的替代方案

CodexCursorGitHub CopilotClineWindsurfContinue

相關錯誤

常見問題

Connection error / fetch failed 是什麼?

Claude Code 無法連線到 Anthropic API(api.anthropic.com)。原因包括網路、企業代理/防火牆、DNS、TLS(時鐘偏差),或 API 端異常。

Connection error / fetch failed 如何解決?

檢查網路並重新連線 / 在代理環境下正確設定 HTTPS_PROXY / HTTP_PROXY / 在防火牆/VPN 中放行到 api.anthropic.com 的連線 / 更換 DNS 或重新連線 / 校正系統日期時間 / 稍候並重試 / 在本頁頂部及 Claude API 確認是否有異常

對比查看 Claude Code