Gemini CLI – Integrationsanleitung

Google Gemini CLI mit einem QCode.cc API-Key konfigurieren – kostenpflichtige Enterprise-Keys; die Pro-/Privat-Tarife wurden am 2026-06-18 eingestellt (QCode bietet Gemini derzeit nicht an; nur Referenz)

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

⚠️ Derzeit nicht verfügbar: QCode hat alle Gemini-Modelle vorübergehend aus dem Angebot genommen. Die folgenden Schritte zum Aufruf von Gemini über QCode sind daher vorerst nicht nutzbar und dienen nur als Referenz; bitte nutzen Sie Claude, GPT oder die chinesischen Modelle.

Zuletzt geprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (Gemini CLI v0.60.0 (2026-09-15; Pro-/Privat-Tarife werden seit 2026-06-18 nicht mehr bedient, kostenpflichtige Enterprise-Keys funktionieren weiterhin))

Auf einen Blick¶

⚠️ Wichtige Änderung: Der Anmeldeweg für Privatnutzer wurde durch Google Antigravity CLI ersetzt. Im offiziellen Beitrag vom 2026-05-19 heißt es wörtlich, dass Gemini CLI und die Gemini-Code-Assist-IDE-Erweiterungen ab dem 2026-06-18 „will stop serving requests“ – für Google AI Pro und Ultra sowie für alle, die es kostenlos mit einem persönlichen Konto nutzen. An diesem Tag wurden Antigravity CLI und Antigravity 2.0 verfügbar (die Antigravity IDE selbst erschien bereits am 2025-11-18). Bei Enterprise liegt der Fall anders: Organisationen mit einer Gemini-Code-Assist-Standard- oder -Enterprise-Lizenz behalten den Zugang, und im selben Beitrag steht: „Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys“. Diese Seite gilt also weiterhin für kostenpflichtige Enterprise-Keys; Nutzer von Pro / Ultra / Gratis-Tarifen sollten zu Google Antigravity CLI wechseln.

Das Repository wird weiterhin gepflegt: Am Tag dieser Prüfung (2026-09-18) wurde weiterhin ein Nightly-Build veröffentlicht, und das neueste stabile Release ist v0.60.0 (2026-09-15). Die korrekte Formulierung lautet „bedient keine Anmeldungen von Privatnutzern mehr“, nicht „wird nicht mehr gepflegt“.

QCode.cc unterstützt Claude Code und OpenAI Codex, die denselben Key nutzen können. Die Einrichtungsschritte für Gemini CLI bleiben unten als Referenz erhalten, doch QCode bietet Gemini-Modelle derzeit nicht an.

Was ist Gemini CLI¶

Gemini CLI ist Googles KI-Programmierassistent für die Kommandozeile, ähnlich wie Claude Code. Er unterstützt Sie im Terminal bei Codeentwicklung, Debugging und Dateioperationen.

Verfügbare Modelle¶

QCode bietet Gemini-Modelle derzeit nicht an. Die folgende Abfrage zeigt, wie Sie sie auflisten können, sobald sie wieder angeboten werden (nur Referenz):

Maßgeblich ist die Live-Abfrage – übernehmen Sie keine feste Liste aus irgendeinem Dokument, auch nicht aus diesem:

curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: cr_your_qcode_key"

Alle zurückgegebenen IDs sind Gemini-Modelle, die Sie aufrufen können; tragen Sie eine davon in GEMINI_MODEL ein. Den vollständigen Katalog und die aktuellen Preise finden Sie unter qcode.cc/models.

Versionshinweis: Seit dem 2026-06-18 bedient Gemini CLI keine persönlichen Konten mit Pro / Ultra / Gratis-Tarif mehr – wechseln Sie zu Google Antigravity CLI (Antigravity CLI und Antigravity 2.0 sind seit 2026-05-19 verfügbar); kostenpflichtige Enterprise-Keys sind nicht betroffen und können weiterhin mit Gemini CLI verwendet werden.

Konfigurationsüberblick¶

Gemini CLI benötigt die folgenden Umgebungsvariablen:

• GOOGLE_GEMINI_BASE_URL - Service-Endpunkt

• GEMINI_API_KEY - API-Key (identisch mit dem für Claude Code)

• GEMINI_MODEL - Modellauswahl Die Einstellungsdatei ist der andere offiziell unterstützte Weg: auf Benutzerebene ~/.gemini/settings.json, auf Projektebene .gemini/settings.json (das Projekt überschreibt den Benutzer). Das Modell steht unter model.name, der Authentifizierungstyp unter security.auth.selectedType; Zeichenfolgenwerte in diesen Dateien können mit $VAR, ${VAR} oder ${VAR:-default} auf Umgebungsvariablen verweisen. Laut Dokumentation gilt GOOGLE_GEMINI_BASE_URL für die Authentifizierung per Gemini-API-Key. Setzen Sie daher beide Variablen wie unten gezeigt.

# Update Homebrew
brew update

# Install Node.js
brew install node

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

# Gemini CLI Configuration
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

source ~/.zshrc

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reload shell configuration
source ~/.bashrc

# Install latest LTS version
nvm install --lts

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

# Gemini CLI Configuration
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

source ~/.bashrc

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"

# Set user-level environment variables (permanent)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

Fehlerbehebung¶

Node.js-Version zu alt¶

Problem: Gemini CLI meldet Inkompatibilität der Node.js-Version

Lösung:

1. Node.js-Version prüfen: node --version

2. Die offizielle Anforderung ist Node.js 20.0.0 oder höher (engines.node >=20.0.0); bleibt man bei 18, schlägt es direkt nach der Installation fehl

3. Upgrade über nvm: nvm install --lts && nvm use --lts

Umgebungsvariablen werden nicht wirksam¶

Problem: Nach dem Setzen der Umgebungsvariablen keine Verbindung möglich

Lösung:

1. Stellen Sie sicher, dass Sie das Terminal erneut geöffnet oder den source-Befehl ausgeführt haben

2. Überprüfen Sie, ob die Variablennamen korrekt sind (Groß-/Kleinschreibung beachten)

3. Stellen Sie sicher, dass das API-Key-Format korrekt ist (beginnt mit cr_)

Netzwerkverbindungsprobleme¶

Problem: Keine Verbindung zum QCode.cc-Dienst möglich

Lösung:

1. Netzwerkverbindung prüfen

2. Überprüfen, ob GOOGLE_GEMINI_BASE_URL korrekt gesetzt ist

3. Andere Endpunkte ausprobieren:

4. Asien: https://asia.qcode.cc/gemini

Verwandte Dokumentation¶

• Antigravity CLI – der offizielle Nachfolger von Gemini CLI

• Umgebungskonfiguration – Claude Code-Einrichtung

• Codex-Integration – OpenAI Codex CLI-Konfiguration

• Schnellstart – Erste Schritte mit Claude Code

Enterprise →