GitHub Copilotの補完が出ない時の対処法|原因を5分で切り分け

AI活用ノウハウ

GitHub Copilotの補完が出ないときは、原因を「アカウント」「エディタ」「組織・ネットワーク」の3層に分けて、上から順に潰していくのが最短です。いきなり再インストールに走ると、実際には無料プランの上限やサインインのずれが原因だった場合に30分以上を無駄にします。この記事では、2026年7月時点の公式仕様にもとづき、症状から原因を絞り込む順番と、原因別の具体的な手順を整理します。

まず30秒で見る3点|補完が出ない時の初動

補完が止まったとき、多くの人がいきなり設定画面を開きますが、先に見るべきは「Copilot自身が何を報告しているか」です。次の3点は合計30秒で確認できて、原因の半分近くをここで特定できます。

ステータスバーのCopilotアイコンを見る

エディタ右下(VS Codeの場合)のCopilotアイコンは、状態によって見た目が変わります。アイコンに斜線が入っている場合は「無効化されている」という意味で、通信エラーとはまったく別の問題です。斜線の理由はクリックすると表示され、「このファイルは除外されています」と出れば後述のコンテンツ除外、「サインインしてください」と出ればアカウント側の問題だと即座に切り分けられます。

GitHubの稼働状況を確認する

自分の環境をいくら触っても直らない場合、GitHub側の障害であることがあります。公式のトラブルシューティングでも、最初にStatusページで Copilot やモデル提供に関する障害が出ていないかを確認するよう案内されています(GitHub Docs 公式トラブルシューティング)。障害中であれば、待つ以外にできることはありません。

拡張機能のバージョンが古くないか

見落とされがちですが影響が大きいのがこれです。公式ドキュメントは「古いクライアントはGitHub Copilotのサーバーと通信できない」と明記しています。数か月更新していない環境では、他の設定がすべて正しくても補完は返ってきません。自動更新を止めている場合は、まず拡張機能を最新版に上げてください。

症状別の切り分け早見表|どこから見るべきか

ここからは、症状によって疑うべき箇所が変わります。編集部で実際の相談内容を整理したところ、症状と原因には次のような対応関係がありました。上から順に確認すると、無駄な作業を減らせます。

症状 × 疑うべき原因の優先度表

症状 最初に疑う 次に疑う 確認の目安時間
どのファイルでも一切出ない サインイン・プラン上限 拡張機能のバージョン 2分
特定のリポジトリ・ファイルだけ出ない コンテンツ除外 ファイル形式の非対応 3分
月の途中から急に出なくなった 無料プランの補完上限 課金・支払い状態 2分
会社PCだけ出ない(自宅は出る) プロキシ・ファイアウォール 組織のポリシー設定 10分
1行は出るが複数行が出ない 既知の挙動・設定 プロンプト側の文脈不足 5分

「全ファイル」か「一部ファイル」かで大きく分かれる

この切り分けは非常に強力です。全ファイルで出ないならアカウントか拡張機能、一部だけなら除外設定かファイル種別と考えてほぼ間違いありません。新規に空の作業フォルダを作り、そこに test.py のような単純なファイルを置いて補完が出るか試すと、1分で判別できます。

原因別の対処(1)アカウント・プランまわり

無料プランの補完上限に達している

2026年7月時点で、Copilot Free は月あたり最大2,000回のコード補完という上限が設けられています(GitHub Docs 個人向けプラン)。日常的にコードを書く人であれば、月の後半に上限へ届くことは珍しくありません。「月初は動いていたのに中旬から出ない」という症状なら、まずこれを疑ってください。

有料プランでは補完自体は無制限です。料金は Copilot Pro が月10ドル、Pro+ が月39ドル、Max が月100ドル、組織向けの Business が1シートあたり月19ドル、Enterprise が月39ドルです(GitHub Docs プラン一覧)。補完が業務のボトルネックになっているなら、Pro への移行が費用対効果としては分かりやすい選択になります。

サインインしているアカウントがずれている

複数のGitHubアカウントを使い分けている場合の定番の原因です。Copilotのライセンスが付与されているアカウントと、エディタでサインインしているアカウントが別だと、当然ながら補完は返りません。公式手順では、VS Codeならアカウントアイコンからサインアウトし、コマンドパレットで Developer: Reload Window を実行してからサインインし直します。Visual StudioではGitHub IDを一度削除して再追加するのが確実です。

2026年6月の課金方式変更の影響

2026年6月1日以降、Copilotの全プランで利用量ベースの課金へ移行しています。従来の「プレミアムリクエスト数」で管理していた感覚のままだと、上限の考え方がずれます。組織アカウントの場合、管理者側で利用枠を絞っている可能性もあるため、個人で解決できない時は請求・利用枠の設定を管理者に確認してください。

原因別の対処(2)エディタ・拡張機能まわり

インライン補完が設定でオフになっている

VS Codeの設定で editor.inlineSuggest.enabledfalse になっていると、Copilotが正常でも画面に何も出ません。テーマや拡張機能のプリセットを適用した際に、意図せず切り替わっていることがあります。言語ごとに有効・無効を分ける設定もあるため、「Pythonでは出るがMarkdownでは出ない」といった症状ではここを見てください。

他の拡張機能と競合している

別のAI補完拡張(TabnineやCodeiumなど)を同時に入れていると、インライン補完の表示権を奪い合って片方が出なくなることがあります。切り分けは単純で、Copilot以外のAI補完拡張をすべて無効化してウィンドウを再読み込みし、補完が戻るか確認します。戻れば競合が原因なので、常用する側を1つに決めるのが現実的です。

再サインインとキャッシュのリセット

「昨日まで動いていた」「PCをスリープから復帰させたら出なくなった」というケースでは、認証トークンが古くなっているだけのことがあります。サインアウト→ウィンドウ再読み込み→サインインの順で新しいトークンを取得すれば戻ります。ここまでで直らない場合に限り、拡張機能の再インストールへ進んでください。

原因別の対処(3)組織・ネットワークまわり

コンテンツ除外の対象になっている

Copilot Business / Enterprise では、リポジトリ管理者や組織オーナーが特定のファイルをCopilotの対象外に設定できます。この設定が効いているファイルでは、補完は仕様として出ません。公式ドキュメントによると、設定の反映には最長30分かかるため、管理者が除外を解除した直後に試しても変わらないことがあります。ステータスバーのアイコンで除外の有無が分かるので、まずそこを確認してください。

社内プロキシ・ファイアウォールで遮断されている

「自宅では動くのに会社のPCだけ出ない」なら、ほぼこれです。GitHubは必要な通信先をCopilot allowlist リファレンスとして公開しているので、情報システム部門にこのページを渡して許可設定を依頼するのが最短ルートです。

注意点として、プロキシのURLが https:// で始まる形式は現時点でサポート対象外です。また認証方式は基本認証かKerberosに限られます。この条件に合わない構成だと、いくら許可リストを整えても接続できません。

それでも直らない時のログ確認

VS Codeの出力パネルでGitHub Copilotのログを開くと、通信エラーなのか認証エラーなのかがメッセージで判別できます。問い合わせをする場合も、このログがあるかないかで解決までの速度が大きく変わります。

やりがちな失敗と、時間を無駄にしない進め方

失敗例:最初に再インストールしてしまう

もっとも多い遠回りがこれです。再インストールは設定と認証状態をリセットするため、たしかに直ることはありますが、原因が分からないまま直るので再発時に同じ時間をまた使います。しかも無料プランの上限やコンテンツ除外が原因だった場合は、再インストールしても症状は1ミリも変わりません。順番としては最後に置くべき手段です。

失敗例:エディタ設定だけを延々と見直す

設定項目は数が多く、探し始めるといくらでも時間が溶けます。前述の「空フォルダに単純なファイルを置いて試す」を先にやれば、そもそもエディタ設定を見る必要があるのかどうかが1分で分かります。

編集的アドバイス:15分で直らなければ一度切り替える

実務上の判断としては、ここまでの手順を15分試して直らなければ、その日は別のツールで作業を進めることをおすすめします。CursorやClineなど代替の補完環境を用意しておくと、Copilot側の障害や組織設定の変更に振り回されずに済みます。どのツールが自分の作業に合うかはAIコーディング補助ツール比較5選で整理しています。似た症状としてCursorでAIが応答しなくなるケースもあり、その切り分けはCursorでAIが応答しないときの対処法にまとめました。

まとめ|上から順に潰せば原因はほぼ特定できる

GitHub Copilotの補完が出ない問題は、闇雲に触ると長引きますが、順番を決めれば短時間で片が付きます。

  • 30秒:ステータスバーのアイコン、GitHubの稼働状況、拡張機能のバージョン
  • 2分:サインインしているアカウントと、無料プランの月2,000回上限
  • 3分:空フォルダの単純なファイルで試し、全体か一部かを判定
  • 5分:インライン補完の設定と、他のAI補完拡張との競合
  • 10分:コンテンツ除外の確認、社内プロキシ・ファイアウォールの許可設定

再インストールは最後の手段です。設定や料金プランの基本から確認したい場合はGitHub Copilotの使い方と料金もあわせてご覧ください。なお、料金や上限の数値は変更されることがあるため、判断の前に公式のプランページで最新の内容を確認することをおすすめします。

タイトルとURLをコピーしました