1. Claude Codeだけ接続できないときに見るポイント
ブラウザではClaudeを使えるのに、ターミナルから起動したClaude Codeだけがタイムアウトする。あるいは、Clashを起動しているのに認証やモデルへのリクエストが失敗する。このような場合、最初に疑いたいのはClash全体の障害ではなく、ターミナルのプロセスがプロキシ設定を受け取っていないことです。ブラウザはOSのシステムプロキシを利用できても、シェルから起動するCLIは別途環境変数が必要なことがあります。
原因を切り分けるときは、(1) Clashのプロキシポートが待ち受けているか、(2) 起動したシェルに HTTP_PROXY と HTTPS_PROXY が設定されているか、(3) Claude Codeの通信がClashのログに現れるか、の順に確認します。いきなり設定ファイルのルールを大きく変更したり、TUNを常時有効にしたりするより、ひとつずつ確認した方が原因を特定しやすくなります。
本記事では、Clash VergeやClash Verge RevなどMihomo対応クライアントを例に、ターミナルへプロキシを渡す方法と、接続エラーをログから追う手順を説明します。画面の名称や初期ポートはクライアント、OS、プロファイルによって異なるため、例の値をそのまま使うのではなく、実際の設定画面に表示されている値と照合してください。
2. Clashのモードとプロキシポートを確認する
まずClashで有効になっているプロファイルを確認し、プロキシの待ち受けポートを調べます。多くの構成ではHTTP通信にもHTTPS通信にも利用できるMixed Portが設定されています。例では 7890 を使いますが、実際の番号はクライアントの設定画面や設定ファイルの mixed-port を確認してください。別のポートが表示されているなら、以降の例もその番号に置き換えます。
- Ruleモード:ルールに基づいて通信先ごとに経路を選びます。通常の開発用途では、まずこのモードでログを確認します。
- Globalモード:対象通信を選択したグループへまとめて送ります。経路の確認には便利ですが、他の通信まで変わるため、検証後は元に戻します。
- Directモード:プロキシを経由しないため、外部ネットワークの条件によってはClaude Codeが接続できません。
- TUNモード:環境変数を読まないプロセスも含め、より広い範囲の通信を扱えます。まずは明示的な環境変数で試し、それで解決しない場合の切り分けに使います。
Ruleモードでは、プロファイルのルールと策略グループの組み合わせによって、同じホストでも実際の経路が異なる場合があります。Clashの接続ログを開いた状態でClaude Codeを一度だけ起動し、通信先のドメイン、選択されたルール、使用されたグループを記録してください。ログに通信がまったく出ない場合は、まずシェルの環境変数、ポート番号、Clashが待ち受けているアドレスを見直します。
3. ターミナルにHTTP_PROXYを設定する
Claude Codeを起動するシェルでプロキシ環境変数を設定します。プロキシアドレスは通常、Clashが動作している端末のループバックアドレスです。以下はポートが 7890 の場合の例です。設定が反映される範囲は、コマンドを入力したシェルと、そこから起動した子プロセスです。
macOS・Linux・WSLの例
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 Codeを起動します。毎回入力するのが手間なら、使用しているシェルに合わせて ~/.zshrc や ~/.bashrc に追加し、設定ファイルを読み直してください。ただし、会社の端末や共有環境では、環境変数をシェル設定へ恒久保存する前に運用ルールを確認します。不要になったら unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy で解除できます。
Windows PowerShellの例
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:http_proxy = $env:HTTP_PROXY
$env:https_proxy = $env:HTTPS_PROXY
PowerShellの環境変数は、そのウィンドウ内で起動したプロセスに引き継がれます。新しく開いたターミナルやIDEの統合ターミナルには設定が引き継がれていないことがあるため、どの画面からClaude Codeを起動したかも確認してください。Windows上のWSLからClashを利用する場合、WSL内の 127.0.0.1 がWindows側のClashを指すとは限りません。WSLのネットワーク構成に応じたホスト側アドレスを確認し、到達可能なアドレスとポートを設定します。
プロキシ用のユーザー名やパスワードをURLへ含める必要がある環境では、コマンド履歴やプロセス情報に認証情報が残る可能性があります。まずClash側でローカル接続の認証設定を確認し、認証情報を含むURLをシェル設定や共有スクリプトへ不用意に書かないでください。
4. 経路を確認してClaude Codeを起動する
環境変数を設定したら、いきなり複数の操作をせず、同じターミナルからHTTPS接続を一度確認します。たとえば curl -I https://api.anthropic.com を実行し、Clashの接続ログにも対応する通信が現れるか確認します。HTTPの応答コードが返ることと、APIとして認証済みの応答が得られることは別です。この確認は、プロキシ経由でTLS接続まで進めるかを調べるためのもので、APIキーの有効性やClaude Codeの認証状態を判定するものではありません。
続いてClaude Codeを起動し、失敗した時刻とClashログの時刻を照合します。ログに対象通信があり、選択グループも想定どおりなら、ノードの応答、DNS、TLS接続などを次に調べます。ログに通信はあるもののDIRECTになっている場合は、Ruleモードでルール順序と策略グループを確認します。接続先のドメインが環境ごとに異なることもあるため、特定のホスト名だけを固定リストとして扱わず、実際のログを出発点にしてください。
ルールを追加する場合は、購読プロファイルを直接書き換える前に、クライアントのローカル上書き機能などを利用できるか確認します。グループ名はプロファイルに存在する実名へ置き換え、より広いルールや末尾の MATCH より前に、対象ドメインのルールを配置します。たとえば、観測された通信先に限って次のような形で追加できます。
rules:
- DOMAIN-SUFFIX,anthropic.com,PROXY
- MATCH,DIRECT
この例の PROXY は説明用の名前です。プロファイル内に同名の策略グループがなければ、そのままでは使えません。また、anthropic.com を広くプロキシへ送ることが意図に合わない場合は、ログから確認できたドメインだけを対象にする方法もあります。設定を変更したあとは、同じ操作を再実行し、ログ上のルール名と経路が変化したかを確認します。
5. よくある接続エラーを切り分ける
- 接続拒否・接続できない:Clashが起動しているか、設定したポートとMixed Portが一致しているかを確認します。WSLやコンテナ内から使う場合は、ループバックアドレスがClashのある環境を指しているかも確認してください。
- タイムアウトする:Clashログで接続先と利用グループを確認し、別の利用可能なノードでも再現するかを比較します。ログに該当通信がなければ、Claude Codeを起動したターミナルの環境変数が有効かを見直します。
- 401・403などの応答が返る:プロキシ接続自体は成立している可能性があります。Claude Codeのログイン状態、アカウントや利用条件、API設定を別々に確認してください。経路の問題と認証・権限の問題を同じものとして扱わないことが大切です。
- 証明書エラーが出る:システム時刻、TLS検査を行う社内プロキシ、証明書ストアを確認します。証明書検証を無効にする設定は安全性を下げるため、安易な回避策として使わないでください。
- ブラウザは使えるがCLIだけ失敗する:ブラウザのシステムプロキシ設定だけでは、ターミナルのプロセスに設定が渡らない場合があります。環境変数を設定した同一シェルからCLIを起動し、IDEの統合ターミナルも別途確認します。
切り分け中は、環境変数を設定したターミナル、Clashのモード、プロファイル名、接続先、ログに表示された策略グループを記録すると、再現条件を整理できます。トークン、APIキー、認証ヘッダーなどの秘密情報はログや質問文に貼らないでください。共有する必要がある場合は、ホスト名やエラー時刻などの診断に必要な情報だけを残し、認証情報を必ず伏せます。
設定を元に戻すときは、シェルの環境変数を解除し、検証用に変更したローカルルールを削除または無効化します。TUNを一時的に使った場合は、確認が終わったあとに通常の状態へ戻し、他のVPNや仮想ネットワークとの競合が残っていないかも確認してください。変更前後のログを比較すれば、改善したのが環境変数なのか、ルールなのか、ノードなのかを判断しやすくなります。
6. よくある質問
HTTP_PROXYとHTTPS_PROXYの両方が必要ですか?
環境によって認識される変数名は異なるため、両方を同じClashのHTTPプロキシURLに設定する方法が一般的です。小文字の変数名も参照するツールがあるため、必要に応じて大文字・小文字をそろえて設定します。利用中のクライアントやランタイムが独自のプロキシ設定を持つ場合は、その仕様も確認してください。
Globalモードにすれば解決しますか?
Globalモードは経路を単純化して比較する一時的な診断には使えますが、端末全体の通信先が同じグループへ送られるため、恒久設定として常に適切とは限りません。まずRuleモードでログを確認し、必要な通信だけを意図したグループへ送る構成を目指してください。
TUNを有効にしないとClaude Codeは使えませんか?
必ずしも必要ではありません。Claude Codeを起動するシェルにHTTPプロキシ環境変数を設定し、ClashのMixed Portへ接続できれば、TUNなしで利用できる場合があります。環境変数が効かないプロセスやネットワーク構成の問題を調べるときに、TUNを短時間の比較手段として試します。
curlが失敗したら、Claude Code側の問題ですか?
curlも失敗する場合は、まずプロキシのポート、経路、DNS、ノードなど、Claude Codeより手前の接続を調べます。一方、curlが接続できてもClaude Codeの認証や設定に問題が残ることはあります。curlの結果だけで判断せず、ClashログとClaude Codeのエラーを同じ時刻で照合してください。
一般的なVPNアプリは端末全体をまとめて経由させるため、CLIだけを切り分けたいときに他の通信まで影響することがあります。また、シェルに環境変数を設定するだけでは、ルールや接続先の確認が難しい場合もあります。ClashならMixed Portでターミナルの経路を明示し、Ruleモードと接続ログを使って通信先ごとに確かめられます。開発用の経路を自分で管理したい場合は、利用環境に合うクライアントから始めてみてください。
Clashで開発環境を整えましょう
使っているOSに合うクライアントを選び、ターミナルのプロキシ経路を確認してみてください。