Gemini CLI Integration mit benutzerdefinierten CodingPlanX-Modellen

Google Gemini CLI mit dem CodingPlanX.ai API-Schlüssel konfigurieren

Gemini CLI Integrationskonfigurationsleitfaden

CodingPlanX.ai unterstützt Claude Code, OpenAI Codex und Google Gemini CLI. Nach dem Kauf eines Pakets teilen sich die drei Tools das Paketkontingent, sodass Sie flexibel wählen können, welches Tool Sie verwenden möchten.

Was ist Gemini CLI

Gemini CLI ist ein Befehlszeilen-KI-Programmierassistent von Google, ähnlich wie Claude Code, der Ihnen bei der Codeentwicklung, beim Debugging und bei Dateioperationen im Terminal helfen kann.

Verfügbare Modelle

Die folgenden Gemini-Modelle können über CodingPlanX.ai verwendet werden:

Modell	Beschreibung
`gemini-3-pro-preview`	Neueste Vorschauversion, empfohlen
`gemini-2.5-pro`	Stabile Version

> Neueste Version: Gemini CLI v0.33.1 (2026-03-12), unterstützt das Extensions-System, benutzerdefinierte Themes und andere neue Funktionen.

Konfigurationsübersicht

Gemini CLI erfordert die Konfiguration der folgenden Umgebungsvariablen:

GOOGLE_GEMINI_BASE_URL - Dienstadresse
GEMINI_API_KEY - API-Schlüssel (identisch mit Claude Code)
GEMINI_MODEL - Modellauswahl

macOS-Konfiguration

Schritt 1: Node.js-Umgebung installieren

Gemini CLI benötigt eine Node.js-Umgebung, um ausgeführt zu werden.

Methode 1: Homebrew verwenden (Empfohlen)

Wenn Sie Homebrew bereits installiert haben, ist es bequemer, Node.js darüber zu installieren:

# Homebrew aktualisieren
brew update

# Node.js installieren
brew install node

Methode 2: Von der offiziellen Website herunterladen

Besuchen Sie https://nodejs.org/
Laden Sie die LTS-Version für macOS herunter
Öffnen Sie die heruntergeladene .pkg-Datei
Folgen Sie den Anweisungen des Installationsprogramms, um die Installation abzuschließen

macOS-Hinweise

Bei Berechtigungsproblemen müssen Sie möglicherweise sudo verwenden
Beim ersten Ausführen müssen Sie es möglicherweise in den Systemeinstellungen zulassen
Es wird empfohlen, Terminal oder iTerm2 zu verwenden

Node.js-Installation überprüfen

Öffnen Sie nach Abschluss der Installation das Terminal und geben Sie die folgenden Befehle ein:

node --version
npm --version

Wenn die Versionsnummer angezeigt wird, war die Installation erfolgreich!

Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global mit npm:

npm install -g @google/gemini-cli

Überprüfen Sie die Installation nach Abschluss:

gemini --version

Schritt 3: Gemini CLI Umgebungsvariablen konfigurieren

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

Temporäre Einstellung (aktuelle Sitzung)

Führen Sie den folgenden Befehl im Terminal aus:

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel. Verwenden Sie einfach denselben API-Schlüssel wie für Claude Code.

Dauerhafte Einstellung (Shell-Konfigurationsdatei)

Fügen Sie den folgenden Inhalt zu Ihrer Shell-Konfigurationsdatei (~/.zshrc) hinzu:

# Gemini CLI Konfiguration
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Führen Sie dann aus:

source ~/.zshrc

Gemini CLI Umgebungsvariablen überprüfen

Im Terminal überprüfen:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Linux / WSL2-Konfiguration

Schritt 1: Node.js-Umgebung installieren

Gemini CLI benötigt eine Node.js-Umgebung, um ausgeführt zu werden.

Methode 1: nvm verwenden (Empfohlen)

nvm kann problemlos mehrere Node.js-Versionen verwalten:

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

# Shell-Konfiguration neu laden
source ~/.bashrc

# Neueste LTS-Version installieren
nvm install --lts

Methode 2: Paketmanager verwenden

# 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

Linux / WSL2-Hinweise

Für WSL2-Benutzer wird empfohlen, es im Linux-Subsystem statt unter Windows zu installieren
Die Verwendung von nvm kann Berechtigungsprobleme vermeiden
Stellen Sie sicher, dass die Shell-Konfigurationsdatei nvm korrekt geladen hat

Node.js-Installation überprüfen

Öffnen Sie nach Abschluss der Installation das Terminal und geben Sie die folgenden Befehle ein:

node --version
npm --version

Wenn die Versionsnummer angezeigt wird, war die Installation erfolgreich!

Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global mit npm:

npm install -g @google/gemini-cli

Überprüfen Sie die Installation nach Abschluss:

gemini --version

Schritt 3: Gemini CLI Umgebungsvariablen konfigurieren

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

Temporäre Einstellung (aktuelle Sitzung)

Führen Sie den folgenden Befehl im Terminal aus:

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel. Verwenden Sie einfach denselben API-Schlüssel wie für Claude Code.

Dauerhafte Einstellung (Shell-Konfigurationsdatei)

Fügen Sie den folgenden Inhalt zu Ihrer Shell-Konfigurationsdatei (~/.bashrc) hinzu:

# Gemini CLI Konfiguration
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Führen Sie dann aus:

source ~/.bashrc

Wenn Sie Zsh verwenden, fügen Sie es zu ~/.zshrc hinzu und führen Sie source ~/.zshrc aus.

Gemini CLI Umgebungsvariablen überprüfen

Im Terminal überprüfen:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Windows-Konfiguration

Schritt 1: Node.js-Umgebung installieren

Gemini CLI benötigt eine Node.js-Umgebung, um ausgeführt zu werden.

Methode 1: Download von der offiziellen Website (Empfohlen)

Öffnen Sie Ihren Browser und besuchen Sie https://nodejs.org/
Klicken Sie auf die "LTS"-Version zum Herunterladen (Long Term Support-Version empfohlen)
Doppelklicken Sie nach dem Herunterladen auf die .msi-Datei
Folgen Sie dem Installationsassistenten, um die Installation abzuschließen, behalten Sie die Standardeinstellungen bei

Methode 2: Paketmanager verwenden

Wenn Sie Chocolatey oder Scoop installiert haben, können Sie es über die Befehlszeile installieren:

# Chocolatey verwenden
choco install nodejs

# Oder Scoop verwenden
scoop install nodejs

Windows-Hinweise

Es wird empfohlen, PowerShell anstelle von CMD zu verwenden
Wenn Sie auf Berechtigungsprobleme stoßen, versuchen Sie, als Administrator auszuführen
Einige Antivirenprogramme könnten Fehlalarme auslösen, Sie müssen es zur Whitelist hinzufügen

Node.js-Installation überprüfen

Öffnen Sie nach Abschluss der Installation PowerShell oder CMD und geben Sie die folgenden Befehle ein:

node --version
npm --version

Wenn die Versionsnummer angezeigt wird, war die Installation erfolgreich!

Schritt 2: Gemini CLI installieren

Installieren Sie Gemini CLI global mit npm:

npm install -g @google/gemini-cli

Überprüfen Sie die Installation nach Abschluss:

gemini --version

Schritt 3: Gemini CLI Umgebungsvariablen konfigurieren

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

PowerShell Temporäre Einstellung (aktuelle Sitzung)

Führen Sie den folgenden Befehl in PowerShell aus:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

> Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel. Verwenden Sie einfach denselben API-Schlüssel wie für Claude Code.

PowerShell Dauerhafte Einstellung (Benutzerebene)

Führen Sie den folgenden Befehl in PowerShell aus:

# Umgebungsvariablen auf Benutzerebene festlegen (dauerhaft gültig)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

> Nach der Einstellung müssen Sie das PowerShell-Fenster neu öffnen, damit die Änderungen wirksam werden.

Gemini CLI Umgebungsvariablen überprüfen

In PowerShell überprüfen:

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

Häufige Probleme

Node.js-Version zu alt

Problem: Gemini CLI meldet, dass die Node.js-Version inkompatibel ist

Lösung:

Node.js-Version überprüfen: node --version
Es wird empfohlen, Node.js 18.x oder höher zu verwenden
Mit nvm aktualisieren: nvm install --lts && nvm use --lts

Umgebungsvariablen nicht wirksam

Problem: Keine Verbindung möglich nach dem Festlegen der Umgebungsvariablen

Lösung:

Bestätigen Sie, dass das Terminal neu geöffnet oder der source-Befehl ausgeführt wurde
Überprüfen Sie, ob der Variablenname korrekt ist (Groß-/Kleinschreibung beachten)
Überprüfen Sie, ob das Format des API-Schlüssels korrekt ist (beginnt mit cr_)

Netzwerkverbindungsproblem

Problem: Keine Verbindung zum CodingPlanX.ai-Dienst möglich

Lösung:

Überprüfen Sie, ob die Netzwerkverbindung normal ist
Überprüfen Sie, ob GOOGLE_GEMINI_BASE_URL korrekt eingestellt ist