Gemini CLI

メモ

無償プランおよび Google One ユーザー： Gemini CLI は、2026 年 6 月 18 日に Antigravity CLI に置き換えられました。詳しくは、 ブログ記事をご覧ください。

Gemini CLI は Gemini 4 Argon 向けに最適化されていません。 Gemini 4 Argon を使用するには、Antigravity をご利用ください。

Gemini CLI

メモ

Gemini CLI は最新の Gemini モデル向けに最適化されていません。Gemini モデルで最高のコーディング エクスペリエンスを得るには、 Antigravity CLIをご利用ください。

Gemini CLI は、Gemini の力をターミナルに直接もたらすオープンソースの AI エージェントです。Gemini に軽量にアクセスでき、プロンプトからモデルまで最も直接的な経路を提供します。

Gemini CLI の詳細は、ドキュメントをご覧ください。

📦 インストール

推奨システム仕様と詳細なインストールガイドについては、 Gemini CLI のインストール、実行、リリースをご覧ください。

クイックインストール

npx ですぐに実行

# Using npx (no installation required)
npx @google/gemini-cli

npm でグローバルにインストール

npm install -g @google/gemini-cli

Homebrew でグローバルにインストール（macOS/Linux）

brew install gemini-cli

MacPorts でグローバルにインストール（macOS）

sudo port install gemini-cli

Anaconda でインストール（制限のある環境向け）

# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli

リリースチャンネル

詳しくはリリースをご覧ください。

プレビュー

新しいプレビューリリースは毎週火曜日の UTC 23:59 に公開されます。これらの リリースは十分な検証が完了しておらず、リグレッションやその他の未解決の問題が 含まれる可能性があります。preview タグを使ってテストとインストールにご協力ください。

npm install -g @google/gemini-cli@preview

安定版

• 新しい安定版リリースは毎週火曜日の UTC 20:00 に公開されます。前週の preview リリースにバグ修正と検証を加えた正式版です。latest タグを使用してください。

npm install -g @google/gemini-cli@latest

ナイトリー

• 新しいリリースは毎日 UTC 00:00 に公開されます。リリース時点の main ブランチにある変更が すべて含まれます。検証や対応が保留中の問題があるものとしてご利用ください。nightly タグを使用してください。

npm install -g @google/gemini-cli@nightly

📋 主な機能

コードの理解と生成

• 大規模なコードベースを検索・編集
• マルチモーダル機能を使い、PDF、画像、スケッチから新しいアプリを生成
• 自然言語で問題をデバッグし、トラブルシューティング

自動化と連携

• プルリクエストの検索や複雑なリベースへの対応など、運用タスクを自動化
• MCP サーバーを使って新しい機能を接続。たとえば、 Imagen、Veo、Lyria によるメディア生成
• ワークフロー自動化のため、スクリプト内で非対話的に実行

🔐 認証方法

ニーズに最適な認証方法を選択してください。

オプション 1：Google でログイン（Google アカウントを使った OAuth ログイン）

組織の有料 Code Assist ライセンスを使用する場合は、Google Cloud プロジェクトを設定してください

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

オプション 2：Gemini API Key

✨ 最適な用途： 特定のモデルを制御したい、または有料プランを利用したい開発者

メリット：

• モデルの選択：特定の Gemini モデルを選択できます
• 従量課金：必要に応じてアップグレードし、上限を引き上げられます

# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

オプション 3：Vertex AI

✨ 最適な用途： エンタープライズチームや本番環境のワークロード

メリット：

• エンタープライズ機能：高度なセキュリティとコンプライアンス
• スケーラブル：課金アカウントを使用すると、レート制限が引き上げられます
• 統合：既存の Google Cloud インフラストラクチャと連携します

# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

Google Workspace アカウントやその他の認証方法については、 認証ガイドをご覧ください。

🚀 はじめに

メモ

Gemini CLI は最新の Gemini モデル向けに最適化されていません。Gemini モデルで最適なコーディング体験を得るには、 Antigravity CLIをお使いください。

基本的な使い方

現在のディレクトリで開始する

gemini

複数のディレクトリを含める

gemini --include-directories ../lib,../docs

特定のモデルを使用する

gemini -m gemini-2.5-flash

スクリプト向けの非対話モード

シンプルなテキスト応答を取得します。

gemini -p "Explain the architecture of this codebase"

JSON の解析やエラー処理など、より高度なスクリプトを作成するには、 --output-format json フラグを使用して、構造化された出力を取得します。

gemini -p "Explain the architecture of this codebase" --output-format json

リアルタイムのイベントストリーミング（長時間実行される操作の監視に便利）には、 --output-format stream-jsonを使用して、改行区切りの JSON イベントを取得します。

gemini -p "Run tests and deploy" --output-format stream-json

使用例

新しいプロジェクトを開始する

cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

既存のコードを分析する

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday

📚 ドキュメント

はじめに

• クイックスタートガイド - すぐに使い始められます。
• 認証の設定 - 認証設定の詳細です。
• 設定ガイド - 設定とカスタマイズについて説明します。
• キーボードショートカット - 生産性向上のヒントです。

主な機能

• コマンドリファレンス - すべてのスラッシュコマンド（/help、/chatなど）。
• カスタムコマンド - 再利用可能な独自のコマンドを作成できます。
• コンテキストファイル（GEMINI.md） - Gemini CLI に永続的なコンテキストを提供します。
• チェックポイント - 会話を保存して再開できます。
• トークンキャッシュ - トークンの使用量を最適化します。

ツールと拡張機能

• 組み込みツールの概要
  • ファイルシステム操作
  • シェルコマンド
  • ウェブの取得と検索
• MCP サーバーとの統合 - カスタムツールで機能を拡張できます。
• カスタム拡張機能 - 独自のコマンドを作成して共有できます。

高度なトピック

• ヘッドレスモード（スクリプト） - Gemini CLI を自動化されたワークフローで使用します。
• IDE 連携 - VS Code のコンパニオンです。
• サンドボックス化とセキュリティ - 安全な 実行環境です。
• 信頼済みフォルダー - フォルダーごとに実行ポリシーを管理します。
• エンタープライズガイド - 企業環境での デプロイと管理について説明します。
• テレメトリとモニタリング - 使用状況を追跡します。
• ツールリファレンス - 組み込みツールの概要です。
• ローカル開発 - ローカル開発ツールについて説明します。

トラブルシューティングとサポート

• トラブルシューティングガイド - よくある問題と解決策です。
• FAQ - よくある 質問です。
• /bug コマンドを使うと、CLI から直接問題を報告できます。

MCP サーバーの使用

~/.gemini/settings.json で MCP サーバーを設定し、Gemini CLI に カスタムツールを追加できます。

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

設定方法については、 MCP サーバー連携ガイド をご覧ください。

🤝 貢献

皆さまからの貢献を歓迎します！Gemini CLI は完全なオープンソース（Apache 2.0）であり、 コミュニティの皆さまには次のようなご協力をお願いしています。

• バグの報告や機能の提案。
• ドキュメントの改善。
• コードの改善案の提出。
• MCP サーバーや拡張機能の共有。

開発環境のセットアップ、コーディング規約、プルリクエストの提出方法については、 貢献ガイドをご覧ください。

予定されている機能や優先事項については、公式ロードマップをご覧ください。

📖 リソース

• 無料コース - 基本を学びましょう。
• 公式ロードマップ - 今後の予定をご確認ください。
• 変更履歴 - 最近の 主な更新をご確認ください。
• NPM パッケージ - パッケージ レジストリです。
• GitHub の Issue - バグの報告や機能のリクエストにご利用ください。
• セキュリティアドバイザリ - セキュリティ更新情報です。

アンインストール

削除方法については、アンインストールガイド をご覧ください。

📄 法的情報

• ライセンス: Apache License 2.0
• 利用規約: 利用規約とプライバシー
• セキュリティ: セキュリティポリシー

---

Google とオープンソースコミュニティが ❤️ を込めて開発