Claude Codeをターミナルから起動したのに、ログインできない、APIへの接続がタイムアウトする、またはブラウザーでは使えるのにCLIだけ失敗することがあります。原因の一つは、Clashが起動していてもターミナルの通信がプロキシを通っていないことです。Claude Codeの通信は、ブラウザーのプロキシ設定だけでは切り替わらず、起動したシェルの環境変数やClashのルーティングルールにも左右されます。この記事では、Clashのプロファイル確認から環境変数の設定、接続テスト、ログを使った切り分けまでを順番に説明します。利用可否や必要なアカウント、アクセス可能な地域は、利用者の契約・地域・ネットワーク環境やサービス提供条件によって異なります。設定を行う前に、利用条件と組織のネットワークポリシーを確認してください。
ターミナルだけ接続できない理由
Clashのシステムプロキシを有効にすると、ブラウザーなど一部のアプリは自動的にプロキシを利用します。しかし、コマンドラインアプリが同じ設定を参照するとは限りません。Claude Codeを実行したシェルがプロキシ用の環境変数を持っていなければ、通信は通常のネットワークへ直接送られることがあります。反対に、環境変数が設定済みでも、ポート番号が現在のClash設定と違っていたり、接続先がルールによってDIRECTに振り分けられたりすれば、期待した経路になりません。
最初に確認するのは、Clashが正常に起動していること、現在のプロファイルが読み込まれていること、そしてローカルのHTTPプロキシポートが有効であることです。Clash VergeやClash Verge Revでは、設定画面でポート番号とシステムプロキシの状態を確認できます。Mihomoを直接使う構成では、設定ファイルのmixed-port、またはportとsocks-portを確認してください。以下の例ではポートを7890としていますが、実際の番号はクライアントの設定に合わせます。
接続の流れは「Claude Codeを起動したシェル → ローカルのClashポート → Clashのルールとプロキシグループ → 選択したノード → 接続先サービス」です。どの段階で失敗しているかを分けて確認すると、ノードの問題と環境変数の問題を混同せずに済みます。まずClashのプロキシグループで利用可能なノードを選び、通常のブラウザー通信ではなく、後述するターミナルからのテスト結果も合わせて見ていきましょう。
Clashのプロファイルと通信ルールを確認する
Clashの画面でプロファイルが読み込まれていることを確認し、選択中のプロキシグループに利用可能なノードがあるかを見ます。ノードの遅延テストが成功していても、Claude Codeの通信がそのノードを通るとは限りません。ルールモードでは、接続先のドメインに一致するルールが先に評価され、DIRECTまたは別のグループへ振り分けられる可能性があります。接続ログに表示される接続先、マッチしたルール、送信先のプロキシグループを照合してください。
Claude Codeが接続できないときは、まずログで対象リクエストが記録されるかを確認します。記録がまったく出ない場合、環境変数が未設定、シェルの再起動が必要、またはアプリが指定したプロキシ方式を使っていない可能性があります。ログに接続が出ていてDIRECTになっている場合は、ルールセットやルールの順序を確認します。プロキシグループに接続されているのにタイムアウトする場合は、別ノードを試す、ノードの状態を確認する、ネットワーク側で該当通信が制限されていないかを調べる、という順で切り分けます。
| 確認箇所 | 見るポイント | 次の対応 |
|---|---|---|
| プロファイル | 有効な設定が読み込まれ、エラー表示がない | プロファイルを再読み込みし、設定エラーを修正する |
| ローカルポート | HTTPまたはmixed-portが有効で、番号が分かる | 環境変数のポート番号を一致させる |
| プロキシグループ | 利用可能なノードが選択されている | 別の正常なノードを選び、再テストする |
| 接続ログ | 接続先、マッチルール、DIRECTかプロキシか | ルールまたは環境変数のどちらが原因か分ける |
Mihomoの設定を自分で管理している場合は、ポートがローカルで待ち受けるように設定されているかも確認します。次は構成の一例です。すでにポート設定がある場合は、むやみに重複した項目を追加せず、現在の値を環境変数で使ってください。
mixed-port: 7890 allow-lan: false mode: rule log-level: info
ターミナルにプロキシ環境変数を設定する
Claude Codeを起動するターミナルに、ClashのHTTPプロキシを環境変数として渡します。まずは現在のシェルだけに一時設定し、接続を確認する方法がおすすめです。設定例の7890は実際のClashポートに置き換えてください。URLは端末内からClashへ接続するためのもので、通常は127.0.0.1を使います。
macOS・Linuxのシェル
zshやbashでは、次のように設定してから同じターミナルでClaude Codeを起動します。大文字と小文字の環境変数を両方指定すると、ツールや依存ライブラリによる参照方法の違いに対応しやすくなります。
export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 claude
環境変数の値が正しく入ったかは、env | grep -i proxyで確認できます。シェルを閉じると一時設定は消えます。毎回使う場合は、利用しているシェルに応じて~/.zshrcや~/.bashrcへ追加し、設定ファイルを読み込むか新しいターミナルを開きます。ただし、すべてのターミナル作業をプロキシ経由にしたくない場合は、常時設定せず、必要なときだけ設定する方法が安全です。
Windows PowerShell
PowerShellでは、現在のウィンドウに対して次のように設定できます。新しく開いたPowerShellには引き継がれないため、まずはこの方法で接続確認を行ってください。
$env:HTTP_PROXY = "http://127.0.0.1:7890" $env:HTTPS_PROXY = "http://127.0.0.1:7890" $env:http_proxy = "http://127.0.0.1:7890" $env:https_proxy = "http://127.0.0.1:7890" claude
Windows TerminalやIDEの内蔵ターミナルから起動する場合は、親アプリの起動時点ですでに環境変数が確定していることがあります。設定を変更した後も古い環境のままなら、ターミナルのタブだけでなくIDEやターミナルアプリ自体を終了して再起動してください。WSL内でClaude Codeを使う場合は、Windows側のClashポートへ接続できるかがネットワーク構成によって異なります。WSL内の127.0.0.1がWindows側を指すとは限らないため、WSLとWindowsのどちらでClashが待ち受けているかを確認し、必要に応じて到達可能なホストアドレスを設定します。
SOCKSポートしか有効にしていない構成では、プロキシURLの方式をsocks5://にする方法もあります。ただし、アプリやライブラリによって対応方式が異なるため、最初はClashのHTTPまたはmixed-portを利用するのが分かりやすい方法です。HTTPプロキシを指定する変数に、根拠なくSOCKSのポートを設定すると接続に失敗します。ポートとプロトコルの組み合わせを必ず照合してください。
接続をテストして問題を切り分ける
環境変数を設定したら、まずClashのローカルポートへ接続できることを確認します。次に、プロキシ経由のリクエストが成功するか、Clashの接続ログに記録されるかを調べます。テスト先への接続可否は地域やネットワークのポリシーによって異なるため、アクセスが許可された環境で確認してください。たとえばcurlが利用できる環境では、以下のようにプロキシを明示してリクエストできます。
curl -I --proxy http://127.0.0.1:7890 https://example.com
curlの結果が成功し、Clashのログにも接続が表示されるのにClaude Codeだけが失敗する場合は、Claude Codeを起動したシェルとテストしたシェルが同じか、起動スクリプトが環境変数を上書きしていないかを確認します。IDEから起動したプロセスは、通常のターミナルとは異なる環境変数を受け取る場合があります。また、接続ログで認証やTLSに関するエラーが見られる場合は、端末の時刻、ネットワークの証明書検査、組織が管理するTLS検査設定などを確認してください。証明書検証を無効にする設定は、セキュリティ上の問題を招くため、安易に有効化しないでください。
| 症状 | 考えられる原因 | 確認・対処 |
|---|---|---|
| 接続ログに何も出ない | 環境変数が渡っていない、ポートが違う | 変数を表示し、Clashの待ち受けポートと照合する |
| ログにDIRECTと表示される | ルールが直接接続を選んでいる | マッチしたルールを確認し、プロファイルの仕様に沿って調整する |
| プロキシ接続がタイムアウトする | ノード障害、ネットワーク制限、到達不能なポート | 別ノードを選び、ローカルポートと接続ログを確認する |
| curlは成功するがCLIは失敗する | 起動元の環境差、アプリ側の設定や認証問題 | 同じシェルで起動し、エラーメッセージとサービスの利用条件を確認する |
原因を探す間は、一度に複数の設定を変えないことが重要です。まずポートを確認し、次に環境変数、続いてClashの接続ログ、最後にノードやルールを調べます。設定を変更したら、同じテストを再実行して差分を確認してください。これにより、Clashの問題なのか、シェルからプロキシ設定が渡っていないのか、サービス側の利用条件やネットワーク制限なのかを判断しやすくなります。
安定して使うための運用ポイント
日常的にClaude Codeだけをプロキシ経由にしたい場合は、ターミナル全体へ恒久設定を追加する前に、プロジェクト用の起動スクリプトや専用のシェル設定で範囲を限定する方法を検討してください。環境変数は子プロセスにも引き継がれるため、設定したターミナルから起動する他のコマンドも同じプロキシを使う可能性があります。社内サービス、ローカル開発サーバー、プライベートネットワークの宛先までプロキシへ送ると、接続できなくなる場合があります。
そのような宛先を直接接続にする必要がある場合は、NO_PROXYやno_proxyを利用できます。ただし、対象にすべきドメインやホスト名は環境ごとに異なります。組織のポリシーを確認せず、広範囲なワイルドカードを登録するのは避けてください。Clash側のルールと環境変数側の除外設定が矛盾すると、ログの見え方が分かりにくくなるため、除外の責任をどちらに持たせるかを整理しておくと運用しやすくなります。
また、プロキシの環境変数に認証情報を含める場合、シェルの設定ファイルやコマンド履歴に秘密情報を残さないよう注意してください。今回の例は端末内のローカルClashポートを利用するもので、認証情報は含みません。接続先サービスの認証情報やAPIキーをログ、画面共有、公開リポジトリへ貼り付けないことも大切です。
要点は、Clashのプロファイルとローカルポートを確認し、Claude Codeを起動する同じターミナルに正しいプロキシ環境変数を設定し、接続ログで実際の経路を確かめることです。これらを順番に確認すれば、「Clashは動いているのにCLIだけ接続できない」問題を切り分けやすくなります。利用条件やネットワークポリシーを確認したうえで、必要な場合はClashの設定ガイドも参照し、ご自身の端末に合った構成で安全に利用してください。