Claude Codeがターミナルでつながらない?Clashのプロキシ設定と確認方法

まずClaude Codeの通信経路を切り分ける

Claude Codeを起動してもログインできない、APIへの接続がタイムアウトする、または応答の途中で切断される場合、原因はClashのノードだけとは限りません。ターミナルから起動したClaude Codeは、ブラウザーと同じプロキシ設定を自動的に使うとは限らず、シェルの環境変数やNode.jsの通信設定を参照することがあります。ブラウザーでClaudeのページを開けることは、Claude Codeの通信もClashを通っている証拠にはなりません。

最初に、問題が起きる操作を分けて確認しましょう。ログイン画面を開けないのか、認証後にAPI接続で失敗するのか、起動後のモデル呼び出しで止まるのかを記録します。ログインには認証やブラウザー起動が関わり、モデルへのリクエストではAPIへのHTTPS接続が必要です。症状が異なれば、確認するドメインや設定も変わります。

Clashの接続履歴を開き、Claude Codeで再現操作を行った時刻に、新しい接続が記録されるか確認してください。接続先ドメイン、適用ルール、選択されたポリシーグループ、接続の終了状態を見ます。該当接続が一件もない場合は、Claude CodeがClashへ接続していない可能性があります。接続が表示されているのに失敗する場合は、ルール、ノード、DNS、TLS接続の順に調べると切り分けやすくなります。

プロファイル、コア、ローカルポートを確認する

Clash VergeやClash Verge Revでは、画面に表示されているプロファイルが読み込まれ、Mihomoコアが稼働していることを確かめます。プロファイルの更新後にコアが停止していたり、設定の読み込みに失敗していたりすると、ターミナルから指定したポートに接続できません。クライアントの「設定」や「ポート」画面で、HTTPポートまたはmixed-portの実際の値を確認してください。初期値が7890の環境はありますが、利用中の値が必ず同じとは限りません。

HTTPポート、SOCKSポート、mixed-portは役割が異なります。Claude Codeのようなコマンドラインツールには、まずHTTPプロキシまたはHTTPとSOCKSの両方を受け付けるmixed-portを試すのが簡単です。以下は構造を示す例であり、ポート番号はクライアントの有効な設定に合わせてください。

mixed-port: 7890
allow-lan: false
mode: rule

ポートが待ち受けているかは、ターミナルからも確認できます。WindowsではPowerShell、macOSやLinuxではシェルで次のコマンドを実行します。

netstat -ano | findstr 7890

lsof -nP -iTCP:7890 -sTCP:LISTEN

ss -lntp | grep 7890

WindowsのコマンドはPowerShellで実行でき、macOSでは通常lsof、Linuxではssが利用できます。結果が表示されない場合は、ポート番号の間違い、コアの停止、別プロセスとの競合を調べます。ポートを変更したら、環境変数に設定するアドレスも同じ値に更新してください。

Clashの接続履歴を見ながらポートへの接続テストを行うと、ターミナルからClashまでの経路を確認できます。接続拒否は、誤ったポートや待受停止を示すことが多く、長いタイムアウトはファイアウォールやClashから外部への接続も候補になります。

Claude Codeを起動するターミナルにHTTPプロキシを設定する

デスクトップのシステムプロキシを有効にしていても、シェルで動作するプログラムがその設定を使うとは限りません。Claude Codeを実行するターミナルに、ClashのHTTP待受ポートを環境変数として渡します。まずは現在のシェルだけに一時設定し、接続を確認してから、必要な場合に限って永続設定へ進むのがおすすめです。

macOSとLinux

次の例では、ClashのHTTPまたはmixed-portが7890の場合を想定しています。実際のポートが異なる場合は、URL内の番号を置き換えてください。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"

claude

環境によっては小文字の変数だけを参照するプログラムもあるため、大文字と小文字の両方を設定しています。設定が有効かは、Claude Codeを起動する前にenv | grep -i proxyで確認できます。ClashがSOCKS専用ポートしか用意していない場合は、HTTPプロキシとして指定しても動作しません。対応するHTTPポートかmixed-portを選んでください。

Windows PowerShell

PowerShellでは、現在のウィンドウで起動するプロセスに環境変数を渡せます。

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
claude

Windows Terminalで新しいタブを開いた場合、設定したシェルとは別のセッションになることがあります。環境変数を設定した同じウィンドウからclaudeを起動し、Claude Codeのプロセスが実際にその値を受け取っているか確認してください。アプリを再起動せずに設定だけ変えても、すでに起動中のプロセスには反映されません。

一時設定で成功した場合も、すぐにシェルの起動ファイルへ追加せず、Clashを終了したときや別ネットワークを使うときの挙動を試します。プロキシが利用できない環境で古い変数が残ると、通常の通信まで失敗する場合があります。永続化するなら、使うシェルの設定ファイルに追加し、不要になったときに削除できる場所と手順も把握しておきましょう。

curlとClaude Codeで段階的に接続をテストする

環境変数を設定したら、いきなり設定を何度も書き換えるのではなく、まず同じターミナルからプロキシを明示したリクエストを試します。次のコマンドはClashのHTTPプロキシを経由するテスト例です。応答コードが表示されるかを確認してください。認証が必要なページや、利用条件の異なる接続先を使っている場合は、結果が異なることがあります。

curl -I --proxy http://127.0.0.1:7890 https://api.anthropic.com

このテストが成功しClaude Codeだけが失敗する場合、Clashの待受と外向き通信は概ね動作しているため、起動シェルの変数、Claude Codeの認証状態、独自のAPI接続先設定などを調べます。反対にcurlも接続できない場合は、Clashの接続履歴とログに該当リクエストが出るかを確認します。履歴に出ないならローカルポートや指定形式、履歴に出て失敗するならルールやノードが主な確認対象です。

エラーの内容も切り分けに役立ちます。Connection refusedは、ローカルポートで受け付けるプロセスがいない場合に見られます。名前解決エラーは、DNS設定や接続先ドメインの解決を確認します。タイムアウトは、ノードの状態、ルールで選ばれた出口、ファイアウォールを順に調べます。HTTPの応答が返ったとしても、それだけでClaude Codeの認証やAPI呼び出しまで正常だと判断せず、最後に実際のコマンド操作で確認してください。

Claude Codeのエラーを共有するときは、エラーメッセージと時刻、適用ルール、選択ポリシーを中心に記録します。サブスクリプションURL、APIキー、認証情報、ローカルのコントロールシークレットをログやスクリーンショットに含めないでください。トークンを含む設定をそのまま公開すると、ネットワークの問題とは別のセキュリティ事故につながるおそれがあります。

プロキシモードとルールの選択結果を確認する

Clashの「ルール」「グローバル」「直接接続」は、接続をどのように処理するかを切り替えるモードです。ルールモードでは設定のrulesを上から照合し、最初に一致したルールのポリシーへ通信を渡します。グローバルモードではグローバルプロキシグループの選択が使われ、直接接続モードでは通常プロキシを通しません。Claude Codeの通信を試すときに直接接続モードになっていないか、まず画面上で確認してください。

ルールモードを使っている場合は、接続履歴でClaude Codeの接続先に適用されたルールとポリシーグループを確認します。正しいグループが表示されても、その中で選ばれているノードが停止中、遅延過多、または接続先への経路を持たない場合は失敗します。ノードのテスト結果だけで判断せず、Claude Codeの接続を発生させたときに同じノードが選ばれているか確認します。

原因を絞り込む目的で一時的にグローバルモードへ切り替え、正常なノードを選んで再試行する方法もあります。この状態で成功するなら、ルールの照合結果、ルールの並び順、またはプロキシグループの選択を調べます。テスト後は普段使うモードに戻してください。常時グローバルモードにすることは、不要な通信までプロキシに流す可能性があるため、問題の切り分けと通常運用を区別しましょう。

設定ファイルを確認する場合は、最終的なMATCHルールより前に、必要なドメイン用ルールがあるかを見ます。ルールは上から順に評価されるため、広い条件や先行するルールが接続を別のグループへ送ることがあります。サブスクリプションを更新すると設定が上書きされることもあるため、長期的な変更はクライアントが提供するオーバーライドやルール追加機能を使い、元ファイルを直接編集する前にバックアップしてください。

観察した状態 優先して確認する項目
接続履歴に何も出ない 環境変数、ポート番号、Claude Codeを起動したシェル
接続は出るがDIRECTになる ルールモード、ルール順序、接続先の照合結果
プロキシグループへ入るがタイムアウトする 選択ノード、ノードの状態、Clashのログ
curlは成功しClaude Codeだけ失敗する 起動環境、認証、API接続先の上書き設定

DNS、TLS、TUNを確認して設定を戻す

接続履歴に対象通信があり、ポリシーグループも正しいのに名前解決やTLS接続で失敗する場合はDNSと証明書の経路を調べます。まずClashのログで、接続先ドメインの解決に失敗していないか、接続先IPへ到達できているかを確認します。DNSの変更は一度に複数行わず、現在のモードと変更前の値を記録してから一項目ずつ試してください。Fake IPを使う構成では、DNS、ルール照合、コアの組み合わせによって見え方が異なるため、設定だけを見て実際の接続結果を決めつけないことが大切です。

組織のネットワークやセキュリティソフトがHTTPS通信を検査している環境では、証明書の検証エラーが出ることがあります。証明書検証を無効化したり、TLS設定を緩めたりするのではなく、エラーに示された証明書とネットワーク管理者の設定を確認してください。APIキーや認証情報を扱う通信では、信頼できない証明書を受け入れる設定は避ける必要があります。

TUNは、アプリごとのプロキシ環境変数だけでは拾えない通信も取り込める仕組みですが、Claude Codeのターミナル接続を試す最初の手順として必須ではありません。TUNを有効にすると、管理者権限、仮想インターフェース、ルート設定、DNSの挙動が関係し、問題の切り分けが複雑になることがあります。まずは通常のHTTPプロキシ指定で確認し、それで足りないアプリ通信がある場合に、使用中のクライアントとOSに合ったTUN設定を検討します。

原因を特定した後は、一時的なグローバルモードやデバッグログを通常の設定に戻し、不要な環境変数を解除します。macOSやLinuxではunset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy、PowerShellではRemove-Item Env:HTTP_PROXY, Env:HTTPS_PROXYを実行できます。最後にClashの通常のルールモードでClaude Codeを再起動し、接続履歴、選択ルール、実際の応答を再確認してください。

Clashをダウンロード