配置 2026年9月15日

Claude CodeをClash Vergeで使う設定ガイド:接続を安定させる方法

Claude Codeはコマンドラインからコード作成やプロジェクト操作を支援する注目の開発ツールです。Clash Vergeを使った基本設定と通信トラブルの確認方法を、初心者にも分かりやすくまとめます。

Dockerプロキシ GitHub加速 高度な設定 YAML

1. Claude CodeとClash Vergeを組み合わせる理由

Claude Codeは、ターミナルからコードの作成、修正、テスト実行、リポジトリの調査などを支援する開発ツールです。ブラウザで利用するAIサービスと違い、実際の作業ではシェル、Git、パッケージマネージャー、エディタの統合ターミナルなど、複数のプロセスが同時に通信します。そのため「ブラウザではClaudeが開くのに、Claude Codeだけログインできない」「質問は送れるが、長い処理でタイムアウトする」といった入口ごとの不一致が起こりやすくなります。

ここでClash Vergeを使うと、システム全体を常時プロキシへ固定するのではなく、Anthropic関連の通信だけを特定の策略グループへ送る構成を作れます。開発用のGitサーバーや社内サービスはDIRECT、Claude Codeに必要な外部ホストはPROXYというように分ければ、不要な通信を巻き込まず、問題が起きたときもログから原因を追いやすくなります。本稿では、初心者が確認しやすい順番で、プロファイル、ルール、環境変数、DNS、ログの見方を整理します。

2. Claude Codeで意識したい通信経路

Claude Codeの通信先は、利用する認証方式やバージョン、実行環境によって変わります。最初からすべてのドメインを推測して登録するのではなく、実際の接続ログを観測しながら必要なものだけを追加することが重要です。代表的な入口は、次のように分けて考えると整理しやすくなります。

Clash Vergeの接続ログを開いた状態でClaude Codeを起動し、ログイン、簡単な質問、ファイルの読み取り、テスト実行を順番に行います。どの操作で新しいホストが現れたかを記録すると、必要なルールを段階的に作成できます。DOMAIN-KEYWORD,anthropic のような広い条件は便利に見えますが、関連サービス以外までプロキシへ送る可能性があるため、最初は完全一致またはドメインサフィックスを優先してください。

3. Clash Vergeで先に確認する設定

ルールを書き換える前に、Clash Vergeで現在どのプロファイルが有効なのかを確認します。購読プロファイルを編集したつもりでも、実際には別のローカルプロファイルが使われていることがあります。画面上でアクティブ表示になっているプロファイル名と、編集対象のYAMLファイルが一致しているかを見てください。

次に確認するのはモードです。通常のデスクトップアプリとターミナルは、まずRuleモード+システムプロキシで試すのが分かりやすい構成です。Claude Codeがシステムプロキシを読まない場合は、後述する環境変数を使います。それでも特定の子プロセスだけがDIRECTになる場合に限り、短時間だけTUNを有効にして挙動を比較します。

システムプロキシとTUNを常時同時に使うと、他のVPN、Docker、WSL、企業向けセキュリティソフトとルートが競合することがあります。症状が変わった場合も「直った」と判断する前に、どの設定変更が効いたのかを一つずつ戻して確認してください。再現条件を残しておけば、後でClash Vergeを更新した際にも同じ切り分けを行えます。

4. Anthropic向けルールの基本例

以下は考え方を示すための概念例です。PROXYとDIRECTは、利用中のサブスクリプションに存在する策略グループ名へ置き換えてください。実際のルールはプロファイルの既存ルールより適切な位置に追加し、最後の既定ルールに先に処理されないよう注意します。

# Replace group names with those in your profile
rules:
  - DOMAIN,api.anthropic.com,PROXY
  - DOMAIN-SUFFIX,anthropic.com,PROXY
  - DOMAIN-SUFFIX,github.com,DIRECT
  - DOMAIN-SUFFIX,githubusercontent.com,DIRECT
  - DOMAIN-SUFFIX,npmjs.org,DIRECT
  - GEOIP,JP,DIRECT
  - MATCH,DIRECT

この例をそのまま恒久設定にするのではなく、Clash Vergeのログに表示された実際のホストと照合してください。認証だけ失敗する場合は、APIホストとは異なるログイン関連ドメインがDIRECTになっている可能性があります。逆に、Claude Codeは動くもののGit操作だけ遅くなった場合は、Anthropic用のルールがGitHubやパッケージ配信まで巻き込んでいないか確認します。

ルールの順番も重要です。社内ドメインやローカルネットワークをDIRECTにする行を先に置き、その後にAnthropic関連のPROXY行を置きます。広いDOMAIN-SUFFIX,comやキーワード条件を上位に置くと、開発環境全体の通信が同じ出口へ流れ、速度低下や証明書エラーの原因になります。

5. ターミナルへプロキシを明示する方法

Clash VergeのMixed Portが、例として7890の場合、Claude Codeを起動するシェルへプロキシを明示できます。macOSやLinuxでは、まず次のように設定します。

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

設定後は、Claude Codeを起動する前に同じターミナルから接続テストを行います。たとえば、対象ホストへヘッダーだけ送る確認では、TLS接続が成立するか、名前解決がどちら側で行われているかを把握できます。テストが失敗した場合は、Claude Codeの設定を疑う前に、Clash VergeのMixed Portが待ち受けているか、選択中の策略グループに利用可能なノードがあるかを確認してください。

Windows PowerShellでは、同じセッション内で次のように設定できます。

$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"

IDEの統合ターミナルは、通常のターミナルと環境変数が異なる場合があります。Visual Studio CodeやJetBrains系IDEからClaude Codeを実行するなら、IDEを再起動した後に環境変数を確認し、同じコマンドを統合ターミナルで試してください。シェルスクリプト、タスクランナー、Dockerコンテナから起動する場合は、それぞれ別の環境として扱う必要があります。

6. DNS、TUN、長時間処理のトラブルシューティング

プロキシ設定が正しく見えても接続できないときは、DNSの経路を確認します。Clash VergeのDNS設定、OSのリゾルバ、企業ネットワークのDNSがそれぞれ異なると、アプリが解決したIPとClashがルール判定に使う名前の対応がずれることがあります。fake-ipを利用している場合は、接続ログに想定したドメイン名が表示されているかを確認し、必要に応じて公式ドキュメントを参照しながら特定ドメインを除外します。

「ログイン画面は開くが、その後戻ってこない」という症状では、ブラウザの認証リダイレクト、既定ブラウザ、Cookie、認証ホストのルールを分けて確認します。プライバシー保護拡張や広告ブロッカーを一時的に無効にしたシークレットウィンドウで再試行すると、プロキシの問題かブラウザ側の問題かを切り分けやすくなります。認証URLが別のブラウザで開いている場合、元のCLIプロセスが待機したままにならないかも見てください。

長いコード生成や複数ファイルの解析だけが途中で止まる場合は、出口ノードの混雑、接続維持時間、瞬間的なパケットロスを疑います。短い質問、長めの質問、ファイル操作の順に試し、どの段階で切断するかを記録します。TUNで改善する場合は、CLIが環境変数を無視している可能性がありますが、TUNを使えば必ず安定するとは限りません。競合するVPNを止め、まず一つの経路だけで再現性を確認することが大切です。

7. APIキーと開発環境を守る運用

Claude Codeをプロキシ経由で使う場合、通信が通ることだけでなく、認証情報の扱いも確認してください。APIキーをシェル履歴、共有ログ、スクリーンショット、リポジトリの設定ファイルへ直接書くのは避け、OSの環境変数や認証ストアなど、プロジェクト外で管理できる方法を使います。Clash Vergeの接続ログを調査用に保存する場合も、URLのクエリ、ヘッダー、プロジェクト名などの機密情報が残っていないか確認しましょう。

また、Claude Codeに作業を依頼するリポジトリの範囲を明確にします。秘密鍵、環境変数ファイル、顧客データ、未公開の設計資料が同じ作業ディレクトリにある場合は、読み取り対象を分ける、不要なファイルを除外する、アクセス権を最小化するといった対策が必要です。Clash Vergeは通信経路を制御するツールであり、送信内容そのものを安全に判断する機能ではありません。プロキシ設定と開発者側の情報管理を別の責任範囲として考えてください。

8. よくある質問

ブラウザでClaudeが使えるのに、Claude Codeだけ失敗するのはなぜですか?

ブラウザはOSのシステムプロキシや認証情報を自動的に利用しますが、CLIは環境変数を必要とする場合があります。まずMixed Port、HTTP_PROXY、HTTPS_PROXY、そしてClash Vergeの接続ログを確認してください。

Claude Codeを使うにはTUNが必須ですか?

必須ではありません。システムプロキシと環境変数で通信できるなら、まずその構成を使う方が切り分けやすく、他のアプリへの影響も小さくなります。TUNはプロキシを認識しないプロセスがある場合の追加手段です。

AnthropicのドメインをすべてPROXYにしても問題ありませんか?

動作確認の短い期間なら切り分けに役立ちますが、恒久運用ではログに現れたホストだけを対象にする方が安全です。Git、社内サービス、パッケージレジストリまで不要に同じ出口へ送らないよう、ルールを狭く保守してください。

長い処理だけタイムアウトするときは何を見ればよいですか?

ノードの混雑、DNSの不一致、TUNや他のVPNとの競合、IDEと通常ターミナルの環境差を順に確認します。短い処理と長い処理を同じ時間帯に比較し、Clash Vergeのログで切断時刻と接続先を記録すると原因を絞り込めます。

ブラウザ拡張や単純な環境変数だけで運用する方法は手軽ですが、CLI、認証、更新、長時間通信が混在すると、どのプロセスがどの経路を使ったのか分かりにくくなります。Clash Vergeなら、接続ログを見ながらAnthropic関連の通信だけを分流し、Gitや社内サービスはDIRECTに残す設計が可能です。Claude Codeの設定を毎回手作業で切り替えるより、ルールと検証手順を一度整理しておく方が、開発環境全体を安定して保ちやすくなります。必要なプラットフォーム向けクライアントを確認したい場合は、用途に合うClash環境を選べるダウンロードページをご利用ください。

Clashをダウンロードして設定を始める →

さっそく使ってみましょう

Claude CodeのCLI通信を含め、用途に合わせたプロキシ環境をClashで整えられます。