LoginSignup
2
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@TechTW

Gemini CLI徹底解説：ターミナルでAIを活用する究極ガイド

Posted at

はじめに：Gemini CLIとは？

Gemini CLIは、Googleが開発したオープンソースのAIエージェントであり、その強力なAIモデルであるGeminiの機能を開発者のターミナルに直接もたらすことを目的としています¹。このツールは、自然言語を用いたコーディング、問題解決、タスク管理といった幅広い開発タスクを効率的に実行できるように設計されています¹。特に、コードベースの深い理解、バグの特定と修正、そして既存コードのリファクタリングを支援する強力なツールとして機能します³。

主要な機能と開発ワークフローにおける価値

  • コードベース理解
    大規模なプロジェクトにおいて、コード構造の要約やモジュールの役割説明、データフローのマッピングを行い、開発者が迅速にプロジェクトに慣れるのを支援します。

  • バグ検出と修正提案
    AIのガイダンスに基づき、コード内のバグを自動的に特定し、その修正案を提示。デバッグプロセスを大幅に効率化します。

  • リファクタリング支援
    コードの自動改善や簡素化を行い、品質と可読性を向上させます。

  • テスト生成
    Pytestなどのフレームワークを用いた単体テストケースを自動生成し、ソフトウェアの信頼性とCIプロセスを強化します。

  • ドキュメント作成支援
    構造化されたMarkdownドキュメント、変更ログ、GitHubのIssue返信などをターミナル内で直接作成可能です。

  • リアルタイム検索
    @searchツールを利用して、ベストプラクティスや情報をリアルタイムで検証できます。

基盤にはReason and Act（ReAct）ループというアーキテクチャを採用し、ローカル／リモートのMCPサーバーや組み込みツールを活用して、バグ修正や新機能作成、テストカバレッジ向上など複雑なユースケースを完了させます。

他のAIコードアシスタントとの比較

Gemini CLIは、AnthropicのClaude Codeに対するGoogleの戦略的回答として位置づけられています。現在はPreview段階ながら、その機能はすでにClaude Codeに匹敵すると評価されています。

GoogleのAI民主化戦略と開発ワークフロー変革へのコミットメント

  • オープンソース＆無料利用枠
    個人Googleアカウント認証で1日1,000リクエスト・1分60リクエストまで無料利用可能。これにより、個人開発者や中小企業の導入障壁を下げ、エコシステム構築を加速します。

  • 早期フィードバック収集
    Preview版として限定サポート下で公開し、ユーザーからのフィードバックを得ることでコミュニティ形成を図る戦略的リリースです。

  • 開発ワークフロー全体のAI支援
    コード理解～バグ修正、リファクタリング、テスト生成、ドキュメント支援まで、開発ライフサイクル全体をカバーすることで、生産性を飛躍的に向上させることを目指しています。

環境構築と認証ガイド

前提条件

  • Node.js／npm
    ・Node Version Manager (NVM) を使用し、Node.js v22をインストール推奨。
    ・npmのインストール確認。

Gemini CLIのインストール

  1. グローバルインストール

    npm install -g @google/gemini-cli

    システム全体で利用可能に。

  2. npxでの一時実行

    npx @google/gemini-cli

    グローバルインストールを避けたい場合。

  3. GitHubリポジトリから直接実行

    npx https://github.com/google-gemini/gemini-cli

    インストール不要。

インストール後はターミナルで gemini と入力するだけで起動できます。

APIキー取得と認証設定

  • APIキー取得
    Google AI Studioまたは既存のGoogle Cloudプロジェクトから取得。

  • 認証方法

    1. 環境変数

      export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

      (~/.bashrc や ~/.zshrc に記述)。

    2. .envファイル
      ~/.gemini/ またはプロジェクトルートの ./.gemini/ に .env を作成し記述。

    3. Googleアカウントログイン
      初回起動時のプロンプトで認証。1分60リクエスト・1日1,000リクエストの無料枠付与。

    4. Vertex AI
      より大規模利用時の高度認証・使用制限に対応。

    5. /authコマンド
      セッション中に認証方法を切り替え。

Gemini CLIの基本操作モード

  1. 対話モード（REPL）

    gemini

    プロンプト入力→AI応答をリアルタイム取得。/quit で終了。

  2. 非対話モード（単一プロンプト）

    gemini -p "あなたのプロンプト"

    スクリプト利用や単発タスク向け。

  3. パイプ処理

    echo "Count to 10" | gemini

    他コマンドの出力をAIが解釈・整形。

  4. サンドボックスモード

    gemini --sandbox -p "あなたのプロンプト"

    Docker/Podmanによる隔離実行で安全性確保。

主要コマンドカテゴリと実践的活用術

スラッシュコマンド（/）

コマンド 機能概要 使用例
/compress チャットコンテキストを要約しトークン節約 /compress
/copy 最後の応答をクリップボードにコピー /copy
/mcp MCPサーバーと利用可能ツールを一覧表示 /mcp
/clear ターミナル画面とコンテキストをクリア /clear
/tools 利用可能なツールを一覧表示 /tools
/extensions アクティブな拡張機能を一覧表示 /extensions
/stats セッションのトークン使用量と節約量を表示 /stats
/memory show 結合されたプロジェクトコンテキストを表示 /memory show
/memory refresh コンテキストをリロード /memory refresh
/chat save 会話をタグ付きで保存 /chat save my_session
/chat resume 保存した会話を再開 /chat resume bugfix_attempt
/restore プロジェクト状態チェックポイントを一覧/復元 /restore checkpoint_20231026
/auth 認証方法を変更 /auth
/bug バグレポート提出 /bug
/help ヘルプ情報表示 /help
/theme CLI視覚テーマ変更 /theme
/quit CLIを終了 /quit

コンテキストコマンド（@）

コンテキストコマンドは、プロンプト内でファイルやディレクトリを参照し、それらの内容をモデルのコンテキストとして提供するために使用されます 。

  • 単一ファイル: @./path/to/file.ext
  • ディレクトリ全体: @./path/to/directory/
  • GEMINI.md: プロジェクト固有指示を提供。
  • 他Markdownインポート: @./another.md

読み込み順序は、グローバル → プロジェクト祖先 → サブディレクトリの階層構造を尊重します¹。

シェルコマンド（!）

  • 単一実行: !git status
    プロンプトの先頭に!を付けてコマンドを入力することで、そのコマンドがシェルで実行されます。
  • シェルモード切替: 単独で ! を入力し、再度 ! で戻る。

高度な設定とカスタマイズ

settings.jsonによる動作設定

settings.jsonファイルを作成することで、Gemini CLIの動作を詳細にカスタマイズできます 。この設定ファイルは、プロジェクト、ユーザー、システムの順で優先順位が適用されるため、特定のプロジェクトに合わせた設定や、個人の好みに合わせたグローバルな設定が可能です 。

  • 優先順位: プロジェクト > ユーザー > システム

  • 主なオプション

    • theme（視覚テーマ）
    • autoAccept（ツール呼び出し自動承認）
    • sandbox（隔離モード設定）
    • checkpointing（事前スナップショット保存）
    • fileFiltering（.gitignore尊重）
    • usageStatisticsEnabled（統計送信無効化）
    • mcpServers（カスタムMCPサーバー設定）

カスタムコマンドと拡張機能

  • TOMLファイルで独自コマンド定義
    ~/.gemini/commands/ または <project>/.gemini/commands/。
  • 拡張機能
    <workspace>/.gemini/extensions/ または ~/.gemini/extensions/ に配置。gemini-extension.json で設定。

チェックポイント機能

--checkpointing または settings.json で有効化。変更前に自動スナップショットを保存し、/restore で任意の状態に復元可能。

開発ワークフローの最適化

  1. 新規プロジェクト立ち上げ

    cd new-project/
gemini

    自然言語で初期コード生成。

  2. 既存コード理解・修正
    プロジェクト内で gemini 実行または /path コマンドで手動ロード。

  3. 単体テスト自動生成
    「ログインボタンのテストを作成してください」などでJest/Pytestテスト生成。

  4. ドキュメント作成
    変更ログやMarkdownレポートを自動生成。

  5. データフロー可視化
    フローチャート・ダイアグラム生成でシステム全体を把握。

まとめと今後の展望

  • 主要利点
    生産性向上、学習曲線短縮、品質向上、柔軟な認証オプション、無料利用枠によるアクセシビリティ。

  • ベストプラクティス
    適切な認証、GEMINI.md／@コマンド活用、サンドボックス＆チェックポイント利用。

  • 注意点
    Preview版のため限定サポート、API経由で「遅さ」を感じる場合あり。

  • 将来性
    MCPサーバーや拡張機能を通じたコミュニティ主導のイノベーション、Google Cloudサービスとのさらなる連携、エンタープライズ利用拡大。

Gemini CLIは、ターミナル中心の開発パラダイムを強化し、AIを「共同作業者」として深く統合することで、開発者のワークフローを大きく変革する可能性を秘めています。

2
3
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
2
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?