Gemini CLI 入門ガイド：インストールから初回起動まで

AI

Gemini CLI 入門ガイド：インストールから初回起動まで

Googleが提供する強力なAIモデル「Gemini」を、ブラウザを介さずにターミナルから直接操作できるGemini CLI。エンジニアにとって、開発ワークフローにAIを組み込むための非常に強力なツールです。

本記事では、公式のNode.js（npm）ベースのインストール方法から、業務利用で必須となるプライバシー設定、そして便利な実行例までをステップバイステップで徹底解説します。

1. 動作環境と事前準備

作業を始める前に、以下の環境が整っているか確認してください。

  • OS: Windows 11 / macOS / Linux
  • Node.js: LTSバージョン推奨（node -v で確認可能）
  • Google アカウント: 個人アカウントまたは Google Workspace アカウント

2. Gemini CLI のインストール手順

Gemini CLIはnpmパッケージとして提供されています。環境に合わせて以下のいずれかの方法を選択してください。

一時的に実行する場合（推奨）

インストールせずに最新版を試したい場合は、npx を使用するのが最も手軽です。

npx @google/gemini-cli

グローバルにインストールする場合

頻繁に使用する場合は、以下のコマンドでシステム全体にインストールします。

npm install -g @google/gemini-cli

3. 初回起動とログイン認証

インストール後、ターミナルで gemini コマンドを実行して認証を行います。

  1. コマンド実行: ターミナルで gemini と入力します。
  2. ブラウザ起動: 自動的にブラウザが立ち上がり、Googleアカウントのログイン画面が表示されます。
  3. 認証の承認: 使用するアカウントを選択し、アクセスを許可します。
  4. 完了: ブラウザに「Authentication successful」と表示されれば、準備完了です。

4. セキュリティとプライバシー設定（重要！）

業務や技術検証で利用する場合、データの取り扱いには注意が必要です。デフォルトでは利用統計が送信される設定になっているため、以下の手順でオプトアウト（収集停止）を設定しましょう。

設定ファイル（settings.json）を編集して、セキュリティを強化します。

  • 設定ファイルのパス: ~/.gemini/settings.json
  • 編集内容: usageStatisticsEnabled を false に設定します。
{
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  },
  "privacy": {
    "usageStatisticsEnabled": false
  }
}

5. Gemini CLI の活用例：基本から応用まで

環境が整ったら、実際にGeminiを動かしてみましょう。

① インタラクティブモード（対話型）

通常のチャットのように、対話形式で質問ができます。

gemini

User: 日本の富士山の高さは？ Gemini: 富士山の高さは 3,776 メートルです。

② 単発クエリの実行

引数としてプロンプトを直接渡すことも可能です。

gemini "Node.jsでファイルを読み込むサンプルコードを書いて"

③ パイプ（Pipe）を利用した高度な連携

エンジニアにとって最も便利な使い方が、他のコマンドの結果をGeminiに渡す方法です。

cat app.js | gemini "このコードのロジックを簡潔に解説して"
  • エラーログの解析:
cat error.log | gemini "このエラーの原因と対策を教えて"

6. まとめ

Gemini CLIを導入することで、開発効率は劇的に向上します。

  • 手軽さ: npmコマンド一つで即導入可能
  • 安全性: 設定ファイルでプライバシー保護が可能
  • 実用性: パイプ処理によるターミナル作業の自動化に最適

まずは npx @google/gemini-cli で、その利便性を体感してみてください！