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 及程式顯示的錯誤內容判斷。
建議依序執行以下檢查,並在每一步後重新測試:
- 確認服務與帳戶:檢查服務在所在地是否可用,以及帳戶登入方式是否正確。
- 確認 Clash 核心:確認核心正在執行、目前設定成功載入,並記下實際代理連接埠。
- 測試本機代理:使用 curl 明確指定 HTTP 或 SOCKS 代理,確認請求能到達服務端。
- 設定同一 Shell 的變數:確保 Claude Code 是從設定好代理變數的終端機啟動。
- 檢查分流與 DNS:在連線記錄中核對規則、策略組、節點與解析狀態。
- 逐項撤回測試設定:排查完成後移除暫時變數、恢復不需要的 TUN 或 VPN,保留最小且可重現的設定。
如果設定了自訂 ANTHROPIC_BASE_URL 或其他服務端點,確認它是否為組織或服務管理者提供的正式設定;不確定時可先查看目前 Shell 是否存在該變數,避免它將請求導向非預期位置。不要為了讓登入成功而隨意更換 API 端點、停用 TLS 驗證或將所有流量永久設為全域代理。保留可回復的變更紀錄,通常比一次大幅改動更容易維護,也能在網路環境或訂閱設定變更後快速找回正常連線。