前言：瀏覽器能用，不代表終端機已走代理

如果你在瀏覽器中可以正常開啟 Claude，卻在執行 Claude Code 時遇到連線逾時、登入失敗或請求無法完成，問題未必出在節點本身。瀏覽器通常會使用作業系統代理設定，或由 Clash 的系統代理功能接管流量；命令列程式則可能在獨立的終端機程序中執行，不一定會自動沿用瀏覽器的代理設定。

Claude Code 的連線需要經過幾個環節：終端機程序取得代理環境變數、Clash 在對應連接埠接收流量、分流規則把請求送往正確的策略組，最後由節點連線至服務端。任何一環設定錯誤，都可能讓瀏覽器正常、CLI 卻卡在連線或登入階段。

排查時建議由近到遠：先確認 Clash 正在執行及代理連接埠，再檢查目前終端機是否有代理變數，接著測試目標連線並查看 Clash 連線記錄。一次只改一個設定，才能判斷問題究竟來自本機環境、規則分流，還是所選節點。

先確認這件事

Claude Code 是在終端機中啟動的命令列工具。只開啟 Clash 的系統代理，不一定會替每個終端機程序設定 HTTP_PROXY 或 HTTPS_PROXY。

1分辨逾時、代理錯誤與登入問題

先記下錯誤發生的時間、操作步驟與完整訊息。相似的「連不上」提示可能對應不同原因；只靠反覆切換節點，往往會掩蓋真正的設定問題。

現象	優先檢查	判斷方向
連線逾時或等待回應很久	代理變數、連接埠、節點狀態	終端機可能沒有使用 Clash，或所選節點無法穩定連線。
Connection refused	Clash 是否執行、代理位址及連接埠	本機代理服務沒有在指定連接埠監聽，或變數指向錯誤的連接埠。
瀏覽器可開啟 Claude，CLI 仍失敗	目前 shell 的環境變數與 Clash 連線記錄	瀏覽器與終端機可能走不同的代理路徑。
網路測試成功，但帳號登入未完成	登入流程、瀏覽器回跳與帳號狀態	基本網路已通，問題可能在登入授權流程，不宜直接判定為代理故障。

不同版本的 Clash 客戶端、核心與使用者設定，監聽連接埠可能不相同。不要直接假設連接埠一定是 7890：請在 Clash Verge、Clash Verge Rev 或其他客戶端的設定頁查看「混合代理埠」（Mixed Port）或 HTTP 代理埠，再將實際數值填入後續指令。

注意

不要在公開貼文或截圖中分享 API 金鑰、登入權杖、完整授權網址或包含個人資訊的終端機記錄。排查代理只需要查看連線狀態與必要的錯誤文字。

2動手設定終端機代理變數

以下範例使用本機代理位址 127.0.0.1，並以 7890 作為示意連接埠。請將它替換成 Clash 客戶端目前實際使用的連接埠。這些設定只會影響目前開啟的終端機工作階段；關閉視窗後通常需要重新設定。

macOS 與 Linux：設定目前工作階段

在 Terminal、iTerm 或其他 shell 中執行以下指令。HTTP 與 HTTPS 請求都使用本機 Clash 代理時，可分別設定大小寫形式，提升與不同命令列程式的相容性：

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"

接著在同一個終端機視窗中啟動 Claude Code。若你先設定變數、再從另一個未繼承該環境的視窗啟動程式，新視窗不會自動取得剛才的設定。可用以下指令檢查變數是否存在：

echo "$HTTP_PROXY"
echo "$HTTPS_PROXY"

若想取消目前工作階段的代理設定，可執行：

unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy

Windows：PowerShell 設定

在啟動 Claude Code 的同一個 PowerShell 視窗中設定環境變數。以下設定同樣只適用於目前視窗：

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

如果使用 Windows Terminal，請確認執行 claude 的分頁確實是剛才設定變數的 PowerShell 工作階段。若你從開始功能表、IDE 整合終端機或其他工具啟動 Claude Code，它可能使用不同的環境變數。

設定與驗證步驟

在 Clash 客戶端確認代理核心正在執行，並查看目前的 HTTP 或混合代理連接埠。
在即將執行 Claude Code 的終端機中，設定對應的 HTTP_PROXY 與 HTTPS_PROXY。
使用同一個視窗進行連線測試，再啟動 Claude Code，避免測試與程式使用不同環境。
若仍失敗，查看 Clash 的連線記錄，確認測試期間是否出現來自該程序的請求及其匹配規則。

關於 SOCKS 代理

若 Clash 提供 SOCKS 連接埠，應先確認 Claude Code 及其執行環境支援的代理格式，再設定相應變數。排查初期建議先使用客戶端明確提供的 HTTP 或混合代理埠，不要只把連接埠改成 SOCKS 埠，否則可能引入協定不相容問題。

3測試連線並檢查 Clash 分流

變數設定完成後，先用命令列測試工具確認終端機是否能透過代理連線，再檢查 Claude Code 的請求有沒有進入 Clash。這一步可以把「終端機完全沒走代理」與「請求已進入代理，但節點或規則不合適」區分開來。

用 curl 確認代理是否可用

在剛才設定好環境變數的終端機中執行：

curl -I --connect-timeout 10 https://api.anthropic.com

這項測試的目的，是觀察請求是否能經目前的網路路徑取得回應；它不代表 API 已完成帳號驗證，也不保證 Claude Code 的登入流程一定成功。若逾時，先檢查連接埠與 Clash 連線記錄；若回應很快，則表示基本連線路徑可能可用，可繼續查看應用程式本身的錯誤與登入狀態。

確認規則命中與節點狀態

啟動測試時，同時打開 Clash 客戶端的連線頁面或即時記錄。觀察請求是否出現、匹配了哪條規則，以及最後被送往哪個策略組。若請求出現但被導向 DIRECT，而目前網路環境無法直連服務，請檢查規則順序與該網域的分流策略；若請求被導向代理組，則確認該組已選取可用節點，並測試另一個穩定節點作比較。

需要針對服務網域調整規則時，應採用你目前配置檔支援的寫法，將規則放在可能過早匹配的廣泛規則之前，並確認其目標策略組名稱確實存在。以 DOMAIN-SUFFIX 規則為例，先確認要處理的網域與策略組，再按配置格式加入規則：

rules:
  - DOMAIN-SUFFIX,anthropic.com,PROXY
  - MATCH,FINAL

上方的 PROXY 只是示意名稱，必須替換成你配置中實際存在的策略組；若你的規則集由訂閱或覆寫檔管理，直接修改後可能在更新時被覆蓋。修改前先備份設定，並確認規則順序，避免把不相關流量一併導向代理。

仍然逾時時的逐項排除方式

沒有任何連線記錄：確認終端機變數有值、Claude Code 是從同一工作階段啟動，以及本機代理連接埠正確。
連線記錄顯示直連：檢查服務網域對應的分流規則是否被更早的規則攔截，並確認目標策略符合目前網路環境。
已匹配代理組但仍逾時：暫時切換到另一個可用節點，或用同一條連線測試比較；若其他應用也不穩定，優先排查節點與本地網路。
只有特定終端機失敗：檢查它的 shell 設定、啟動方式與代理環境變數，並確認是否有其他工具覆寫這些變數。
網路通但登入失敗：依 Claude Code 顯示的登入指示重新檢查授權流程，確認系統瀏覽器能完成回跳；不要把授權錯誤誤當成連接埠故障。

避免一次改太多設定

同時更換節點、修改 DNS、切換 TUN 模式與重寫規則，會讓故障原因難以判斷。建議每次只調整一項，記錄結果；確認有效後再保留設定。

如果終端機測試能通、Clash 也顯示請求已走對策略，但 Claude Code 仍無法登入或持續報錯，請記錄錯誤訊息、客戶端版本、作業系統與測試結果，再依官方支援管道檢查帳號或應用程式狀態。請遮蔽權杖、金鑰、電子郵件等敏感資訊。

立即免費下載 Clash，開啟流暢上網新體驗 →

Claude Code 連不上怎麼辦？檢查 Clash 終端機代理設定