Gemini Code Assist の補完が出ないとき — 症状別の切り分け手順

Gemini Code Assist を導入したのにコード補完が動かない、VS Code の拡張機能が応答しない、Outline 機能が表示されない――こういったトラブルに直面したことはないでしょうか。ここでは実際によくあるトラブルを症状別に整理し、すぐに試せる対処法をご紹介します。

まず確認すること：基本チェックリスト

トラブルシューティングを始める前に、以下の基本事項を確認してください。

1. ログインと認証の確認

VS Code の左側サイドバーに表示される Gemini アイコンをクリックし、Google アカウントでサインインしているかを確認します。サインインが必要なメッセージが表示されている場合は、認証から再スタートです。

2. 拡張機能のバージョン確認

VS Code の拡張機能タブで「Gemini Code Assist」を検索し、最新バージョンがインストールされているかを確認します。古いバージョンでは動作しない機能があります。

3. ネットワーク接続の確認

Gemini Code Assist はクラウドサービスであるため、安定したインターネット接続が必要です。社内プロキシや VPN 環境の場合は、後述の設定が必要になることがあります。

症状別トラブルシューティング

症状1：コード補完（インラインサジェスト）が一切表示されない

原因と対処法：

まず VS Code の設定で Gemini Code Assist が有効になっているかを確認します。コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開いて「Gemini: Enable/Disable Suggestions」と入力し、現在の状態を確認してください。

次に、インラインサジェストの設定を確認します。settings.json に以下の設定が含まれているか確認してください。

{
  "editor.inlineSuggest.enabled": true,
  "geminiCode.enableInlineSuggestions": true
}

設定変更後は VS Code を再起動してください。

また、Tab キーで候補を受け入れる設定になっているかも確認しましょう。editor.tabCompletion が "off" になっていると、候補が表示されても受け入れられません。

それでも動かない場合： 拡張機能を一度アンインストールし、VS Code を再起動してから再インストールしてみてください。

症状2：VS Code 拡張機能はインストールされているのにサインインできない

対処法：

VS Code のコマンドパレットで「Gemini Code Assist: Sign Out」を実行してサインアウトします。
OS のキーチェーン/認証情報マネージャーから Google 関連のキャッシュをクリアします。
再度「Gemini Code Assist: Sign In」を実行してサインインします。

ブラウザのデフォルト設定が原因の場合： VS Code が外部ブラウザを開いて認証を行う際に問題が起きることがあります。VS Code の設定で "workbench.externalBrowser" が正しく設定されているか確認してください。

企業アカウント（Google Workspace）をお使いの場合： 管理者が Gemini Code Assist の使用を許可していない可能性があります。Google Workspace 管理コンソールで Gemini Code Assist が有効化されているかを管理者に確認してもらう必要があります。

症状3：Outline 機能が表示されない・機能しない

Gemini Code Assist には、コードの概要（Outline）を生成してナビゲーションを助ける機能があります。この機能が動作しない場合の対処法を説明します。

対処法1：言語サポートの確認

Outline 機能は現時点では一部の言語でのみ利用可能です。Python、JavaScript、TypeScript、Java、Go などが主要な対応言語です。使用している言語が対応しているかを公式ドキュメントで確認してください。

対処法2：設定の確認

{
  "geminiCode.enableOutline": true
}

上記の設定が settings.json に含まれているか確認してください。

対処法3：ファイルサイズの確認

非常に大きなファイル（数千行以上）では Outline の生成に時間がかかることがあります。処理中はステータスバーにスピナーが表示されます。しばらく待ってみてください。

症状4：補完の精度が低い・的外れな候補が出る

Gemini Code Assist の補完精度は、コンテキスト（周囲のコード）の量と質に依存します。

改善のためのヒント：

コメントで意図を明示することで精度が向上します。

# ユーザーのメールアドレスのバリデーション関数
# RFC 5322に準拠した形式チェックを行う
def validate_email(email: str) -> bool:
    # ← ここでGeminiの補完がより正確な実装を提案するようになる

また、ファイルの先頭に使用するライブラリや技術スタックを記載することも効果的です。

// Framework: Next.js 15 App Router
// State: Zustand
// Styling: Tailwind CSS

症状5：プロキシ環境・VPN 環境でつながらない

社内ネットワークのプロキシ設定が必要な環境では、VS Code の設定でプロキシを指定する必要があります。

VS Code のプロキシ設定：

{
  "http.proxy": "http://your-proxy-server:port",
  "http.proxyStrictSSL": false,
  "http.proxyAuthorization": null
}

上記の設定でも解決しない場合は、HTTPS_PROXY 環境変数を設定してから VS Code を起動してみてください。

# macOS / Linux
export HTTPS_PROXY=http://your-proxy-server:port
code .
 
# Windows (PowerShell)
$env:HTTPS_PROXY="http://your-proxy-server:port"
code .

症状6：JetBrains IDE（IntelliJ IDEA / PyCharm 等）で動作しない

Gemini Code Assist は JetBrains IDE にも対応しています。動作しない場合は以下を確認してください。

IDE のプラグインマーケットプレースで「Google Cloud Code」または「Gemini Code Assist」プラグインを検索し、最新版がインストールされているか確認します。プラグインのインストール後は IDE の再起動が必要です。

また、JetBrains IDE 向けの設定は VS Code とは異なる場所にあります。「Settings → Tools → Google Cloud Code」から設定を確認してください。

ログを確認して原因を特定する

症状が特定できない場合は、Gemini Code Assist のログを確認することで詳細な原因がわかります。

VS Code でのログ確認方法：

メニューの「Help → Toggle Developer Tools」を開く
Console タブで「gemini」または「google」で検索してエラーメッセージを確認する

または、VS Code の Output パネル（Ctrl+Shift+U）で「Gemini Code Assist」を選択するとログが表示されます。

よくあるエラーメッセージと対処

「Authentication failed」というエラーが出る場合は、サインアウト後に再サインインしてください。「Quota exceeded」が表示される場合は、利用制限に達しています。しばらく時間をおいてから試すか、利用プランのアップグレードを検討してください。「Network error」が続く場合は、ファイアウォールやプロキシの設定を確認してください。「Extension host terminated unexpectedly」の場合は VS Code を完全に終了し再起動してください。

エージェントモードだけ動かないときは——補完の不具合と切り分ける

Gemini Code Assist のエージェントモードは、インライン補完やチャット応答とは別の機能です。複数ファイルにまたがる変更の計画と実行、コマンドの提案、テスト生成などを半自動で進めます。2025年後半から段階的に提供が始まり、2026年現在は Enterprise と Individual Pro のプランで利用できます。

ここで多いのが、補完は効いているのにエージェントだけが動かない、という相談です。原因の切り分け方が補完とは少し違います。

まず「有効化」を確認する

エージェントモードは拡張機能を入れただけでは使えません。明示的な有効化が必要です。VS Code ではチャットパネルの入力欄に「Agent」モードのトグルが出ているかを確認してください。出ていなければ、次のいずれかに当てはまります。

ライセンスが対応していない（Free プランではエージェントモードは使えません。Pro か Enterprise が必要です）
組織の管理者が無効化している（Workspace 環境では管理コンソールでの許可が要ります）
拡張機能が古い（エージェントモードは比較的新しいため、最新版へ更新してください）

私自身、個人開発で使い始めたとき、補完が効いていたので有効化済みだと思い込み、トグルの存在に気づくまで回り道をしました。補完とエージェントは別物、とまず切り分けるのが近道です。

指示が広すぎて途中で止まる

エージェントはリポジトリ全体を参照できますが、一度に扱えるコンテキストには上限があります。「プロジェクト全体のバグを直して」のような広い指示は、途中でタイムアウトするか無応答になりがちです。スコープを絞ると安定します。

# 止まりやすい例
「このプロジェクトのバグを全部見つけて修正して」

# 通りやすい例
「src/api/auth.ts の JWT トークン検証に問題がないか確認して修正して」

@workspace / @file が解決されない

@workspace でプロジェクト全体、@file で特定ファイルを参照できますが、ワークスペースのインデックスができていないと参照に失敗します。VS Code ではウィンドウのリロード（コマンドパレット →「Developer: Reload Window」）でインデックスが再構築されることが多いです。.gitignore で除外したファイルはエージェントからも見えませんので、参照したいファイルが除外されていないかも確認してください。

エージェント特有のエラー文

Failed to complete task: context limit exceeded — 指示が広すぎます。ファイルや機能を絞ってください。
Agent mode is not available for your plan — ライセンスが未対応です。プランを確認してください。
Unable to index workspace — ワークスペースが大きすぎるか権限の問題です。出力パネルの詳細ログを確認してください。

私が個人開発で Dolice Labs のブログ運用コードに使ったときも、最初は広い指示で止まり、ファイル単位に区切ったとたん通るようになりました。エージェントは「賢く全部やってくれる」より「小さく確実に渡す」ほうが速い、というのが実感です。

全体を振り返って

Gemini Code Assist のトラブルは、多くの場合、認証の問題・拡張機能の設定・ネットワーク環境のいずれかに原因があります。本記事のチェックリストを順番に試していただくことで、多くの問題は解決できるかと思います。それでも解決しない場合は、公式の Gemini Code Assist サポートページもあわせてご確認ください。困っている方のお役に立てれば幸いです。