インストールガイド
システムにGemini CLIをインストールして設定する
システム要件
システムがこれらの要件を満たしていることを確認してください
Windows
- Windows 10以降
- Node.js 18.0.0以上
- PowerShell 5.1またはPowerShell Core 7+
- Windows Terminal（推奨）
macOS
- macOS 10.15 (Catalina)以降
- Node.js 18.0.0以上
- Xcode Command Line Tools
- TerminalまたはiTerm2
Linux
- Ubuntu 18.04+ / CentOS 8+ / Debian 10+
- Node.js 18.0.0以上
- curlまたはwget
- bashまたはzshシェル
インストール方法
ニーズに最適なインストール方法を選択してください
NPMインストール
ほとんどのユーザーに推奨される方法
ステップ 1: npmでグローバルインストール
システムにGemini CLIをグローバルインストールします
npm install -g @google/generative-ai-cliステップ 2: インストールの確認
インストールが成功したことを確認します
gemini --versionステップ 3: APIキーの設定
Google AI APIキーを設定します
gemini config set api-key YOUR_API_KEYDockerインストール
一貫したデプロイメントのためのコンテナ化環境
ステップ 1: Dockerイメージをプル
公式Dockerイメージをダウンロードします
docker pull google/gemini-cli:latestステップ 2: APIキーで実行
APIキーでコンテナを開始します
docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latestステップ 3: インタラクティブモード
インタラクティブチャットセッションを開始します
docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chatソースから
開発用にソースコードからビルド
ステップ 1: リポジトリをクローン
GitHubからソースコードを取得します
git clone https://github.com/google-gemini/gemini-cli.gitステップ 2: 依存関係をインストール
必要な依存関係をすべてインストールします
cd gemini-cli && npm installステップ 3: ビルドとリンク
プロジェクトをビルドしてグローバルシンボリックリンクを作成します
npm run build && npm linkAPIキー設定
Gemini CLIの使用を開始するためにGoogle AI APIキーを設定します
APIキーを取得
- 1Google AI Studioにアクセス
- 2Googleアカウントでサインイン
- 3「APIキーを作成」をクリックしてキーをコピー
キーを設定
CLIコマンドを使用:
gemini config set api-key YOUR_API_KEY環境変数を使用:
export GEMINI_API_KEY=YOUR_API_KEYインストールの確認
すべてが正常に動作することを確認するためにインストールをテストします
バージョン確認
gemini --versionインストールされたバージョン番号が表示されるはずです
API接続テスト
gemini ask "こんにちは、聞こえますか？"Geminiからの応答が返されるはずです
設定確認
gemini config list現在の設定が表示されるはずです
よくある問題
よくあるインストール問題の解決策
コマンドが見つかりません
インストール後に「コマンドが見つかりません」エラーが出る場合、PATHにnpmのグローバルbinディレクトリが含まれていない可能性があります。
npm config get prefixシェルプロファイル（.bashrc、.zshrcなど）のPATHにbinディレクトリを追加してください
権限が拒否されました
macOS/Linuxでは、sudoを使用するか、npmが別のディレクトリを使用するように設定する必要がある場合があります。
npm config set prefix ~/.npm-global次に~/.npm-global/binをPATHに追加してください