一、先釐清連線路徑:Claude Code 不一定跟著瀏覽器走
如果瀏覽器可以開啟 Claude 網頁版,卻在終端機登入失敗、卡在載入,或執行任務時出現逾時,兩者並不矛盾。瀏覽器可能使用作業系統代理或瀏覽器擴充功能;Claude Code 則是由終端機啟動的命令列程式,是否經過代理,取決於它讀取的環境變數、啟動方式,以及目前的 Clash 規則。簡單說,桌面程式顯示代理已啟用,不代表每一個終端機行程都會自動使用它。
排查時先分清楚問題出現在哪一步:安裝或更新失敗、瀏覽器授權頁無法開啟、登入後無法交換憑證,還是已經開始對話才發生連線中斷。不同階段可能涉及不同的目的主機與網路請求。先記下錯誤訊息、發生時間、使用的網路,以及當時選取的 Clash 節點;與其一開始就更換多項設定,這些線索更有助於縮小範圍。
本文聚焦於自有裝置上的終端機代理與連線診斷。使用服務前,請確認所在地規範、組織網路政策及 Anthropic 的服務條款;代理只能改變連線的路徑,不能取代帳號資格、服務可用性或企業授權要求。
二、先看錯誤類型:認證失敗不等於代理故障
出現「無法連線」、「逾時」或連線重置時,代理路徑確實值得檢查;但若錯誤明確提到帳號、授權、用量或 API 金鑰,單純換節點通常無法解決。應先辨認錯誤是由本機網路、遠端服務,還是帳戶設定回傳,再決定是否調整 Clash。
- 名稱解析失敗:錯誤包含無法解析主機或類似 DNS 錯誤時,檢查目前網路的 DNS 設定、Clash 的 DNS 模式與相關規則,不要先把問題歸因於帳號。
- 連線逾時或重置:例如 ETIMEDOUT、ECONNRESET,可能與目標流量走直連、節點不穩、代理埠設定錯誤或網路中其他 VPN 衝突有關。
- 代理連線被拒絕:若訊息指出連不到 127.0.0.1 的代理埠,常見原因是 Clash 尚未啟動、混合埠號填錯,或該埠沒有開啟監聽。
- HTTP 401 或 403:代表請求已取得服務端回應,但可能是登入狀態、權限、服務可用性或政策問題。除非同時有網路錯誤證據,否則先檢查帳號與授權設定。
- 操作一段時間後才中斷:可能是節點丟包、長連線品質不佳、網路切換,或終端機行程繼承了過期的代理設定。記錄中斷時間並觀察 Clash 連線紀錄,比反覆重新登入更有效。
也要留意 Claude Code 的安裝、登入與模型請求未必發生在同一個步驟。若錯誤只出現在安裝或更新階段,請檢查安裝來源的連線;若授權頁能開啟但回到終端機後失敗,則要確認瀏覽器回呼流程和啟動終端機的行程環境。別因為其中一個步驟成功,就假設整條連線路徑都正常。
三、檢查 Clash:模式、節點與規則命中
先確認 Clash 客戶端正在執行,而且目前設定檔已成功載入。接著檢查代理模式:在「規則」模式下,Claude Code 對應的流量會依照規則決定走哪個策略;如果流量最後命中 DIRECT,即使代理節點本身正常,終端機也可能仍然直連。測試時可以暫時切換到便於觀察的策略或全域模式,確認路徑是否改變;測試結束後應恢復符合日常需求的設定,避免把全域代理當作不經檢查的永久解法。
在 Clash Verge、Clash Verge Rev 或其他相容客戶端中,開啟連線或請求紀錄,然後重新執行一次會重現問題的操作。觀察紀錄是否出現新連線、連線使用哪個策略群組,以及最終選到哪個節點。若沒有任何相關紀錄,應先懷疑終端機未使用該代理,或流量沒有進入目前這個 Clash 核心;若有紀錄但連線失敗,再檢查節點延遲、丟包和規則結果。
Claude Code 的實際網路請求可能隨版本、登入方式及功能而改變,因此不要只憑網路文章抄一份固定網域清單。以你自己的連線紀錄和官方文件核對目的主機,再建立範圍明確的規則。需要新增網域時,先以單一目的主機驗證;避免不加區分地把整個大型網域家族送到同一策略,造成無關流量也被改道。
若使用訂閱提供的規則或覆寫設定,確認新增規則的位置正確。多數規則引擎會依序比對,較早命中的規則可能讓後面的自訂項目永遠不生效。修改前先備份設定,完成後重新載入設定檔,並再次從連線紀錄確認命中結果;不要只以介面顯示「已切換」作為設定生效的證據。
四、讓終端機明確使用代理:確認埠號與環境變數
若你的 CLI 支援標準代理環境變數,可以在啟動 Claude Code 的同一個終端機工作階段中,設定 HTTP_PROXY、HTTPS_PROXY 和小寫形式。下列範例假設 Clash 在本機監聽 7897;不同客戶端、設定檔或作業系統的埠號可能不同,請先到客戶端設定確認實際值。若使用的是 SOCKS 埠,請勿直接把它當成 HTTP 代理埠填入。
# macOS / Linux: replace 7897 with the actual Clash HTTP or mixed port
export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
# Start Claude Code from this same terminal session
這些變數只會影響從該終端機啟動、並繼承此環境的行程;已經開啟的終端機視窗、背景服務或圖形介面程式不一定會同步更新。若在 zsh 或 bash 設定檔中加入變數,重新載入設定檔或開新視窗後再測試。暫時排查時,也可以只在單次命令前設定環境變數,確認問題是否與行程環境有關,再決定是否寫入長期設定。
Windows PowerShell 可在目前工作階段設定同名變數;同樣要依實際監聽埠調整。若 Claude Code 是由 IDE、工作排程器或其他啟動器執行,它未必會讀取你在另一個 PowerShell 視窗中設定的值。最直接的比較方式,是從已設定代理的終端機啟動一次,再從原本的啟動方式測試一次;若結果不同,差異多半在行程繼承的環境或代理設定。
# PowerShell: use the real Clash HTTP or mixed port
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:http_proxy = $env:HTTP_PROXY
$env:https_proxy = $env:HTTPS_PROXY
# Launch Claude Code from this PowerShell session
如果有內網服務需要直連,可以依照工具支援情況設定 NO_PROXY,但應只列出確實需要略過代理的本機或內網主機。過度寬泛的略過清單可能讓目標請求又回到直連;反過來,將內部服務送入外部代理也可能違反組織政策。團隊環境應先確認既有代理規範,不要自行覆蓋公司管理的設定。
五、逐層測試:先驗證埠,再驗證網路請求
一次只改一個條件,依序確認「Clash 是否監聽」、「終端機是否能連到本機代理」、「目標請求是否經代理送出」。在 macOS 或 Linux 上,可先用系統工具檢查環境變數,再使用 curl 明確指定代理;Windows 則可用 PowerShell 查看變數,並使用相同原則測試。若本機代理埠連不上,先回頭檢查 Clash 的監聽狀態與埠號,不必急著修改 Claude Code 設定。
# Confirm the configured proxy variables
env | grep -i proxy
# Test through the local proxy without sending account credentials
curl -v --proxy http://127.0.0.1:7897 https://api.anthropic.com/
上述請求的目的在於觀察連線能否建立、是否經過本機代理,以及 TLS 握手是否完成;沒有提供認證資料時,遠端服務可能回傳錯誤狀態碼,這本身不等於傳輸失敗。不要把 API 金鑰放進命令列參數、截圖或共享紀錄,也不要為了測試而把真實提示內容送到不可信的診斷服務。若要比較「明確指定代理」與「依環境變數使用代理」,可在不帶憑證的前提下分別執行,觀察連線結果是否一致。
測試時可對照 Clash 的連線紀錄和終端機輸出:若明確指定代理能連線,但 Claude Code 仍逾時,先確認它是否在同一個終端機環境中啟動,以及目前版本是否接受這些標準變數;也要檢查是否有其他程式或啟動器覆寫代理值。若請求已命中預期策略但仍斷線,則在同一網路下換一個已知健康的節點測試,並記錄差異,而不要同時切換節點、代理模式與 DNS。
若只有網域解析階段失敗,檢查 DNS 請求是否按預期處理,並留意系統 DNS、Clash DNS 與公司網路 DNS 之間是否存在衝突。若只有啟用 TUN 後出問題,先關閉 TUN 並恢復原本路由,確認是否與其他 VPN、虛擬網路介面或防火牆規則衝突。每次測試都記下變更和結果,才能把「感覺比較快」轉成可重現的判斷。
六、何時考慮 TUN:代理變數無效時再擴大範圍
TUN 模式能讓相容核心接手更多系統網路流量,對不讀標準代理變數的程式可能有幫助;但它也會影響更大範圍的連線,並可能與公司 VPN、零信任客戶端、虛擬機器網路或防火牆規則互相干擾。因此,建議先用本機 HTTP 或混合代理埠和環境變數測試;只有確認程式不採用這些設定,且你有權管理該裝置時,再考慮短時間測試 TUN。
啟用前先確認系統權限與客戶端提示,並準備好關閉 TUN、恢復原本網路路由的方式。不要在重要工作期間同時更改 TUN、節點和規則;若網路突然中斷,先停用最近一次變更,確認基礎連線恢復,再逐項重測。公司管理的裝置應先詢問 IT 或資安管理者,不要以新增系統路由的方式繞過組織設定。
若問題只在特定網路出現,例如公司網路可以開啟登入頁、家用網路卻無法完成連線,請將網路環境差異納入檢查。代理並不能修復所有中間設備限制,也不能保證每個長連線都穩定;同一節點在不同網路上的表現可能不同。將「使用代理與否、代理模式、節點、錯誤時間」記錄下來,通常比盲目提高重試次數更容易找出真正原因。
七、常見問題
瀏覽器能用 Claude,為什麼 Claude Code 仍然逾時?
瀏覽器與終端機程式可能使用不同的代理設定。瀏覽器擴充功能不一定會接管 CLI 流量;請確認終端機是否設定了正確的代理環境變數、變數中的埠號是否與 Clash 實際監聽值一致,並從連線紀錄核對 CLI 請求是否命中預期策略。
如何知道應該填哪個 Clash 代理埠?
查看目前客戶端設定中的 HTTP、SOCKS 或混合埠,不要假設所有安裝預設值都相同。環境變數範例使用的是 HTTP 或混合代理埠;SOCKS 埠的協定不同,必須依 CLI 支援情況設定正確的代理格式。
設定代理後仍出現 401 或 403,該怎麼辦?
這類狀態碼通常表示服務端已回應,不應只靠更換節點處理。確認登入狀態、授權方式、帳號可用性與組織政策;若同時出現 DNS、TLS 或連線逾時,再回頭檢查代理紀錄。不要在公開紀錄中分享金鑰或授權資料。
使用 Claude Code 一定要開啟 TUN 嗎?
不一定。若程式能使用標準代理環境變數,通常可先從本機代理埠開始測試。TUN 會影響更廣泛的系統流量,可能與其他 VPN 或企業網路軟體衝突,應在確認需求並準備還原方式後再使用。
有些只靠瀏覽器擴充功能的代理方案,無法一致地涵蓋終端機、IDE 子行程與背景工作;而過度簡化的全域代理雖然容易測試,卻不一定符合日常分流與企業政策需求。相較之下,Clash 可透過可觀察的規則、節點選擇與連線紀錄,逐步確認 Claude Code 的流量走向,也能依裝置支援程度選用終端機代理或 TUN。若你希望從同一套設定開始檢查不同平台的客戶端,可以前往下載頁選擇合適版本。