Entwickler-Ressourcen

Gemini CLI

Gemini CLI mit der nativen Gemini-API von RunAPI konfigurieren, Anfragen prüfen und die vorherige Einrichtung wiederherstellen.

Markdown anzeigen

Übersicht

Gemini CLI ist ein Terminal-Agent. Diese Anleitung stellt den Modellanbieter auf die native Gemini-API von RunAPI um; RunAPI-Tools über MCP hinzuzufügen ist ein separater Schritt.

Bevor Sie beginnen

Folgen Sie der offiziellen Installationsanleitung. Erstellen Sie über die Authentifizierungsanleitung einen eigenen Standard-API-Schlüssel und kopieren Sie eine Gemini-native Modell-ID aus dem Modellkatalog. Committen Sie niemals Ihren Schlüssel.

SHELL

npm install -g @google/gemini-cli

RunAPI konfigurieren

Beginnen Sie mit diesen Variablen in Ihrer aktuellen Shell. Die Basis-URL ist die HTTPS-API-Wurzel ohne /v1beta; das SDK ergänzt POST /v1beta/models/{model}:streamGenerateContent?alt=sse. HTTP ist nur für localhost erlaubt.

SHELL

export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID

Für dauerhafte Nutzung speichern Sie dieselben drei Variablen in ~/.gemini/.env außerhalb Ihrer Repositories. Beschränken Sie den Zugriff mit chmod 600 ~/.gemini/.env. Gemini CLI sucht nach .env vom aktuellen Verzeichnis bis zu dessen Eltern und prüft anschließend ~/.gemini/.env und ~/.env; achten Sie auf widersprüchliche Dateien.

Führen Sie diese beiden Einstellungen in ~/.gemini/settings.json zusammen und behalten Sie andere Einstellungen bei. Verwenden Sie gemini-api-key zur API-Schlüssel-Authentifizierung, nicht eine zwischengespeicherte Google-Anmeldung. Der Schlüssel wird standardmäßig in x-goog-api-key gesendet.

JSON

{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}

Ein Modell auswählen

Verwenden Sie GEMINI_MODEL, --model YOUR_RUNAPI_MODEL_ID oder /model in einer interaktiven Sitzung. Vermeiden Sie auto, pro und flash: Diese Aliase können auf Google-Modell-IDs verweisen, die RunAPI nicht anbietet. Interne Auswahl, Klassifizierung und Schleifenerkennung können auch flash- oder flash-lite-Hilfsmodelle anfordern; prüfen Sie deren Verfügbarkeit separat.

Überprüfen

Führen Sie dies in einem vertrauenswürdigen Repository aus. Prüfen Sie das Modell in einer interaktiven Sitzung mit /about oder /stats und bestätigen Sie eine passende streamGenerateContent-Anfrage in den RunAPI-Nutzungsdaten. Eine erfolgreiche CLI-Antwort allein beweist nicht, welcher Endpunkt sie erhalten hat.

SHELL

gemini --version
gemini -p "Describe this repository in one sentence."

RunAPI-Tools hinzufügen

MCP fügt Tools hinzu, keinen Modellanbieter. Dieser Befehl registriert den lokalen Server; folgen Sie Local MCP für dessen separate Authentifizierung und Prüfung.

SHELL

gemini mcp add runapi npx -y @runapi.ai/mcp

Fehlerbehebung

Gehen Anfragen weiterhin an Google, prüfen Sie konkurrierende .env-Dateien, security.auth.selectedType, zwischengespeicherte Anmeldungen und Google/Vertex-Authentifizierungsvariablen. Bei Invalid auth method selected wählen Sie gemini-api-key statt gateway in den Einstellungen und starten neu.

Bei 401 prüfen Sie den Schlüssel und eine mögliche GEMINI_API_KEY_AUTH_MECHANISM-Überschreibung; standardmäßig wird x-goog-api-key verwendet. Bei 404 entfernen Sie /v1beta aus der Basis-URL und kopieren erneut eine unterstützte Gemini-native Modell-ID. Ist ein Hilfsmodell nicht verfügbar, prüfen Sie die tatsächlich angeforderte ID; ein Hauptmodell garantiert nicht alle CLI-Funktionen.

RunAPI bietet weder countTokens noch embedContent an. Bei einem Fehler von countTokens kann Gemini CLI Tokens lokal schätzen; diese Schätzungen können von den Nutzungsdaten abweichen. Verwenden Sie außer für localhost HTTPS und deaktivieren Sie nicht die Zertifikatsprüfung.

RunAPI entfernen

Entfernen Sie die drei Variablen aus Ihrer Shell und gespeicherten .env-Dateien, stellen Sie vorheriges security.auth.selectedType und die Modelleinstellung wieder her und widerrufen Sie den eigenen Schlüssel in RunAPI. Entfernen Sie den separat hinzugefügten MCP-Server nur, wenn Sie dessen Tools nicht mehr benötigen.

SHELL

unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL

Nächste Schritte

Weiter geht es mit dem LLM-API-Schnellstart, Gemini generateContent, streamGenerateContent, dem Modellkatalog oder Local MCP.