ClashでGitHub Copilotが使えない?VS Codeの接続エラー対処法

まずCopilotのどの通信が失敗しているか切り分ける

Clashを有効にした直後からVS CodeのGitHub Copilotが使えなくなった場合、最初に確認したいのは「GitHubのウェブサイトを開けるか」ではなく、Copilot拡張機能が必要とする認証、補完要求、更新処理のどの段階で止まっているかです。ブラウザーでGitHubにログインできても、VS Codeの拡張機能ホストが同じプロキシ経路を使っているとは限りません。VS Codeの画面、拡張機能ホスト、ログイン用ブラウザー、ターミナルは、それぞれ異なるプロキシ設定や環境変数を参照することがあります。

症状は大きく三つに分けられます。アカウント認証の画面から先へ進まない場合は、VS Codeからログイン用ブラウザーを開く経路や認証コールバックを確認します。ログイン済みなのにコード補完だけが表示されない場合は、Copilot拡張機能からサービスへのHTTPS接続、ルールによる出口選択、証明書検証を調べます。「Connecting」「Request failed」「ETIMEDOUT」などが繰り返し表示される場合は、ローカルプロキシポート、VS Codeのプロキシ設定、Clashの接続ログを順番に確認すると効率的です。

また、GitHubのトップページ、リポジトリ画面、CopilotのAPI通信は同じ接続先を使うとは限りません。GitHub関連のドメインを一つ許可しただけで、認証や補完要求がすべて成功するとは判断しないでください。Clashの接続一覧で、VS Codeを起動した直後、拡張機能を再読み込みした直後、補完候補を要求した直後の通信を観察します。該当する接続が表示されないなら、VS CodeがClashを経由していない可能性があります。

Clashのポートとルール適用状態を確認する

VS CodeをClashへ接続する前に、Clashコアが起動し、実際にプロキシ接続を受け付けていることを確認します。ポート番号はクライアントや設定によって異なるため、7890と決めつけてはいけません。Clash Verge Rev、Mihomo系クライアントなどの設定画面で、mixed-port、HTTPポート、SOCKSポートの現在値を確認してください。サブスクリプションの更新やプロファイルの切り替えによって、以前のポートから変更されている場合もあります。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

ローカルポートが待ち受けているかは、OS側からも調べられます。WindowsではPowerShellで次のコマンドを実行し、macOSやLinuxではlsofまたはssを利用できます。

Get-NetTCPConnection -LocalPort 7890 -State Listen

lsof -nP -iTCP:7890 -sTCP:LISTEN

ss -lntp | grep 7890

何も表示されない場合は、VS Code側の設定を変更する前にClashのコア状態とログを確認します。設定の読み込みに失敗している、別のアプリがポートを使用している、古いClashプロセスだけが残っている、といった原因が考えられます。逆にポートが待ち受けていても、プロキシ先への接続が失敗することがあります。その場合は、Clashの接続履歴で接続先、使用されたルール、選択されたポリシーグループ、エラー内容を確認します。

ローカルプロキシをcurlでテストする

VS Codeを調べる前に、同じ端末のターミナルからローカルポートを明示してHTTPS通信をテストすると、問題の範囲を絞れます。次のポート番号は例なので、実際には現在のClash設定へ置き換えてください。

curl -I -x http://127.0.0.1:7890 https://github.com

curl -I --proxy socks5h://127.0.0.1:7891 https://github.com

connection refusedなら、ポート番号、Clashコア、ファイアウォールを確認します。長時間待ってタイムアウトする場合は、ノードの状態、ルールの出口、DNS解決、ネットワークそのものを調べます。HTTPSの応答が返ってもCopilotの全機能が保証されるわけではありませんが、少なくともローカルポートから外部サイトまでの基本経路を確認できます。

テスト中は、Clashのモードを一時的に「ルール」から「グローバル」へ切り替える方法もあります。グローバルモードでCopilotが動き、ルールモードで失敗するなら、ノード自体よりもドメイン分類、ルールの順序、ポリシーグループの選択が原因である可能性が高いでしょう。確認後は通常のルールモードへ戻し、必要な通信だけを適切なグループへ振り分けます。

VS Codeのプロキシ設定をClashに合わせる

VS Codeには、OSのシステムプロキシを利用する動作と、設定ファイルでプロキシを指定する動作があります。環境やバージョンによって挙動が異なるため、まずコマンドパレットで「Preferences: Open User Settings (JSON)」を開き、既存のプロキシ関連設定を確認します。設定画面の検索欄でproxyと入力しても確認できます。

{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxySupport": "on",
  "http.proxyStrictSSL": true
}

http.proxyには、ClashのHTTPまたはmixedポートを指定します。SOCKSポートを指定する場合は、利用中のVS Codeや拡張機能がその形式に対応しているかを確認してください。互換性を優先するなら、まずHTTP形式で受け付けられるmixedポートを使う方が切り分けやすいでしょう。ローカルポートに認証を設定していない一般的な構成では、URLにユーザー名やパスワードを追加する必要はありません。

http.proxySupportは、VS Codeがプロキシをどの程度利用するかに関係します。設定を強制的に変更しても、拡張機能が独自のHTTPクライアントを使う場合や、拡張機能側が別の設定を持つ場合は、すべての通信が同じ動作になるとは限りません。http.proxyStrictSSLを安易にfalseへ変更するのも避けてください。TLS証明書の検証を無効にすると、原因を隠すだけでなく、通信の安全性を下げることになります。

設定変更後は、コマンドパレットから「Developer: Reload Window」を実行し、VS Codeのウィンドウと拡張機能ホストを再読み込みします。単に設定画面を閉じただけでは、すでに起動している拡張機能プロセスが古い接続情報を保持していることがあります。再読み込み後にClashのログを開き、認証または補完要求に対応する接続が新しく記録されるかを確認してください。

GitHub Copilotと拡張機能ホストのログを見る

VS Codeには、拡張機能の状態と通信エラーを調べるためのログ表示機能があります。まず左側の拡張機能ビューでGitHub Copilotまたは関連するCopilot拡張機能が有効になっていること、無効化やクラッシュが発生していないことを確認します。拡張機能の詳細画面で「再読み込み」や更新が表示されている場合は、更新後にVS Codeを再起動します。

次に「表示」メニューの「出力」を開き、出力パネルの右上にあるチャンネル選択からGitHub Copilot、GitHub Copilot Chat、Log (Extension Host)など、表示されている関連チャンネルを選択します。名称は拡張機能のバージョンによって異なることがあります。ここで、ログイン状態、トークン取得、接続タイムアウト、TLSエラー、プロキシ接続拒否などの記録を確認します。

  • 認証に失敗する:ブラウザーで開いた認証ページを完了しても、VS Codeへ戻るコールバックが遮断されていないか確認します。既存のGitHubセッションをいったんサインアウトし、VS Codeから再度サインインする方法も有効です。
  • 補完要求がタイムアウトする:Clashの接続履歴で該当通信がタイムアウトしていないか、選択されたノードがHTTPS通信を処理できるかを調べます。
  • 証明書エラーが出る:HTTPS検査型のセキュリティソフト、企業ネットワークの証明書、時刻ずれ、古いルート証明書を確認します。検証を無効化して解決しようとしないでください。
  • ログにプロキシ関連の記録がない:拡張機能ホストが別の設定を使っている、Clashを経由しないTUNまたはVPNが優先されている、または接続処理が実行される前に拡張機能が停止している可能性があります。

VS Codeのステータスバーに表示されるCopilotのアイコンも確認します。アイコンが無効状態、サインイン要求状態、利用不可状態のどれなのかで、見るべき箇所が変わります。補完候補が出ない場合は、対象ファイルの言語モード、Copilotを無効にするワークスペース設定、組織アカウントの利用制限も確認してください。ネットワークが直っていても、特定の言語やリポジトリだけで補完を無効にしていると候補は表示されません。

GitHub関連のルールとポリシーグループを確認する

Clashのルールは通常、上から順番に評価され、最初に一致したルールで処理されます。GitHub向けの通信をプロキシへ送るルールを追加する場合、既存の広いルールや早い段階のDIRECT指定に隠れていないか確認してください。逆に、すべてのGitHub関連通信を無条件に同じ出口へ固定すると、社内GitHub、通常のGit操作、認証、Copilot APIの必要条件が混ざり、別の問題を起こすことがあります。

rules:
  - DOMAIN-SUFFIX,github.com,GitHub
  - DOMAIN-SUFFIX,githubusercontent.com,GitHub
  - MATCH,既定のポリシー

上の例はルールの考え方を示すだけで、実際に必要なドメイン一覧やポリシー名を保証するものではありません。Copilotはサービス構成やクライアントのバージョンによって接続先が変わる可能性があります。ログに表示された実際の接続先を基準に、必要な範囲だけを確認してください。接続先を推測して大量のドメインを許可するより、認証、補完要求、拡張機能更新のタイミングで記録された通信を一つずつ確認する方が安全です。

ルールに一致しているのに接続できない場合は、ポリシーグループの中で選ばれているノードを確認します。ノードの遅延が低く表示されても、長時間のHTTPS接続、ストリーミング形式の応答、特定のTLS経路に問題がないとは限りません。別ノードへ切り替え、同じ操作を再実行して結果を比較します。複数ノードで同じ失敗が起きるなら、VS Codeのプロキシ設定、DNS、ルール、ネットワーク制限を優先して調べます。

DNS設定も見落としやすい部分です。ドメインルールを正しく適用するには、Clashが接続先のドメイン情報を取得できる必要があります。Fake IP、通常の名前解決、TUNのDNS処理を組み合わせている場合、設定の方式によってログに表示されるアドレスやルールの一致方法が変わります。DNSを変更するときは、変更前の設定を保存し、Copilotだけでなく通常のHTTPSサイト、Git操作、VS Code Marketplaceも順に確認します。

TUNモードと環境変数の競合を切り分ける

システムプロキシを有効にしても、すべてのアプリケーションがその設定を利用するわけではありません。TUNモードはOSのネットワーク層でより広い通信を取り込めますが、仮想インターフェース、DNS、管理者権限、ルート設定に依存します。TUNを有効にした状態でVS Codeを起動している場合、VS Codeのhttp.proxyとTUN経由の処理が重なり、二重のプロキシやループが起きることがあります。

切り分けでは、まず構成を単純化します。ClashのTUNを一時的に無効にし、システムプロキシとVS Codeの明示的なHTTPプロキシのどちらか一つだけを有効にして、VS Codeを完全終了してから再起動します。これでCopilotが動くなら、TUNのルート、DNSモード、除外ルール、他のVPNやセキュリティソフトとの競合を調べます。逆に、TUNを無効にしても同じ失敗なら、ローカルポートやVS Codeのプロキシ設定を優先します。

ターミナルでGitHub CLIやGit操作も行う場合は、環境変数がVS Codeとは別のポートを指していないか確認します。

echo $HTTP_PROXY
echo $HTTPS_PROXY
echo $ALL_PROXY

$env:HTTP_PROXY
$env:HTTPS_PROXY
$env:ALL_PROXY

シェルの環境変数は、VS Codeをそのターミナルから起動した場合に拡張機能ホストへ影響することがあります。不要な変数を一時的に解除してからVS Codeを起動し、動作を比較してください。Windowsでは新しいターミナルやVS Codeを開き直さないと変更が反映されない場合があります。Gitのプロキシ設定、パッケージマネージャーの独自設定、ブラウザー拡張機能のプロキシも別々に存在するため、「ターミナルで成功したからVS Codeも同じ」とは判断しないことが重要です。

設定を戻しながら最終確認する手順

原因を特定したら、変更を一度に増やさず、動作した最小構成から必要な機能を戻します。次の順番なら、どの変更が結果に影響したかを記録しやすくなります。

  1. Clashの有効設定を保存する。使用中のプロファイル名、コアの種類、ローカルポート、モード、DNS、TUNの状態を記録します。サブスクリプションURLや認証情報を含む設定は公開しないでください。
  2. ローカルポートを確認する。Clashの接続ログとOSの待受状態を確認し、curlでHTTPSプロキシ通信をテストします。
  3. VS Codeの経路を一つにする。システムプロキシ、TUN、http.proxy、環境変数が異なる経路を指していない状態にします。
  4. VS Codeを再読み込みする。ウィンドウの再読み込みだけで直らない場合は、VS Codeを完全終了し、バックグラウンドプロセスも終了してから再起動します。
  5. 認証と補完を別々に試す。GitHubへのサインイン、Copilotの状態表示、通常のコード補完、Copilot Chatの順に確認し、Clashの接続ログと時刻を照合します。
  6. 最後にルールを細かくする。グローバルモードでの成功を確認した後、ルールモードへ戻し、必要な接続先だけを適切なポリシーグループへ割り当てます。

それでも解決しない場合は、Clashの接続ログ、VS Codeの関連出力、発生時刻、使用したポート、エラーの種類をまとめます。サブスクリプションURL、アクセストークン、秘密鍵、完全な認証ヘッダーは削除してください。エラーが「接続拒否」「名前解決失敗」「TLS証明書エラー」「タイムアウト」のどれに近いかを整理するだけでも、次に確認する層が明確になります。

Clashをダウンロード