Gemini CLI

Gemini CLI とは

Gemini CLI は、Google がオープンソース（Apache 2.0）で公開しているコマンドライン向けの AI エージェントです。ターミナルで gemini を起動し、コードの質問、ファイル編集、シェルコマンドの実行などを Gemini モデルに頼めます。

現在の位置づけ（重要）

公式 README とドキュメントによると、個人の無料利用や Google AI Pro/Ultra の利用者向けの提供は、2026年6月18日に Antigravity CLI（agy）へ移りました。Gemini CLI は現在、Gemini Code Assist の Standard/Enterprise や GitHub 向け Code Assist を契約している組織、そして従来からの有料 API キーや Vertex AI の利用者が主な対象です。ドキュメントには、最新モデルの Gemini 4 Argon には最適化されておらず、使いたい場合は Antigravity を使うよう案内があります。新規に始める個人の方は、まず公式の案内で自分の契約がどちらに当たるかを確認してください。

できること

• 大きなコードベースの質問と編集。複数ディレクトリを --include-directories で追加できます。
• PDF・画像・スケッチからのアプリ生成。
• PR の確認やリベースなどの自動化。
• --output-format json や stream-json による非対話実行。

しくみ

プロジェクトの文脈は GEMINI.md というコンテキストファイルで渡します。MCP サーバーは ~/.gemini/settings.json に設定して拡張できます。ほかに拡張機能、エージェントスキル、フック、チェックポイント（セッションの自動保存）、サンドボックス、信頼するフォルダの設定があります。

料金の考え方

認証方式ごとに異なります。Google アカウントでのログインは組織の Code Assist ライセンスが前提、Gemini API キーは従量課金、Vertex AI は企業向けです。具体的な金額はライセンスと利用量で変わるため、公式の案内を確認してください。

主な機能

• GEMINI.md: プロジェクトの文脈や指示を渡すコンテキストファイル。
• MCP: 外部のツールやサービスを settings.json で追加。
• 拡張機能とエージェントスキル: 機能や手順の追加。
• フック: スクリプトで挙動をカスタマイズ。
• チェックポイント: セッションの自動スナップショット。
• サンドボックスと信頼するフォルダ: ツールの実行範囲を限定。
• 非対話モード: JSON 出力でスクリプトや CI に組み込めます。

リポジトリの構成

packages 配下に cli、core、a2a-server、vscode-ide-companion などが分かれており、docs と ROADMAP.md も公開されています。

インストール

npm install -g @google/gemini-cli

インストールせずに試すなら npx @google/gemini-cli、macOS・Linux では brew install gemini-cli でも入れられます。リリースチャンネルは @latest（安定版）、@preview、@nightly から選べます。

認証

次のいずれかを選びます。

1. Google でログイン: OAuth で Google アカウントにログインします。有料の Code Assist ライセンスを使う場合は GOOGLE_CLOUD_PROJECT を設定します。
2. Gemini API キー: GEMINI_API_KEY を設定します。モデルを選べ、利用量に応じた課金です。
3. Vertex AI: GOOGLE_API_KEY と GOOGLE_GENAI_USE_VERTEXAI=true を設定します。企業向けです。

起動

cd your-project
gemini

モデルは -m で指定できます。

• 個人向けの無料利用は2026年6月18日に Antigravity CLI へ移っています。以前の情報（無料枠の回数など）をそのまま当てはめないでください。
• 最新モデルの Gemini 4 Argon には最適化されていないと公式が案内しています。
• ファイル編集やシェル実行を行うため、サンドボックスや信頼するフォルダの設定を理解して使ってください。
• API キーや Vertex AI を使うと従量課金です。上限の設定を確認してください。
• 入力した内容は Google のサービスで処理されます。データの扱いは、使う認証方式とライセンスの規約で確認してください。
• GitHub のスター数は 約10万9千（2026年11月10日時点）、最新リリースは v0.67.0（2026年11月4日）です。