CC-Switch Gemini
Diese Seite beschreibt die Verwendung von Gemini-bezogenen Providern mit der Gemini CLI über CC Switch. Die Schnittstellen und Authentifizierungsmethoden von Gemini unterscheiden sich von OpenAI-kompatiblen Schnittstellen, daher können Sie nicht einfach die reguläre OpenAI Base-URL eintragen und davon ausgehen, dass sie mit Gemini funktioniert.
Was diese Seite erklärt
Es wird nur empfohlen, Gemini in CC Switch zu konfigurieren, wenn der Provider ausdrücklich Gemini- / Google- / Vertex-relevante Schnittstellen bereitstellt oder die Dokumentation explizit die Unterstützung für Gemini CLI bestätigt.
Vorab-Prüfungen
| Zu prüfender Punkt | Vorgehensweise | Grund |
|---|---|---|
| Gemini CLI lässt sich starten | Prüfen Sie zuerst, ob die Gemini CLI auf diesem Rechner ausgeführt werden kann | CC Switch ist lediglich für den Konfigurationswechsel zuständig |
| Der Provider unterstützt Gemini | Im Dashboard oder in Anleitungen sind Einträge zu Gemini / Google / Vertex vorhanden | OpenAI-kompatible Schnittstellen sind nicht identisch mit der Gemini-Schnittstelle |
| Schlüsseltyp ist korrekt | Bestätigen Sie, dass der API-Key für Gemini oder Vertex vorgesehen ist | Ein falscher Schlüsseltyp führt zu Authentifizierungsfehlern |
| Der Modellname stammt aus der Gemini-Liste | Kopieren Sie den Gemini-Modellnamen aus dem Dashboard des Providers | Mischen Sie keine Modellnamen von Claude oder OpenAI ein |
Ausfüllen der Felder
| Einstellung | Eingabemethode | Hinweis für Einsteiger |
|---|---|---|
| Provider Name | Geben Sie den Zweck eindeutig an | Zum Beispiel 'Gemini provider' oder 'Google Gemini' |
| Target Tool / Preset | Wählen Sie Gemini- oder Google- / Vertex-bezogene Vorlagen aus | Wählen Sie keine OpenAI-kompatiblen Vorlagen aus |
| Base URL | Kopieren Sie die zu Gemini gehörende Schnittstellenadresse | Falls das Dashboard nur eine OpenAI-Adresse bereitstellt, tragen Sie diese vorerst nicht ein |
| API Key | Kopieren Sie den zu Gemini / Vertex passenden Key | Der Schlüsseltyp muss zur Base-URL passen |
| Model Name | Kopieren Sie aus der Gemini-Modellliste | Modellnamen unterscheiden sich in der Regel von OpenAI und Claude |
Auf Gemini anwenden
- Öffnen Sie CC Switch und wechseln Sie in den Provider-Verwaltungsbereich.
- Fügen Sie einen neuen Gemini-Provider hinzu oder wählen Sie einen bereits konfigurierten Gemini-Provider aus.
- Wählen Sie für das Zielwerkzeug die Presets rund um die Gemini CLI aus.
- Tragen Sie die entsprechende Base-URL, den API-Key und den Modellnamen für Gemini ein.
- Führen Sie nach dem Speichern Apply / Switch aus.
- Öffnen Sie das Terminal erneut und führen Sie einen minimalen Test mit der Gemini CLI durch.
Funktionstest
Die häufigsten Ursachen für Konfigurationsfehler bei Gemini sind das Eintragen einer OpenAI-kompatiblen Adresse für Gemini oder ein Schlüsseltyp, der nicht zur Schnittstellenadresse passt.
gemini "Please reply only: CC-Switch Gemini is active"