Claude Code 在台灣如何連線?用 Clash 設定終端機代理

先確認 Claude Code 的連線路徑

Claude Code 在終端機中執行,不能假設它會自動沿用瀏覽器的代理設定。瀏覽器可能讀取作業系統系統代理、使用擴充功能,或透過自己的網路設定連線;命令列程式則可能直接連網,或只接受目前 Shell 工作階段中的代理環境變數。因此,即使瀏覽器能開啟 Claude 網頁,也不代表 Claude Code 的登入與 API 請求已經經過 Clash。

在台灣使用時,先確認 Anthropic 服務及 Claude Code 在所在地與帳戶類型下的可用性,並遵守服務條款與組織政策。若服務本身不可用、帳戶權限不足或驗證流程未完成,調整代理不會解決問題。若服務可用,再檢查終端機是否能連到 Clash 的本機代理連接埠,以及 Claude Code 的連線是否命中預期規則。

建議先關閉其他 VPN、代理擴充功能與重複執行的 Clash 用戶端,再用全新開啟的終端機進行測試。開啟 Clash Verge、Clash Verge Rev 或其他 Mihomo 圖形用戶端的連線紀錄,重新執行一次 Claude Code 登入或一般請求,觀察是否出現相關連線、命中的規則與策略組。如果瀏覽器流量有記錄,但測試期間終端機沒有新增連線,問題多半在終端機的代理設定或流量接管方式,而不是先前選擇的節點。

確認 Clash 的代理連接埠正在監聽

終端機通常需要連線至 Clash 的 HTTP、SOCKS 或 mixed-port。常見範例是 7890,但這不是固定值:用戶端設定、訂閱覆寫或其他本機程式都可能改變連接埠。請在用戶端的設定頁或目前生效的設定中確認實際數值,並確認核心已啟動。若核心沒有啟動,即使 YAML 中寫著 mixed-port: 7890,該連接埠也不一定可用。

mixed-port: 7890
allow-lan: false
mode: rule

接著可在 macOS 或 Linux 查看監聽狀態;Windows 可用 PowerShell 查詢。請將範例中的連接埠換成用戶端顯示的實際數值:

# macOS / Linux
lsof -nP -iTCP:7890 -sTCP:LISTEN

# Windows PowerShell
Get-NetTCPConnection -LocalPort 7890 -State Listen

若沒有監聽結果,先檢查核心執行狀態、設定載入紀錄及連接埠占用情形,不必急著改 Claude Code 的設定。若連接埠正在監聽,可用 curl 明確指定代理測試到目標服務的連線:

curl -sv --connect-timeout 10 \
  -x http://127.0.0.1:7890 \
  https://api.anthropic.com/ \
  -o /dev/null

Windows PowerShell 請使用 curl.exe,避免它被 PowerShell 的命令別名取代。看到 HTTP 回應,通常表示本機代理與 HTTPS 握手至少已走到伺服器回應階段;回應狀態不等於 Claude Code 登入成功,也不能證明帳戶權限正常。若出現 connection refused,優先核對位址、連接埠與核心狀態;若逾時,查看 Clash 連線紀錄、策略組與節點狀態。

為終端機設定代理環境變數

明確指定代理的測試成功後,可在執行 Claude Code 的同一個 Shell 工作階段設定環境變數。多數代理工具的 HTTP CONNECT 方式會使用 http:// 代理位址處理 HTTPS 目標;https_proxy 變數名稱表示要代理 HTTPS 請求,不代表本機代理位址一定要寫成 https://。以下均以 HTTP mixed-port 7890 為例。

macOS 與 Linux

在 Bash 或 Zsh 中輸入下列命令,設定只對目前終端機及其啟動的子程序生效:

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

若用戶端提供 SOCKS 連接埠,也可改用 all_proxy,例如 export ALL_PROXY=socks5h://127.0.0.1:7891。socks5h 會讓網域解析交由代理端處理,適合用來區分本機 DNS 與代理出口問題;請先確認你的 Clash 連接埠確實提供 SOCKS5。不要同時留下指向不同連接埠的 HTTP 與 SOCKS 設定,否則不同程式可能採用不同變數而呈現不一致結果。

Windows PowerShell

PowerShell 可設定目前程序範圍的環境變數,再由同一個視窗啟動 Claude Code:

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

在 CMD 中則可使用 set HTTP_PROXY=http://127.0.0.1:7890 與 set HTTPS_PROXY=http://127.0.0.1:7890。若變更環境變數後仍使用已開啟的終端機、IDE 整合終端機或背景工作程序,該程序可能保留舊環境。請關閉並重新開啟終端機或 IDE,再測試一次。

完成後可用 echo $HTTPS_PROXY(macOS、Linux)或 $Env:HTTPS_PROXY(PowerShell)確認變數值。若需要取消目前 Shell 的設定,macOS 或 Linux 可執行 unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy;PowerShell 可執行 Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY。若變數值正確但連線仍不通,檢查環境中的 NO_PROXY 或 no_proxy 是否意外把相關網域排除在代理之外。

系統代理與 TUN 模式如何選擇

系統代理只會影響會讀取作業系統代理設定的應用程式。某些命令列工具不會自動採用它,因此對 Claude Code 這類終端機工作流程,設定環境變數通常是最直接的起點。若已設定環境變數,仍應以 Clash 連線紀錄確認請求有沒有進入核心,而不要只看桌面上的「系統代理」開關。

TUN 模式則透過虛擬網路介面接管較廣泛的 IP 流量,適用於不讀取系統代理、也沒有提供代理設定的程式。啟用 TUN 通常需要系統權限,並可能影響 DNS、路由表、其他 VPN 或安全軟體。若終端機環境變數已能穩定連線,沒有必要只為 Claude Code 額外開啟 TUN。若確實需要測試,應先停止其他 VPN,再確認用戶端的 TUN 狀態與系統權限,並重新查看實際連線紀錄。

方式 適用情境 檢查重點
終端機環境變數 只需讓 Claude Code 或目前 Shell 中的工具使用代理 代理位址、連接埠、Shell 變數及啟動程序
系統代理 會讀取作業系統代理設定的桌面應用程式 系統代理是否啟用,以及應用程式是否採用該設定
TUN 模式 需要接管不支援代理設定的流量 權限、路由、DNS、其他 VPN 與連線記錄

若環境變數和 TUN 同時啟用,流量可能依應用程式實作與核心設定走不同路徑。為了降低誤判,先用環境變數完成單一路徑測試;只有在已確認程式不使用代理變數時,再評估 TUN。

檢查分流規則、DNS 與節點狀態

請在 Clash 的連線頁面確認終端機請求命中了哪條規則、交給哪個策略組,以及最後選用哪個節點。若請求被 DIRECT 處理,檢查規則順序、策略組選擇與目前執行模式。Clash 規則通常由上而下比對,較早命中的規則會先決定處理方式;將自訂規則放在最終兜底規則之後,通常不會生效。需要調整時,優先使用用戶端支援的覆寫機制,避免直接修改之後會被訂閱更新覆蓋的內容。

節點延遲測試成功,只能表示測試目標在測試時可達,不能保證 Claude Code 使用的所有連線都正常。部分請求可能連到不同服務網域,登入流程也可能涉及瀏覽器跳轉、帳戶驗證或組織政策。不要只憑網路文章加入寬泛的網域規則;應以 Clash 連線紀錄與服務端實際錯誤為依據,確認哪些連線需要採取相同策略。

DNS 問題常表現為網域無法解析、連線逾時,或節點伺服器網域無法建立連線。先確認目前 DNS 模式、上游伺服器與用戶端是否啟用 DNS 接管;接著比較一般網域解析與經代理的測試結果。若使用 TUN,確認虛擬介面與 DNS 接管狀態一致;若只使用終端機代理,使用 socks5h 測試可減少本機先行解析造成的干擾。不要以關閉 TLS 憑證驗證作為排錯手段,這會降低連線安全性,也無法修復錯誤的代理規則。

依錯誤訊息定位問題並恢復設定

登入頁面無法開啟與登入後請求失敗,可能是不同環節出問題。若終端機明確回報無法連線到 127.0.0.1,先核對 Clash 是否運作及連接埠是否一致;若已連入代理但長時間逾時,檢查策略組、節點、DNS 與規則命中;若代理測試收到服務端回應但 Claude Code 仍拒絕登入,則應另外確認帳戶狀態、所在地服務可用性、組織登入方式及 CLI 版本。HTTP 狀態碼本身不是完整診斷結果,應結合發生時間、請求是否進入 Clash 及程式顯示的錯誤內容判斷。

建議依序執行以下檢查,並在每一步後重新測試:

  1. 確認服務與帳戶:檢查服務在所在地是否可用,以及帳戶登入方式是否正確。
  2. 確認 Clash 核心:確認核心正在執行、目前設定成功載入,並記下實際代理連接埠。
  3. 測試本機代理:使用 curl 明確指定 HTTP 或 SOCKS 代理,確認請求能到達服務端。
  4. 設定同一 Shell 的變數:確保 Claude Code 是從設定好代理變數的終端機啟動。
  5. 檢查分流與 DNS:在連線記錄中核對規則、策略組、節點與解析狀態。
  6. 逐項撤回測試設定:排查完成後移除暫時變數、恢復不需要的 TUN 或 VPN,保留最小且可重現的設定。

如果設定了自訂 ANTHROPIC_BASE_URL 或其他服務端點,確認它是否為組織或服務管理者提供的正式設定;不確定時可先查看目前 Shell 是否存在該變數,避免它將請求導向非預期位置。不要為了讓登入成功而隨意更換 API 端點、停用 TLS 驗證或將所有流量永久設為全域代理。保留可回復的變更紀錄,通常比一次大幅改動更容易維護,也能在網路環境或訂閱設定變更後快速找回正常連線。

下載Clash