前言：為什麼 Claude Code 需要穩定網路？

Claude Code 是面向開發者的命令列 AI 工具，可以在終端機中閱讀專案檔案、分析程式碼、協助除錯、產生測試，以及根據你的指示修改檔案。它的操作方式和一般網頁聊天工具不同：一次任務可能需要連續發送多次請求，還可能在執行指令、讀取檔案或確認變更時維持較長時間的連線。因此，節點延遲、DNS 解析錯誤、代理模式不完整，都可能讓 Claude Code 出現登入失敗、請求逾時、回應中斷或反覆重試。

Clash Verge 可以把代理訂閱、節點選擇、規則分流與 TUN 模式集中在同一個介面中管理。只要設定得當，就能讓 Claude Code 的相關流量穩定通過代理，同時讓一般網站和本地開發服務保持直連，避免全域代理造成速度下降或內網工具無法使用。

本文設定目標

完成 Clash Verge 安裝、匯入訂閱、測試節點、設定代理模式與 DNS，並為 Claude Code 建立清晰且容易維護的分流規則。

1開始前的環境準備

在調整 Clash Verge 之前，先確認電腦、帳號和網路服務都處於可用狀態。很多連線問題其實不是配置檔案造成，而是系統權限、訂閱失效或節點本身品質不佳。

確認作業系統：Windows、macOS 和 Linux 都可以使用 Clash Verge Rev 或其他支援 Mihomo 的客戶端。不同版本的選單名稱可能略有差異，但核心概念相同。
準備有效訂閱：你需要從合法且可信任的服務商取得 Subscription URL。Clash Verge 本身不提供節點，也不會自動產生代理服務。
更新 Claude Code：確認 Node.js、npm 或官方要求的執行環境正常，並且可以在終端機執行 Claude Code。代理只能改善網路路徑，無法修復工具版本或帳號權限問題。
保留原始設定：修改 YAML 前先複製一份備份。若更新訂閱後設定被覆蓋，可以快速還原。

安全提醒

不要把訂閱連結、Access Token、API Key 或終端機錯誤日誌公開貼到論壇。訂閱 URL 通常包含帳戶識別資訊，API Key 洩漏後也可能造成未授權使用。

選擇合適的 Clash 客戶端

如果你剛開始使用，建議選擇介面完整、持續維護的 Clash Verge Rev，並確認其使用的是 Mihomo 核心。舊版 Clash for Windows 雖然操作簡單，但部分功能和核心支援已不適合新的協議與配置。macOS 使用者也可以選擇 ClashX 或其他支援 Mihomo 的客戶端，但本文的選單說明以 Clash Verge Rev 為主。

2在 Clash Verge 匯入訂閱與測試節點

完成安裝後，第一步不是立即開啟 TUN，而是先確認訂閱可以正常下載，並且至少有一個節點能穩定連線。匯入流程通常不會改變你的系統設定，適合先用來排查帳號和節點問題。

Windows / macOS 匯入步驟

開啟 Clash Verge，進入左側的「配置」或「Profiles」頁面。
將服務商提供的 Subscription URL 貼到訂閱輸入框，然後點擊匯入或下載。
等待 YAML 配置下載完成。若頁面顯示解析失敗，先確認連結沒有多餘的空格，也不要把整段網址截斷。
點擊剛匯入的配置，使其成為目前啟用的配置檔案。
前往「代理」頁面，選擇一個延遲較低、負載合理的節點。

小撇步

不要只看節點名稱中的國家或地區。先執行延遲測試，再實際開啟 Claude Code 發送一個短指令，因為 ICMP 延遲低不代表 HTTPS 長連線一定穩定。

節點選擇參考

觀察項目	建議標準	常見問題
延遲	一般開發用途優先選擇 250ms 以內	延遲過高會讓每次指令回應等待較久
穩定度	連續測試時不頻繁逾時或斷線	晚間尖峰時段封包遺失明顯
地區一致性	長時間使用同一地區的固定節點	頻繁變更 IP 可能觸發帳號安全驗證
負載	避開長期顯示高負載的共享節點	連線初期正常，長回應時速度突然下降

3選擇代理模式：規則、全域與 TUN

Clash Verge 常見的工作模式包括規則模式、全域模式和直連模式。對 Claude Code 來說，沒有一個模式適合所有網路環境；最穩妥的做法是先用全域模式確認代理可用，再切換到規則模式，最後視需要啟用 TUN 模式。

先用全域模式排查連線

如果你不確定 Claude Code 的流量是否經過 Clash，可以短時間切換到「全域」模式，並選擇一個固定節點。接著在終端機執行 Claude Code，測試登入、發送問題和取得完整回應。如果全域模式正常而規則模式失敗，通常代表規則沒有匹配相關域名，或終端機程式沒有使用系統代理。

建議的測試順序

在 Clash Verge 開啟系統代理。
暫時選擇全域模式與固定節點。
確認瀏覽器可以開啟一般 HTTPS 網站，並檢查外部 IP 是否已變更。
在專案目錄中執行 Claude Code，輸入簡短且不涉及敏感資料的測試指令。
確認回應完成後，再切換回規則模式。

什麼時候需要開啟 TUN 模式？

如果 Claude Code 不讀取系統代理，或你需要讓所有終端機、Git、套件管理器和開發工具的連線都被 Clash 接管，可以開啟 TUN 模式。TUN 會建立虛擬網路介面，把更多系統流量交給 Mihomo 處理，對命令列工具通常比單純的 HTTP 系統代理更完整。

啟用 TUN 後，Windows 可能需要系統管理員權限，Linux 可能需要相應的網路權限，macOS 則可能跳出允許網路擴充功能的提示。若開啟後無法上網，先檢查系統是否同時啟用了其他 VPN、虛擬網卡或安全軟體，避免多個網路攔截工具互相衝突。

不要長期使用全域模式

全域模式會讓本地服務、公司內網、套件鏡像和國內網站也經過代理。完成測試後，建議回到規則模式，降低不必要的延遲與流量消耗。

4為 Claude Code 建立分流規則

規則模式的核心是讓目標服務走穩定代理，而本地開發環境保持直連。Claude Code 使用的實際域名可能因帳號、服務版本和登入流程而不同，因此規則應以官方文件、連線日誌和你實際遇到的請求為準，不要盲目加入大量未知域名。

常見域名規則寫法

以下範例展示規則的排列方式。請把 CLAUDE 替換成你配置中實際存在的代理策略組名稱，例如 Claude-AI 或 PROXY。規則必須放在較寬泛的兜底規則之前，否則可能還沒匹配到目標域名就被 GEOIP 或 MATCH 接走。

rules:
  - DOMAIN-SUFFIX,anthropic.com,CLAUDE
  - DOMAIN-SUFFIX,claude.ai,CLAUDE
  - DOMAIN-SUFFIX,claude.com,CLAUDE
  - DOMAIN-SUFFIX,intercom.io,CLAUDE
  - DOMAIN,api.anthropic.com,CLAUDE
  - DOMAIN,console.anthropic.com,CLAUDE
  - DOMAIN-SUFFIX,github.com,DIRECT
  - DOMAIN-SUFFIX,githubusercontent.com,DIRECT
  - DOMAIN-SUFFIX,npmjs.org,DIRECT
  - DOMAIN-SUFFIX,pypi.org,DIRECT
  - MATCH,DIRECT

上面的域名只是配置思路示例，並不代表每個帳號或每個版本都必須使用全部項目。若你使用的是 API，而不是互動式 Claude Code 登入流程，通常應優先確認 API 端點、驗證端點和套件下載站是否可正常連線。

本地專案與開發服務保持直連

Claude Code 可能需要操作本地檔案、啟動測試伺服器或連接 Docker、資料庫。建議將本機地址放在代理規則前面，避免請求繞到遠端節點：

rules:
  - DOMAIN,localhost,DIRECT
  - DOMAIN,local,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve

規則順序很重要

Clash 通常按照由上到下的順序匹配規則。把特定域名放在前面、區域網路放在前面、最後才使用兜底規則，是最容易檢查和維護的寫法。

5DNS、終端機與環境變數設定

DNS 是 Claude Code 連線穩定度中經常被忽略的一環。若域名解析走本地 DNS，而實際 HTTPS 連線走代理，可能出現解析結果不一致、連線逾時或地區判斷異常。使用 TUN 模式時，建議在 Clash Verge 的 DNS 設定中啟用由 Mihomo 接管 DNS 的選項，並避免同時開啟多個互相衝突的加密 DNS 或 VPN DNS。

如果你只使用系統代理而沒有開 TUN，可以檢查終端機是否讀取 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY。不同命令列工具的支援方式不完全相同，因此不建議一開始就把代理變數永久寫入全域 Shell 設定檔。

# 僅作為臨時測試，端口請以 Clash Verge 顯示為準
export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897

# 測試完成後取消目前工作階段的代理變數
unset HTTP_PROXY
unset HTTPS_PROXY

Windows PowerShell 的寫法不同，可以使用：

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

# 清除目前工作階段
Remove-Item Env:HTTP_PROXY
Remove-Item Env:HTTPS_PROXY

請留意 HTTP 代理端口和 SOCKS 端口並不一定相同。若把 SOCKS 端口當成 HTTP 端口使用，可能導致部分工具完全無法連線。最終應以 Clash Verge「設定」頁面顯示的端口為準，不要直接套用網路文章中的固定數字。

6常見問題與排查方法

完成配置後，如果 Claude Code 仍然不穩定，建議一次只改一個變數。先記錄目前使用的節點、模式、DNS 和錯誤訊息，再依序排查，這樣比較容易找出真正原因。

現象	可能原因	處理方法
登入頁面打不開	節點不可用、規則未匹配或 DNS 解析失敗	先用全域模式測試，再檢查 Clash 連線日誌
能登入但回應中斷	節點負載過高、長連線不穩或頻繁切換 IP	改用固定地區、低負載節點，避免自動切換
Git 或 npm 下載失敗	終端機沒有使用代理，或相關域名被錯誤直連	檢查 TUN、環境變數與代理日誌
本地網站無法開啟	全域代理或 TUN 規則攔截了 localhost	加入本地地址直連規則，並關閉其他 VPN

使用連線日誌定位問題

在 Clash Verge 的「連線」或「日誌」頁面中，執行一次 Claude Code 操作，觀察請求使用了哪個域名、命中了哪條規則，以及最後選擇了哪個策略組。如果相關請求顯示為 DIRECT，但你希望它走代理，就需要補充更精確的域名規則；如果請求已經走代理卻仍逾時，問題通常轉向節點品質、DNS 或服務端限制。

穩定使用建議

固定一個主要節點和一個備用節點，平時使用規則模式，只有排查問題時才暫時切換全域模式。訂閱更新後重新檢查策略組名稱，避免自動更新讓既有規則指向不存在的名稱。

FAQ：Claude Code 與 Clash Verge 常見問答

一定要開啟 TUN 模式嗎？

不一定。如果 Claude Code 能正常讀取系統代理，規則模式配合 HTTP 或 SOCKS 代理就可能足夠。當命令列工具不遵循系統代理、DNS 行為異常，或你需要接管更多系統流量時，再啟用 TUN 模式會比較合適。

應該使用自動選擇節點嗎？

測試時不建議使用頻繁切換的自動策略。Claude Code 可能維持長連線，節點在工作途中更換會造成回應中斷或重新驗證。建議先測試幾個節點，選定延遲和穩定度較好的固定節點，再把另一個節點設為手動備援。

加入很多 Claude 相關域名就一定更穩嗎？

不一定。過多未知規則會讓配置難以維護，也可能把不該代理的服務一併導向節點。優先使用連線日誌確認實際域名，採用必要的 DOMAIN-SUFFIX 或 DOMAIN 規則，並定期清理重複項目。

設定代理後仍顯示驗證或 API 錯誤，怎麼辦？

先區分網路錯誤和帳號錯誤。若是 timeout、connection reset，可排查節點、DNS 和代理模式；若是權限不足、金鑰無效或配額耗盡，則需要到對應的帳號或 API 管理頁面處理，單靠 Clash 無法解決。

Claude Code 配合 Clash Verge 如何穩定使用？設定教學