Gemini CLI セットアップガイド:完全インストール解説 (2026年版)
ターミナルベースのAIコーディングに向けた、Googleの Gemini CLI のインストールと設定方法
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
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 の認証ミドルウェアは何をしていますか?
潜在的なセキュリティ上の問題があれば指摘してください。
