教程 2026年9月26日

Claude Code 在終端連不上?用 Clash Verge 設定代理與排查

Claude Code 在終端機連不上時,問題未必出在程式本身,也可能是命令列沒有走代理。本文示範如何用 Clash Verge 檢查代理模式、終端環境變數與分流設定,並提供連線測試及節點挑選方向,讓新手也能逐項排除常見狀況。

跨境電商 Amazon 賣家 Shopify

一、先釐清:瀏覽器能用,不代表 Claude Code 也走代理

如果你在瀏覽器中可以開啟 Claude 相關頁面,卻在終端機啟動 Claude Code 時遇到逾時、連線中斷或一直等待,兩種現象並不矛盾。瀏覽器通常會讀取作業系統的代理設定,或使用自己的網路設定;命令列程式則可能由目前的 shell、環境變數或程式自身的網路實作決定出口。換句話說,Clash Verge 顯示代理已啟用,不等於每個終端機行程都已使用代理。

也要先分清楚「無法建立連線」與「連上服務後遭拒絕」。若錯誤是 ETIMEDOUT、ECONNRESET 或 TLS handshake timeout,比較值得檢查代理路徑、節點與連線品質;若已取得明確的 401、403、登入失敗或額度訊息,則應另查帳號狀態、認證流程、服務權限與工具設定。看到錯誤碼就先換節點,可能會把真正的問題遮住。

本文以使用者自有裝置上的終端機與 Clash Verge 設定為範圍。請遵守所在地法規、公司網路政策及 Anthropic 服務條款;若使用組織管理的代理或裝置,請先確認相關政策,不要擅自改寫受管設定。

二、先檢查 Clash Verge:模式、監聽埠與節點狀態

開始改終端機環境前,先在 Clash Verge 確認代理核心正常運作,並檢查目前選取的設定檔與出站策略。不同版本或設定檔可能使用不同的監聽埠;不要因為網路文章常見某個埠號,就假定自己的電腦也是相同設定。請在 Clash Verge 的設定或常規頁面查看 HTTP、SOCKS 或混合埠(Mixed Port),並確認該埠確實已啟用。

接著確認目前模式與規則選擇。若是規則模式,Claude Code 連線所使用的主機必須命中預期的代理策略;若是全域模式,可用來短暫確認問題是否與分流有關,但不宜把它當成永久解法。每次測試只改一個變數,並記下測試時間、模式、節點及錯誤訊息,才有辦法辨認是哪項變更帶來差異。

Claude Code 使用的網域可能隨版本、登入方式或服務功能變動,因此不建議只憑一份固定網域清單建立寬泛規則。以 Clash Verge 連線紀錄中的實際主機為線索,再對照官方文件與錯誤訊息逐步補規則;如果請求根本沒有出現在紀錄裡,先處理代理變數或路由方式,比新增網域規則更有效。

三、讓終端機明確使用 Clash Verge 代理

最直接的測試方式,是在啟動 Claude Code 的同一個終端機工作階段設定 HTTP_PROXY、HTTPS_PROXY 與 ALL_PROXY。以下的 7897 只是示例,請替換成 Clash Verge 實際啟用、並且支援相應協定的本機埠。若你使用混合埠或 HTTP 代理,可先測試這種寫法:

export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"
export ALL_PROXY="http://127.0.0.1:7897"

claude

有些命令列工具只讀取大寫變數,有些也會檢查小寫形式;如果設定後仍看不到請求,可以一併設定小寫名稱。使用 SOCKS 埠時,請使用該埠實際支援的協定格式,不要把 SOCKS 埠誤當成 HTTP 代理。協定與埠號不相符,常會造成看似逾時、實際卻是代理握手失敗的狀況。

若只想在目前終端機測試,不要急著把設定寫進所有啟動檔。這樣可以避免其他程式也被改變出口,並方便在測試結束後關閉終端機或移除變數。若確認有效,再依使用的 shell,將設定加入合適的個人設定檔,或建立只供開發工作使用的啟動指令。macOS、Linux 常見的命令列介面多使用 export;Windows PowerShell 則可在目前工作階段設定環境變數:

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
$env:ALL_PROXY="http://127.0.0.1:7897"

claude

環境變數只會傳給其後啟動的子行程。若你已開啟終端機或編輯器,後來才在其他地方設定代理,新啟動的終端機與舊的終端機可能拿到不同設定;編輯器內建終端機也可能繼承編輯器啟動時的環境。修改後請在同一個視窗檢查變數,再重新啟動 Claude Code。若透過腳本、工作排程或遠端開發環境啟動,亦須在實際執行程式的環境中設定,而不是只在另一個互動式終端機設定。

四、用最小測試分開檢查代理、網路與工具本身

不必一開始就反覆執行完整工作流程。先確認本機代理埠是否有回應,再用 curl 測試一般 HTTPS 請求是否能透過指定代理送出。以下命令中的埠號仍須換成你的實際設定:

curl -I --proxy http://127.0.0.1:7897 https://api.anthropic.com

這個測試的重點是觀察是否能完成名稱解析、建立連線並取得伺服器回應,而不是期待一定出現特定狀態碼。服務端回覆錯誤狀態或提示缺少認證,仍可能代表網路路徑已經打通;相反地,若命令停在連線階段或報告代理連線失敗,就應先檢查埠號、代理協定、核心狀態及節點。測試時不要在命令列貼上或輸出 API 金鑰、存取權杖等秘密資料。

接著比較「明確指定代理」與「讀取環境變數」的結果。若帶有 --proxy 的請求成功,但不帶參數時失敗,通常表示目前 shell 沒有正確匯出代理變數,或工具未讀取你設定的變數。若兩種方式都失敗,先不要急著改 Claude Code 的認證設定;回到 Clash Verge 檢查紀錄有沒有對應連線,並嘗試一個已知可用的節點。

也可以依照下列順序縮小範圍:

  1. 確認核心與埠正常:確認 Clash Verge 已啟動,代理埠已開啟,並且設定的位址是本機回環位址。
  2. 測試一般 HTTPS:先用 curl 驗證明確代理請求;留意逾時出現在連線、名稱解析還是伺服器回應之後。
  3. 觀察 Clash 紀錄:確認請求有進入核心、命中預期規則,且沒有落到直連或拒絕策略。
  4. 再啟動 Claude Code:沿用相同終端機和環境變數測試;若此時仍失敗,再依錯誤訊息區分認證、權限或工具版本問題。

當本機請求可通、但 Claude Code 仍無法使用時,請記錄工具版本、作業系統、啟動方式、錯誤原文,以及 Clash 是否看到相關連線。避免直接公開包含個人路徑、帳號識別資訊或憑證的完整除錯輸出。若錯誤明確是帳號或存取權限問題,應回到官方帳戶與工具設定處理;代理只能改善連線路徑,不能修復憑證失效或授權不足。

五、規則分流與 TUN:什麼時候需要進一步調整?

如果終端機環境變數已設定,但 Claude Code 的連線仍沒有進入預期策略,先檢查連線紀錄所顯示的目的地主機和命中規則。比起把整個網域家族一股腦送進代理,更穩妥的方式是根據實際觀察到的主機新增必要規則,並保留其他連線原有的直連或公司政策。使用訂閱內建規則時,也要注意更前面的規則可能已先命中;一條寫在規則清單後段的新增項目,不一定會如預期生效。

終端機程式若不支援一般代理環境變數,或有多個工具需要共用系統層級的分流,可以評估在 Clash Verge 中使用 TUN。它會將符合條件的網路流量交由核心處理,因此對不讀取代理變數的行程可能較方便;但它也涉及系統權限、路由、DNS,以及與公司 VPN 或其他網路工具的相容性。啟用前應先了解如何關閉並還原設定,避免同時改動多項網路配置後無法判斷故障原因。

節點選擇也不應只看一次性的延遲數字。Claude Code 可能需要連續傳送多次請求,較重要的是連線穩定、回應不中斷,而且能依你的使用情境正常完成驗證。一次只切換一個節點,再用相同命令和相同網路環境重測;若換節點後狀況改變,記錄差異即可,不必同時重寫規則、切換模式與調整 DNS。

六、常見問題

Q:Clash Verge 已經開啟系統代理,為什麼終端機仍然連不上?
因為命令列程式不一定會讀取作業系統代理設定。請確認啟動 Claude Code 的同一個終端機已設定正確的代理環境變數,並核對其值與 Clash Verge 的實際監聽埠一致。

Q:測試網址回傳 401 或其他錯誤碼,是否代表代理沒有成功?
不一定。只要請求已到達伺服器,回覆狀態碼可能是認證或服務端處理結果。請將「有伺服器回應」與「帳號可以正常使用」分開判斷,也不要在測試命令中暴露憑證。

Q:我應該直接開啟 TUN 嗎?
不必。先試著為終端機設定代理變數;只有當工具不支援這種方式,或確實需要系統層級的流量處理時,再評估 TUN。使用前確認權限、路由、DNS 和其他 VPN 的相容性,並保留復原方法。

Q:為什麼同一個帳號在另一個終端機可以使用?
兩個終端機可能來自不同的 shell、編輯器或啟動程序,繼承到的環境變數也可能不同。請在能使用的視窗與失敗的視窗分別檢查代理變數和 Clash 連線紀錄,找出差異後再調整。

有些只針對瀏覽器設計的代理工具,雖然能處理網頁請求,卻未必會讓終端機、背景程序或編輯器子行程採用相同出口;固定手動指定代理雖然直接,卻也不利於日常切換和觀察規則。Clash Verge 可透過圖形介面查看模式、節點與連線紀錄,並搭配終端機代理變數或適當的 TUN 設定,讓排查有跡可循。如果你需要為常用裝置配置相容用戶端,可以先查看下載選項,再依自己的系統與網路政策選擇合適方案。

前往下載 Clash →

準備好開始了嗎?

下載適用於你的平台的客戶端,再依本文步驟檢查終端機代理設定與連線紀錄。