Claude Code 台灣香港怎麼用？v2rayN 終端代理設定教學

先確認服務與使用條件

Claude Code 是在終端機中執行的程式，會依賴網路連線與帳戶驗證。v2rayN 只負責在本機建立代理入口，再將符合規則的請求交給所選節點轉送；它不會替帳戶註冊、付款、變更服務地區，也不會保證某個地區一定可以使用特定功能。台灣或香港使用者在開始設定前，仍應確認帳戶所在地、付款資料、組織政策與服務提供者當時的可用範圍。

如果瀏覽器可以開啟一般網站，但 Claude Code 仍然逾時，優先懷疑終端機沒有取得代理設定。Windows 的「系統代理」主要供支援系統代理的圖形程式使用，命令列工具不一定會自動讀取它。相反地，終端機通常需要讀取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 等環境變數，才能將請求送往 v2rayN 的本機連接埠。

匯入訂閱並選擇可用節點

使用 v2rayN 前，先從服務提供者取得自己的訂閱網址。訂閱通常包含多個 VMess、VLESS、Trojan 或 Shadowsocks 節點，匯入後由 v2rayN 顯示名稱、協議、位址與延遲。不要把含有帳戶權杖的訂閱網址貼到公開解析服務、聊天群組或截圖中；若連結外洩，應立即回到服務提供者後台重新產生。

匯入後不要只依節點名稱判斷台灣或香港線路。延遲測試只能反映 TCP 或 ICMP 等有限條件，不能代表 Claude Code 的完整請求一定成功。建議先選擇延遲低、失敗率穩定的節點，再用瀏覽器與終端機各測試一次。若某節點能開啟一般網頁，卻在 TLS 握手或 API 請求階段失敗，應改測另一個節點及另一種傳輸組合。

1. 開啟訂閱分組

   啟動 v2rayN，前往主介面的「訂閱分組」→「訂閱分組設定」→「新增」。貼上完整訂閱網址，為分組填入容易辨識的名稱，儲存後執行「更新訂閱」或「更新全部訂閱」。

2. 檢查節點資料

   確認更新後有出現節點，並查看協議、伺服器位址、遠端連接埠、TLS、SNI、Reality 公鑰或 WebSocket 路徑等欄位。若節點數量為零，先排查訂閱回應內容，不要急著修改終端機變數。

3. 選擇核心

   在「設定」→「參數設定」→「Core 類型」確認目前使用的核心。新節點若依賴 Xray 支援的 VLESS、Reality 或 Vision 參數，應使用與訂閱相容的 Xray 核心；舊節點則依服務提供者的相容性要求選擇。

4. 測試活動節點

   回到主介面選擇一個節點，使用右鍵功能中的延遲測試或連線測試。測試成功後再啟用系統代理，並記下目前節點名稱、核心類型與本機 HTTP 連接埠，方便後續定位問題。

5. 確認代理入口

   啟用「系統代理」後，在 v2rayN 設定中確認 HTTP 代理通常監聽於 127.0.0.1:10809，SOCKS 代理通常監聽於 127.0.0.1:10808。若介面顯示不同數值，以實際顯示為準。

理解 HTTP 與 SOCKS 代理差異

終端機變數指向哪一種代理，取決於工具是否支援該協議。HTTP 代理通常使用 http://127.0.0.1:10809，適合會讀取 HTTP_PROXY 與 HTTPS_PROXY 的命令列程式。HTTPS 變數的值仍可寫成 HTTP 代理網址，因為它描述的是「連線到本機代理入口所使用的協議」，不是把值改寫成遠端網站的 HTTPS 位址。

SOCKS5 代理通常使用 socks5://127.0.0.1:10808。部分工具只支援 socks5h://，其中 h 表示網域解析也交由代理端處理，可以減少本機 DNS 解析造成的差異；但不是每個程式都接受這個前綴。初次設定 Claude Code 時，建議先使用 v2rayN 的 HTTP 入口，因為相容性通常較容易判斷，確認成功後才測試 SOCKS5。

不要同時把 HTTP、SOCKS 和其他代理程式串在一起。多層代理可能導致請求循環，例如 v2rayN 的訂閱更新又被終端機代理攔截，或另一個本機服務佔用同一連接埠。測試時只保留一個代理入口，並暫停會修改系統代理的其他網路工具。

在終端機設定代理變數

以下設定只影響目前開啟的終端機工作階段，關閉視窗後通常會失效，適合先測試。請先讓 v2rayN 保持執行並啟用系統代理，再開啟新的 PowerShell 視窗。若 v2rayN 使用的 HTTP 連接埠不是 10809，將範例中的數字替換成實際值。

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

若使用 Windows 命令提示字元，寫法不同，變數會套用至目前的命令提示字元視窗：

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

需要暫時改用 SOCKS5 時，可在 PowerShell 測試 ALL_PROXY。不過如果 Claude Code 或其底層請求函式沒有讀取 SOCKS 變數，這個方法不一定生效，因此失敗時不要直接判定節點不可用：

$env:ALL_PROXY="socks5://127.0.0.1:10808"
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
claude

在其他終端機環境中，常見寫法是 export HTTP_PROXY="http://127.0.0.1:10809" 與 export HTTPS_PROXY="http://127.0.0.1:10809"。如果只想為單次執行設定，也可以把變數放在指令前面。請避免把 API 金鑰直接寫進公開腳本、批次檔或終端機截圖；代理變數與 API 金鑰屬於不同設定，前者只指定網路路徑，後者負責帳戶驗證。

驗證登入、API 與終端機連線

完成代理變數後，先不要立即修改大量 Claude Code 選項。應依序檢查「本機代理可連線」「網域解析正常」「TLS 握手成功」「帳戶驗證有效」四個層次。瀏覽器能夠載入登入頁，只能證明圖形介面路徑部分正常；Claude Code 可能使用不同的請求方式、環境變數或驗證流程，因此還需要在同一個已設定變數的終端機內重新啟動。

若程式已經開啟，再補上環境變數通常不會改變該程序的既有環境。請先結束目前的 Claude Code 工作階段，確認 PowerShell 中能讀取變數，再重新執行。可以用以下命令查看代理值是否存在，但不要將包含帳戶權杖的完整輸出貼到公開場所：

Get-ChildItem Env:HTTP_PROXY
Get-ChildItem Env:HTTPS_PROXY
Test-NetConnection 127.0.0.1 -Port 10809

Test-NetConnection 顯示本機連接埠可達，只代表 v2rayN 正在監聽，不代表遠端節點、TLS 或帳戶服務一定成功。若本機連接埠測試失敗，回到 v2rayN 檢查核心是否啟動、代理模式是否開啟，以及 Windows 防火牆是否阻擋本機程式。若本機測試成功但 Claude Code 逾時，則應改查節點、DNS、系統時間與終端機實際讀取的變數。

常見錯誤與安全還原

設定成功後，建議把「測試用代理」與「永久環境變數」分開管理。PowerShell 暫時變數只存在目前視窗，適合在不同節點之間比較；若使用 Windows 的使用者環境變數永久寫入，所有新啟動的命令列程式都可能套用代理，包含不需要代理的內部服務與開發工具。永久設定前，應先確認是否會影響公司網路、區域網路位址或其他自動化工作。

完成工作後，可以在 PowerShell 還原目前視窗的設定：

Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:ALL_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:NO_PROXY -ErrorAction SilentlyContinue

如果曾經在系統環境變數中永久加入代理，請到 Windows「設定」→「系統」→「系統資訊」→「進階系統設定」→「環境變數」檢查使用者變數與系統變數，移除不再使用的 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。修改後必須重新開啟終端機，已經啟動的程式不會自動取得新值。