Gemini CLI – Integrationsanleitung

Google Gemini CLI mit einem QCode.cc API-Key konfigurieren – kostenpflichtige Enterprise-Keys; die Pro-/Gratis-Tarife wurden am 2026-06-18 eingestellt

Zuletzt geprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (Gemini CLI v0.60.0 (2026-09-15; Pro-/Gratis-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“.

🚧 Eingeschränkte Verfügbarkeit: Gemini-Ressourcen stehen derzeit nur in begrenztem Umfang zur Verfügung und werden noch nicht breit angeboten. Wenn Sie einen hohen Bedarf haben, wenden Sie sich bitte an unseren Live-Chat oder schreiben Sie an hi@qcode.cc – wir können dedizierte Gemini-Ressourcen für Sie einrichten.

QCode.cc unterstützt Claude Code, OpenAI Codex und Google Gemini CLI. Nach dem Kauf eines Tarifs teilen sich alle drei Tools dasselbe Kontingent, sodass Sie frei wählen können, welches Tool Sie verwenden.

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¶

Die folgenden Gemini-Modelle sind über QCode.cc verfügbar:

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. Backup-Endpunkte ausprobieren:

4. Asien-Backup: 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