Gemini CLI セットアップガイド：完全インストール解説 (2026年版)

Gemini CLI セットアップガイド：完全インストール (2026年版)

Gemini CLI は、Google が提供するオープンソースのターミナルベース AI コーディングエージェントです。Gemini 2.5 Pro のパワーをコマンドラインに直接もたらし、ターミナルを離れることなく、AI とのチャット、コードの編集、コマンドの実行、ファイルの管理を可能にします。Google アカウントがあれば無料で利用でき、寛大な 1 日あたりの利用枠が提供されています。

このガイドでは、macOS、Linux、Windows での完全なセットアッププロセスに加え、設定のヒントや実用的な使用例を詳しく解説します。

Gemini CLI とは？

Gemini CLI は、ターミナルで動作するエージェント型 AI ツールです。Claude Code や GitHub Copilot CLI のようなものですが、Google の Gemini モデルを搭載しているのが特徴です。

機能	詳細
モデル	Gemini 2.5 Pro (デフォルト)
価格	無料 (Google アカウントが必要)
1日の制限	1,000 リクエスト/日 (無料ティア)
コンテキスト	ローカルファイルとプロジェクト構造を読み取り
アクション	ファイル編集、コマンド実行、コード検索、ファイル作成
プラットフォーム	macOS, Linux, Windows (WSL 経由またはネイティブ)
オープンソース	はい (Apache 2.0 ライセンス)

前提条件

Gemini CLI をインストールする前に、以下を確認してください：

Node.js 18 以降 がインストールされていること
Google アカウント (無料の Gmail アカウントで可) を持っていること
ターミナルアプリケーション (macOS のターミナル、Linux の各種ターミナル、または Windows Terminal)

Node.js のバージョンを確認する：

node --version
# v18.0.0 以上が出力される必要があります

Node.js のインストールまたは更新が必要な場合：

# macOS (Homebrew を使用)
brew install node

# Linux (nvm を使用)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts

# Windows (winget を使用)
winget install OpenJS.NodeJS.LTS

ステップ 1: Gemini CLI のインストール

Gemini CLI を実行する最も簡単な方法は npx を使用することです。これにより、グローバルインストールなしで実行できます。

npx https://github.com/anthropics/claude-code gemini

失礼、これは正しくありません。Gemini CLI は Google の製品です。正しいインストール方法は以下の通りです。

方法 1: npx で実行 (インストール不要)

npx @google/gemini-cli

これにより、永続的なインストールなしで最新バージョンがダウンロードされ、実行されます。お試しで使うには最速の方法です。

方法 2: npm でグローバルインストール

npm install -g @google/gemini-cli

インストール後は、どこからでも実行できます：

gemini

方法 3: ソースからインストール

コントリビューターや最新の開発版を利用したい方向け：

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
npm install
npm run build
npm link

インストールの確認

gemini --version

ターミナルにバージョン番号が表示されれば成功です。

ステップ 2: Google 認証

Gemini CLI を初めて実行すると、Google アカウントでの認証を求められます。

gemini

以下のようなメッセージが表示されます：

Welcome to Gemini CLI!
To get started, you need to sign in with your Google account.
Opening browser for authentication...

ブラウザウィンドウが自動的に開きます。
Google アカウントでサインインします。
要求された権限を許可します。
ブラウザで認証完了が確認されます。
ターミナルに戻ります。これで Gemini CLI が使用可能になります。

代替案：API キーで認証する

OAuth ではなく Gemini API キーを使用したい場合：

aistudio.google.com/apikey から API キーを取得します。
環境変数を設定します：

# シェルプロファイル (~/.bashrc, ~/.zshrc など) に追加
export GEMINI_API_KEY="your-api-key-here"

ターミナルを再起動するか、プロファイルを読み込みます：

source ~/.zshrc  # または ~/.bashrc

Gemini CLI を実行すると、自動的に API キーが使用されます：

gemini

認証方法の比較

方法	セットアップ	最適な用途
Google OAuth (デフォルト)	ブラウザでのサインイン	個人利用、最高の無料制限枠
API キー	環境変数	CI/CD、自動化、スクリプト
サービスアカウント	JSON キーファイル	エンタープライズ、サーバー環境

ステップ 3: 基本設定

Gemini CLI は、設定ファイルと環境変数を通じて構成できます。

設定ファイル

~/.gemini/settings.json に設定ファイルを作成または編集します：

{
  "model": "gemini-2.5-pro",
  "theme": "dark",
  "autoApprove": false,
  "sandboxMode": true,
  "maxTokens": 8192,
  "temperature": 0.7
}

主要な設定オプション

設定	デフォルト	説明
`model`	`gemini-2.5-pro`	使用する Gemini モデル
`theme`	`dark`	ターミナルのカラーテーマ (dark/light)
`autoApprove`	`false`	ファイル編集やコマンドの自動承認
`sandboxMode`	`true`	破壊的な操作を制限する
`maxTokens`	`8192`	1回答あたりの最大出力トークン数
`temperature`	`0.7`	創造性レベル (0.0-1.0)

プロジェクトレベルの設定

プロジェクトのルートに .gemini ファイルを作成し、プロジェクト固有の指示を設定できます：

# .gemini

## Project Context
これは TypeScript、Tailwind CSS、Prisma ORM を使用した Next.js 15 アプリケーションです。

## Coding Standards
- TypeScript の strict モードを使用すること
- コードベース内の既存の命名規則に従うこと
- すべてのエクスポートされた関数に JSDoc コメントを書くこと
- デフォルトでサーバーコンポーネントを使用し、必要な場合にのみクライアントコンポーネントを使用すること

## Testing
- Vitest を使用してテストを書くこと
- テストファイルはソースファイルと同じ場所に .test.ts 拡張子で配置すること

Gemini CLI をプロジェクトディレクトリから実行すると、このファイルが自動的に読み込まれます。

ステップ 4: 必須コマンド

インタラクティブセッションを開始する

# プロジェクトディレクトリに移動
cd /path/to/your/project

# Gemini CLI を起動
gemini

単一のコマンドを実行する

# インタラクティブモードに入らずに質問する
gemini "package.json と README に基づいて、このプロジェクトが何をするものか説明して"

一般的なインタラクティブコマンド

インタラクティブセッション内では、以下のコマンドが使用できます：

コマンド	説明
`/help`	利用可能なすべてのコマンドを表示
`/model`	アクティブなモデルを切り替え
`/context`	現在のコンテキスト (読み込まれたファイル) を表示
`/clear`	会話履歴をクリア
`/compact`	会話を要約してコンテキストを節約
`/quit` または `Ctrl+C`	Gemini CLI を終了
`/stats`	トークン使用統計を表示

ステップ 5: 実用的な使用例

コードベースについて質問する

> src/middleware.ts の認証ミドルウェアは何をしていますか？
  潜在的なセキュリティ上の問題があれば指摘してください。

Gemini CLI セットアップガイド：完全インストール (2026年版)

このガイドでは、macOS、Linux、Windows での完全なセットアッププロセスに加え、設定のヒントや実用的な使用例を詳しく解説します。

Gemini CLI とは？

機能	詳細
モデル	Gemini 2.5 Pro (デフォルト)
価格	無料 (Google アカウントが必要)
1日の制限	1,000 リクエスト/日 (無料ティア)
コンテキスト	ローカルファイルとプロジェクト構造を読み取り
アクション	ファイル編集、コマンド実行、コード検索、ファイル作成
プラットフォーム	macOS, Linux, Windows (WSL 経由またはネイティブ)
オープンソース	はい (Apache 2.0 ライセンス)

前提条件

Gemini CLI をインストールする前に、以下を確認してください：

Node.js 18 以降 がインストールされていること
Google アカウント (無料の Gmail アカウントで可) を持っていること
ターミナルアプリケーション (macOS のターミナル、Linux の各種ターミナル、または Windows Terminal)

Node.js のバージョンを確認する：

node --version
# v18.0.0 以上が出力される必要があります

Node.js のインストールまたは更新が必要な場合：

# macOS (Homebrew を使用)
brew install node

# Linux (nvm を使用)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts

# Windows (winget を使用)
winget install OpenJS.NodeJS.LTS

ステップ 1: Gemini CLI のインストール

Gemini CLI を実行する最も簡単な方法は npx を使用することです。これにより、グローバルインストールなしで実行できます。

npx https://github.com/anthropics/claude-code gemini

失礼、これは正しくありません。Gemini CLI は Google の製品です。正しいインストール方法は以下の通りです。

方法 1: npx で実行 (インストール不要)

npx @google/gemini-cli

これにより、永続的なインストールなしで最新バージョンがダウンロードされ、実行されます。お試しで使うには最速の方法です。

方法 2: npm でグローバルインストール

npm install -g @google/gemini-cli

インストール後は、どこからでも実行できます：

gemini

方法 3: ソースからインストール

コントリビューターや最新の開発版を利用したい方向け：

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
npm install
npm run build
npm link

インストールの確認

gemini --version

ターミナルにバージョン番号が表示されれば成功です。

ステップ 2: Google 認証

Gemini CLI を初めて実行すると、Google アカウントでの認証を求められます。

gemini

以下のようなメッセージが表示されます：

Welcome to Gemini CLI!
To get started, you need to sign in with your Google account.
Opening browser for authentication...

ブラウザウィンドウが自動的に開きます。
Google アカウントでサインインします。
要求された権限を許可します。
ブラウザで認証完了が確認されます。
ターミナルに戻ります。これで Gemini CLI が使用可能になります。

代替案：API キーで認証する

OAuth ではなく Gemini API キーを使用したい場合：

aistudio.google.com/apikey から API キーを取得します。
環境変数を設定します：

# シェルプロファイル (~/.bashrc, ~/.zshrc など) に追加
export GEMINI_API_KEY="your-api-key-here"

ターミナルを再起動するか、プロファイルを読み込みます：

source ~/.zshrc  # または ~/.bashrc

Gemini CLI を実行すると、自動的に API キーが使用されます：

gemini

認証方法の比較

方法	セットアップ	最適な用途
Google OAuth (デフォルト)	ブラウザでのサインイン	個人利用、最高の無料制限枠
API キー	環境変数	CI/CD、自動化、スクリプト
サービスアカウント	JSON キーファイル	エンタープライズ、サーバー環境

ステップ 3: 基本設定

Gemini CLI は、設定ファイルと環境変数を通じて構成できます。

設定ファイル

~/.gemini/settings.json に設定ファイルを作成または編集します：

{
  "model": "gemini-2.5-pro",
  "theme": "dark",
  "autoApprove": false,
  "sandboxMode": true,
  "maxTokens": 8192,
  "temperature": 0.7
}

主要な設定オプション

設定	デフォルト	説明
`model`	`gemini-2.5-pro`	使用する Gemini モデル
`theme`	`dark`	ターミナルのカラーテーマ (dark/light)
`autoApprove`	`false`	ファイル編集やコマンドの自動承認
`sandboxMode`	`true`	破壊的な操作を制限する
`maxTokens`	`8192`	1回答あたりの最大出力トークン数
`temperature`	`0.7`	創造性レベル (0.0-1.0)

プロジェクトレベルの設定

プロジェクトのルートに .gemini ファイルを作成し、プロジェクト固有の指示を設定できます：

# .gemini

## Project Context
これは TypeScript、Tailwind CSS、Prisma ORM を使用した Next.js 15 アプリケーションです。

## Coding Standards
- TypeScript の strict モードを使用すること
- コードベース内の既存の命名規則に従うこと
- すべてのエクスポートされた関数に JSDoc コメントを書くこと
- デフォルトでサーバーコンポーネントを使用し、必要な場合にのみクライアントコンポーネントを使用すること

## Testing
- Vitest を使用してテストを書くこと
- テストファイルはソースファイルと同じ場所に .test.ts 拡張子で配置すること

Gemini CLI をプロジェクトディレクトリから実行すると、このファイルが自動的に読み込まれます。

ステップ 4: 必須コマンド

インタラクティブセッションを開始する

# プロジェクトディレクトリに移動
cd /path/to/your/project

# Gemini CLI を起動
gemini

単一のコマンドを実行する

# インタラクティブモードに入らずに質問する
gemini "package.json と README に基づいて、このプロジェクトが何をするものか説明して"

一般的なインタラクティブコマンド

インタラクティブセッション内では、以下のコマンドが使用できます：

コマンド	説明
`/help`	利用可能なすべてのコマンドを表示
`/model`	アクティブなモデルを切り替え
`/context`	現在のコンテキスト (読み込まれたファイル) を表示
`/clear`	会話履歴をクリア
`/compact`	会話を要約してコンテキストを節約
`/quit` または `Ctrl+C`	Gemini CLI を終了
`/stats`	トークン使用統計を表示

ステップ 5: 実用的な使用例

コードベースについて質問する

> src/middleware.ts の認証ミドルウェアは何をしていますか？
  潜在的なセキュリティ上の問題があれば指摘してください。

Hyperealで構築を始めよう

Gemini CLI セットアップガイド：完全インストール (2026年版)

Gemini CLI とは？

前提条件

ステップ 1: Gemini CLI のインストール

方法 1: npx で実行 (インストール不要)

方法 2: npm でグローバルインストール

方法 3: ソースからインストール

インストールの確認

ステップ 2: Google 認証

代替案：API キーで認証する

認証方法の比較

ステップ 3: 基本設定

設定ファイル

主要な設定オプション

プロジェクトレベルの設定

ステップ 4: 必須コマンド

インタラクティブセッションを開始する

単一のコマンドを実行する

一般的なインタラクティブコマンド

ステップ 5: 実用的な使用例

コードベースについて質問する

関連記事

Google Drive MCP サーバーの設定方法 (2026年版)

Gemini 3 API の使い方：開発者向け完全ガイド (2026年版)

Google AI Studio を無料で活用する方法：クイックガイド (2026年版)

今日から構築を開始

Hyperealで構築を始めよう

Gemini CLI セットアップガイド：完全インストール (2026年版)

Gemini CLI とは？

前提条件

ステップ 1: Gemini CLI のインストール

方法 1: npx で実行 (インストール不要)

方法 2: npm でグローバルインストール

方法 3: ソースからインストール

インストールの確認

ステップ 2: Google 認証

代替案：API キーで認証する

認証方法の比較

ステップ 3: 基本設定

設定ファイル

主要な設定オプション

プロジェクトレベルの設定

ステップ 4: 必須コマンド

インタラクティブセッションを開始する

単一のコマンドを実行する

一般的なインタラクティブコマンド

ステップ 5: 実用的な使用例

コードベースについて質問する

関連記事

Google Drive MCP サーバーの設定方法 (2026年版)

Gemini 3 API の使い方：開発者向け完全ガイド (2026年版)

Google AI Studio を無料で活用する方法：クイックガイド (2026年版)

今日から構築を開始