教程 2026年9月15日

Claude Code 如何搭配 Clash Verge 穩定使用?完整設定教學

Claude Code 能在終端機中協助撰寫程式、檢查專案與執行開發任務,但網路品質會影響回應速度。本文帶你用 Clash Verge 完成基本設定,並提供節點選擇與連線異常的處理方向。

跨境電商 Amazon 賣家 Shopify

一、先理解 Claude Code 的連線路徑:終端機不等於瀏覽器

Claude Code 是在終端機中執行的開發工具,會依照你的指令讀取專案檔案、分析程式碼、提出修改建議,並在獲得授權後執行測試、搜尋檔案或呼叫相關開發工具。這種工作方式與直接在瀏覽器開啟聊天頁面不同:瀏覽器通常會讀取作業系統代理設定,但終端機程式、Node.js 執行環境、套件管理器與子行程,未必會自動使用同一個出口。

因此,遇到「瀏覽器可以開啟服務,但 Claude Code 一直等待」或「登入頁面可以載入,實際請求卻逾時」時,不要先假設是帳號或工具本身故障。實際上,整個流程可能同時涉及帳號登入、模型請求、安裝與更新、套件下載、憑證驗證,以及終端機所使用的 HTTPS 連線。其中任一環節沒有通過 Clash Verge 的正確規則,都可能表現為無回應、重試、連線重置或請求逾時。

請遵守所在地法令、公司資訊安全政策與 Anthropic 服務條款。本文僅說明如何在自有裝置上檢查開源代理與終端機連線;若你使用公司帳號、固定出口或受管控的開發環境,請先依照組織的法遵與資安要求操作。

二、先分類錯誤:代理問題、帳號問題與專案問題要分開

開始修改 Clash Verge 設定之前,建議先把錯誤整理成可重現的描述。若終端機立即顯示未授權、登入失敗、帳號沒有權限、配額不足或模型不可用,這些訊息通常屬於帳號、訂閱、工作區或服務政策問題,單純切換代理節點不一定能解決。若錯誤是ETIMEDOUT、ECONNRESET、socket hang up、TLS handshake timeout,而且不同網路或節點的成功率明顯不同,才比較值得優先檢查代理路徑。

另外,也要排除本機專案造成的假象。例如目前目錄沒有有效的版本控制資訊、檔案權限不足、依賴套件尚未安裝、工作區設定不完整,或指令要求讀取的檔案不存在,這些問題即使網路完全正常仍會發生。最簡單的做法是先建立一個小型測試專案,確認 Claude Code 能否完成讀取目錄、說明檔案與執行單元測試等基本操作,再把範圍擴大到正式專案。

若問題只在某個專案出現,請比較該專案是否使用了不同的 Node.js 版本、套件管理器或啟動腳本;若所有目錄都無法連線,而且錯誤會隨節點改變,才把焦點放到 Clash Verge 的模式、規則、DNS 與本機代理埠。

三、設定 Clash Verge 前的準備工作

開啟 Clash Verge 後,先確認設定檔已成功載入,且目前使用的是含有可用節點與策略群組的設定。不要只看托盤圖示或「已啟用」字樣,還要進入連線或日誌頁面,確認核心確實正在執行。若設定檔剛匯入,建議先更新一次訂閱,再檢查節點延遲與最近的錯誤紀錄;一個顯示可用、但實際握手頻繁失敗的節點,會讓後續判斷變得困難。

接著記下本機的混合代理埠或 HTTP 代理埠。很多配置預設使用類似 127.0.0.1:7890 的位址,但你的設定可能改成其他埠號,不能直接照抄。若要讓終端機明確使用代理,必須以 Clash Verge 實際顯示的埠號為準。對大多數以 HTTPS 發送請求的工具來說,混合埠通常比單獨指定 SOCKS 埠更容易與環境變數配合。

在模式選擇上,可以先使用規則模式,讓已知的服務域名依策略群組分流。若你正在排查規則是否命中,短時間使用全域代理作為對照測試會比較容易,但不建議長期把所有區域流量都送往同一節點。測試完成後,應恢復規則模式,並透過日誌確認實際命中的策略,而不是只依賴主觀感覺判斷「好像有走代理」。

四、為 Claude Code 建立清楚的規則與節點策略

Claude Code 的請求不一定只會連到一個主機。登入流程、服務介面、模型請求、更新檔案與套件下載,可能由不同的網域提供。實務上不要一開始就把整個網域家族無差別送進代理,而是先依照官方文件、終端機錯誤與 Clash Verge 連線紀錄,整理出真正出現的主機。這樣可以減少誤分流,也能在日後更換訂閱或節點時快速定位問題。

你可以為模型服務建立獨立策略群組,例如 CLAUDE_DEV,再為程式碼託管或套件下載建立 DEV_TOOLS。分組的好處是:當模型請求延遲變高時,只需要切換 CLAUDE_DEV;如果套件下載速度不穩,也能單獨測試 DEV_TOOLS,不必讓整個系統同時更換出口。

# Example rules snippet — replace group names with your profile
rules:
  - DOMAIN-SUFFIX,anthropic.com,CLAUDE_DEV
  # Add the real service hosts observed in your logs.
  - DOMAIN-SUFFIX,github.com,DEV_TOOLS
  - DOMAIN-SUFFIX,npmjs.org,DEV_TOOLS

  # Keep private network traffic direct.
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve

  - MATCH,DIRECT

上面的內容只是示意,不能在未核對域名、群組名稱與規則順序的情況下直接套用。Clash 通常按照規則由上至下匹配;如果前面有過寬的 DOMAIN-SUFFIX 或關鍵字規則,後面的精確規則可能永遠不會生效。每次修改後,請在 Clash Verge 重新載入設定,並透過連線紀錄確認請求命中了哪一個策略。

五、讓終端機正確使用 Clash Verge 的代理埠

圖形介面顯示「系統代理已開啟」,不代表所有終端機工具都會自動讀取它。不同程式可能讀取作業系統代理、環境變數、專屬設定檔,或完全不使用代理。對 Claude Code 這類終端機工具,最容易驗證的方式是先在目前的 shell 中明確設定代理環境變數,再進行最小化測試。

# Replace 7890 with the HTTP or mixed port shown in Clash Verge
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=http://127.0.0.1:7890

# Keep local addresses outside the proxy
export NO_PROXY=localhost,127.0.0.1,::1

在 Windows PowerShell 中,環境變數寫法不同;在 macOS 或 Linux 上,則通常可將需要長期使用的設定放進互動式 shell 設定檔。不過,請先以目前工作階段測試,不要一開始就永久修改全域環境。某些公司內網、資料庫或本機開發服務不應經過外部代理,若把代理變數寫入所有啟動腳本,可能造成內部服務無法連線。

你可以先使用一個簡單的 curl 請求驗證環境變數是否生效,再啟動 Claude Code。測試時觀察三件事:終端機是否能完成 DNS 解析、Clash Verge 日誌是否出現對應請求,以及請求使用的策略是否為預期的 CLAUDE_DEV。若 curl 能通而工具仍失敗,問題可能在工具自身的代理支援、認證流程或版本相容性,而不是基本網路路徑。

如果終端機由編輯器、任務執行器或其他背景服務啟動,還要注意父行程是否繼承了環境變數。你在互動式終端機裡設定成功,不代表從 IDE 內建終端機、工作區腳本或自動化程序啟動時也會得到相同設定。建議在腳本開頭輸出代理變數是否存在,但不要把任何存取權杖、API 金鑰或私密資訊寫入公開日誌。

六、系統代理與 TUN 模式:什麼時候該切換

如果 Claude Code 和相關工具都能讀取 HTTP(S)_PROXY,先使用系統代理或明確環境變數通常比較容易維護。這種方式的影響範圍較小,遇到問題時也容易恢復:關閉環境變數或停用系統代理即可回到原本的網路路徑。對只需要讓單一終端機工作階段使用代理的情境,這往往是第一個值得嘗試的方案。

TUN 模式則把更多不讀代理設定的應用納入虛擬網路介面,由核心依照路由和規則決定出站。當某個原生程式、背景子行程或套件工具完全不理會代理環境變數時,TUN 可能比較方便;但它也需要更高權限,並可能與其他 VPN、零信任客戶端、公司安全軟體或虛擬網卡產生衝突。

啟用 TUN 前,請先記錄目前的網路狀態,並確認知道如何在 Clash Verge 中關閉它。若啟用後出現區域網路服務無法開啟、內部 Git 伺服器連不上、網路速度突然下降或 DNS 解析異常,先停用 TUN,再逐項檢查路由與例外規則。不要同時更換節點、改 DNS、改規則與開啟 TUN,否則很難知道哪一個變更真正造成結果。

DNS 也值得單獨檢查。若域名解析結果來自不一致的網路路徑,可能出現「規則看似正確,但實際連線到錯誤位址」的情況。排查時可分別測試直連 DNS 與代理 DNS,並對照 Clash Verge 日誌。對內部域名、區域網路與公司指定解析伺服器,則應保留明確的直連或專用 DNS 規則,不要一律交給外部節點處理。

七、節點選擇與穩定性檢查:低延遲不是唯一標準

對互動式程式設計工具來說,節點的穩定性通常比一次測得的最低延遲更重要。Claude Code 可能會進行多輪請求,還可能傳送較大的上下文或等待較久的模型回應;一個延遲很低但容易重置長連線的節點,實際體驗可能比延遲稍高但保持穩定的節點更差。

建議先選定一個表現穩定的節點,完成規則命中、代理變數與工具版本的確認,再以同一套測試流程比較第二個節點。可以在筆記中記錄節點名稱、測試時間、錯誤訊息、Clash Verge 命中策略與工具版本。當問題再次出現時,這些資料比「剛才好像可以」更有助於判斷是節點波動、服務端限制,還是本機設定被改動。

八、常見連線異常與建議處理順序

登入頁面可以開,但登入後沒有回應

先觀察登入跳轉是否連到多個主機,並確認這些主機都在 Clash Verge 日誌中出現且命中了預期策略。若只有主登入頁經過代理,而驗證回呼或靜態資源直連,可能會出現登入迴圈或空白頁。此時不要立即刪除所有設定,應先記錄缺少的域名,再以精確規則補上。若登入後顯示明確的權限或帳號訊息,則應回到帳戶設定處理。

請求逾時或反覆重試

先確認終端機是否真的使用了代理埠,再確認 Clash Verge 是否有對應連線紀錄。如果完全沒有紀錄,表示請求可能沒有經過 Clash;如果有紀錄但頻繁重置,則比較像節點、DNS、長連線或服務端路徑問題。可以在相同環境下切換另一個節點測試,但一次只改一個變數,避免把規則錯誤誤判成節點故障。

模型請求正常,但 npm 或 Git 下載失敗

這種情況很常見,因為模型服務與套件、程式碼託管使用的主機可能完全不同。請分別檢查套件管理器是否讀取代理環境變數、註冊表是否為公司指定來源,以及 Git 是否有自己的代理設定。不要為了修復一次套件下載,就把所有網域改成全域代理;應將下載來源獨立放入 DEV_TOOLS 策略,並保留內部倉庫的直連例外。

開啟 TUN 後區域網路或公司 VPN 異常

先停用 TUN,確認問題是否立即消失,再檢查路由表、虛擬網卡優先順序與內網例外規則。公司 VPN 常會要求特定域名或網段固定走內部通道,若被 TUN 或全域代理攔截,可能導致內部服務不可用。這類情況應以公司網路政策為最高優先,不要只追求讓模型工具能連線。

九、常見問題

瀏覽器能用,為什麼 Claude Code 仍然連不上?

瀏覽器與終端機可能使用不同的代理設定、DNS 路徑與身分狀態。請先為終端機設定與 Clash Verge 混合埠一致的代理環境變數,再從連線日誌確認請求確實命中預期策略。

是否應該一直使用全域代理模式?

全域模式適合短時間用來判斷「規則模式是否漏掉必要域名」,不建議作為長期方案。確認問題後,應回到規則模式,為模型服務、套件下載、內網與私人網段分別設定策略,降低誤路由和維護成本。

什麼時候需要開啟 TUN?

當某個必要程式完全不讀取系統代理或環境變數,而且你已確認規則與節點正常時,才考慮 TUN。啟用前要確認權限、虛擬網卡、公司 VPN 與區域網路相容性,並先準備好停用與復原方法。

換了很多節點仍然失敗,是否代表節點都不可用?

不一定。如果錯誤訊息是權限、帳號、額度或模型不可用,換節點不會修復服務端設定;如果完全沒有連線日誌,也可能是終端機沒有使用代理。建議依序檢查帳號狀態、代理環境變數、規則命中、DNS、節點穩定性,避免反覆盲切節點。

相較於只依賴瀏覽器代理外掛或必須手動為每個應用程式重複設定的工具,Clash Verge 能把終端機、套件管理器與其他開發程式放進同一套可觀察的規則框架;你可以依照日誌調整域名策略,使用穩定節點承載長連線,再透過系統代理或 TUN 補足不同程式的相容性。若你正在尋找一種能同時管理 Claude Code 與日常開發流量、又方便逐步排錯的方案,完成上述檢查後即可前往下載適合自己平台的 Clash 客戶端。

立即下載 Clash,開始穩定的終端機開發流程 →

準備好開始了嗎?

使用 Clash Verge 管理 Claude Code、套件下載與其他開發工具的連線策略。