# Gemini CLI – Integrationsanleitung

> **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

| Punkt | Details |
|---|---|
| Nutzbare Modelle | Gemini ✅ · Claude ❌ · GPT ❌ · Chinesische Modelle ❌ |
| Protokoll & Base URL | Gemini: `https://api.qcode.cc/gemini` (die CLI hängt `/v1beta/...` selbst an – fügen Sie es nicht manuell hinzu) |
| Konfigurationsort | `~/.gemini/settings.json` oder Umgebungsvariablen `GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY` |
| Offizielle Dokumentation | [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |

> **⚠️ 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](/docs/ide/antigravity) 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](javascript:void(Tawk_API.toggle())) 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](https://geminicli.com/) 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:

```bash
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](https://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](https://antigravity.google/) (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.


<div data-os="macos" markdown="1">

## macOS-Konfiguration

### Schritt 1: Node.js installieren

Gemini CLI benötigt Node.js zum Ausführen.

#### Methode 1: Mit Homebrew (Empfohlen)

Wenn Sie Homebrew installiert haben, nutzen Sie es zur Installation von Node.js:

```bash
# Update Homebrew
brew update

# Install Node.js
brew install node
```

#### Methode 2: Offizieller Download

1. Besuchen Sie [https://nodejs.org/](https://nodejs.org/)

2. Laden Sie die LTS-Version für macOS herunter

3. Öffnen Sie die heruntergeladene `.pkg`-Datei

4. Folgen Sie den Anweisungen des Installationsprogramms, um die Installation abzuschließen

#### Hinweise für macOS

- Bei Berechtigungsproblemen müssen Sie möglicherweise `sudo` verwenden

- Beim ersten Start ist möglicherweise eine Bestätigung in den Systemeinstellungen erforderlich

- Terminal oder iTerm2 wird empfohlen

#### Node.js-Installation überprüfen

Öffnen Sie nach der Installation das Terminal und führen Sie aus:

```bash
node --version
npm --version
```

Wenn Versionsnummern angezeigt werden, war die Installation erfolgreich!

### Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global über npm:

```bash
npm install -g @google/gemini-cli
```

Überprüfen Sie nach der Installation:

```bash
gemini --version
```

### Schritt 3: Umgebungsvariablen für Gemini CLI konfigurieren

Legen Sie die folgenden Umgebungsvariablen fest, um eine Verbindung zum Relay-Dienst herzustellen:

#### Temporäre Einrichtung (Aktuelle Sitzung)

Führen Sie die folgenden Befehle im Terminal aus:

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

> Ersetzen Sie `cr_xxxxxxxxxx` durch Ihren [QCode.cc API-Key](https://qcode.cc/dashboard). Verwenden Sie denselben API-Key wie für Claude Code.

#### Permanente Einrichtung (Shell-Konfiguration)

Fügen Sie Folgendes in Ihre Shell-Konfigurationsdatei (`~/.zshrc`) ein:

```bash
# 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"
```

Führen Sie anschließend aus:

```bash
source ~/.zshrc
```

### Umgebungsvariablen für Gemini CLI überprüfen

Überprüfen Sie im Terminal:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2-Konfiguration

### Schritt 1: Node.js installieren

Gemini CLI benötigt Node.js zum Ausführen.

#### Methode 1: Mit nvm (Empfohlen)

nvm erleichtert die Verwaltung mehrerer Node.js-Versionen:

```bash
# 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
```

#### Methode 2: Mit Paketmanager

```bash
# 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
```

#### Hinweise für Linux / WSL2

- WSL2-Benutzer sollten in der Linux-Subsystem-Umgebung installieren, nicht in Windows

- Die Verwendung von nvm hilft, Berechtigungsprobleme zu vermeiden

- Stellen Sie sicher, dass die Shell-Konfigurationsdatei nvm korrekt lädt

#### Node.js-Installation überprüfen

Öffnen Sie nach der Installation das Terminal und führen Sie aus:

```bash
node --version
npm --version
```

Wenn Versionsnummern angezeigt werden, war die Installation erfolgreich!

### Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global über npm:

```bash
npm install -g @google/gemini-cli
```

Überprüfen Sie nach der Installation:

```bash
gemini --version
```

### Schritt 3: Umgebungsvariablen für Gemini CLI konfigurieren

Legen Sie die folgenden Umgebungsvariablen fest, um eine Verbindung zum Relay-Dienst herzustellen:

#### Temporäre Einrichtung (Aktuelle Sitzung)

Führen Sie die folgenden Befehle im Terminal aus:

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

> Ersetzen Sie `cr_xxxxxxxxxx` durch Ihren [QCode.cc API-Key](https://qcode.cc/dashboard). Verwenden Sie denselben API-Key wie für Claude Code.

#### Permanente Einrichtung (Shell-Konfiguration)

Fügen Sie Folgendes in Ihre Shell-Konfigurationsdatei (`~/.bashrc`) ein:

```bash
# 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"
```

Führen Sie anschließend aus:

```bash
source ~/.bashrc
```

Wenn Sie Zsh verwenden, fügen Sie den Eintrag in `~/.zshrc` hinzu und führen `source ~/.zshrc` aus.

### Umgebungsvariablen für Gemini CLI überprüfen

Überprüfen Sie im Terminal:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="windows" markdown="1">

## Windows-Konfiguration

### Schritt 1: Node.js installieren

Gemini CLI erfordert Node.js zur Ausführung.

#### Methode 1: Offizieller Download (Empfohlen)

1. Öffnen Sie Ihren Browser und besuchen Sie [https://nodejs.org/](https://nodejs.org/)

2. Klicken Sie auf die „LTS“-Version zum Herunterladen (empfohlen für Stabilität)

3. Doppelklicken Sie auf die heruntergeladene `.msi`-Datei

4. Folgen Sie dem Installationsassistenten und behalten Sie die Standardeinstellungen bei

#### Methode 2: Paketmanager verwenden

Wenn Sie Chocolatey oder Scoop installiert haben, verwenden Sie die Befehlszeile:

```powershell
# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs
```

#### Hinweise für Windows

- PowerShell wird gegenüber CMD empfohlen

- Führen Sie als Administrator aus, falls Berechtigungsprobleme auftreten

- Einige Antivirus-Software kann dies melden; bei Bedarf zur Whitelist hinzufügen

#### Node.js-Installation überprüfen

Öffnen Sie nach der Installation PowerShell oder CMD und führen Sie aus:

```powershell
node --version
npm --version
```

Wenn Versionsnummern angezeigt werden, war die Installation erfolgreich!

### Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global über npm:

```powershell
npm install -g @google/gemini-cli
```

Überprüfung nach der Installation:

```powershell
gemini --version
```

### Schritt 3: Umgebungsvariablen für Gemini CLI konfigurieren

Setzen Sie die folgenden Umgebungsvariablen, um eine Verbindung zum Relay-Dienst herzustellen:

#### PowerShell temporäre Einrichtung (aktuelle Sitzung)

Führen Sie die folgenden Befehle in PowerShell aus:

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

> Ersetzen Sie `cr_xxxxxxxxxx` durch Ihren [QCode.cc API-Key](https://qcode.cc/dashboard). Verwenden Sie denselben API-Key wie für Claude Code.

#### PowerShell permanente Einrichtung (Benutzerebene)

Führen Sie die folgenden Befehle in PowerShell aus:

```powershell
# 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)
```

> Sie müssen PowerShell erneut öffnen, damit die Änderungen wirksam werden.

### Umgebungsvariablen für Gemini CLI überprüfen

Überprüfung in PowerShell:

```powershell
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL
```

</div>

## 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:
   - Asien-Backup: `https://asia.qcode.cc/gemini`

## Verwandte Dokumentation

- [Antigravity CLI](/docs/ide/antigravity) – der offizielle Nachfolger von Gemini CLI
- [Umgebungskonfiguration](/docs/getting-started/environment) – Claude Code-Einrichtung

- [Codex-Integration](/docs/ide/codex) – OpenAI Codex CLI-Konfiguration

- [Schnellstart](/docs/getting-started/quick-start) – Erste Schritte mit Claude Code