前言：先判斷問題出在哪一層
Claude Code 是在終端機中執行的程式開發工具，會透過網路連線完成登入、讀取模型資訊及提交請求。若瀏覽器可以正常開啟相關服務，但終端機卻出現登入失敗、請求逾時或連線中斷，問題未必在 Claude Code 本身；終端機可能沒有使用 Clash 的代理，或 Clash 的分流規則沒有把相關流量送到可用節點。
本指南會從 Clash 代理狀態、終端機代理環境變數、分流規則與連線測試逐步排查。以下以常見的 Clash Verge Rev 與 Mihomo 為例；不同版本的選單名稱可能略有差異，請以你目前客戶端顯示的設定為準。Clash 只負責轉送網路流量，不會提供 Claude 帳號、API 金鑰或服務權限；使用前也請確認所在地區、帳號與服務使用方式符合 Anthropic 的相關政策。
排查方向
先確認節點能連線，再確認終端機知道代理連接埠，最後檢查規則命中、登入狀態與錯誤訊息。每次只改一項設定，較容易找出真正原因。
1確認 Clash 已啟動並選好節點
開始設定終端機之前，先在 Clash 客戶端確認設定檔已成功載入，代理核心正在運作，而且目前選取的策略組有可用節點。若核心未啟動、訂閱過期或策略組仍停留在失效節點，後續即使設定了代理環境變數，請求仍可能無法送出。
- 開啟 Clash Verge Rev 或其他 Mihomo 客戶端，確認目前設定檔沒有 YAML 解析錯誤。
- 在「代理」或「Proxies」頁面選擇一個可用的策略組與節點；若使用自動選擇，先確認策略組確實有可選節點。
- 查看客戶端的「連線」或「Connections」頁面，稍後進行測試時觀察是否出現新的連線記錄。
- 在設定頁確認 HTTP 或 mixed-port 的實際連接埠。常見預設值可能是
7890，但不同設定檔可能使用其他數字，以下指令請按實際值修改。
先看連接埠
HTTP 代理與 mixed-port 通常可供終端機設定 http_proxy、https_proxy 使用。不要直接假設連接埠一定是 7890；請以 Clash 的設定頁或 YAML 中的 port、mixed-port 為準。
選擇合適的代理模式
若你使用規則模式，Claude Code 相關請求會依照網域規則分流；若沒有命中代理規則，流量可能落到直連或其他預設策略。切換到全域模式可作為短暫的診斷方法：若全域模式下恢復連線，通常代表原本的規則或策略組需要檢查。測試完成後建議切回日常使用的模式，不必長期讓所有流量都經過代理。
2為終端機設定代理變數
桌面客戶端的「系統代理」主要影響支援系統代理設定的應用程式，不保證每個終端機程式都會自動採用。Claude Code 由 shell 啟動時，較直接的方式是在啟動前設定代理環境變數。請把下方的 7890 替換為 Clash 實際使用的 HTTP 或 mixed-port；若代理要求驗證，則需依客戶端及服務設定調整，切勿把密碼貼到公開日誌或截圖中。
在目前使用的終端機視窗執行以下指令，之後由同一個視窗啟動 Claude Code：
上述設定只對目前 shell 工作階段及其子程序生效。關閉終端機視窗後，變數通常不會保留；若確認設定有效，才考慮加入 ~/.zshrc、~/.bashrc 等 shell 設定檔。不要在多人共用或會同步的設定檔中保存代理帳密。
在 PowerShell 中使用以下語法設定目前視窗的環境變數，再從同一視窗啟動程式：
PowerShell 的環境變數寫法與 macOS、Linux 的 export 不同。請勿把前一組 shell 指令直接貼進 PowerShell，否則變數可能沒有照預期設定。
確認變數與連線結果
設定後可先檢查變數內容：macOS 或 Linux 執行 echo "$https_proxy"，PowerShell 執行 $env:https_proxy。如果結果是空白，或連接埠和 Clash 設定不一致，代表目前終端機還沒有使用預期代理。也可以用 curl -I https://api.anthropic.com 做基本連線測試；伺服器回應非成功狀態碼，不一定表示代理失效，重點是觀察是否能完成 TLS 連線、是否立即逾時，以及 Clash 連線記錄是否出現對應流量。單一測試網域的結果也不能取代 Claude Code 本身的登入測試。
3檢查分流規則與常見錯誤
若終端機變數正確，但請求仍逾時，請在 Clash 的連線記錄中查看 Claude Code 啟動後是否出現連線，以及每筆連線使用的規則與策略組。Anthropic 服務可能涉及多個網域，實際請求也會隨服務更新而變動，因此不要只憑一個網址推斷所有流量都已涵蓋。以下示範的是規則方向，請將 你的代理策略組 換成設定檔內已存在的策略組名稱，並確認它位於預設兜底規則之前：
此處的策略組名稱只是佔位文字，不能原封不動放進設定檔。若現有設定使用不同的規則結構，請先備份原始 YAML，再依其格式修改；縮排錯誤或引用不存在的策略組可能導致整份設定無法載入。規則通常按順序匹配，因此新增的網域規則應放在較寬泛的兜底規則之前。修改後重新載入設定檔，並在連線頁確認實際命中的規則與節點。
| 症狀 | 可能原因 | 建議檢查 |
|---|---|---|
| 連線逾時或無法建立連線 | 代理連接埠錯誤、節點不可用，或終端機未採用代理 | 比對環境變數與 Clash 連接埠，切換節點後重試，並查看連線記錄 |
| 瀏覽器可用，Claude Code 仍失敗 | 系統代理已開啟，但 shell 沒有代理變數 | 在啟動 Claude Code 的同一個終端機視窗設定變數 |
| 登入頁面反覆失敗或帳號驗證不通過 | 登入狀態過期、瀏覽器驗證流程未完成，或帳號權限有問題 | 依官方登入流程重新驗證，確認帳號狀態；不要把登入憑證交給第三方 |
| 出現未授權或權限相關回應 | 帳號登入狀態、方案權限或 API 憑證設定不符 | 確認使用的是預期的登入方式與有效憑證；不要將 API 金鑰貼到支援請求或公開紀錄 |
| 連線時好時壞 | 節點品質不穩、策略組頻繁切換，或網路連線中斷 | 固定使用一個穩定節點測試，暫停自動切換後比較結果 |
保護帳號與憑證
提交錯誤紀錄前，請先遮蔽 API 金鑰、存取權杖、帳號資訊及完整環境變數。不要使用來路不明的指令清除驗證資料，也不要將憑證直接寫進可分享的 YAML、shell 設定檔或公開程式碼庫。
4建立可重複的測試流程
完成設定後，建議依照固定順序測試，避免同時更換節點、修改規則與重設登入狀態，導致無法判斷是哪個變更真正有效。先使用一個已確認可連線的節點，在新的終端機視窗設定代理變數，再執行基本 HTTPS 測試。確認請求出現在 Clash 連線記錄後，才啟動 Claude Code 並依提示登入。
- 確認客戶端： 檢查 Clash 核心、設定檔、代理連接埠與目前節點都正常。
- 確認終端機： 檢查
http_proxy和https_proxy指向正確的本機連接埠，並從同一個終端機視窗啟動程式。 - 確認分流： 在 Clash 連線頁找到相關請求，檢查命中的規則及實際使用的策略組。
- 確認帳號： 若網路連線已建立，但登入或權限仍失敗，依官方提示檢查帳號狀態與認證流程，不要把網路錯誤和帳號錯誤混為一談。
- 逐項還原： 測試完成後移除臨時規則或診斷用的全域模式設定，只保留已驗證、確實需要的配置。
如果使用 TUN 模式，通常是為了接管未遵循系統代理的流量；但它可能需要管理員權限，且會影響更多應用程式。建議先用明確的終端機代理變數完成基本測試，只有在確認應用程式未採用代理且你了解 TUN 影響範圍時，才進一步啟用。使用公司網路、開發容器、SSH 遠端主機或 WSL 時，也要分別確認代理位於哪個執行環境：本機 Clash 的 127.0.0.1 通常只代表目前所在的系統，不一定能被容器或遠端主機直接存取。
保留有效設定
記下測試時使用的作業系統、shell、Clash 連接埠、策略組與錯誤時間即可；分享問題時遮蔽個人資訊與憑證。這些資訊通常比只提供「連不上」更有助於定位故障。
透過上述流程，多數 Claude Code 的終端機連線問題都能拆解為代理未生效、分流未命中、節點不穩或帳號驗證等不同原因。確認每一層都正常後，再恢復日常的規則模式與安全設定，就能讓開發環境保持清楚、可檢查，也更容易在下次遇到問題時快速排查。