瀏覽器能用，Claude Code 終端機卻連不上？HTTP 代理設定與排查

瀏覽器中的 Claude 能開啟，終端機執行 claude 卻逾時或無法登入，先確認終端機是否使用代理。瀏覽器擴充功能、系統代理與 shell 環境變數是不同設定；網頁正常，不代表終端機也設定完成。

本文適用於獨立的 Claude Code CLI，不是 Claude Desktop。使用者仍須符合官方支援地區與帳號資格要求，網路連通不能取代這些條件。

這些臨時設定適用於從目前終端機前景啟動的 CLI。--bg 或背景代理請依官方背景網路設定處理；持續執行的背景管理程序不會可靠地繼承後來修改的 shell 變數。

1. 先確認代理用戶端正常運作

JMS 訂閱用於在用戶端設定節點，實際請求路徑是：

Claude Code → 用戶端本機 HTTP/mixed 連接埠 → 選定的 JMS 節點 → Anthropic 服務。

將目前訂閱匯入支援實際節點協定的用戶端。JMS 在 2026 年調整過協定，舊的純 Shadowsocks 用戶端不一定適用。先參考 VLESS/Reality 連線排查與 Clash Verge 訂閱設定。

在用戶端查找本機 HTTP 或 mixed 監聽連接埠，並保持程式執行。它不是遠端伺服器連接埠、訂閱網址、UUID 或 Reality 公鑰。監聽應綁定本機，不需為此開啟區域網路分享。

官方網路文件說明 Claude Code 支援 HTTP/HTTPS 代理，但不直接支援 SOCKS。若只有 SOCKS 連接埠，請開啟 HTTP/mixed 監聽或改用相容用戶端。

2. 在啟動 Claude 的終端機設定

第一次測試建議另開終端機。先在本機確認 https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY、all_proxy、ALL_PROXY、no_proxy 和 NO_PROXY 是否已有設定。不要公開貼出變數值，代理網址可能含有密碼。

Claude Code 依 https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY 的順序，採用第一個已設定的值。舊的小寫變數可能蓋過新的大寫設定。不同工具的處理方式不同，不能假設 ALL_PROXY 會讓 Claude 直接使用 SOCKS。覆寫前應私下保留原值並解決衝突。

macOS 或 Linux：Bash/Zsh

7890 只是範例，執行前務必換成用戶端顯示的實際 HTTP/mixed 連接埠：

JMS_PROXY_PORT=7890
export HTTPS_PROXY="http://127.0.0.1:${JMS_PROXY_PORT}"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1"
claude

Windows：PowerShell

同樣請將 7890 改成實際 HTTP/mixed 連接埠。以下指令適用於 PowerShell，不是命令提示字元：

$JmsProxyPort = 7890
$env:HTTPS_PROXY = "http://127.0.0.1:$JmsProxyPort"
$env:HTTP_PROXY = $env:HTTPS_PROXY
$env:NO_PROXY = "localhost,127.0.0.1,::1"
claude

http:// 表示連到本機代理的方式，不會將目的網站的 HTTPS 降為明文。NO_PROXY 讓本機請求直接連線，有助於登入回呼到達 CLI。

設定只影響目前終端機及其啟動的程序。執行中的 Claude Code 不會讀取後來更改的 shell 變數：先退出、設定，再從同一個終端機執行 claude。測試成功之前，不必寫入 shell 啟動檔。

在 WSL、容器或 SSH 中，127.0.0.1 指執行指令的環境，不一定是用戶端所在的 Windows 或主機。應先確認可達性，不要把代理直接公開到網際網路。

3. 不提供金鑰也能測試連線

退出 Claude Code，在剛才設定好的終端機執行對應指令。測試明確使用本機代理，只請求公開 API 主機，不傳送 API key。

macOS/Linux：

curl --proxy "$HTTPS_PROXY" --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output /dev/null --silent --show-error --write-out 'HTTP %{http_code}\n' https://api.anthropic.com/

Windows PowerShell 請用 curl.exe，避免舊版 PowerShell 的 curl 別名：

curl.exe --proxy $env:HTTPS_PROXY --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output NUL --silent --show-error --write-out "HTTP %{http_code}\n" https://api.anthropic.com/

連線等待上限為 10 秒，整個請求上限為 20 秒。HTTP 401、403 或 404 仍可能表示已收到 HTTP 回應；API 根網址並非已登入的模型呼叫。需結合錯誤內容判斷：非 2xx 不必然是代理失效，有 HTTP 回應也不代表帳號能正常使用 Claude Code。

HTTP 000 伴隨連線錯誤或逾時，通常表示未收到正常 HTTP 回應。憑證錯誤應另行處理，保留 TLS 驗證，不要加入 -k 或關閉憑證檢查。求助時，不要公開訂閱網址、登入驗證碼、權杖或私密診斷紀錄。

4. 依現象決定下一步

用 claude --version 查看版本、claude doctor 檢查安裝，並依官方安裝文件更新對應安裝方式。版本缺陷、登入過期或平台故障也會看起來像網路問題。

5. 清除這次臨時設定

若測試前這些變數不存在，只清除上面新增的值：

Bash/Zsh：

unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORT

PowerShell：

Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue

這只會刪除目前值，不會恢復被覆寫的舊值；必要時請自行在本機還原。更改環境後應重新啟動 Claude Code。系統與啟動檔中的持久設定需另行檢查。

選擇連線服務

JMS 為相容用戶端提供節點，再由用戶端與終端機設定交給 CLI。它不提供 Anthropic 訂閱、不保證帳號獲准或不被停用；本機代理也不改變雲端 MCP 連接器的出口。

可依裝置與現行協定查看方案與用戶端下載指南。若符合需求，可查看 Just My Socks 服務。

聯盟揭露：透過此推廣連結購買，我們可能獲得佣金。