如果 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 找到。