導入ガイド

プロバイダー導入ガイド

ツール別の設定手順やトラブルシューティングを見る。

プロバイダー導入ガイド/Gemini CLI 設定ガイド

Gemini CLI 設定ガイド

Gemini CLIはGoogle提供のターミナル向けAIツールです。コマンドライン上でGeminiを活用したQ&A、コード理解、プロジェクト支援を行うのに適しています。

公式情報 ダウンロードおよびドキュメントは公式サイトの情報に準拠します。
Gemini CLI 公式ドキュメント インストール、コマンド、設定の入り口 認証ドキュメント Googleログイン、Gemini API Key、Vertex AI GitHub オープンソースリポジトリとバージョン情報

ツールの概要と主な用途

Google GeminiターミナルツールGoogleログインGemini API Key

まず認証方式を選択する

方式対象ユーザー説明
Googleログイン個人ユーザー・初心者Geminiを実行し、画面の指示に従ってログインします
Gemini API KeyすでにGoogle AI StudioのKeyをお持ちの方KeyをGEMINI_API_KEYに設定します
Vertex AI企業・クラウドプロジェクトユーザーGoogle Cloudのプロジェクトと権限に合わせて設定します

API Keyのテスト方法

PowerShellで一時テスト
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" gemini

テスト成功後の進め方

  1. まずは空のディレクトリでGemini CLIを実行し、重要なプロジェクトを直接開かないようにしてください。
  2. 短い質問を1つだけ投げ、モデルが正常に応答できることを確認します。
  3. 次にテスト用のファイルを読み取らせ、ファイルを変更しないよう明確に指示します。
  4. API Keyを継続的に使用する場合は、Gemini CLIの公式ドキュメントに従ってローカル環境変数または設定ファイルに認証情報を保存します。
  5. 中転プロバイダーを切り替えたり、CC-Switchを使用したりした場合は、ターミナルを再度開いてから再テストしてください。
現象優先確認項目対応策
Googleログインが要求される現在の認証方式がGoogleログインの流れになっていませんか？まずはGemini CLI自体の指示に従って認証を完了させてください。API Keyとログイン手続きのトラブルシューティングを混同しないようにしてください
Keyが無効GEMINI_API_KEYはGoogle AI Studio / Geminiのものですか？OpenAIやClaudeのKeyをGeminiに入力しないでください
モデルが利用できない指定したモデル名はGeminiのリストに含まれていますか？OpenAIやClaudeのモデル名をGemini CLIに入力しないでください

中転プロバイダー設定時の注意点

Gemini CLIとOpenAI互換の中転プロバイダーは規格が異なります。プロバイダー側がGemini CLI、Google Gemini、またはVertex AI向けの設定手順を明確に明記している場合のみ、その案内に従ってください。

通常のOpenAI Base URLをGemini CLIに入力しないでください。OpenAI、Claude、Geminiはそれぞれ異なるプロトコルです。プロバイダーの管理画面で専用のアドレスが提供されている場合は、必ず対応するツールのものを入力してください。
Gemini CLI 公式ドキュメント インストール、コマンド、設定の入り口を確認できます。
Gemini CLI 認証ドキュメント Googleログイン、Gemini API Key、Vertex AIについて確認できます。