跳到主要內容
maxstudioNews
AI 自動化DEV Community (Claude Code)約 5 分鐘

Claude Code 無法連線?七步驟代理伺服器設定檢查清單

當 Claude 瀏覽器版運作正常,但 Claude Code 在終端機中卻無法連線時,通常是代理伺服器設定問題。本文提供一份七步驟檢查清單,協助使用者快速診斷並解決 Claude Code 的代理伺服器連線障礙。這些步驟涵蓋了環境變數設定、SOCKS 代理限制、NO_PROXY 排除等常見問題,確保 Claude Code 能順利透過代理伺服器連線。

Claude Code 無法連線?七步驟代理伺服器設定檢查清單
圖片來源:DEV Community (Claude Code)

如果 Claude.ai 在您的瀏覽器中能正常載入,但 Claude Code 在終端機中卻逾時,這表示瀏覽器使用了您的系統代理,而 CLI(命令列介面)則沒有。Claude Code 是一個終端機程序,它只會讀取代理伺服器的環境變數。

幾乎所有情況都歸因於三個原因之一:變數未在啟動它的 shell 中設定、位址是 SOCKS 位址,或者 NO_PROXY 排除了該請求。以下每個步驟都能讓您在一分鐘內找到答案。這些資訊來自 Claude Code 官方網路配置頁面,並於 2026 年 11 月 15 日進行了檢查。

1. 尋找您的本地 HTTP 埠號

打開 Clash Verge Rev、FlClash 或您使用的任何客戶端設定,尋找 HTTP 埠號或混合埠號。7890 和 7897 是常見的埠號。請使用您客戶端顯示的數字。

訂閱 URL 不是代理伺服器位址,節點的遠端埠號也不是。您需要的是客戶端在本地監聽的埠號。

2. 在相同的 shell 中設定變數,然後啟動

在 macOS 和 Linux 上的 zsh 或 bash 中,請執行以下指令:

export HTTPS_PROXY = "http://127.0.0.1:7890" export HTTP_PROXY = "$HTTPS_PROXY" claude

Windows 上的 PowerShell 沒有 export 指令,請使用以下指令:

$env : HTTPS_PROXY = "http://127.0.0.1:7890" $env : HTTP_PROXY = $env : HTTPS_PROXY claude

Claude Code 在啟動時只會讀取這些變數一次。在進行任何更改後,請結束正在執行的會話並重新啟動它。

3. 不要使用 SOCKS 位址

文件指出 Claude Code 不支援 SOCKS 代理。以 socks5:// 開頭的位址將無法運作。請使用 HTTP 或混合埠號,並以 http:// 作為前綴。

Https_proxy 這個名稱描述了被代理請求的類型,但本地代理位址本身仍然以 http:// 開頭。

4. 檢查是否有舊的變數覆蓋了新設定

Claude Code 會按照以下順序,使用第一個設定的變數:

https_proxy HTTPS_PROXY http_proxy HTTP_PROXY

多年前留在您的 .zshrc 中的小寫 https_proxy 會覆蓋您剛剛 export 的大寫變數。您可以使用 env | grep -i proxy 來檢查。

5. 檢查 NO_PROXY 設定

執行 echo $NO_PROXY 或 $no_proxy 來查看。如果其中包含 anthropic.com、claude.ai 或單獨的星號,這些請求將會跳過代理伺服器。

條目可以用空格或逗號分隔,而星號則會繞過所有請求。在公司筆記型電腦上,請僅移除阻礙連線的條目。

6. 詢問 Claude Code 正在使用哪個代理伺服器

在會話中執行 /status,並查看 Proxy 這一行。它會顯示活動的代理伺服器 URL,並將無法解析的值標記為無效。

如果位址缺少 http:// 方案,Claude Code 會在啟動時停止並顯示一個錯誤,其中會指出變數名稱。如需更多詳細資訊,請使用偵錯日誌啟動:claude --debug。

日誌會儲存到 ~/.claude/debug/,而不會在終端機中印出。

7. 在不使用 Claude Code 的情況下測試代理伺服器

執行 curl -x http://127.0.0.1:7890 -I https://api.anthropic.com。如果回應標頭成功返回,表示您的終端機透過代理伺服器的路徑運作正常,問題出在變數設定。

如果逾時或連線被拒絕,則問題出在客戶端或節點,請回到步驟 1 重新檢查。

人們常忽略的兩種情況

WSL、容器和遠端伺服器:在這些環境中,127.0.0.1 指的是環境本身,而不是您 Windows 或 Mac 主機上的客戶端。請使用環境可以到達的位址,並在客戶端中啟用 LAN 存取。

永久設定和背景代理:將變數放入 ~/.claude/settings.json 的 env 區塊中。文件指出背景代理不會繼承您正在輸入的 shell,因此設定檔是唯一能可靠地觸及它們的地方。

{ "env" : { "HTTPS_PROXY" : "http://127.0.0.1:7890" , "HTTP_PROXY" : "http://127.0.0.1:7890" } }

在規則模式下必須透過代理伺服器的網域

api.anthropic.com claude.ai claude.com platform.claude.com

遺漏任何一個都會導致登入卡住。

代理伺服器無法解決的問題

401、403 或 429 錯誤表示請求已到達 Anthropic。這些是驗證、權限或速率限制問題,請閱讀回應主體以了解詳情。被停用的帳戶只能透過官方申訴來恢復。

Anthropic 會根據您的實際位置來決定可用性。更改您的出口節點並不會改變這項規則,因此請先檢查支援國家列表。

參考資料

Claude Code 網路配置:https://code.claude.com/docs/en/network-config

Anthropic 支援國家:https://www.anthropic.com/supported-countries

聲明:我在 NailongVPN (nailongvpn.com) 工作,這篇文章是在協助使用者偵錯時撰寫的。一篇涵蓋 Cursor、GitHub Copilot 和 API 錯誤的較長版本可在 https://nailongvpn.com/en/ai-connectivity 找到。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。