🐻‍❄️ Google Gemini CLI 導入・設定ガイド

わしがお主に、Google Gemini CLIの導入から活用まで、温かくご案内するのじゃ。このガイドを読めば、くまのようにほっこりしながらも、確実にツールを習得できるぞい✨

🌟 Gemini CLIって何なのじゃ？

🧸「しろくまちゃん、Gemini CLIって何なの？」

🐻‍❄️「テディちゃん、それは素晴らしい質問なのじゃ！Gemini CLIというのは、GoogleがつくったオープンソースのAIエージェントで、コマンドライン（ターミナル）から直接Geminiの力を使えるツールなのぢゃ。つまり、お主のパソコンで、まるで賢い助手がいるかのように、コードを書いたり、ファイルを分析したり、質問に答えてくれるのじゃよ」

このAIエージェントの能力は本当に素晴らしいのじゃ。大規模なコードベース全体を理解して編集したり、定型的な作業を自動化したり、自然な言葉でお願いするだけでアプリケーションを生成したりできるのじゃ。まさに現代の魔法のような存在じゃぞい。

わしが特に感動するのは、その巨大な100万トークンのコンテキストウィンドウなのじゃ。これは、プロジェクト全体のファイルを一度に理解できるということじゃから、まるでお主のプロジェクトを隅々まで知り尽くした熟練の同僚が隣にいるような感覚なのじゃ。

❄️ 始める前の準備（システム要件）

🧸「準備って、何が必要なの？」

🐻‍❄️「心配するでないぞ、テディちゃん。準備はそれほど複雑ではないのじゃ」

お主のシステムで確認すべき要件は以下の通りじゃ：

オペレーティングシステム: macOS、Windows、Linuxのどれでも対応しておる。わしのようにどこでも適応できるのじゃよ🐻‍❄️

Node.js: これが一番重要じゃ。バージョン18以上が必要なのじゃ。確認するには、ターミナルで node -v と入力するのじゃ。もし古いバージョンだったり、インストールされていなかったりしたら、公式サイトからダウンロードするか、nvm（Node Version Manager）を使うのがおすすめじゃよ。

Googleアカウント: 無料利用枠を使うために必要なのじゃ。ほとんどのお主は既に持っておると思うぞい。

プロフェッショナルな開発環境を目指すなら、nvmのようなバージョン管理ツールを使うのがベストプラクティスじゃ。これにより、プロジェクトごとに異なるNode.jsバージョンを使い分けることができ、dependency地獄を避けることができるのじゃ。

🎵 インストール方法の選択

🧸「インストール方法がいくつかあるって聞いたけど、どれがいいの？」

🐻‍❄️「それぞれに特徴があるから、お主の使い方に合わせて選ぶのが大切じゃ。わしが詳しく説明してやるぞい」

方法1: npx（おすすめ🌟）

npx @google/gemini-cli

この方法は、わしが最も推奨する方法じゃ。なぜなら：

• 常に最新版: 実行するたびに最新バージョンを使用するのじゃ
• チーム開発に最適: みんなが同じバージョンを使えるから、「僕の環境では動く」問題を防げるのじゃ
• セキュリティ: 古い脆弱性のあるバージョンを使い続ける心配がないのじゃ
• クリーンな環境: グローバルな環境を汚さないのじゃ

唯一のトレードオフは、初回実行時（コールドスタート）がわずかに遅くなることじゃが、セキュリティと一貫性を考えれば些細なことじゃよ。

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

npm install -g @google/gemini-cli

この方法は個人開発者や、起動速度を最優先する場合におすすめじゃ：

• 高速起動: 一度インストールすれば gemini コマンドですぐに起動するのじゃ
• 利便性: システムのどこからでも使えるのじゃ

ただし、定期的なアップデートが必要じゃ：

npm upgrade -g @google/gemini-cli

方法3: Homebrew（macOSユーザー向け）

brew install gemini-cli

macOSでHomebrewを常用しているお主には、この方法が一番馴染み深いじゃろう。

🍃 認証の設定（無料から企業レベルまで）

🧸「認証って複雑そう…」

🐻‍❄️「心配せずとも、段階的に説明するから大丈夫じゃよ。実は認証には3つのレベルがあって、お主のニーズに合わせて選べるのじゃ」

レベル1: Googleアカウントログイン（初心者におすすめ✨）

初回実行時に「Login with Google」を選択するだけじゃ。ブラウザが開いて、普通のGoogleログインをするだけで完了じゃよ。

素晴らしい無料利用枠:

• 強力な gemini-2.5-pro モデルへのアクセス
• 100万トークンの巨大なコンテキストウィンドウ
• 1分間に60リクエスト、1日1,000リクエストまで無料

この利用枠だけで、多くの個人プロジェクトや学習用途には十分すぎるほどじゃ。

レベル2: APIキー（自動化したい場合）

Google AI Studio（aistudio.google.com）でAPIキーを生成し、環境変数に設定するのじゃ：

# macOS/Linux
export GEMINI_API_KEY="YOUR_API_KEY"

# Windows (コマンドプロンプト)
set GEMINI_API_KEY="YOUR_API_KEY"

# Windows (PowerShell)
$env:GEMINI_API_KEY = "YOUR_API_KEY"

この方法は、CI/CDパイプラインや自動化スクリプトで威力を発揮するのじゃ。

レベル3: Vertex AI（企業レベル）

🧸「企業レベルって、すごく難しそう…」

🐻‍❄️「確かに少し複雑じゃが、手順を踏めば必ずできるぞい。Google Cloud Platformを使う企業向けの方法じゃ」

1. Google Cloud SDKのインストール:

gcloud init

2. Application Default Credentialsの設定:

gcloud auth application-default login

3. Vertex AI使用の設定:

export GOOGLE_GENAI_USE_VERTEXAI=true

この方法により、企業レベルのガバナンス、セキュリティ、監査証跡が利用できるようになるのじゃ。

🌈 設定とカスタマイズ

🧸「設定ファイルって、どうやって使うの？」

🐻‍❄️「良い質問じゃ！Gemini CLIは柔軟な設定システムを持っておるのじゃ。設定には優先順位があって、より具体的な設定が広範な設定を上書きするのじゃよ」

設定の優先順位（高→低）

1. コマンドラインフラグ: 一時的な上書き
2. 環境変数: APIキーなどの秘匿情報
3. プロジェクトレベル: ./.gemini/settings.json
4. ユーザーレベル: ~/.gemini/settings.json
5. システムレベル: /etc/gemini-cli/settings.json

settings.json の例

{
  "theme": "GitHub",
  "autoAccept": false,
  "sandbox": "docker",
  "checkpointing": {
    "enabled": true
  },
  "fileFiltering": {
    "respectGitIgnore": true
  },
  "usageStatisticsEnabled": true
}

GEMINI.md でAIに指示

プロジェクトルートに GEMINI.md ファイルを作ることで、AIに永続的な指示を与えることができるのじゃ：

# My Awesome App

## General Instructions
- All Python code must be PEP 8 compliant
- Use 2-space indentation for all new files
- You are an expert developer working on this project

## Component-Specific Style Guides
@./src/frontend/react-style-guide.md
@./src/backend/fastapi-style-guide.md

.env で機密情報を安全管理

GEMINI_API_KEY="YOUR_API_KEY"
YOUR_GITHUB_PAT_ENV_VAR="ghp_..."

重要な注意: .env ファイルは必ず .gitignore に追加して、間違ってバージョン管理にコミットしないよう気をつけるのじゃよ🚨

🎶 基本的な使い方

🧸「実際にどうやって使うの？」

🐻‍❄️「使い方は主に2つのモードがあるのじゃ。対話的に使うか、一回限りのコマンドとして使うかじゃよ」

対話モード

gemini

引数なしで実行すると、対話的なREPLモードが起動するのじゃ。ここでAIと会話しながら作業できるぞい。

非対話モード

gemini -p "このファイルをasync/awaitを使うようにリファクタリングして。 @./my-script.js"

一回限りのタスクや、スクリプトからの呼び出しに便利じゃ。

特殊コマンド

対話モード内では、特殊なプレフィックスを使った強力なコマンドが使えるのじゃ：

スラッシュコマンド (/):

• /help: 全コマンドの一覧
• /quit: セッション終了
• /stats: トークン使用量の表示
• /restore: 過去のセッション復元

コンテキストコマンド (@):

• @./src/: フォルダ全体をコンテキストに追加
• @./file.js: 特定のファイルをコンテキストに追加

シェルコマンド (!):

• !ls -l: シェルコマンドを実行し、結果をコンテキストに含める

🌟 トラブルシューティング

🧸「エラーが出ちゃった時はどうすればいい？」

🐻‍❄️「落ち着くのじゃ、テディちゃん。よくある問題とその解決法をわしが教えてやるぞい」

よくある問題と解決法

問題1: インストールが失敗する

• 症状: npx https://github.com/... が動かない
• 解決法: npx @google/gemini-cli を使うのじゃ

問題2: 認証エラー

• 症状: 認証関連のエラーメッセージ
• 解決法:
  • GEMINI_API_KEY が正しく設定されているか確認
  • Vertex AIの場合は gcloud auth application-default login を再実行

問題3: 接続問題

• 症状: ネットワーク関連のエラー
• 解決法:
  • インターネット接続を確認
  • ファイアウォールの設定を確認
  • Node.jsが18以上であることを再確認

✨ 高度な活用法

基本操作に慣れたら、こんな高度な使い方にもチャレンジしてみるのじゃ：

プロジェクト全体の分析: Gitリポジトリのルートで起動し、「このプロジェクトのアーキテクチャを説明して」と聞いてみるのじゃ。

定型作業の自動化: テストの生成、デプロイメント、コードレビューなど、繰り返し作業を自動化できるぞい。

機能拡張: Model Context Protocol (MCP) サーバーを設定して、データベースアクセスや外部API連携など、CLIの能力を大幅に拡張できるのじゃ。

🎊 まとめ

🧸「しろくまちゃん、ありがとう！これで安心してGemini CLIを使えそう」

🐻‍❄️「どういたしまして、テディちゃん。Gemini CLIは最初こそ設定が必要じゃが、一度慣れれば開発作業が格段に楽しく、効率的になるのじゃ。わしのように、いつでも温かいサポートを提供してくれる頼もしい相棒になってくれるはずじゃよ」

Gemini CLIは単なるツールではなく、お主の創造性を拡張し、複雑なタスクを簡単にし、学習を加速してくれる真のパートナーなのじゃ。最初は小さなタスクから始めて、徐々にその可能性を探求していくのがおすすめじゃよ。

そして何より大切なのは、このツールを使って楽しむことじゃ。わしのようにほんわかした気持ちで、新しい技術との出会いを楽しんでおくれ🐻‍❄️✨

困ったことがあったら、公式のGitHubリポジトリやドキュメントを参照するのじゃ。オープンソースのコミュニティは、わしたちくまのように温かく迎え入れてくれるはずじゃよ🌈