Fehlerbehebungsanleitung
Lösungen für häufige Probleme und häufig gestellte Fragen zu Gemini CLI. Finden Sie schnelle Korrekturen und detaillierte Anleitungen für verschiedene Probleme.
Schnelle Diagnosebefehle
Beginnen Sie mit diesen Befehlen zur Diagnose häufiger Probleme
gemini --versionCLI-Version und Build-Informationen überprüfen
gemini config listAktuelle Konfigurationseinstellungen anzeigen
gemini config resetKonfiguration auf Standardwerte zurücksetzen
gemini logsAktuelle Fehlerlogs und Debug-Informationen anzeigen
gemini doctorDiagnosechecks und Gesundheitsüberprüfung ausführen
gemini cache clearZwischengespeicherte Daten und temporäre Dateien löschen
Häufige Probleme und Lösungen
Durchsuchen Sie nach Kategorie, um Lösungen für spezifische Probleme zu finden
Installationsprobleme
Probleme bei Installation und Einrichtung
npm install schlägt mit Berechtigungsfehlern fehl
Verwenden Sie npm mit dem --global Flag oder konfigurieren Sie npm für ein anderes Verzeichnis. Auf macOS/Linux müssen Sie möglicherweise sudo verwenden oder npm ordnungsgemäß konfigurieren.
Lösung:
npm install -g @google/generative-ai-cliBefehl nach Installation nicht gefunden
Stellen Sie sicher, dass das npm global bin-Verzeichnis in Ihrem PATH ist. Überprüfen Sie mit `npm config get prefix` und fügen Sie das bin-Verzeichnis zu Ihrem PATH hinzu.
Lösung:
export PATH=$PATH:$(npm config get prefix)/binNode.js Versionskompatibilitätsprobleme
Gemini CLI erfordert Node.js 16 oder höher. Aktualisieren Sie Node.js mit nvm oder laden Sie es von nodejs.org herunter.
Lösung:
node --version # Should be 16.0.0 or higherAuthentifizierungs- und API-Probleme
Probleme mit API-Schlüsseln und Authentifizierung
Ungültiger API-Schlüssel-Fehler
Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und die entsprechenden Berechtigungen hat. Holen Sie sich bei Bedarf einen neuen Schlüssel von Google AI Studio.
Lösung:
gemini config set api-key YOUR_API_KEYAPI-Kontingent überschritten
Überprüfen Sie Ihre Nutzungslimits in Google AI Studio. Erwägen Sie ein Upgrade Ihres Plans oder die Implementierung einer Ratenbegrenzung.
Lösung:
gemini config set rate-limit 10 # Requests per minuteNetzwerkverbindungsprobleme
Überprüfen Sie die Internetverbindung und Firewall-Einstellungen. Überprüfen Sie die Proxy-Konfiguration, wenn Sie sich hinter einer Unternehmens-Firewall befinden.
Lösung:
gemini config set proxy http://proxy.company.com:8080Configuration Problems
Issues with CLI configuration and settings
Konfigurationsdatei beschädigt oder fehlt
Setzen Sie die Konfiguration auf die Standardwerte zurück und konfigurieren Sie sie neu. Sichern Sie zuerst wichtige Einstellungen.
Lösung:
gemini config reset
gemini config set api-key YOUR_API_KEYModell nicht verfügbar oder veraltet
Überprüfen Sie verfügbare Modelle und aktualisieren Sie die Konfiguration. Einige Modelle können regionale Beschränkungen haben.
Lösung:
gemini models list
gemini config set model gemini-proUmgebungsvariablen nicht erkannt
Stellen Sie sicher, dass Umgebungsvariablen ordnungsgemäß gesetzt und exportiert sind. Überprüfen Sie Variablennamen und -werte.
Lösung:
export GEMINI_API_KEY=your_key_here
export GEMINI_MODEL=gemini-proLeistungsprobleme
Langsame Antworten und Leistungsprobleme
Langsame Antwortzeiten
Überprüfen Sie die Netzwerkverbindung, reduzieren Sie die Anfragegröße oder versuchen Sie ein anderes Modell. Erwägen Sie Streaming für lange Antworten.
Lösung:
gemini config set stream true
gemini config set max-tokens 1000Hoher Speicherverbrauch
Begrenzen Sie den Gesprächsverlauf, reduzieren Sie Batch-Größen oder starten Sie die CLI-Sitzung regelmäßig neu.
Lösung:
gemini config set history-limit 10
gemini session clearTimeout-Fehler
Erhöhen Sie die Timeout-Einstellungen oder teilen Sie große Anfragen in kleinere Teile auf.
Lösung:
gemini config set timeout 60000 # 60 secondsTool- und Plugin-Probleme
Probleme mit Tool- und Plugin-Funktionalität
Tool-Ausführung schlägt fehl
Überprüfen Sie Tool-Berechtigungen, Dateipfade und Abhängigkeiten. Stellen Sie sicher, dass das Tool ordnungsgemäß installiert und konfiguriert ist.
Lösung:
gemini tools list
gemini tools test tool-namePlugin lädt nicht
Überprüfen Sie den Plugin-Pfad, suchen Sie nach Syntaxfehlern und stellen Sie sicher, dass alle Abhängigkeiten installiert sind.
Lösung:
gemini plugins list
gemini plugins reload plugin-nameMCP-Server-Verbindungsprobleme
Überprüfen Sie den Serverstatus, die Netzwerkverbindung und die Protokollversionskompatibilität.
Lösung:
gemini mcp status
gemini mcp reconnect server-nameBenötigen Sie weitere Hilfe?
Wenn Sie hier keine Lösung finden, versuchen Sie diese Ressourcen
Dokumentation
Schauen Sie sich die vollständige Dokumentation für detaillierte Anleitungen und Beispiele an.
Dokumentation durchsuchen →GitHub Issues
Melden Sie Bugs oder fordern Sie Features in unserem GitHub-Repository an.
Problem melden →Community
Nehmen Sie an unseren Community-Diskussionen teil und erhalten Sie Hilfe von anderen Benutzern.
An Diskussion teilnehmen →Verwandte Ressourcen
Erkunden Sie weitere Dokumentation und Anleitungen