Gemini CLI

Gemini CLI mit Gateway-API-Schlüssel und nativer v1beta-API nutzen.

Installation und Vorbereitung

  1. Installieren Sie Node.js ab Version 20 und das offizielle Gemini-CLI-npm-Paket unten. Prüfen Sie gemini --version.
  2. Erstellen Sie unter routerra.ai API-Schlüssel einen Schlüssel für ein natives Gemini-Modell aus Modelle. Die Verbindung nutzt Gemini generateContent/streamGenerateContent, nicht OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Native Gemini-Route konfigurieren

  1. Setzen Sie die drei Variablen in der startenden Shell. Das SDK ergänzt /v1beta/models/...; GOOGLE_GEMINI_BASE_URL muss deshalb https://routerra.ai ohne /v1 oder /v1beta sein. Ersetzen Sie Schlüssel und Modell.
  2. Wählen Sie Use Gemini API key; neuere Builds erkennen Gateway-Authentifizierung eventuell automatisch. Bestehende Google-/Vertex-Sitzungen können die Route umgehen; wechseln Sie mit /auth. Dauerhaft speichern Sie NAME=value-Zeilen in ~/.gemini/.env und starten neu. Committen Sie diese Datei nicht.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Für Windows PowerShell:

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Verbindung prüfen

Testen Sie einen kurzen Prompt mit explizitem --model. Eine Google-Anmeldeseite zeigt den falschen Modus. /v1/v1beta oder /v1beta/v1beta weist auf einen zusätzlichen URL-Pfad hin. Bei abgelehntem Modell prüfen Sie native Gemini-Verfügbarkeit statt eine OpenAI-ID einzusetzen. Entfernen Sie widersprüchliche GOOGLE_GENAI_USE_VERTEXAI-/GOOGLE_GENAI_USE_GCA-Werte, starten Sie neu und prüfen Sie routerra.ai-Verbrauch.