Claude Code 需要在終端機中完成登入、工作區初始化與 API 通訊；如果終端機程序沒有讀取系統代理，常見結果就是登入頁面能開啟，但授權回呼失敗、連線逾時，或執行指令時回應到一半中斷。這不一定代表 Claude Code 帳號或 v2rayN 節點失效，很多時候只是圖形介面和命令列程序使用了不同的網路路徑。
本文以 Windows 上的 v2rayN 為主要範例，兼顧台灣、香港使用者常見的網路環境，說明如何匯入訂閱、選擇節點、開啟系統代理，並在 PowerShell 或 Windows Terminal 中設定終端機代理變數。文中也會處理登入流程、HTTPS 代理、SOCKS 代理、分流模式和故障驗證，讓你可以先用最少變更完成測試，再逐步調整成日常使用的配置。
本文適合想在終端機使用 Claude Code，卻遇到登入失敗、連線逾時、更新套件失敗或回應中斷的 v2rayN 使用者。你會學到 v2rayN 7.x 的訂閱匯入與系統代理設定、PowerShell 代理變數寫法、登入前後的驗證方法，以及如何區分節點故障、代理變數錯誤與網域分流問題。
Claude Code 為什麼需要單獨設定終端機代理
瀏覽器可以正常開啟網頁，不代表 Claude Code 一定能連線。瀏覽器通常會讀取 Windows 系統代理，或使用本身的代理設定；終端機程式則可能只按照環境變數、程式內建設定或作業系統預設路由建立 HTTPS 連線。當 v2rayN 只開啟本機監聽，卻沒有開啟系統代理，而 Claude Code 又沒有設定 HTTP_PROXY 或 HTTPS_PROXY，請求就可能直接從本機網路送出。
Claude Code 的登入和指令執行通常涉及多個 HTTPS 請求。登入階段可能需要開啟瀏覽器完成授權，終端機本身則要等待授權結果；完成登入後，工作階段還會持續與服務端通訊。因此，必須同時確認「瀏覽器能連線」和「啟動 Claude Code 的終端機能連線」兩條路徑，而不能只測試其中一條。
實務上，最穩妥的起點是使用 v2rayN 的 HTTP 代理連接埠 127.0.0.1:10809，因為許多命令列工具能直接理解 HTTP CONNECT 代理。SOCKS5 連接埠 127.0.0.1:10808 也可使用，但前提是該工具明確支援 SOCKS 代理，而且環境變數格式與程式解析方式一致。不要把 HTTP 代理埠和 SOCKS 代理埠混用，否則常見結果是立即出現協定錯誤或連線被重設。
結論：先統一終端機出口
瀏覽器能開啟登入頁，只能證明瀏覽器路徑可用；Claude Code 是否成功，應以啟動它的同一個終端機執行代理測試，確認請求確實經過 v2rayN 的 HTTP 或 SOCKS 入口。
v2rayN 匯入訂閱並確認節點可用
在設定 Claude Code 之前，先把 v2rayN 本身整理到可驗證狀態。訂閱網址通常包含多個 VMess、VLESS 或其他節點資料；匯入成功不等於每個節點都能使用，還需要選取一個延遲穩定、HTTPS 連線成功率較高的節點。台港網路環境可能受到尖峰時段、跨境路由和 DNS 回應差異影響，建議至少測試兩個不同地區或不同傳輸方式的節點。
-
更新訂閱
開啟 v2rayN 7.x，進入「訂閱分組」→「訂閱設定」，新增你的訂閱網址並儲存。回到主視窗後選擇「訂閱分組」→「更新全部訂閱」，等待節點清單完成載入。
-
選擇節點
在節點清單選擇延遲較低且最近測試成功的節點，再按右鍵執行測試。延遲數值只能作為參考，應同時觀察實際連線是否穩定，以及 HTTPS 網頁是否能持續載入。
-
開啟系統代理
從 v2rayN 主視窗或系統匣選單啟用「系統代理」，先使用「自動設定」或「PAC」模式確認一般網頁可用。若要讓終端機固定走指定代理，後續再設定環境變數。
-
確認本機埠號
進入「設定」→「參數設定」→「核心基礎設定」，確認 HTTP 代理監聽為 127.0.0.1:10809、SOCKS 代理監聽為 127.0.0.1:10808。若你曾自訂埠號，必須以畫面實際數值為準。
-
記錄核心日誌
開啟 v2rayN 日誌區域，確認沒有
bind、address already in use、TLS 交握失敗或遠端連線逾時。只有核心和節點已穩定，才適合繼續排查 Claude Code。
如果訂閱更新本身失敗，先不要急著在終端機中重複執行登入指令。可先讓 v2rayN 連上任一可用節點，再在訂閱設定中啟用「透過代理更新」之類的選項，然後重新更新。若訂閱網址已過期、需要特定 User-Agent，或服務商限制更新頻率，這些問題也不會透過修改本機代理埠號得到解決。
在 PowerShell 設定 Claude Code 代理
Windows Terminal、PowerShell 和命令提示字元都可以啟動 Claude Code，但環境變數的寫法不同。以下以 v2rayN 的 HTTP 代理 127.0.0.1:10809 為例。這種寫法只會影響目前的 PowerShell 視窗，關閉視窗後設定就會消失，適合先做一次乾淨測試，避免永久設定干擾其他命令列工具。
$env:HTTP_PROXY="http://127.0.0.1:10809"
$env:HTTPS_PROXY="http://127.0.0.1:10809"
$env:ALL_PROXY="http://127.0.0.1:10809"若你的 v2rayN 版本已將 HTTP 代理改成其他連接埠，請同步替換三行中的埠號。HTTPS_PROXY 的值仍然可以是 http:// 開頭，因為它表示「連往 HTTPS 目標時使用 HTTP CONNECT 代理」，並不是說目標網站改用未加密 HTTP。部分工具只讀取大寫變數，部分工具同時讀取小寫變數；若測試結果不一致，可以補上小寫版本。
$env:http_proxy="http://127.0.0.1:10809"
$env:https_proxy="http://127.0.0.1:10809"
$env:all_proxy="http://127.0.0.1:10809"設定完成後，先不要立刻判斷 Claude Code 是否正常。應該使用同一個終端機檢查環境變數是否存在，並以支援代理的 HTTPS 測試命令確認請求能出去。以下命令只用來觀察連線結果，不代表登入已完成：
Get-ChildItem Env:HTTP_PROXY
Get-ChildItem Env:HTTPS_PROXY
curl.exe -I https://example.com如果你使用的是 Git Bash，寫法改為 export HTTPS_PROXY=http://127.0.0.1:10809；如果使用命令提示字元，則可執行 set HTTPS_PROXY=http://127.0.0.1:10809。不要在一個視窗用 PowerShell 的 $env: 語法設定後，切換到另一個尚未繼承設定的終端機視窗測試。最簡單的方法是從設定代理的同一個視窗啟動 Claude Code。
HTTP 代理方案
- 代理位址
- 127.0.0.1
- 代理埠號
- 10809
- 變數格式
- http://127.0.0.1:10809
- 適合情境
- HTTPS 命令列工具
優先用於 Claude Code 的首次連線測試，設定直觀且容易從日誌判斷。
SOCKS5 方案
- 代理位址
- 127.0.0.1
- 代理埠號
- 10808
- 常見格式
- socks5://127.0.0.1:10808
- 注意事項
- 依工具支援情況使用
若工具支援遠端 DNS，可使用 socks5h；若不確定，先回到 HTTP 代理方案。
完成登入並驗證終端機路徑
在代理變數設定完成後，從同一個 PowerShell 視窗啟動 Claude Code，依畫面指示完成登入。登入時瀏覽器可能會自動開啟授權頁面；這時瀏覽器需要能走通代理，原本設定的終端機也必須保持開啟，因為授權流程通常還需要把結果交回命令列程序。若瀏覽器能載入頁面，但終端機長時間停留在等待授權，應優先檢查終端機的代理變數和 v2rayN 日誌。
登入完成後，不要只執行一個大型工作來判斷連線。先用短指令觀察 Claude Code 是否能回應，再逐步測試檔案讀取、專案掃描和較長的工作。這樣可以區分「無法建立初始 HTTPS 連線」和「長連線中途被網路設備重設」兩種完全不同的問題。
- 初始登入失敗：檢查瀏覽器、PowerShell 和 v2rayN 是否使用同一個節點與代理路徑。
- 登入後立即逾時：確認
HTTPS_PROXY拼寫、協定前綴及本機埠號，並檢查 v2rayN 是否仍在執行。 - 回應中途停止：先測試另一個節點，觀察核心日誌是否出現連線重設、讀取逾時或上游關閉。
- 只有某個專案失敗：檢查專案程序是否由不同終端機、IDE 或工作排程器啟動，因為它們不一定繼承目前視窗的代理變數。
若 Claude Code 是從編輯器內建終端機啟動，請確認編輯器是在設定代理變數之後才開啟。許多桌面程式會在啟動時讀取環境，之後才開啟的整合終端機可能與獨立 PowerShell 使用不同變數。最可靠的驗證方式，是先關閉編輯器，從已設定代理的獨立 Windows Terminal 完成一次登入，再回到編輯器測試。
瀏覽器登入頁能開，為什麼終端機仍逾時？
兩者可能使用不同代理。請在啟動 Claude Code 的同一個 PowerShell 執行 Get-ChildItem Env:HTTPS_PROXY，確認值為目前 v2rayN 的 HTTP 代理位址。
HTTP_PROXY 和 HTTPS_PROXY 要填哪個埠號？
以常見 v2rayN 設定來說，兩者都先填 http://127.0.0.1:10809。只有在工具明確要求 SOCKS5 時，才改用 10808。
設定 ALL_PROXY 後反而連不上，怎麼辦？
先移除可能造成衝突的全域代理變數，只保留 HTTP_PROXY 和 HTTPS_PROXY 測試；PowerShell 可用 Remove-Item Env:ALL_PROXY 清除目前視窗的設定。
換節點後需要重新設定 Claude Code 嗎？
通常不需要。只要 v2rayN 仍在相同的本機埠號監聽，Claude Code 使用的是本機代理入口，換節點會由 v2rayN 負責出站。
分流模式與終端機連線的取捨
首次設定時，建議先使用全域代理或較寬鬆的規則模式完成驗證，確定 Claude Code 可以登入並持續回應後，再改成細緻分流。原因是終端機請求可能涉及登入服務、API 服務、更新服務和其他必要網域；如果只放行其中一個網域，表面上可能能開啟登入頁，實際執行工作時卻在另一個請求階段失敗。
使用規則分流時，應讓必要的 HTTPS 網域透過代理出站，並避免把未知的服務網域硬編寫為直連。分流規則還可能受到 DNS 解析結果、IPv4 或 IPv6 選擇、程序名稱和連接埠條件影響。若你在台灣或香港的本地網路對某些服務本來就能穩定直連，可以等完整流程驗證後，再逐項加入直連規則，而不要一開始就同時修改 DNS、TUN 和程序分流。
- 全域模式：適合首次登入和定位故障，變數最少，但區域網路與本地服務也可能被送往代理。
- 規則模式：適合日常使用，能將本地網域、區域網路和指定服務分開處理，但需要維護規則。
- TUN 模式：適合不讀取環境變數或不支援代理的程序；若 Claude Code 已明確使用 HTTP 代理，初期不必同時啟用 TUN。
- 代理變數模式：影響範圍容易控制，適合只讓目前的終端機和相關命令列工具走 v2rayN。
常見錯誤與復原順序
當 Claude Code 報錯時，先記錄完整訊息、執行命令、目前節點和 v2rayN 日誌時間。不要只截取最後一行，因為 timeout 可能是 DNS、代理入口、TLS 交握或遠端服務延遲造成。將問題縮小到一個終端機視窗、一個節點和一個代理埠號，通常比同時改動多項設定更快。
錯誤：connect ECONNREFUSED 127.0.0.1:10809
原因與解法：終端機嘗試連往 10809，但 v2rayN 沒有在該埠號監聽，或你在 v2rayN 中使用了自訂埠號；確認核心正在執行，並以實際設定更新 HTTPS_PROXY。
錯誤：Proxy CONNECT aborted 或 tunneling socket could not be established
原因與解法：代理協定與監聽埠號不匹配；若 10809 是 HTTP 代理，請使用 http://127.0.0.1:10809，不要直接改成 socks5://。
錯誤：ETIMEDOUT 或 request timeout
原因與解法：可能是節點出站延遲、DNS、分流規則或連線被中途丟棄；先換另一個節點並暫時使用全域代理，再從 v2rayN 日誌確認請求是否抵達核心。
錯誤：登入完成但終端機仍等待
原因與解法：瀏覽器與終端機可能沒有走同一條路徑，或授權回傳被本機安全軟體攔截；保持原終端機開啟，確認代理變數，並重新從同一視窗啟動登入流程。
完成測試後，如果你只想讓 Claude Code 使用代理，可以在目前 PowerShell 視窗清除變數，避免其他命令列程式沿用代理：
Remove-Item Env:HTTP_PROXY
Remove-Item Env:HTTPS_PROXY
Remove-Item Env:ALL_PROXY
Remove-Item Env:http_proxy
Remove-Item Env:https_proxy
Remove-Item Env:all_proxy如果需要每次開啟 PowerShell 都使用代理，可以將設定加入 PowerShell 設定檔，但不建議在尚未完成測試前永久寫入。永久設定後，當 v2rayN 尚未啟動時，所有依賴這些變數的命令列工具都可能出現本機連線拒絕。比較安全的做法是建立一個專用啟動腳本，先確認 v2rayN 已連線，再在該工作階段設定變數。
結論：故障排查要按照層級回退
先確認 v2rayN 核心，再確認本機代理埠號，接著確認終端機環境變數，最後才檢查 Claude Code 登入和服務端回應。每次只改一層，才能知道哪個變更真正解決問題。