1. インストール前:システム要件と WebView2 ランタイム
Clash Verge の Windows クライアントは、設定画面の描画に WebView2 を使用します。WebView2 Runtime がシステムにないと、アプリが起動しない、または真っ白なウィンドウが表示されることがあります。インストール段階で最初につまずきやすいポイントです。
落とし穴 1:WebView2 ランタイムがない
症状:アプリアイコンをダブルクリックしてもウィンドウが真っ白なまま、または WebView2 Runtime がありませんというメッセージが出てすぐ落ちる。
原因:Windows 11 と 2022 年以降の Windows 10 更新プログラムには通常 WebView2 が組み込まれています。それより前の Windows 10 では手動インストールが必要です。
対処:Microsoft 公式サイトから WebView2 Runtime の x64 オフラインインストーラーをダウンロードし、インストール後に Clash Verge を開き直します。システムの再起動は不要です。
システム要件:
- Windows 10 バージョン 1809(ビルド 17763)以上、または Windows 11
- Intel / AMD デバイスは x64 インストーラー、ARM デバイスは arm64 インストーラーを選択
- メモリ使用量は約 200 MB。4 GB のメモリがあれば快適に動作します
インストーラーは公式ダウンロードページからのみ入手してください。サードパーティのダウンロードサイトはファイルが古く、出所も不明なため使用しないでください。
2. Clash Verge のインストール:パス、権限、サービスモード
インストール手順:
- インストーラーを実行し、インストール先を選択して「デスクトップにショートカットを作成」にチェックを入れる
- 「インストール」をクリックし、進捗バーが完了するまで待つ
- 初回起動後に「設定」→「サービスモード」を開き、「インストール」をクリックする
落とし穴 2:インストール先パスに日本語やスペースが含まれている
症状:サービスモードのインストールに失敗する、または TUN モードを有効にしても仮想ネットワークアダプターが作成されない。
原因:Windows サービスの登録と仮想ネットワークアダプターのドライバーは、非 ASCII パスへの対応が不完全です。
対処:デフォルトのパス C:\Program Files\Clash Verge を使用するか、英数字のみでスペースを含まないパスに変更します。すでに日本語パスにインストールしている場合は、アンインストールしてから再インストールしてください。
落とし穴 3:サービスモードのインストールに失敗する
症状:「サービスモードをインストール」をクリックすると「権限が不足しています」または「インストールに失敗しました」と表示される。
原因:現在のアカウントが管理者ではない、またはセキュリティソフトがサービス登録をブロックしています。
対処:Clash Verge のアイコンを右クリックして「管理者として実行」を選び、「設定」→「サービスモード」から再試行します。それでも失敗する場合は、セキュリティソフトのシステム保護を一時的に無効にして、インストール完了後に再度有効にしてください。
サービスモードにすると、mihomo カーネルが Windows サービスとして動作します。TUN モードはサービスモードに依存するため、有効にしておけば起動のたびに UAC の許可ダイアログが出ることもありません。この手順は省略しないでください。
3. サブスクリプションの取り込み:リンク形式と解析失敗の対処
「サブスクリプション」ページで「新規作成」をクリックし、名前を入力してサブスクリプションリンクを貼り付け、「確認」をクリックします。クライアントがリンクの内容を取得し、ノード一覧として解析します。
落とし穴 4:サブスクリプションの解析に失敗する
症状:取り込み後に「解析に失敗しました」「サブスクリプションが空です」と表示される、またはノード一覧が 0 件になる。
順番に確認してください:
- リンクが期限切れではないか:ブラウザでサブスクリプションリンクを直接開いてみる。401、403、または「期限切れ」と表示されたら、プロバイダーの管理画面でリンクを再生成する
- 返ってくる内容が YAML か:ブラウザで開くと
proxies:で始まるテキストが表示されるはず。JSON や sing-box 形式が返ってくる場合は、プロバイダーの管理画面で Clash Meta 形式のサブスクリプションに切り替えて取り込み直す - サブスクリプションのドメインにアクセスできるか:ネットワーク環境によってはサブスクリプションサーバーに直接接続できないことがある。先にシステムプロキシを有効にしてから、サブスクリプションカードの「更新」をクリックして再試行する
サブスクリプションリンクの形式は通常次のとおりです:
https://example.com/api/v1/client/subscribe?token=xxxxxxxxサブスクリプションリンクの取得が行われるのは、取り込み時と手動更新時だけです。プロバイダー側でプランを変更したりリンクを再発行した場合は、サブスクリプションカードの「更新」をクリックして再取得しないと、ノード一覧は変わりません。
取り込みに成功したら、「プロキシ」ページでノードまたはポリシーグループを選択します。Clash Verge は mihomo カーネルを使用しているため、proxy-providers や rule-providers といった Clash Meta の拡張フィールドも問題なく解析できます。
4. システムプロキシの有効化:ポート競合とブラウザ拡張機能
Clash Verge のデフォルトの混在ポートは 7897 で、HTTP と SOCKS5 の両方のプロキシを提供します。有効化するには「設定」→「システムプロキシ」でスイッチをオンにします。システムプロキシは Windows の「インターネットオプション」に書き込まれるため、システムプロキシを参照するアプリはすべてプロキシ経由になります。
落とし穴 5:システムプロキシを有効にしてもブラウザが直接接続する
原因 1:ブラウザに SwitchyOmega などのプロキシ拡張機能が入っていて、拡張機能がプロキシ設定を管理しているため、システムプロキシが無視されています。
原因 2:7897 ポートが他のプログラムに使用されていて、mihomo カーネルが起動に失敗しています。
対処:
- ブラウザのプロキシ拡張機能を無効にするか削除して、ブラウザがシステムプロキシに従うようにする
- コマンドラインでポートの使用状況を確認する:
netstat -ano | findstr 7897 - 出力が空でなく、プロセスが Clash Verge 以外の場合は、「設定」→「ポート」で混在ポートを変更してからアプリを再起動する
- ブラウザを再起動し、ip.sb にアクセスして出口 IP を確認する
システムプロキシのスイッチをオンにした後、ブラウザでページが開けなくなった場合は、いったんスイッチをオフにしてから上記 2 つの手順で確認してください。オン・オフを繰り返すのは避けましょう。
5. TUN モードへの切り替え:仮想ネットワークアダプターと DNS 上書き
TUN モードは仮想ネットワークアダプターを介してシステムのすべての IP トラフィックを引き受け、アプリがプロキシ設定を読み取る必要がありません。コマンドラインツール、ゲーム、UDP を使うアプリはシステムプロキシでは漏れやすいですが、TUN モードに切り替えればすべて対象になります。
有効化の条件:サービスモードがインストール済みであること。有効化するには「設定」→「TUN モード」でスイッチをオンにします。初回は Windows から仮想ネットワークアダプターのインストール確認が表示されるので、「許可」をクリックしてください。
落とし穴 6:TUN モードを有効にした直後にオフになる
原因 1:サービスモードがインストールされていない、またはインストールに失敗している。
原因 2:仮想ネットワークアダプターのドライバーがセキュリティソフトに隔離されている。
対処:
- 「設定」→「サービスモード」が「インストール済み」になっているか確認する
- 「デバイスマネージャー」→「ネットワークアダプター」を開き、Clash Verge の仮想ネットワークアダプターが存在するか確認する
- セキュリティソフトの隔離領域からブロックされたドライバーファイルを復元し、Clash Verge を再起動する
TUN モードを有効にした後、システムプロキシのスイッチはオンでもオフでも構いません。両方を有効にしている場合、ブラウザはシステムプロキシ、それ以外のトラフィックは仮想ネットワークアダプターを通るため、互いに干渉しません。
TUN モードでは DNS 上書きも同時に有効にするのがおすすめです:「設定」→「DNS 上書き」→ Fake-IP を有効にします。mihomo が DNS 解決を引き受けることで、一部アプリの DNS クエリがプロキシを迂回して漏れるのを防ぎます。mihomo のデフォルトの Fake-IP レンジは 198.18.0.1/16 で、手動で変更する必要はありません。
6. サービスモード、自動起動、ファイアウォール
サービスモードのインストールが完了すると、Clash Verge はシステムサービスとして動作するため、ユーザーのログイン状態に関係なく自動起動します。
自動起動:「設定」→「自動起動」でスイッチをオンにします。起動後にプロキシが効いていない場合は、タスクマネージャーの「スタートアップ」タブで Clash Verge が無効になっていないか確認してください。
落とし穴 7:ファイアウォールにブロックされる
症状:TUN モードを有効にすると一部のアプリがネットワークに接続できない。Windows セキュリティセンターに「アクセスを許可しますか?」というダイアログが表示される。
対処:
- ダイアログが表示されたら、「プライベートネットワーク」と「パブリックネットワーク」の両方にチェックを入れ、「アクセスを許可」をクリックする
- 誤って「キャンセル」をクリックした場合は、「Windows セキュリティ」→「ファイアウォールとネットワーク保護」→「ファイアウォールを通過するアプリを許可」を開き、Clash Verge を手動で追加する
- 一覧に見つからない場合は「別のアプリを許可」をクリックし、インストール先フォルダーにある Clash Verge の実行ファイルを指定する
7. 7 つの落とし穴早見表
| 落とし穴 | 症状 | 対処 |
|---|---|---|
| 1 WebView2 がない | ウィンドウが真っ白、起動直後に落ちる | WebView2 Runtime をインストールする |
| 2 パスに日本語が含まれる | サービスモードまたは TUN のインストールに失敗 | 英数字のみのパスに変えて再インストール |
| 3 サービスモードの失敗 | 権限不足と表示される | 管理者として実行して再試行 |
| 4 サブスクリプションの解析失敗 | 取り込み後にノードが 0 件 | リンクの有効期限と形式を確認 |
| 5 システムプロキシが効かない | ブラウザが直接接続のまま | プロキシ拡張を無効化、7897 ポートを確認 |
| 6 TUN を有効にすると即オフ | スイッチが自動で戻る | サービスモードを先にインストール、仮想アダプターを確認 |
| 7 ファイアウォールにブロック | 一部のアプリが接続できない | プライベートとパブリックを許可 |
8. 設定完了後の確認チェックリスト
- システムプロキシが効いている:ip.sb にアクセスし、出口 IP がノードの地域と一致していること
- TUN が効いている:コマンドプロンプトを開いて
curl -I https://www.google.comを実行し、HTTP/2 200 が返れば正常です - サブスクリプションを更新できる:サブスクリプションカードの「更新」をクリックしてエラーが出ないこと
- 自動起動:PC を再起動し、アプリを手動で開かなくてもネットワークに接続できること
7 つの落とし穴をひととおり確認できたら、Windows での設定は完了です。ポリシーグループの選択やルールのマッチングで困ったときは、引き続き利用マニュアルを参照してください。