Gemini CLI-Konfigurationsanleitung

📋 Vorbereitende Schritte

Bitte stellen Sie vor Beginn sicher, dass Sie Folgendes erledigt haben:

Ein Koze-Konto registriert und angemeldet
Einen API-Schlüssel auf der API-Verwaltungsseite erstellt
Die Gemini CLI installiert haben (npm install -g @anthropic-ai/gemini-cli oder siehe Offizielles Repository)

🚀 Methode 1: Zugriff über die Gemini API (Empfohlen)

Setzen Sie die folgenden Umgebungsvariablen im Terminal:

# Koze Gemini Proxy-Adresse setzen export GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Koze-API-Schlüssel festlegen
export GEMINI_API_KEY='Ihr API-Schlüssel'

# Zu verwendendes Modell angeben
export GEMINI_MODEL='gemini-2.5-pro'

Authentifizierungsmethode: Wählen Sie beim Start Gemini-API-Schlüssel verwenden aus. Wenn Sie zur Eingabe eines API-Schlüssels aufgefordert werden, drücken Sie einfach die Eingabetaste und lassen Sie das Feld leer.

💡 Falls Sie beim Start automatisch zur Google-Anmeldeseite weitergeleitet werden, löschen Sie bitte die Datei ~/.gemini/settings.json und starten Sie die Anwendung neu.

🔧 Zweite Methode: Zugriff über die Code Assist API

Eine weitere Zugriffsmethode, geeignet für bestimmte Anwendungsfälle:

# Code Assist-Endpunkt einrichten

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Zugriffstoken einrichten (mit Ihrem Koze API-Schlüssel)

export GOOGLE_CLOUD_ACCESS_TOKEN='Ihr API-Schlüssel'

# GCA-Modus aktivieren

export GOOGLE_GENAI_USE_GCA='true'

# Festlegen Das Modell

export GEMINI_MODEL='gemini-2.5-pro'

Authentifizierungsmethode:Wählen Sie beim Start Anmelden mit Google.

⚠️ Hinweis: Die Gemini CLI-Konsole zeigt möglicherweise „Fehler beim Abrufen der Benutzerinformationen: 401 Nicht autorisiert“ an. Dies ist normal und beeinträchtigt die Nutzung nicht.



🎯 Schritt 3: Gemini CLI starten

Nach der Konfiguration starten Sie die CLI im Terminal:

gemini

📌 Umgebungsvariablen speichern

Es wird empfohlen, Umgebungsvariablen in die Shell-Konfigurationsdatei zu schreiben (siehe Beispiel mit Methode 1):

# Zsh-Benutzer

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=

export GEMINI_MODEL=

EOF source ~/.zshrc



📌 Verfügbare Modelle







Modellname

Beschreibung








gemini-2.5-pro

Gemini 2.5 Pro, die neueste Generation leistungsstarker Modelle




gemini-2.5-flash

Gemini 2.5 Flash, schneller und leistungsstärker Kostengünstig




gemini-2.0-flash

Gemini 2.0 Flash







⚠️ Häufig gestellte Fragen (FAQ)







Problem

Lösung








Automatische Weiterleitung zu Google Login nach dem Start

Löschen Sie ~/.gemini/settings.json und versuchen Sie es erneut




Fehlermeldung 401 Nicht autorisiert

Dies ist eine normale Fehlermeldung und hat keine Auswirkungen auf die Nutzung; Ignorieren Sie es.




Modell nicht verfügbar

Prüfen Sie in der Koze-Modelllobby, ob Ihr aktueller Tarif Gemini-Modelle beinhaltet.

Modellname	Beschreibung
`gemini-2.5-pro`	Gemini 2.5 Pro, die neueste Generation leistungsstarker Modelle
`gemini-2.5-flash`	Gemini 2.5 Flash, schneller und leistungsstärker Kostengünstig
`gemini-2.0-flash`	Gemini 2.0 Flash

Problem	Lösung
Automatische Weiterleitung zu Google Login nach dem Start	Löschen Sie `~/.gemini/settings.json` und versuchen Sie es erneut
Fehlermeldung 401 Nicht autorisiert	Dies ist eine normale Fehlermeldung und hat keine Auswirkungen auf die Nutzung; Ignorieren Sie es.
Modell nicht verfügbar	Prüfen Sie in der Koze-Modelllobby, ob Ihr aktueller Tarif Gemini-Modelle beinhaltet.