blog

Gemini CLIとは?仕組み・使い方・料金から終了後の移行先(Antigravity 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の業務導入・社内活用をご検討の方は、AI開発会社クリスタルメソッドの無料相談をご利用ください。

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

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 と Claude Code の技術比較:移行期に開発者が知っておきたい違い

Gemini CLIの個人向け提供終了(2026年6月18日)とAntigravity CLIへの移行を機に、「そもそも他のCLI型AIエージェントとどう違うのか」を比較検討する開発者は多い。crystal-methodはAIエージェント開発を専門とし、社内の開発フローでClaude Codeを1年以上、本番運用として使い続けているという一次経験を持つ。ここではGemini CLI公式リポジトリ・公式ドキュメント、Anthropic公式ドキュメント・公式料金ページで確認できた事実だけを、実運用側の視点で技術比較する。Gemini CLI自体を本番運用してきた実績は当社にはないため、体験談ではなく公開情報どうしの比較に限定する。

項目 Gemini CLI Claude Code
提供元 Google Anthropic
ソースコード オープンソース(GitHub公開:google-gemini/gemini-cli) 非公開(プロプライエタリ)
個人・無料での利用 Googleアカウントでログインすれば無償版Gemini Code Assistライセンスが適用され、60リクエスト/分・1,000リクエスト/日まで無料(公式ドキュメント記載) 無料プランにはClaude Codeは含まれない。利用にはPro(月額20ドル、年払いは月額17ドル)以上のサブスクリプション、またはAnthropic Console経由のAPI従量課金が必須(公式料金ページ記載)
ツール呼び出し・拡張の仕組み 組み込みツール(ファイル操作・シェルコマンド・Google検索によるグラウンディング)に加え、MCP(Model Context Protocol)で外部ツールを拡張。プロジェクト文脈は「GEMINI.md」に記述 MCPに標準対応し外部ツール連携が可能。プロジェクト文脈は「CLAUDE.md」に永続化。加えて複数のClaude Codeを並列実行し1つのリードエージェントが調整する「サブエージェント」、処理前後にコマンドを挟む「Hooks」、再利用可能な作業手順を型化する「Skills」を標準機能として持つ
対応モデル Gemini 3ファミリー、Gemini 2.5 Flash(公式ドキュメント記載) Claudeモデル各種(提供ラインナップは随時更新されるため、最新の対応状況は公式サイトを参照)
個人向け提供の継続性 2026年6月18日をもって個人向け(Googleアカウントログイン)提供を終了。後継としてGo製・クローズドソースの「Antigravity CLI」(コマンド名agy)への移行をGoogleが案内。Standard/Enterprise版のGemini Code Assistおよび有料APIキー経由の利用は継続 本記事執筆時点で個人向け提供の終了予告なし(変更の可能性があるため最新情報は公式サイトで確認)

実務でCLI型AIエージェントを比較するとき、まず効いてくるのは「無料で試せる上限」と「エージェントがどこまで自律的にタスクを分担できるか」の2点だ。Gemini CLIは個人利用のハードルの低さ(無料・オープンソース)が強みだったが、2026年6月18日の個人向け終了によりAntigravity CLIへの移行が前提となる。一方でClaude Codeは無料プランが無く実務投入には月額課金が前提になる代わりに、サブエージェントによる並列作業やHooksによる自動化など、複数タスクを同時に回す運用を見据えた機能が標準で揃っている。どちらを選ぶかは「まず無料で触ってみたいか」「本番の開発フローに継続的に組み込みたいか」という利用目的で分かれる、というのが1年間Claude Codeを実運用してきた開発者としての実感だ。

なお、後継のAntigravity CLIはクローズドソース・Go製で、複数エージェントの並列実行と非同期ワークフローを前提に設計されている(Google発表)。これはGemini CLIの元々の設計というより、むしろClaude Codeのサブエージェント設計に近い方向への進化と言える。Gemini CLIからの移行を検討する開発者にとっては、「オープンソースの手軽さ」から「並列・非同期のエージェント運用」へと設計思想そのものが変わる移行になる点は覚えておきたい。

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

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の研究開発を主導している。
運営会社について編集方針

Geminiを使ったAI業務活用のご相談はこちら

クリスタルメソッドは、Geminiを起点にした業務へのAI導入・AIエージェント開発を支援しています。「自社の業務にGeminiをどう活かせるか」「Google Workspaceと連携した活用をしたい」といったご相談を承っています。

AIブログ購読

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

Study about AI

AIについて学ぶ

  • Gemini 3.7 Flash料金比較と導入判断:2026年末までの半額期間を活かす企業戦略

    Gemini 3.7 Flash料金比較と導入判断:2026年末までの半額期間を活かす企業戦略

    Googleは2026年8月13日、前バージョンであるGemini 3.6 Flashのリリースからわずか3週間という異例の速さで、最新の軽量・高速モデル「Ge...

  • GPT-5.6の高速化が日本企業に与える影響と、経営層が取るべき導入判断基準

    GPT-5.6の高速化が日本企業に与える影響と、経営層が取るべき導入判断基準

    GPT-5.6 Solの「14倍高速化」が示す技術革新の全貌 OpenAIはAIチップメーカーのCerebrasと提携し、同社のフラグシップモデル「GPT-5....

  • IBM OpenAI 提携がもたらす企業向けAIの変革と日本企業が取るべき一手

    IBM OpenAI 提携がもたらす企業向けAIの変革と日本企業が取るべき一手

    IBMとOpenAIの戦略的提携と「GPT-5.6」統合の概要 米IBMとOpenAIは2026年8月13日、エンタープライズAIの展開を大規模に加速するための...

View more