blog

Gemini CLI とは何か:仕組み・使い方・終了後の移行先【2026年版】

Gemini CLI とは何か:仕組み・使い方・終了後の移行先【2026年版】

Gemini CLIとは:ターミナルで動くAIエージェントの本質

Gemini CLIは、GoogleのAIモデル「Gemini」をターミナル(コマンドライン)から直接操作するオープンソースのエージェントツールとして、2025年6月25日に公開された。ブラウザやGUIアプリを介さず、コードの生成・レビュー・リファクタリング、ファイル操作、Webリサーチといった複合タスクを自然言語で指示できる点が、従来のAIアシスタントとの本質的な差異である。

ただし、利用にあたって把握しておくべき重要な事実がある。Googleは2026年6月18日をもって、Gemini CLIおよびGemini Code Assist IDE拡張の個人向け提供を終了すると発表した(出典:株式会社フィット, 2026窓の杜, 2026)。後継ツールとして「Antigravity CLI」への移行が案内されており、応答性の向上とオーケストレーション対応が特徴として挙げられている。法人・有償契約(Google Workspace等)を通じた利用は継続できる形態があるため、組織での導入を検討する場合はGoogle公式の最新情報を確認されたい。

Geminiモデルそのものの概要についてはGeminiとは何か(基本概要)を、料金プラン全体についてはGemini料金プランの詳細解説を参照されたい。

ユーザー (ターミナル)

Gemini CLI エージェント層 (GEMINI.md参照)

Geminiモデル 3.5 Flash / 3.1 Pro 最大1Mトークン

外部連携 MCP / Google検索 ファイルシステム

自然言語指示 → エージェント解釈 → モデル推論 → ツール実行

Gemini CLIのアーキテクチャ概要:ターミナルからの自然言語指示がエージェント層を経てGeminiモデルと外部ツールに連携する

Gemini CLIの主な機能と技術的特徴

Gemini CLIは単なるチャットのコマンドライン版ではない。エージェントとして動作し、ファイルシステムへのアクセス、シェルコマンドの実行、外部ツール呼び出しを組み合わせて複合タスクを自律的に処理する。主要な機能は以下の通りである。

  • 大規模コンテキストウィンドウ:現行の主力モデルであるGemini 3.1 Proは最大100万トークンのコンテキストウィンドウを持ち、大規模なコードベース全体を一度に読み込んでの質問・編集が可能である。Gemini 3.5 Flash(2026年5月19日リリース)は高速・低コストで、コーディングやエージェント系ベンチマークにおいてGemini 3.1 Proを上回る性能が報告されている(出典:Google公式モデル情報)。
  • GEMINI.mdによるプロジェクトコンテキスト注入:プロジェクトルートに置いたMarkdownファイルを起動時に自動読み込みし、コーディング規約や設計方針を常時参照させられる。
  • Model Context Protocol(MCP)対応:外部MCPサーバーとの連携により、GitHub・Slack・自社APIなどとの統合が可能。2026年4月時点で数百規模のExtensionが公開されており、BigQueryやGoogle WorkspaceのExtensionも利用できる(出典:G-gen, 2026)。
  • Google検索との統合:リアルタイムWebリサーチをAIが自律的に実行し、最新情報を踏まえた回答を生成する。
  • 非対話モード(ワンショット実行):-pフラグでプロンプトを直接渡し、CI/CDパイプラインへの組み込みが可能。
  • オープンソース:GitHubで公開されており、コミュニティによるカスタマイズ・拡張が継続している。

2026年4月末のv0.40系アップデートでは、記憶機能・タスク管理・拡張機能群の強化が行われ、単純なコマンドラインインターフェースを超えたエージェント基盤としての性格が明確になった(出典:Zenn, 2026)。

インストールと基本操作

Gemini CLIのインストールはnpm install -g @google/gemini-cliの1コマンドで完了する。事前にNode.js 20以上が必要である(出典:blog.laozhang.ai, 2026)。

Step 1:Node.jsのバージョン確認
node -vを実行し、v20以上であることを確認する。未インストールの場合はnodejs.orgから取得する。
Step 2:グローバルインストール
npm install -g @google/gemini-cliを実行する。gemini --versionでバージョンが表示されれば成功である。
Step 3:起動と認証
geminiと入力して起動する。初回はGoogleアカウントへのOAuth認証(ブラウザ)が求められる。APIキーを使う場合は環境変数GEMINI_API_KEYを設定する。

対話モードで起動後に利用できる主なコマンドと操作を下表に示す。

コマンド・操作 説明
gemini 対話モードを起動する
gemini -p "指示文" 非対話モード(ワンショット実行)
/help 利用可能なスラッシュコマンドの一覧を表示する
/model 使用するモデルを切り替える
/tools 有効なツール(検索・ファイルアクセス等)を確認する
/clear 会話履歴をリセットする
@ファイル名 特定のファイルをコンテキストとして渡す
!から始まるコマンド シェルコマンドを直接実行する
/quit または Ctrl+D 終了する

実践的な活用パターンとGEMINI.mdカスタマイズ

コードベース横断的な理解と編集

Gemini CLIの最大の強みは、大規模コンテキストウィンドウを活かしてリポジトリ全体を読み込んだ上で横断的な質問・編集ができる点にある。対話モードで起動した状態で「このプロジェクトの認証フローを説明して」と問うと、複数ファイルにまたがるロジックを総合して解説する。「バグが発生している可能性のある箇所を洗い出して」のような曖昧な指示でも、コンテキスト全体を参照した上で疑わしいパターンを列挙する。

CI/CDパイプラインへの組み込み

非対話モードはスクリプト・自動化パイプラインへの統合に適している。Pull Request作成時に差分コードをGemini CLIに渡してレビューコメントを自動生成する用途や、デプロイ前のドキュメント自動更新などに活用できる。

GEMINI.mdによるプロジェクト固有の制御

プロジェクトルートにGEMINI.mdを置くと、Gemini CLIが起動時に自動で読み込む。記述できる内容の例として、技術スタック・コーディング規約、避けるべきライブラリや非推奨パターン、チーム固有の用語・設計方針、実行禁止コマンド(本番デプロイ等)などが挙げられる。毎回プロンプトで指示を繰り返す手間を省きつつ、AIの挙動をプロジェクト単位で制約できる実用的な仕組みである。セキュリティポリシー(「外部APIキーをコードに直書きしない」等)もここに記載しておくことが望ましい。

MCPによる外部ツール統合

設定ファイル(~/.gemini/settings.jsonまたは.gemini/settings.json)にMCPサーバーを登録することで、AIが使えるツールを拡張できる。代表的な統合先は次の通りである。

MCPサーバーの例 主な用途
GitHub MCP Issue作成・PR管理・コード検索
BigQuery Extension(Google製) クエリ実行・データ分析
Google Workspace Extension(Google製) ドキュメント・スプレッドシート連携
Filesystem MCP 指定ディレクトリへのファイルアクセス制御
自社カスタムMCP 社内APIや独自ツールとの連携

Geminiの画像生成機能との組み合わせや、ディープリサーチ機能についてはGemini Deep Research活用ガイドGemini Imagen解説もあわせて参照されたい。

料金・利用枠と他ツールとの比較

Gemini CLIの利用形態ごとの料金は次の通りである。APIのトークン単価等、最新情報はGoogle公式(gemini.google/subscriptions/Google AIプラン)で確認されたい。

Googleアカウント(個人・無料)
Gemini 3.5 Flash等を制限付きで無料利用可能。OAuthでログインするだけで開始できる。利用上限はGoogle公式を参照。
APIキー(Gemini API)
Google AI StudioでAPIキーを発行して利用。無料枠あり。超過分はトークン課金(Gemini 3.5 Flash:入力$1.50・出力$9.00 /百万トークン)。Vertex AI経由での利用も可能。
Google AI Pro / Ultra(有料)
Google AI Pro($19.99/月)はGemini 3.1 Pro・1Mコンテキスト対応。Google AI Ultra($99.99/月)はDeep Think・Gemini Sparkを含む最上位構成(出典:Google公式)。

類似のAI CLIツールとの比較を下表に示す。なお各ツールの仕様は変動するため、最新情報は各公式ドキュメントで確認されたい。

ツール 基盤モデル 無料利用 最大コンテキスト オープンソース MCP対応
Gemini CLI Gemini 3.5 Flash / 3.1 Pro 他 制限付きで無料 最大100万トークン
Antigravity CLI(後継) Gemini系 要確認 要確認 要確認 ○(オーケストレーション対応)
Claude Code Claude系 限定的 最大20万トークン(参考値) ×
GitHub Copilot CLI GPT-4o他 月60回(無料枠) 比較的小さい × ×
Aider 複数モデル対応 モデル依存 モデル依存 ×

Gemini CLIは無料利用枠の広さと最大100万トークンのコンテキストウィンドウが際立っている。一方で個人向けの提供終了という事実は、長期的な運用計画を立てる上で無視できない。他サービスとの詳細な性能・機能比較についてはGemini比較記事を参照されたい。無料版で利用できる範囲についてはGemini無料版の活用ガイドも有用である。

セキュリティ・運用上の注意点と既知の限界

Gemini CLIはファイルシステムへの書き込みとシェルコマンド実行が可能であるため、強力である反面、誤操作や情報漏洩のリスクが存在する。また、2026年3月25日以降のサービス変更により、不正利用検知(Abuse Detection)の強化と、サードパーティ製ソフトウェアを介したOAuth利用に関するポリシー違反の検知強化が実施されている(出典:Zenn, 2026)。

安全な運用のために守るべき原則を以下に示す。

  • 本番環境では使用しない:本番サーバーや本番データベースに直接接続した環境でのエージェント実行は避ける。開発環境・ステージング環境での利用を基本とする。
  • Gitで管理されたディレクトリで使う:変更をGitでトラッキングしておけば、誤った変更に対してgit diffでの確認・git restoreでの巻き戻しが可能である。
  • APIキーの管理:APIキーは.envファイルで管理し、コードや設定ファイルに直接書き込まない。.gitignoreへの追加も忘れずに行う。
  • 機密データをコンテキストとして渡さない:個人情報・認証情報・顧客データを含むファイルの読み込みは避ける。
  • GEMINI.mdにセキュリティポリシーを記載する:「本番環境へのデプロイコマンドを実行しない」「外部APIキーをコードに直書きしない」等のルールをGEMINI.mdに明記することで、AIの挙動を制約できる。
  • ファイル変更の確認プロンプトを軽視しない:Gemini CLIはファイル変更前に確認を求めるが、内容を精査せずに承認すると意図しない変更が生じうる。

限界としては、AIの推論能力はモデルに依存するため誤った提案が含まれる可能性があること、大規模コンテキストを多用する場合はAPIコストが増大すること、そして個人向け終了後は後継ツールAntigravity CLIへの移行が前提となることが挙げられる。

Gemini CLIを安全に運用するためのセキュリティ対策:本番環境分離・Git管理・APIキー保護・GEMINI.mdによるポリシー制御
Gemini CLIの安全な運用には、環境分離・Git管理・APIキー保護・GEMINI.mdによるポリシー制御の4点が基本となる

Geminiの関連機能についてさらに詳しく知りたい場合は、Gemini Gems活用ガイドGemini Canvas解説Gemini Veo解説も参照されたい。

弊社クリスタルメソッドが開発する「DeepAI」は、実在の人物の容姿・表情・声・振る舞いをデジタル空間で再現するバーチャルヒューマン/AIアバターソリューションである。接客・研修・面接練習・広報など、AIとの自然なインタラクションが求められる場面での活用を想定している。Gemini CLIのようなエージェント基盤と生成AIアバター技術の組み合わせに関心をお持ちの方は、弊社ブログで関連情報を発信しているのでご参照いただきたい。

参考文献

監修

河合 継(クリスタルメソッド株式会社 代表取締役)

AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番組でのAI解説実績を持つAI研究者として、AIの研究開発を主導している。
運営会社について編集方針

AIブログ購読

 
クリスタルメソッドがお届けする
AIブログの更新通知を受け取る

Study about AI

AIについて学ぶ

  • 音声・音楽AIのイメージ

    SakuraSpeech(サクラスピーチ)|日本語特化のAI音声合成 – ブラウザ・API・完全オフライン対応【2026年版】

    SakuraSpeech(サクラスピーチ)は、入力したテキストを自然で表情ゆたかな日本語音声に変換する、日本語特化のAI音声合成(TTS:Text-to-Spe...

  • GPT-5.5 Claude エージェント ベンチマーク選定——日本企業が問い直すべき評価軸

    GPT-5.5 Claude エージェント ベンチマーク選定——日本企業が問い直すべき評価軸

    GPT-5.5がClaude Fable 5を上回った——「Agents’ Last Exam」とは何か 2026年6月、AIエージェント評価の文脈...

  • 米上院 金融AI 規制 公聴会——日本の銀行・証券への実務的示唆

    米上院 金融AI 規制 公聴会——日本の銀行・証券への実務的示唆

    上院 金融AI 規制 公聴会の要点——何が、なぜ今議題に上ったか 2026年6月11日午前10時(米東部夏時間)、米上院銀行・住宅・都市問題委員会(U.S. S...

View more