Claude Code連線不穩怎麼辦？用V2Ray設定終端機代理

先分清楚代理與帳號問題

v2rayN 負責管理節點與啟動核心；Claude Code 則是在終端機中執行的命令列工具。瀏覽器能透過 v2rayN 開啟網站，只代表瀏覽器目前可以連線，不代表 PowerShell、Windows Terminal 或其他終端機程式也會自動使用同一條代理。終端機通常需要讀取目前工作階段中的代理環境變數，或使用應用程式明確支援的代理設定。

建議先把故障分成三層：第一層是 v2rayN 核心與節點能否正常連線；第二層是終端機是否連到正確的本機代理入口；第三層才是 Claude Code 的登入狀態、帳號資格與授權流程。一次只檢查一層，避免同時換節點、重裝工具和清除登入資料，最後反而難以判斷是哪項改動有效。

• 網頁也無法開啟：先檢查 v2rayN 的作用中節點、核心記錄和系統代理狀態。
• 網頁可用，只有 Claude Code 逾時：優先確認終端機是否收到正確的代理變數，以及連接埠是否正在監聽。
• 能連線但登入失敗：檢查登入流程、帳號與服務授權；重複更換本機代理設定未必能解決帳號問題。

上述數字只是檢查用的常見範例，並非固定規格。若你的 v2rayN 設定使用其他 HTTP 監聽連接埠，環境變數也必須跟著修改。不要把節點伺服器的位址或遠端連接埠填到 HTTP_PROXY；這個變數應指向本機代理服務。

確認 v2rayN 本機代理入口

先啟動 v2rayN，選取一個可用節點並確認核心正在執行。不同版本的介面位置可能不同，可從「設定」→「參數設定」查看本機監聽連接埠，或在系統匣選單與主視窗中尋找入站、HTTP 代理或本機代理相關設定。若介面將 HTTP 與 SOCKS 分開顯示，記下 HTTP 代理的位址和連接埠；下方指令以 127.0.0.1:10809 為例。

1. 啟動核心

   在 v2rayN 中選擇作用中節點並啟動服務。查看日誌或狀態提示，確認核心沒有因設定錯誤或本機連接埠占用而立即退出。

2. 查看代理類型

   開啟「設定」→「參數設定」或相應的入站設定，確認本機是否提供 HTTP 代理。使用 HTTP 代理網址格式填入環境變數，不要把 SOCKS 連接埠誤當成 HTTP 連接埠。

3. 核對監聽位址

   記下本機位址與連接埠，常見位址是 127.0.0.1。若設定限定監聽在其他介面，請以實際設定為準，並避免在不必要時將本機代理開放給區域網路。

4. 測試核心連線

   先用瀏覽器或其他已知可用的方式測試同一節點。若核心尚未連上伺服器，先處理節點、網路或核心錯誤，再設定 Claude Code。

5. 記下實際連接埠

   把設定頁面顯示的 HTTP 連接埠記下來，後續指令中的 10809 都要替換成這個值。切換節點通常不等於更換本機監聽連接埠，但仍應重新確認實際設定。

如果不確定某個連接埠是否正在監聽，可在 PowerShell 執行唯讀檢查。以下指令檢查範例連接埠 10809；沒有輸出表示當下沒有找到該 TCP 監聽項目，並不能證明遠端節點一定故障。

Get-NetTCPConnection -LocalPort 10809 -State Listen -ErrorAction SilentlyContinue |
  Select-Object LocalAddress, LocalPort, OwningProcess

在終端機設定代理變數

Claude Code 從終端機啟動時，應在啟動命令的同一個終端機工作階段中設定代理變數。常見變數名稱為 HTTP_PROXY 和 HTTPS_PROXY；HTTPS 網站仍使用 http://127.0.0.1:連接埠 這種寫法，因為這表示先透過本機 HTTP 代理轉送 HTTPS 要求，不代表目標網站改用未加密連線。

以下以 Windows PowerShell 為例，連接埠使用前述的 10809。只影響目前 PowerShell 工作階段，不會自動替其他已開啟的終端機設定代理：

$env:HTTP_PROXY = "http://127.0.0.1:10809"
$env:HTTPS_PROXY = "http://127.0.0.1:10809"
$env:NO_PROXY = "localhost,127.0.0.1"
claude

若已經在 Claude Code 工作階段中，可先退出，再於設定好變數的終端機重新執行。若你使用命令提示字元而不是 PowerShell，設定方式不同；不要把 PowerShell 的 $env: 語法直接貼進命令提示字元。使用 Bash 的環境可在目前工作階段執行：

export HTTP_PROXY="http://127.0.0.1:10809"
export HTTPS_PROXY="http://127.0.0.1:10809"
export NO_PROXY="localhost,127.0.0.1"
claude

NO_PROXY 用來指定不經代理的本機目標，並非繞過一般網際網路代理的開關。若你的環境已有 NO_PROXY 清單，先查看目前內容，再依需要合併項目；直接覆寫可能影響其他開發工具。若希望變數在新終端機中持續存在，可設定使用者層級的環境變數，但排查時建議先用工作階段設定，確認有效後再決定是否持久化。

不同版本的 Claude Code、執行環境或周邊工具，可能對代理變數的處理方式有所差異。若變數已設定但仍無法連線，先確認你啟動的 Claude Code 確實繼承了這些變數，再查看錯誤訊息與官方版本說明；不要只因為瀏覽器可用，就認定命令列程式已使用相同代理。

逐層排查逾時與連線失敗

確認環境變數後，以同一個終端機視窗啟動 Claude Code，記錄完整錯誤文字與發生時間。若日誌指出本機連線遭拒，優先檢查代理連接埠與 v2rayN 核心；若錯誤發生在連線至服務端或等待回應階段，再比較節點、網路環境與服務狀態。錯誤片段只能提供方向，不能單獨證明帳號已失效或節點一定被封鎖。

• Connection refused 或連線遭拒：常見於本機代理沒有監聽、連接埠填錯，或核心已停止。重新查看 v2rayN 入站設定，並用 PowerShell 檢查實際監聽狀態。
• Connection timed out 或逾時：可能是終端機沒有走代理、節點無回應、網路中斷，或服務端未能及時完成連線。先在同一網路測試 v2rayN 節點，再換一個已知可用節點做對照。
• DNS 或名稱解析錯誤：確認核心日誌中是否出現目標網域解析失敗，並分辨是本機直連解析、核心 DNS 設定，還是遠端服務端回應問題。不要在沒有證據時隨意更換多組 DNS。
• TLS、握手或憑證相關錯誤：確認系統時間正確、用戶端版本符合需求，並留意錯誤是否只在特定網路出現。這類訊息不等同於代理連接埠設定錯誤。
• 啟動後立即顯示登入錯誤：先確認 Claude Code 能否完成登入流程，以及目前使用的帳號是否有權使用相關服務。登入驗證與 v2rayN 節點驗證是不同事情。

每次只改一項並以相同方式重測。例如先保持節點不變，只修正 HTTP 連接埠；確認仍失敗後，再換節點，不要同時修改環境變數、核心、DNS 和帳號狀態。這樣才能從結果看出故障是否位於本機代理入口，或是在更後面的連線與授權階段。

檢查登入授權與工具狀態

代理可用並不代表 Claude Code 帳號必然能登入。登入可能使用瀏覽器完成授權，瀏覽器與終端機是兩個不同的連線路徑：瀏覽器開啟授權頁成功，不代表終端機的 API 要求也使用代理；反過來，終端機能連上代理，也不能代替帳號驗證或服務資格檢查。

依序確認以下事項：

• 重新檢查登入狀態：依 Claude Code 目前版本提供的登入與狀態指令檢查授權情況。若已登入其他帳號，先確認目前工作階段使用的是預期帳號，不要直接刪除所有設定檔。
• 確認服務資格：查看帳號目前可使用的服務與組織政策。若畫面明確顯示帳號、付款或管理員授權問題，調整本機代理通常無法改變帳號權限。
• 檢查版本與安裝來源：確認執行的是預期的 Claude Code 安裝版本，避免同一台電腦上存在多個命令路徑，導致設定套用在另一個執行檔上。
• 留意登入回呼：若登入需要瀏覽器開啟並回傳本機授權資訊，依照終端機提示完成流程。防火牆或安全軟體阻止本機回呼時，錯誤可能出現在授權步驟，而不是節點連線階段。
• 比較錯誤發生位置：分清錯誤是在啟動、登入頁面、授權回傳，還是登入後呼叫服務時出現。保留前後文，才能判斷要檢查終端機代理、帳號授權或本機安全軟體。

若同一帳號在一種網路可以登入、另一種網路無法登入，可在不改變帳號與工具版本的情況下，比較兩種網路的結果。若更換可用節點後問題仍只出現在授權階段，應依錯誤內容檢查登入狀態或服務支援，而不是持續重建 v2rayN 訂閱。

常見問題