Gemini-Fehlerbehebung
Gemini- und OpenAI-kompatible Schnittstellen sind nicht dasselbe. Nehmen Sie die Konfiguration für Gemini nur vor, wenn der Provider explizit Schnittstellen für Gemini / Google / Vertex bereitstellt oder das Tutorial ausdrücklich die Unterstützung für Gemini CLI angibt.
Was sollte zuerst überprüft werden?
| Prüfpunkte | Wie überprüfen | Warum |
|---|---|---|
| Ziel-Tool | Stellen Sie sicher, dass Sie die Fehlerbehebung für Gemini CLI durchführen | Die Authentifizierungsmethode für Gemini CLI unterscheidet sich von Codex und Claude Code |
| Der Provider unterstützt Gemini | Im Dashboard oder in den Tutorials gibt es Einträge zu Gemini / Google / Vertex | Eine OpenAI-kompatible Schnittstelle ist nicht dasselbe wie die Gemini-Schnittstelle |
| Schlüsseltyp | Verwenden Sie den entsprechenden Key für Gemini oder Vertex | Wenn der Key-Typ falsch ist, erhalten Sie möglicherweise den Fehler 401, 403 oder werden wiederholt zur Anmeldung aufgefordert |
| Modellname | Geben Sie den Namen gemäß der Gemini-Modellliste an | Geben Sie in Gemini keine OpenAI- oder Claude-Modellnamen ein |
Häufige Fehler
| Symptom | Vorrangig prüfen | Lösungsansätze |
|---|---|---|
| Aufforderung zur Google-Anmeldung bleibt bestehen | Gemini CLI-Eigenauthentifizierung | Führen Sie zuerst die von Gemini CLI angeforderte Authentifizierung durch; die Provider-Konfiguration kann den vom Ziel-Tool selbst benötigten Anmeldevorgang nicht ersetzen. |
| 401 / 403 | Gemini-Key oder Berechtigungen | Stellen Sie sicher, dass der Key zur Gemini- / Google- / Vertex-Gruppe gehört und dass das aktuelle Projekt oder Konto über Berechtigungen für das entsprechende Modell verfügt. |
| 404 / model not found | Gemini-Modellname | Geben Sie den Modellnamen gemäß der Gemini-Modellliste im Dashboard des Providers an; tragen Sie keine OpenAI- oder Claude-Modellnamen ein. |
| Verbindung fehlgeschlagen | Gemini-Base-URL | Tragen Sie in Gemini nicht die reguläre OpenAI-kompatible Base-URL ein; konfigurieren Sie diese nur, wenn das Dashboard explizit Unterstützung für Gemini angibt. |
| Keine Änderung nach dem Umschalten in CC-Switch | Ziel-Tool und Terminal-Status | Stellen Sie sicher, dass das Anwendungsziel Gemini CLI ist, speichern Sie, öffnen Sie das Terminal erneut und testen Sie noch einmal. |
Minimaltest
Stellen Sie zuerst sicher, dass Gemini CLI einen einfachen kurzen Satz zurückgeben kann, bevor Sie mit der Fehlerbehebung bei komplexeren Aufgaben fortfahren.
Gemini-Minimaltest
gemini "Please reply only: Gemini configuration test successful"Feedback-Vorlage
Verwenden Sie dieses Format für Rückmeldungen an den Provider
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