Gemini トラブルシューティング
GeminiとOpenAI互換インターフェースは仕様が異なります。プロバイダーがGemini / Google / Vertex関連のインターフェースを明示的に提供している場合や、チュートリアルでGemini CLIのサポートが明確に記載されている場合のみ、Gemini向けの設定を行ってください。
最初に確認すべき項目
| 確認項目 | 確認方法 | 理由 |
|---|---|---|
| 対象ツール | Gemini CLIをトラブルシューティングしているか確認 | Gemini CLIの認証方法はCodexやClaude Codeとは異なります |
| プロバイダーがGeminiに対応しているか | 管理画面やチュートリアルにGemini / Google / Vertex関連のエントリがあるか確認 | OpenAI互換インターフェースとGeminiインターフェースは仕様が異なります |
| Keyの種類 | GeminiまたはVertex対応のKeyを使用しているか確認 | Keyの種類が正しくない場合、401、403エラーが発生したり、繰り返しログインを求められたりすることがあります |
| モデル名 | Geminiモデル一覧に従って入力 | GeminiにOpenAIやClaudeのモデル名を入力しないでください |
よくあるエラー
| 現象 | 優先確認項目 | 解決策 |
|---|---|---|
| Googleへのログインを求められ続ける | Gemini CLI 本体の認証 | まずはGemini CLIの指示に従って必要な認証を完了させてください。プロバイダーの設定は、ツール本体が必要とするログイン処理を代替するものではありません。 |
| 401 / 403 | Gemini Keyまたは権限 | KeyがGemini / Google / Vertexグループに属していること、および現在のプロジェクトまたはアカウントに対象モデルの権限があることを確認してください。 |
| 404 / model not found | Gemini モデル名 | プロバイダーの管理画面にあるGeminiモデル一覧に従って入力してください。OpenAIやClaudeのモデル名は入力しないでください。 |
| 接続失敗 | Gemini Base URL | 通常のOpenAI互換Base URLをGeminiに入力しないでください。管理画面でGemini対応が明記されている場合のみ設定してください。 |
| CC-Switch切り替え後に反映されない | 対象ツールとターミナルの状態 | 適用対象がGemini CLIになっていることを確認して保存し、ターミナルを再起動してから再度テストしてください。 |
最小テスト
まずGemini CLIが固定の短い返答を返せるか確認し、その後より複雑なタスクのトラブルシューティングに進んでください。
Gemini 最小テスト
gemini "Please reply only: Gemini configuration test successful"問い合わせテンプレート
プロバイダーへ問い合わせる際は以下を記載
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened