1. Claude Codeだけターミナルから接続できない理由
ブラウザでは Claude が使えるのに、Claude Codeを起動すると接続エラーになる。あるいは、Clash Vergeを有効にしているはずなのに、ターミナルではタイムアウトが続く。こうした症状は、プロキシの設定が壊れているとは限りません。ブラウザとターミナルは別のプロセスであり、OSのシステムプロキシを参照するか、シェルの環境変数を読むかはアプリごとに異なります。つまり「デスクトップ全体でプロキシがオン」という表示だけでは、Claude Codeの通信経路まで確認できたことにはなりません。
切り分けでは、まずClash Vergeのローカルポートへ接続できるか、次にシェルにプロキシ環境変数が渡っているか、最後にClaude Codeの通信が意図したルールと策略グループを通っているかを順番に見ます。いきなりTUNや複雑なルールを追加するより、ひとつずつ確認したほうが原因を特定しやすく、ほかのアプリへの影響も抑えられます。
Claude Codeは、利用形態や認証方法によって接続先が異なることがあります。API通信の代表例として api.anthropic.com が挙げられますが、サインインやセットアップ、パッケージの取得では別のホストが関与する場合もあります。ここで紹介するドメインは確認の出発点です。最終的には、実際にClaude Codeを起動したときのClash Vergeログを見て、接続先と選択されたルールを確かめてください。
2. Clash Vergeでモードとポートを確認する
最初にClash Vergeを開き、意図したプロファイルが有効か確認します。複数のプロファイルやローカル設定を使っていると、編集した設定と稼働中の設定が別になっていることがあります。プロファイルを切り替えた直後や更新した直後は、現在アクティブなものを見直してください。画面上の項目名はバージョンによって変わることがあるため、設定値と接続ログを合わせて判断するのが確実です。
- 接続モード:まずはRuleモードを選びます。Globalモードは通信全体を同じ策略へ送るため、原因の切り分けには使えても、通常運用では意図しない通信までプロキシ経由になることがあります。
- Mixed Port:ポート番号を確認します。初期値が常に同じとは限らないので、例に出てくる
7890をそのまま使わず、Clash Vergeの実際の表示と一致させてください。 - 策略グループ:ログに表示されるグループ名と、利用可能なプロキシノードを確認します。ルールに指定したグループ名がプロファイル内に存在しないと、設定を読み込めないことがあります。
- システムプロキシとTUN:システムプロキシは対応アプリの通信を受けますが、すべてのCLIが参照するとは限りません。TUNはより広い範囲を扱う方式なので、環境変数での確認後も対象プロセスを捕捉できない場合に、短時間の検証として試します。
この段階では、Clash Vergeのログを開いた状態でClaude Codeを起動し、接続先のドメイン、通信のルール、利用された策略グループを確認します。接続記録がまったく増えない場合は、シェルからプロキシへ接続できていない、別のClashインスタンスやポートを参照している、あるいはプロセスが環境変数を引き継いでいない可能性があります。ログに通信が現れているのに失敗する場合は、選択されたグループやノードの状態、接続先ホストを次に確認します。
3. ターミナルに環境変数を設定する
ターミナルアプリは、OSのシステムプロキシ設定を自動で使わないことがあります。その場合は、Clash VergeのMixed Portを HTTP_PROXY と HTTPS_PROXY に指定します。ポート番号は必ず自分の設定に置き換えてください。HTTPS通信であっても、ローカルのプロキシがHTTP CONNECT方式を受け付ける構成では、URLのスキームを http:// にします。
macOS・Linuxの例
zshやbashでは、現在のターミナルセッションに次のように設定できます。小文字の変数を参照するツールとの互換性も考慮し、大文字と小文字の両方を揃えます。
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=http://127.0.0.1:7890
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export all_proxy="$ALL_PROXY"
claude
これは例として 7890 を使用しています。実際のMixed Portに合わせて変更し、設定後は同じターミナルからClaude Codeを起動します。設定を毎回有効にしたい場合は、利用中のシェルに応じて ~/.zshrc や ~/.bashrc へ追加し、新しいターミナルを開くか設定ファイルを読み込み直します。共有端末や一時的なテストでは、まず現在のセッションだけで試すのがおすすめです。不要になったときは unset HTTP_PROXY HTTPS_PROXY ALL_PROXY http_proxy https_proxy all_proxy で解除できます。
Windows PowerShellの例
PowerShellでは、次のように現在のセッションに設定できます。変数は、そのPowerShellから起動したプロセスへ引き継がれます。すでに開いているターミナルやIDEの統合ターミナルには自動反映されないため、設定後に同じウィンドウからClaude Codeを起動してください。
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "http://127.0.0.1:7890"
claude
プロキシを使わない社内ホストやローカルアドレスがある環境では、必要に応じて NO_PROXY も設定します。ただし、設定範囲を広げすぎると、プロキシを通したい宛先まで直接接続になることがあります。何を除外するかはネットワーク管理者の方針に合わせ、原因が分からない段階で大きな除外リストを追加しないようにしましょう。
4. 接続テストとルールの確認
Claude Codeを起動する前に、まずローカルポートへ接続できることを確かめます。次の例ではHTTPプロキシ経由でHTTPSの接続を試します。ポート番号は実際の設定に合わせてください。
curl -I -x http://127.0.0.1:7890 https://api.anthropic.com
ここでHTTPの応答が返ることは、必ずしもAPIが正常に利用できることを意味しません。認証情報のないリクエストでは、401や404などが返る場合もあります。重要なのは、名前解決やTLS接続の前段階でタイムアウトしていないか、Clash Vergeのログに通信が記録されているかです。接続拒否が出るなら、Mixed Portの値やClash Vergeの稼働状況を見直します。プロキシを指定したテストは通るのにClaude Codeが失敗するなら、環境変数を起動プロセスが受け取っているかを調べます。
ルールは、確認できたドメインから小さく追加します。以下は概念例であり、PROXY は自分のプロファイルに存在する策略グループ名へ置き換えます。既存ルールより後ろに追加すると、先行ルールに先に一致して想定した経路にならないことがあるため、ルールの順序にも注意してください。
rules:
- DOMAIN,api.anthropic.com,PROXY
- DOMAIN-SUFFIX,anthropic.com,PROXY
- MATCH,DIRECT
プロファイルによってはルールが購読設定から生成されており、元の設定を直接編集すると更新時に上書きされる場合があります。Clash Vergeで利用しているローカル上書きやルール編集の方法を確認し、変更箇所を把握できる形で管理してください。DOMAIN-KEYWORD,anthropic のような広い条件を最初から使うと、必要のないホストまで対象になる可能性があります。まずログに出た完全一致のホストや適切なサフィックスを使い、追加するたびにClaude Codeの動作とログを再確認するのが安全です。
APIのホストがPROXYへ向かっているのに認証で失敗する場合は、通信経路以外の原因も考えられます。アカウントや利用プラン、認証状態、APIキーの設定、サービス側の利用条件はプロキシ設定とは別に確認してください。APIキーをターミナルのコマンドへ直接書いたり、ログや画面共有へ貼り付けたりするのは避け、秘密情報として管理します。
5. 症状別の切り分けとFAQ
ブラウザは使えるのにClaude Codeだけ失敗する
ブラウザの通信が通ることは、ターミナルの設定が通る証拠ではありません。Clash VergeのMixed Port、ターミナルでの環境変数、Claude Codeを起動した親プロセスの順に確認します。特にIDEの統合ターミナルは、OSのターミナルとは異なるシェル設定や環境変数を持つことがあります。まずOS標準のターミナルで同じ設定を試し、結果が違うか比較すると、IDE側の環境に原因があるか判断しやすくなります。
WSLから接続できない
WSL2では、Linux側の 127.0.0.1 が常にWindows側のClash Vergeを指すとは限りません。Windows上で動くプロキシへ接続する場合は、WSLのネットワークモードやホストへの到達方法を確認し、WSL内から実際に到達できるアドレスとポートを使ってください。Windows側のポート番号をそのまま設定して接続拒否になる場合は、まずWSLからホストへの疎通を切り分けます。TUNを有効にする場合も、既存VPNや仮想ネットワークとの競合がないかを確認してから短時間で検証してください。
接続がタイムアウトする、途中で切れる
Clash Vergeのログで、要求がどのルールに一致し、どの策略グループを選んだかを確認します。別ルールでDIRECTへ流れているならルール順序や対象ドメインを見直し、意図したグループに到達しているのに切断されるなら、ノードの状態やネットワーク品質を確認します。認証エラーやサービス側の利用制限は、ネットワークタイムアウトとは異なるため、エラー内容を区別して記録しましょう。毎回同じ操作で再現するか、別のネットワークでも起きるかを比べると、原因を狭められます。
環境変数を設定すればシステムプロキシは不要ですか?
Claude Codeを起動するターミナルに正しい環境変数が設定されていれば、そのCLIの通信をプロキシへ送る方法として利用できます。ただし、設定はそのターミナルから起動したプロセスに適用されるため、ブラウザや別のターミナルまで一括で切り替えるものではありません。利用するアプリと目的に応じて、システムプロキシと環境変数を使い分けてください。
最初からTUNを有効にすべきですか?
通常は、Mixed Portとシェルの環境変数を先に確認するほうが原因を追いやすくなります。それでもプロセスがプロキシを使わない場合や、環境変数を設定できないアプリを含めて通信を捕捉したい場合に、TUNを検証します。TUNは通信範囲が広いため、競合するVPNやルート変更がないかを確認し、必要な場面に限定して使うのがよいでしょう。
ルールへ追加するドメインは何ですか?
まずはログで確認した接続先を使います。api.anthropic.com はAPI通信を調べる際の出発点ですが、認証やセットアップなどの経路は利用方法によって異なります。固定の一覧だけに頼らず、Claude Codeの起動中にClash Vergeへ記録されたドメインと選択ルールを確認してください。
一般的なVPNアプリは接続全体をまとめて切り替える設計が中心で、CLIごとの環境変数やドメイン単位の経路を追いにくいことがあります。一方、Clash VergeはMixed Port、プロファイル、ルール、接続ログを使って、Claude Codeだけを段階的に切り分けられます。広い範囲を一律に切り替えるのではなく、必要な通信先と起動環境を確認しながら設定したい方は、対応クライアントを選んで導入し、利用環境に合った手順から始めてください。
Clash Vergeの設定を始めましょう
利用する端末に合ったクライアントを選び、プロキシとルールの設定を確認できます。