作成日 : 2026年2月6日

Gemini CLIをVSCodeで使う方法｜導入手順から基本操作まで解説

Gemini CLIをVSCodeで使うと、ターミナル操作とコード編集を1つの画面で完結でき、生成AIを使った開発効率化をすぐに体験できます。Gemini CLIはコマンドラインからGeminiを操作できるツールで、VSCodeと組み合わせることで、CLIに不慣れな初級エンジニアでも扱いやすくなります。

当記事では、Gemini CLIとVSCode連携の基本的な考え方から、事前準備、インストール、動作確認までを分かりやすく解説します。AI×CLI開発の第一歩を踏み出したい方に向けた内容です。

※（免責）掲載情報は記事作成日時点のものです。最新の情報は各AIサービスなどの公式サイトを併せてご確認ください。

Gemini CLIとVSCodeを組み合わせる意味とは？

Gemini CLIとVSCodeを組み合わせる最大の意味は、AI操作と開発作業を同一環境で完結させ、学習と実践の速度を高められる点にあります。CLIの柔軟性とエディタの操作性を同時に活用できるため、初級エンジニアでも無理なくAI支援開発を体験できます。

Gemini CLIの基本概要

Gemini CLIは、ターミナルからGeminiを操作するためのコマンドラインツールです。GUIを介さず、コマンド入力によってテキスト生成やコード作成、修正指示を実行できます。

CLI形式の利点は、操作がシンプルで再現性が高いことです。入力したコマンドや結果が履歴として残るため、試行錯誤の過程を振り返りやすく、学習用途にも向いています。また、将来的にスクリプト化や自動化へ発展させやすい点も特徴です。一方で、ターミナル操作に慣れていない場合、心理的なハードルを感じやすい側面もあります。

VSCodeと連携する意味

VSCodeと連携することで、Gemini CLIの操作性と可視性が大きく向上します。その理由は、コード編集・ターミナル実行・結果確認を1つの画面で行えるためです。

VSCodeには統合ターミナルがあり、エディタを切り替えることなくGemini CLIを実行できます。生成されたコードをその場で確認・修正でき、差分表示機能を使えば変更点も把握しやすくなります。これにより、CLI操作への不安を軽減しながら、実際の開発フローに近い形でAI活用を学べます。

Gemini CLIと拡張機能の違い

Gemini CLIは操作の自由度が高く、VSCode拡張機能は直感的な補助に向いています。両者は役割が異なるため、併用することで効果を発揮します。

CLIは細かな指示や一括処理に強く、学習が進むほど活用範囲が広がります。一方、VSCode拡張機能（Gemini CLI Companion）は、開いているファイルや選択範囲をCLIに渡し、提案の差分確認などをVSCode上で行いやすくします。まずはVSCode上でGemini CLIを動かし、必要に応じて拡張機能を補助的に使うことで、無理のないAI開発環境を構築できます。

Gemini CLIをVSCodeで使うための事前準備

Gemini CLIをVSCodeで使うには、事前に開発環境と認証情報を整えておくことが重要です。準備を省くと、インストール後にエラーが出やすくなるため、最初に必要条件を確認しておきましょう。

必要な開発環境

基本となる開発環境は、OS・ターミナル・VSCodeの3点です。これらが揃っていれば、Gemini CLIの導入をスムーズに進められます。

Gemini CLIはmacOS／Linux／Windowsに対応しています。ターミナルはOS標準のものを利用できます。VSCodeは公式サイトから最新版をインストールし、拡張機能が利用できる状態にしておきましょう。Gemini CLIの利用にはNode.js 20以上が必須のため、事前に動作環境を確認しておきましょう。

GoogleアカウントもしくはAPIキーの取得

Gemini CLIを利用するには、GoogleアカウントまたはAPIキーによる認証が必要です。これは、不正利用を防ぎ、利用状況を管理するための仕組みです。

個人利用はGoogleアカウント（OAuth）でのログインが手軽で、APIキーを使う場合は環境変数（例：GEMINI_API_KEY）で設定します。Gemini APIキーはGoogle AI StudioのAPI Keysページから取得できます。取得したAPIキーは漏えい防止を最優先し、可能ならIP制限などのキー制限も設定します。

APIキーの設定（環境変数・VSCode）

APIキーは、環境変数として設定することで安全かつ安定して利用できます。その理由は、コードや設定ファイルに直接書き込まずに済むためです。

macOSやLinuxではシェル設定ファイルに、Windowsでは環境変数設定画面からAPIキーを登録します。環境変数の設定後は、新しいターミナルを開くと（必要に応じてVSCodeも再起動すると）反映されるため、反映後にGemini CLIを実行します。誤って公開リポジトリにAPIキーを含めないよう注意しましょう。

VSCodeの基本設定

VSCodeは、統合ターミナルと基本的な表示設定を確認しておくと使いやすくなります。事前設定により、CLI操作時の混乱を防げます。

統合ターミナルが有効になっているかを確認し、フォントや配色を見やすい状態に調整しておくと作業効率が向上します。これらの準備を整えることで、Gemini CLIとVSCodeを安心して使い始められます。

Gemini CLIのインストールと連携設定は？

Gemini CLIのインストールとVSCode連携は、手順を整理して進めれば初級エンジニアでも迷わず完了できます。ここでは、インストールから連携設定、動作確認までを一連の流れとして解説します。

Gemini CLIのインストール方法

Gemini CLIは、公式に案内されている方法でインストールするのが最も安全です。その理由は、非公式な手順を使うと動作不良や将来的な互換性の問題が起こりやすいためです。

一般的には、パッケージマネージャや公式配布コマンドを使ってインストールします。インストール後は、ターミナルでコマンドを実行し、バージョン情報が表示されるかを確認しましょう。これにより、CLI本体が正しく導入されているかを簡単に確認できます。エラーが出た場合は、Node.jsなどの依存関係が不足していないかも併せて確認します。

VSCode拡張機能（Gemini CLI Companion）の導入

VSCode拡張機能を導入すると、Gemini CLIの操作がより分かりやすくなります。特に、CLIに不慣れな場合は視覚的な補助が役立ちます。

拡張機能はVSCodeの拡張機能マーケットプレイスから検索し、インストールするだけで利用できます。導入後はコマンドパレットから起動でき、エディタのファイル／選択範囲の共有や差分確認などを行いやすくなります。拡張機能は必須ではありませんが、学習段階では導入しておくと安心です。

CLIとVSCodeの連携設定

CLIとVSCodeの連携は、統合ターミナルを中心に行います。その理由は、VSCode内でCLI操作とコード編集を同時に進められるためです。

VSCodeの統合ターミナルを起動し、そこからGemini CLIを実行します。Googleログイン（OAuth）で利用するか、APIキーを環境変数（GEMINI_API_KEY など）に設定して利用します。必要に応じて、VSCodeの設定ファイルでターミナルのシェルや表示方法を調整すると、より快適に使えます。

インストール後の動作確認

動作確認は、簡単なコマンドを実行するだけで十分です。これにより、インストールと連携が正しく行われているかを判断できます。

例えば、短いプロンプトを入力してGeminiからの応答が返ってくるかを確認します。結果がターミナルに表示されれば、CLIとVSCodeの連携は正常です。併せて、生成された内容をエディタ上で確認・編集できるかもチェックすると、実際の利用イメージをつかみやすくなります。

インストール時の注意点

インストール時は、認証情報と環境差異に注意が必要です。ここを見落とすと、エラーの原因になります。

APIキーを直接コードに書かないこと、OSごとの環境変数設定方法を正しく理解することが重要です。また、VSCodeやGemini CLIのバージョンが古い場合、正常に連携できないことがあります。公式情報を確認しながら進めることで、トラブルを回避しやすくなります。

VSCodeでの基本的な使い方

VSCodeでGemini CLIを使う基本は、統合ターミナルを起点にAI支援を開発フローへ組み込むことです。ここでは、日常的に使いやすい操作方法を中心に解説します。

ターミナルからの基本操作

Gemini CLIは、VSCodeの統合ターミナルから実行するのが最もシンプルです。エディタとターミナルを行き来せずに操作でき、実行結果を即座に確認できる点が大きな利点です。

VSCode下部にある統合ターミナルを起動し、Gemini CLIのコマンドを入力します。プロンプトには「何をしたいか」を短く具体的に書くのがポイントです。実行結果はその場で表示されるため、試行錯誤しながら使い方を学べます。CLI操作に慣れていない場合でも、VSCode上で完結することで心理的な負担を抑えられます。

コード生成と修正支援

Gemini CLIは、コード生成や既存コードの修正支援に活用できます。自然言語で要件や意図を伝えられるため、設計内容をそのまま指示に反映しやすくなります。

新規コードを作りたい場合は、要件や条件を簡潔に入力します。生成されたコードはエディタ上で確認し、必要に応じて手動で調整します。また、既存コードの改善点を尋ねたり、処理内容の説明を求めたりする使い方も有効です。VSCode上で編集しながらGemini CLIを使うことで、AIの提案をそのまま実装に反映しやすくなります。

差分表示とレビュー活用

差分表示を使うと、Gemini CLIによる変更点を安全に確認できます。修正箇所と内容を視覚的に把握できるため、意図しない変更に気づきやすくなります。

VSCodeの差分表示機能を使えば、修正前後のコードを比較できます。Gemini CLIが提案した変更を1つずつ確認しながら適用することで、意図しない修正を防げます。レビュー用途としても活用でき、AIの提案をそのまま受け入れるのではなく、理解しながら取り込む姿勢を保てます。これにより、学習と品質管理の両立が可能になります。

Gemini CLIをVSCodeで使いこなそう

Gemini CLIをVSCodeで活用すると、CLI操作とコード編集を一体化したAI支援開発を無理なく始められます。特に、統合ターミナルや差分表示を活用することで、AIの提案を理解しながら取り入れやすくなります。Gemini CLIをVSCodeで使う環境を整えることで、生成AIを取り入れた開発フローの第一歩を安心して踏み出せるでしょう。

※ 掲載している情報は記事更新時点のものです。