ブラウザは使えるのに Claude Code がつながらない？ターミナルの HTTP プロキシ設定

ブラウザでは Claude が開くのに、ターミナルの claude がタイムアウトする場合は、まずターミナルにプロキシが設定されているか確認しましょう。ブラウザ拡張、OS のプロキシ設定、シェルの環境変数は別々です。

この記事は単独で動作する Claude Code CLI が対象です。Claude Desktop の設定手順ではありません。公式の対応地域とアカウント条件を満たす必要があり、接続できるだけで利用資格が変わることはありません。

この一時設定は、現在のターミナルからフォアグラウンドで起動する CLI が対象です。--bg やバックグラウンドエージェントは公式の専用設定に従ってください。常駐する管理プロセスが後からのシェル変更を確実に引き継ぐとは限りません。

1. 先にプロキシクライアントを接続する

JMS サブスクリプションはクライアントにノードを設定するために使います。実際のリクエスト経路は次のとおりです。

Claude Code → クライアントのローカル HTTP/mixed ポート → 選択した JMS ノード → Anthropic サービス。

現在のノードのプロトコルに対応したクライアントへ、最新のサブスクリプションを読み込んでください。JMS は 2026 年にプロトコルを変更しており、古い Shadowsocks 専用クライアントが引き続き使えるとは限りません。VLESS/Reality の接続トラブル対策と Clash Verge の設定を先に確認できます。

クライアントのローカル HTTP または mixed の待受ポートを調べ、クライアントを起動したままにします。リモートサーバーのポート、サブスクリプション URL、UUID、Reality 公開鍵ではありません。待受はローカルに限定し、この設定のために LAN 共有を有効にする必要はありません。

公式ネットワーク文書では、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 の既存設定を手元で確認します。URL にパスワードが含まれることがあるため、値を公開しないでください。

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 は後から変更した環境変数を読み直しません。一度終了し、設定後に同じターミナルで claude を起動します。動作確認前にシェルの設定ファイルへ永続化する必要はありません。

WSL、コンテナ、SSH 内の 127.0.0.1 は、コマンドを実行している環境を指します。クライアントが動作する Windows やホストと同じとは限りません。プロキシをインターネットへ公開せず、到達可能な経路を確認してください。

3. 認証情報なしで接続テストする

Claude Code を終了し、設定済みのターミナルで実行します。ローカルプロキシを明示的に経由し、公開 API ホストへアクセスするだけなので API キーは送信しません。

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 を使います。

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 のルート URL は認証済みのモデル呼び出しではありません。非 2xx だけでプロキシの故障と判断せず、応答があってもアカウントで使える証明とは考えないでください。

HTTP 000 と接続エラーやタイムアウトが出た場合、通常の HTTP 応答を受け取れていません。証明書エラーは別に調べます。TLS 検証を維持し、-k の追加や証明書検証の無効化は避けてください。サブスクリプション URL、ログインコード、トークン、非公開の診断ログを公開しないでください。

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 を再起動します。OS や設定ファイルの永続設定は別途確認が必要です。

接続サービスを選ぶとき

JMS は対応クライアント用のノードを提供し、クライアントとターミナル設定が CLI へ接続を渡します。Anthropic の契約、アカウント承認、停止防止を保証するものではありません。ローカルプロキシでクラウドの MCP コネクターの出口も変わりません。

端末と現在のプロトコルに合わせてプランとクライアントのダウンロード案内を確認できます。用途に合う場合は、Just My Socks のサービスを見る。

アフィリエイトについて：このリンクから購入すると、当サイトに紹介料が支払われる場合があります。