在台港使用 Claude Code 時,終端機能否連上服務,通常不只取決於 Clash 是否已啟動,還要確認目前使用的帳號與所在地區符合服務政策、終端機流量確實經過代理,以及登入程序所需的瀏覽器連線是否正常。本文以 Clash Verge、Clash Verge Rev 與 Mihomo 常見設定為例,整理從匯入訂閱、設定終端機代理,到檢查分流與排查登入問題的做法。請先確認 Claude Code 在你的帳號、地區及網路環境中可用;代理設定不會改變服務的資格或使用政策。

先確認 Clash 與節點狀態

開始設定前,先把問題範圍縮小。若節點本身無法連線,或 Clash 核心沒有正常執行,後續修改終端機環境變數也不會改善結果。開啟 Clash Verge 或 Clash Verge Rev,確認訂閱已更新、代理組中有可用節點,並選取一個目前連線穩定的節點。若使用 Mihomo 核心,也可在控制面板查看節點延遲與活動連線。

接著確認代理監聽連接埠。多數配置會使用 7890,但實際值可能因設定檔、客戶端或手動修改而不同。到客戶端設定頁面查看「混合連接埠」(Mixed Port)或 HTTP 代理連接埠;若沒有混合連接埠,則查看 HTTP 代理連接埠。以下示例以本機的 127.0.0.1:7890 為例,請依照自己的設定替換,不要直接假設每台電腦都使用相同連接埠。

先用混合連接埠較簡單:Clash 的 Mixed Port 通常同時接受 HTTP 與 SOCKS 代理連線。將終端機的 HTTP_PROXY 和 HTTPS_PROXY 指向本機混合連接埠,通常比逐一確認不同協定的連接埠更容易排查。

如果需要檢查或調整核心設定,示例如下。這類欄位通常由客戶端產生或由訂閱設定管理;不要為了套用範例而覆寫整份訂閱設定。若使用覆寫設定,先確認客戶端支援相應欄位,再保留原有節點、策略組與規則。

Mihomo 本機代理連接埠示例
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule

這裡的 allow-lan: false 與 bind-address: 127.0.0.1 是以只供本機使用為例,可避免區域網路中的其他裝置連到你的代理連接埠。若你有跨裝置使用需求,請先了解防火牆、認證與區域網路暴露風險,不要在沒有保護的情況下把代理服務公開到區域網路或網際網路。

設定終端機代理環境變數

桌面瀏覽器能透過 Clash 上網,不代表命令列程式也會自動使用代理。終端機中的程式通常會讀取 HTTP_PROXY、HTTPS_PROXY 等環境變數;未設定時,Claude Code 可能直接連線,或因目前網路路徑無法到達服務而出現逾時、登入失敗等情況。建議先在目前的終端機工作階段設定代理,確認有效後再考慮加入個人 Shell 設定檔。

macOS 與 Linux 若使用 zsh 或 bash,可在終端機執行以下命令。範例採用 HTTP 代理格式,並把本機的 Clash 連接埠設為 7890:

macOS/Linux 暫時設定代理
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5h://127.0.0.1:7890"

# 檢查目前設定
env | grep -i proxy

HTTPS_PROXY 變數名稱表示要為 HTTPS 網址使用代理,變數值仍可以是指向本機 HTTP 代理的 http:// URL,兩者並不矛盾。若你的 Mixed Port 不接受 SOCKS5,或設定後命令列工具出現協定錯誤,可以先移除 ALL_PROXY,只保留 HTTP_PROXY 與 HTTPS_PROXY 測試。不同程式對代理變數的支援程度不完全相同,優先採用簡單設定,避免同時指定多組互相衝突的代理。

Windows PowerShell 可在啟動 Claude Code 的同一個視窗設定環境變數。以下設定只影響目前 PowerShell 工作階段;關閉視窗後通常不會保留:

Windows PowerShell 暫時設定代理
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "socks5h://127.0.0.1:7890"

# 檢查目前設定
Get-ChildItem Env:*proxy*

設定持久化時,macOS 或 Linux 使用者可把經確認有效的 export 命令加入 ~/.zshrc 或 ~/.bashrc,再開啟新終端機或載入設定檔。Windows 使用者可以在 PowerShell 個人設定檔中加入環境變數,但若只在特定工作需要代理,保留為暫時設定通常更容易管理,也較不會讓其他命令列程式意外走代理。無論採用哪種方式,都要確保 Claude Code 是從已設定變數的同一個終端機啟動。

不要把代理設定寫進專案:包含本機連接埠、登入憑證或金鑰的設定不應提交到 Git,也不要在公開日誌或截圖中貼出 Token。環境變數只負責指定連線路徑,不應拿來存放可公開分享的機密資料。

測試連線並啟動 Claude Code

在執行 Claude Code 前,先確認終端機能連到 Clash 的本機代理。可用 curl 請求一個 HTTPS 網址;若命令能收到 HTTP 回應,至少表示此終端機能透過目前設定的代理發出請求。這項測試只能確認基本連線,不代表帳號已獲准使用 Claude Code,也不代表所有服務端點、登入流程或功能都一定正常。

使用 curl 測試代理
curl -I https://claude.ai

如果命令顯示無法連線到 127.0.0.1 或連接埠被拒絕,先回到 Clash 確認核心正在執行、連接埠一致,而且沒有其他程式占用該連接埠。如果請求逾時,檢查目前節點狀態、Clash 連線紀錄與分流模式;若回應出現服務端錯誤或存取受限訊息,則不要直接將問題歸因於代理變數,還需確認帳號狀態、服務可用地區與服務政策。

基本測試通過後,從同一個終端機啟動 Claude Code,並依照官方流程完成登入。終端機中的代理變數主要影響 CLI 程式本身;登入時如果需要開啟瀏覽器,瀏覽器是否經過 Clash 取決於瀏覽器自己的代理設定、作業系統設定或 TUN 模式。若瀏覽器頁面無法載入,先用瀏覽器正常開啟服務頁面確認網路,再檢查登入回呼是否完成。不要把不同應用程式的代理狀態混為一談。

如果在 Shell 設定檔中加入代理後,想暫時恢復直連,可在 macOS 或 Linux 執行下列命令:

macOS/Linux 清除目前工作階段代理
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY
unset http_proxy https_proxy all_proxy

PowerShell 則可使用下列命令清除目前視窗中的設定。若代理仍然生效,檢查是否有 Shell 設定檔、IDE 整合終端機或其他啟動腳本再次寫入環境變數:

PowerShell 清除目前工作階段代理
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:ALL_PROXY -ErrorAction SilentlyContinue

用 Clash 規則檢查實際流量

環境變數設定正確,只能說明程式知道要連到本機代理;流量最後使用哪個節點,仍由 Clash 的模式、規則與策略組決定。使用規則模式時,相關網域可能命中不同規則;使用全域模式時,通常會統一交由所選代理策略處理,但也會讓其他應用程式的連線一併改變。初次排查可先使用自己熟悉的模式,避免同時更改多項規則,否則難以判斷是哪一項設定造成差異。

觀察結果可能原因建議檢查
終端機連不到本機代理核心未啟動、連接埠不符,或代理監聽地址設定不同比對 Clash 的 Mixed Port 與環境變數中的連接埠
curl 有回應,但 Claude Code 仍失敗程式環境未繼承變數、服務端點受規則影響,或登入狀態有問題在同一終端機檢查變數,並查看 Clash 活動連線與程式錯誤訊息
瀏覽器能登入,CLI 無法連線瀏覽器與終端機使用不同代理路徑,或 CLI 沒有讀取代理變數從已設定代理的終端機重新啟動 CLI,並分別測試瀏覽器與終端機
連線成功但帳號無法使用服務帳號資格、地區政策、付款或服務端限制查閱服務官方說明與帳號狀態,不以調整代理推定可用性

在 Clash Verge 的連線頁面中,可以在啟動 Claude Code 後觀察是否出現相關連線,並查看命中的規則與策略組。Mihomo Dashboard 也能提供類似資訊。若看不到預期連線,先確認 CLI 啟動時環境變數仍存在;若連線出現但走了不預期的策略,才進一步檢查規則順序、規則集與策略組選擇。不要只依照單一錯誤訊息反覆更換節點,先判斷問題發生在「終端機到 Clash」、「Clash 到節點」還是「帳號與服務端」這一段。

若採用 TUN 模式,Clash 可以在系統層攔截更多應用程式流量,但不同作業系統、權限與客戶端版本的行為可能不同。TUN 不等於每個終端機程式都會呈現相同的代理狀態,也不保證登入瀏覽器與 CLI 共用同一條路徑。排查時可以先明確設定環境變數,再用 Clash 連線記錄核對;確認穩定後,才決定是否需要調整 TUN 或規則配置。

完成設定後,建議保留一套容易還原的流程:啟動 Clash、確認節點、在需要的終端機設定代理、用 curl 做基本測試,再啟動 Claude Code。若服務仍無法使用,依序核對連接埠、環境變數、分流記錄與帳號資格,而不是把所有問題都視為節點故障。這樣既能讓終端機連線設定更清晰,也能避免不必要地改動整份 Clash 訂閱或系統網路設定。