Claude Code 為開發者提供方便的終端機編程體驗，但登入、套件下載與模型回覆都依賴穩定的網路連線。在內地使用時，即使 Clash Verge 已經啟動，Claude Code 仍可能因為終端機沒有繼承代理、系統代理與命令列代理不一致，或 DNS 與節點連線異常而無法正常工作。本文以 Clash Verge 為例，從安裝、訂閱匯入、節點選擇，到終端機環境變數與常見錯誤排查，逐步完成 Claude Code 的基本連線設定。文中使用的連接埠與節點名稱僅為示例，實際數值應以你的 Clash Verge 介面顯示為準。

準備工作與安裝 Clash Verge

開始之前，請先確認電腦系統、Claude Code 的安裝方式，以及代理工具三者相互獨立。Clash Verge 負責建立本機代理服務，Claude Code 則是透過終端機發起網路請求，兩者之間通常不是「安裝完成後自動連通」，而是需要透過系統代理或環境變數明確指定。

  • Clash Verge 或 Clash Verge Rev：負責載入配置、管理節點，並在本機監聽 HTTP、SOCKS 或 Mixed 代理連接埠。
  • Claude Code：在終端機中運行，可能需要連線至登入服務、模型服務及相關 API。
  • 終端機代理設定：決定 curl、Node.js、Python、npm 以及 Claude Code 發出的請求是否經過 Clash。

請從可信任的專案頁面取得 Clash Verge 安裝檔，依照 Windows、macOS 或 Linux 的系統版本選擇對應套件。安裝後首次啟動，若系統詢問是否允許網路存取或建立代理服務，應根據你的使用需求允許。若使用 Windows，建議以一般使用者權限啟動即可，只有在需要 TUN 模式或修改系統網路設定時，才按照提示授予額外權限。

進入 Clash Verge 後，先不要急著測試 Claude Code。請在設定頁確認目前使用的核心類型、Mixed Port 或 HTTP Port，以及模式是否為 Rule。對大多數日常使用者而言，Rule 模式比 Global 模式更容易兼顧國內網站的直連速度與特定服務的代理需求；若只是短時間排查連線問題，可以暫時切換到 Global 模式進行對比，但不建議長期讓所有本地流量都經過代理。

先確認服務合規性：不同地區對網路服務、跨境連線及第三方 AI 服務的使用要求可能不同。請確認你的帳戶、網路環境與使用方式符合所在地法律、學校或公司政策，並妥善保護 API 金鑰、登入憑證和訂閱連結。

匯入訂閱與選擇可用節點

Clash Verge 本身不提供代理節點，通常需要使用你已經取得的訂閱連結或本地 YAML 配置。開啟「訂閱」或「Profiles」頁面，新增訂閱 URL，為配置設定容易辨識的名稱，然後執行更新。若訂閱連結需要登入或帶有特殊參數，請完整貼上，不要自行刪除問號後面的內容。

  1. 開啟 Clash Verge 的 Profiles 頁面，貼上訂閱連結。
  2. 執行更新，等待配置下載並完成解析。
  3. 將新配置設為目前啟用的配置。
  4. 進入 Proxies 頁面，在主要策略組中選擇一個延遲較低且狀態正常的節點。
  5. 使用內建測速或實際發送 HTTPS 請求，確認節點不只是「延遲可測」，而是能穩定完成 TLS 連線。

節點選擇不應只看面板中的毫秒數。延遲測試通常只代表節點能否快速回應某個測速網址，並不能完整反映 Claude Code 的登入、長連線、串流回覆或大段文字傳輸品質。建議至少比較兩到三個節點，觀察是否能連續完成多次請求，並留意連線中途重置、回覆停頓及頻繁切換等情況。

設定項目建議做法排查重點
代理模式先使用 Rule，必要時短暫切換 GlobalGlobal 可用而 Rule 不可用，通常是規則匹配問題
節點策略組選擇穩定、延遲合理的節點不要只依賴一次測速結果
本機連接埠優先使用 Mixed Port確認連接埠沒有被其他程式佔用
DNS使用 Clash 內建 DNS 或可靠的系統 DNS檢查域名解析錯誤與污染結果
配置更新先更新訂閱，再重新載入配置確認節點與策略組確實出現在當前配置中

如果 Clash Verge 顯示節點可用，但 Claude Code 仍無法連線，請先在瀏覽器或命令列測試同一代理。不要同時修改節點、模式、DNS 和終端機變數，否則很難判斷是哪一層發生問題。最有效率的順序是：先確認 Clash 本身能代理，再確認終端機能代理，最後才檢查 Claude Code 或登入帳戶。

設定終端機的 HTTP 與 SOCKS5 代理

Clash Verge 的系統代理開關，主要影響支援系統代理的瀏覽器和應用程式；終端機工具未必會自動讀取這項設定。因此，建議在終端機中明確設定 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY。若使用 Mixed Port，通常可以用 HTTP 代理格式連線；若要使用 SOCKS5，則填入 Clash Verge 顯示的 SOCKS Port。

Windows PowerShell 臨時設定
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:ALL_PROXY = "socks5://127.0.0.1:7897"

# 檢查目前工作階段的代理變數
Get-ChildItem Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:ALL_PROXY

上面的設定只對目前 PowerShell 視窗有效，關閉視窗後就會失效。這種方式適合先測試連線，不會把代理設定永久寫入系統。若你使用的是 Windows 命令提示字元，可改用 set 指令；若使用 Git Bash，語法則與 Linux 和 macOS 的 Shell 類似。

macOS、Linux 或 Git Bash 臨時設定
export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"
export ALL_PROXY="socks5://127.0.0.1:7897"

# 確認變數是否已生效
env | grep -i proxy

如果你的 Clash Verge 使用的不是 7897，請將所有範例中的連接埠替換成介面顯示的實際數值。常見的錯誤是把 HTTP Port、SOCKS Port 和 Mixed Port 混用，或是在 HTTPS_PROXY 中寫成不存在的連接埠。若不確定代理類型，先使用 Mixed Port 配合 http://127.0.0.1:連接埠 測試，通常最容易成功。

驗證終端機是否真的經過代理

設定環境變數後，先不要直接啟動 Claude Code。可以用 curl 發送一個 HTTPS 請求，並同時觀察 Clash Verge 的 Connections 頁面是否出現對應連線。若 Connections 沒有任何新記錄，代表終端機沒有使用這組代理，或請求根本尚未發出。

使用 curl 測試代理
curl -I --max-time 15 https://example.com

# 明確指定 HTTP 代理測試
curl -I --proxy http://127.0.0.1:7897 --max-time 15 https://example.com

測試結果可以從三個方向判斷：第一，命令是否在合理時間內返回；第二，Clash Verge 是否記錄了這次請求；第三，終端機是否出現「connection refused」「timeout」或 TLS 錯誤。如果指定代理的命令可以成功，而設定環境變數後失敗，問題多半在變數名稱、Shell 語法或程式是否支援該變數。

啟動 Claude Code 與常見錯誤排查

完成代理驗證後，在同一個終端機視窗啟動 Claude Code，讓它繼承剛才設定的環境變數。若 Claude Code 已經安裝完成，可以直接輸入對應的啟動命令；若尚未安裝，請依照官方文件使用適合你系統的安裝方法。安裝工具本身可能需要存取套件倉庫，因此也應在代理設定生效後執行。

首次啟動通常會涉及登入或授權流程。瀏覽器登入成功不代表終端機一定可用，因為瀏覽器可能使用系統代理，而終端機則沒有。若畫面長時間停在登入、授權碼交換或模型請求階段，請先查看 Clash Verge 的連線記錄，確認請求是否有命中節點，以及是否出現 DNS 失敗、TLS 握手失敗或遠端主動關閉連線。

錯誤現象可能原因處理方法
Connection refused本機連接埠錯誤，或 Clash Verge 沒有啟動確認 Clash 正在運行，重新檢查 Mixed Port 與 SOCKS Port
Timeout節點不可用、路由不穩定或請求未經代理更換節點，並在 Connections 中確認實際路由
TLS handshake failed系統時間錯誤、節點 TLS 異常或中間網路干擾同步系統時間，測試其他節點，不要直接關閉證書驗證
登入頁面可開但命令列失敗瀏覽器使用系統代理，終端機沒有代理變數重新設定 Shell 環境變數，再用 curl 驗證
模型回覆中斷節點丟包、長連線不穩或策略組自動切換暫時固定穩定節點，避免測試期間頻繁自動切換

若使用 npm、Git 或其他工具下載依賴，還要留意它們各自的代理設定。例如某些 Node.js 工具會讀取 HTTP_PROXY 和 HTTPS_PROXY，但部分套件管理器可能有獨立配置。不要把代理 URL、帳戶密碼或訂閱連結直接提交到 Git 儲存庫，也不要在公開截圖中展示包含授權資訊的命令列內容。

推薦排查順序：先確認 Clash Verge 已啟動並能看到節點，再確認瀏覽器或 curl 可經過代理，接著確認終端機環境變數，最後才處理 Claude Code 的登入與模型請求。每次只改一個設定，通常比反覆切換多個選項更快定位問題。

如果你不希望每個終端機程式都使用代理，可以只在啟動 Claude Code 前設定環境變數，完成工作後清除它們。PowerShell 可使用 Remove-Item Env:HTTP_PROXY 等指令，macOS、Linux 或 Git Bash 則可使用 unset HTTP_PROXY HTTPS_PROXY ALL_PROXY。這樣能避免其他不需要代理的命令列工具意外走代理，也方便在不同專案之間切換網路環境。

Clash Verge 的核心作用是提供可靠、可觀察的本機代理入口，而 Claude Code 能否穩定使用，取決於節點品質、終端機代理變數、DNS、TLS 與長連線穩定性。按照「先測 Clash、再測終端機、最後測 Claude Code」的流程設定，即使遇到登入失敗或回覆中斷，也能快速找到問題所在。完成配置後，建議固定一個穩定節點進行日常開發，並定期更新訂閱與檢查連線記錄，讓開發流程保持可預期。

立即開始

用 Clash 掌控您的流量

支援 Windows、macOS、Linux、Android 與 iOS，靈活規則，開箱即用。

免費下載 查看設定指南 →