CC-Switch Gemini 設定ガイド
このページでは、CC Switch経由でGemini関連プロバイダー（中転ステーション）をGemini CLIに適用する方法を解説します。Geminiのインターフェースや認証方式はOpenAI互換インターフェースとは異なるため、通常のOpenAI Base URLをそのまま流用してGeminiで使用することはできません。
公式情報 ダウンロードおよびドキュメントは公式サイトの情報が優先されます。
このページで解説すること
プロバイダーがGemini / Google / Vertex関連のインターフェースを明確に提供している場合、またはドキュメントでGemini CLIのサポートが明記されている場合にのみ、CC SwitchでGeminiを設定することをおすすめします。
開始前の確認事項
| 確認項目 | 確認方法 | 理由 |
|---|---|---|
| Gemini CLIが起動できる | まずローカル環境でGemini CLIが開けるか確認する | CC Switchは設定の切り替えのみを担当するため |
| プロバイダーがGeminiに対応している | 管理画面やチュートリアルにGemini / Google / Vertex関連の記載がある | OpenAI互換インターフェースとGeminiのインターフェースは異なるため |
| Keyの種類が正しい | KeyがGeminiまたはVertex用のものであることを確認する | Keyの種類が違うと認証エラーになるため |
| モデル名がGeminiリストのものになっている | プロバイダーの管理画面からGeminiのモデル名をコピーする | ClaudeやOpenAIのモデル名と混同しないようにするため |
各項目の入力方法
| 設定項目 | 入力方法 | 初心者の注意点 |
|---|---|---|
| Provider Name | 用途がわかる名前を入力 | 例：「Gemini provider」「Google Gemini」など |
| Target Tool / Preset | GeminiまたはGoogle / Vertex関連のプリセットを選択 | OpenAI互換プリセットは選択しないこと |
| Base URL | Gemini対応のインターフェースアドレスを貼り付け | 管理画面にOpenAI用アドレスしかない場合は無理に入力しないこと |
| API Key | Gemini / Vertex対応のKeyを貼り付け | Keyの種類はBase URLと一致している必要があります |
| Model Name | Geminiモデルリストを貼り付け | モデル名は通常OpenAIやClaudeとは異なります |
Geminiへ適用する手順
- CC Switchを開き、Provider管理画面に移動します。
- 新規Gemini Providerを追加するか、設定済みのGemini Providerを選択します。
- ターゲットツールとしてGemini CLI関連のプリセットを選択します。
- Gemini対応のBase URL、API Key、モデル名を入力します。
- 保存後、Apply / Switchを実行します。
- ターミナルを再起動し、Gemini CLIで最小限のテストを実行します。
正しく動作するかのテスト
Gemini設定が失敗する最も一般的な原因は、GeminiにOpenAI互換アドレスを入力してしまっているか、Keyの種類がインターフェースアドレスと一致していないことです。
Gemini 最小限テスト
gemini "Please reply only: CC-Switch Gemini is active"Gemini CLIで依然としてGoogleログインが要求される場合は、まずGemini CLI自体の案内に従ってください。CC SwitchはサポートされているProviderの設定を同期するだけであり、対象ツール自体のログイン要件をバイパスすることはできません。