Gemini CLI とは？インストール・使い方【2026年版】

Gemini CLIとは何か：ターミナルから直接使えるAIの全貌

Gemini CLIは、GoogleのAIモデル「Gemini」をターミナル（コマンドライン）から直接操作できるオープンソースのエージェントツールです。2025年6月にGoogleが公開したこのツールは、ブラウザやGUIアプリを開かずに、コードの生成・レビュー・リファクタリング、ファイル操作、Webリサーチなどを自然言語で指示できる開発者向けの強力なインターフェースとして急速に注目を集めています。

当社でも生成AIをプロダクト開発や業務効率化に活用しており、Gemini CLIは特にコーディング作業やドキュメント整備のフローに組み込んでいます。本記事では、Gemini CLIのインストールから実践的な使い方、活用シーン、注意点まで、実運用の知見を交えて徹底解説します。なお、Geminiというモデルそのものの概要についてはGeminiとは何か（基本概要）をご参照ください。

Gemini CLIの主な特徴

Gemini CLIは単なるチャットのコマンドライン版ではありません。エージェント的に動作し、ファイルシステムへのアクセス、コードの実行、ツール呼び出しを組み合わせて複合タスクを自律的にこなせる点が最大の特徴です。

• 大規模コンテキストウィンドウ：現行の主力モデルであるGemini 3.5 Flashや、Gemini 3.1 Proが持つ最大100万トークンのコンテキストウィンドウを活用可能。大規模なコードベース全体を一度に読み込んで質問・編集できます。
• マルチモーダル対応：テキストだけでなく、画像・PDFなどのファイルを渡して解析させることができます。
• ツール統合（MCP対応）：Model Context Protocol（MCP）サーバーと連携することで、外部APIや自社ツールとの統合が可能です。
• Google検索との統合：リアルタイムWebリサーチをAIが自律的に行い、最新情報を踏まえた回答を生成します。
• オープンソース：GitHubで公開されており、カスタマイズ・拡張が可能です。
• 無料利用枠が大きい：個人のGoogleアカウントでログインするだけで、Gemini 3.5 Flash等を一定の制限付きで無料利用できます。

インストール方法：3ステップで環境構築

Gemini CLIのインストールは非常にシンプルです。Node.js（バージョン18以上）が必要なため、先にインストールされていることを確認してください。

インストール後に gemini --version でバージョンが表示されれば成功です。当社では複数の開発メンバーが各自の端末にインストールしていますが、npmによるグローバルインストールは数分で完了し、環境差異によるトラブルもほとんど発生していません。

基本的な使い方：対話モードとワンショット実行

対話（REPL）モード

ターミナルで gemini と入力すると対話モードが起動します。プロンプトに日本語で指示を入力すると、AIが応答・ツール実行・ファイル操作などを行います。

ワンショット実行（非対話モード）

スクリプトや自動化パイプラインに組み込む場合は、非対話モードが便利です。

gemini -p "このディレクトリのREADMEを日本語で要約して"

-p フラグでプロンプトを直接渡すと、AIが応答して終了します。CI/CDパイプラインでのコードレビューやドキュメント自動生成などに活用できます。当社でも、Pull Request作成時に差分コードをGemini CLIに渡してレビューコメントを自動生成するスクリプトを試験運用しています。

実践的な活用シーン

コードベース全体の把握・質問

Gemini CLIの最大の強みは、大規模なコンテキストウィンドウを活かしてリポジトリ全体を読み込める点です。対話モードで起動し、「このプロジェクトの認証フローを説明して」と尋ねるだけで、複数ファイルにまたがるロジックを横断的に解説してくれます。

実際に当社のプロジェクトで試したところ、約30,000行のTypeScriptコードを読み込ませ、「バグが発生している可能性のある箇所を洗い出して」と指示すると、数分で疑わしいパターンをリストアップしてくれました。人間が全体を把握するために要していた時間を大幅に短縮できています。

コード生成・リファクタリング

「このクラスをTypeScriptで書き直して、async/awaitに統一して」「テストカバレッジを上げるためのユニットテストを追加して」など、自然言語で具体的な指示を出すとファイルを直接編集してくれます。ファイル変更前には確認プロンプトが表示されるため、誤った操作を防ぐ安全弁も機能しています。

ドキュメント生成・整備

「src/配下の全関数にJSDocコメントを追加して」「APIエンドポイントの一覧をMarkdownテーブルにまとめて」といった定型的なドキュメント作業を自動化できます。当社ではスプリントのたびにコメントが不足しがちな内部ライブラリに対して定期的に実行しており、ドキュメント品質の底上げに役立てています。

Webリサーチと情報収集

Google検索との統合により、「最新のNext.jsのApp Routerに関するベストプラクティスを調べてコードに反映して」のように、リアルタイムな情報収集と実装を組み合わせた指示が可能です。AIが自律的に検索→読み込み→実装という流れをこなします。

シェルコマンドとの連携

Gemini CLIはシェルコマンドの実行も可能なため、「ログファイルの中からエラーだけ抽出して集計して」など、データ処理やシステム管理タスクも自然言語で依頼できます。ただしシェルコマンド実行は強力な操作であるため、信頼できる環境でのみ使用することを推奨します。

GEMINI.mdで挙動をカスタマイズする

プロジェクトルートに GEMINI.md というMarkdownファイルを置くと、Gemini CLIが起動時に自動で読み込み、プロジェクト固有のコンテキストや指示を常に参照させることができます。

記述できる内容の例：

• プロジェクトの技術スタック・コーディング規約
• 避けてほしいライブラリや非推奨パターン
• よく使うコマンドやスクリプトのリスト
• チーム固有の用語や設計方針

当社では各リポジトリに GEMINI.md を設置し、「TypeScriptの型は必ず明示すること」「テストはVitestで書くこと」などのルールを記載しています。これにより、毎回プロンプトで指示しなくてもプロジェクトの流儀に沿ったコード生成が安定してできるようになりました。

MCPサーバーとの統合：外部ツールを接続する

Gemini CLIはModel Context Protocol（MCP）に対応しており、外部のMCPサーバーを設定ファイル（~/.gemini/settings.json または .gemini/settings.json）に登録することで、AIが使えるツールを拡張できます。

MCPサーバーはnpxやDockerで起動するものが多く、設定ファイルにコマンドとパラメータを記述するだけで接続できます。ツールが増えるほどGemini CLIが「考えてアクションできる」範囲が広がります。

料金と利用枠：無料で使える範囲

Gemini CLIの料金体系は利用方法によって異なります。

Geminiの料金プラン全体についてはGemini料金プランの詳細解説をご確認ください。個人開発や学習目的であれば、無料枠の範囲で十分に実用的な使い方ができます。Geminiが無料でどこまで使えるかについてはGemini無料版の活用ガイドもあわせてご覧ください。

Gemini CLIと他のAI CLIツールの比較

類似のAI CLIツールと比較したときのGemini CLIの位置づけを整理します。

Gemini CLIは無料枠の大きさとコンテキストウィンドウの広さが際立っています。Claude Codeはコーディング能力の高さで評価されており、どちらが優れているかはユースケースや好みによります。他のAIサービスとの詳細な性能・機能比較についてはGemini比較記事をご参照ください。

安全に使うための注意点

Gemini CLIはファイルシステムへの書き込みやシェルコマンドの実行ができるため、強力である反面、誤操作のリスクも存在します。安全に運用するための重要なポイントを整理します。

• 本番環境では使わない：本番サーバーや本番データベースに直接接続した環境でエージェント実行するのは避けてください。開発環境・ステージング環境での利用を基本とします。
• ファイル変更前の確認を必ず確認する：Gemini CLIはファイルを変更する前に「このファイルを書き換えてよいか？」と確認してくれますが、慌てて承認しないよう注意します。
• Gitで管理されたディレクトリで使う：変更をGitでトラッキングしておけば、万一誤った変更が加えられても git diff で確認・ git restore で巻き戻せます。
• APIキーの管理：APIキーを環境変数に設定する場合、コードや設定ファイルに直接書き込まないようにします。.env ファイルを使い、.gitignore に追加してください。
• 機密データを渡さない：個人情報・認証情報・顧客データを含むファイルをコンテキストとして渡すことは避けてください。
• GEMINI.mdにセキュリティポリシーを記載する：「外部APIキーをコードに直書きしない」「本番環境へのデプロイコマンドを実行しない」など、チームのルールをGEMINI.mdに明記しておくことで、AIの挙動をある程度制約できます。

よくあるエラーと対処法

まとめ

Gemini CLIは、最大100万トークンの大規模コンテキストウィンドウ、充実した無料利用枠、オープンソースによる拡張性を兼ね備えた、開発者にとって今最も注目すべきAI CLIツールのひとつです。現行の既定モデルであるGemini 3.5 Flash（2026年5月リリース）は高速・低コストでエージェント系タスクにも強く、高精度な処理が必要な場面ではGemini 3.1 Pro（1Mコンテキスト対応）への切り替えも容易です。インストールから実際の作業までの障壁が低く、GEMINI.mdによるプロジェクト固有のカスタマイズやMCPによる外部ツール統合まで対応しており、日々の開発ワークフローに自然に溶け込みます。

当社の実運用においても、コードレビューの補助・ドキュメント生成・リファクタリング提案など、繰り返し発生する定型タスクの削減に明確な効果が出ています。一方、本番環境での利用や機密データの取り扱いには注意が必要です。セキュリティを意識した運用ルールを整備した上で、段階的に活用範囲を広げていくことをお勧めします。

Geminiのモデル全体像や他サービスとの比較については、Geminiとは何か・Gemini比較の各記事もあわせてご活用ください。

関連記事

• gemini とは
• gemini gems
• gemini deep research
• gemini canvas
• gemini veo
• gemini imagen

参考文献

• Google AI（Gemini）プラン公式
• Google One AIプラン