--- title: Gemini CLI | RunAPI description: Gemini CLI mit der nativen Gemini-API von RunAPI konfigurieren, Anfragen prüfen und die vorherige Einrichtung wiederherstellen. url: https://runapi.ai/de/docs/resources/tool-integrations/gemini-cli.md canonical: https://runapi.ai/de/docs/resources/tool-integrations/gemini-cli locale: de --- > HTML-Version: https://runapi.ai/de/docs/resources/tool-integrations/gemini-cli > Website-Index für KI-Agenten: https://runapi.ai/llms.txt # Gemini CLI ## Ü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][1]. Erstellen Sie über die [Authentifizierungsanleitung](https://runapi.ai/de/docs/guides/authentication.md) einen eigenen Standard-API-Schlüssel und kopieren Sie eine Gemini-native Modell-ID aus dem [Modellkatalog](https://runapi.ai/de/models). Committen Sie niemals Ihren Schlüssel. [1]: https://geminicli.com/docs/get-started/installation/ ```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](https://runapi.ai/de/docs/resources/mcp/local.md) 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](https://runapi.ai/de/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/de/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/de/docs/api/gemini/stream-generate-content.md), dem [Modellkatalog](https://runapi.ai/de/models) oder [Local MCP](https://runapi.ai/de/docs/resources/mcp/local.md). --- ## Mehr von RunAPI - [Startseite](https://runapi.ai/de/.md) - [Modellkatalog](https://runapi.ai/de/models.md) - [Preise](https://runapi.ai/de/pricing.md) - [Anbieter](https://runapi.ai/de/models) - [Dokumentation](https://runapi.ai/de/docs/guides) - [SDKs](https://runapi.ai/de/sdk.md) - [CLI](https://runapi.ai/de/cli.md) - [MCP Server](https://runapi.ai/de/mcp.md) - [x402](https://runapi.ai/de/x402.md) - [Claude Code vs Cursor](https://runapi.ai/de/claude-code-vs-cursor.md) - [Cursor API-Einrichtung](https://runapi.ai/de/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/de/openrouter-alternative.md) - [Enterprise](https://runapi.ai/de/contact.md) - [Kontakt](https://runapi.ai/de/contact.md) - [Bedingungen](https://runapi.ai/de/terms.md) - [Datenschutz](https://runapi.ai/de/privacy.md) - [Website-Index für KI-Agenten](https://runapi.ai/llms.txt) Kontakt: contact@runapi.ai ## Strukturierte Daten ```json [ { "@context": "https://schema.org", "inLanguage": "de", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/de", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/de/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "de", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/de", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/deicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "de", "@type": "TechArticle", "headline": "Gemini CLI", "description": "Gemini CLI mit der nativen Gemini-API von RunAPI konfigurieren, Anfragen prüfen und die vorherige Einrichtung wiederherstellen.", "url": "https://runapi.ai/de/docs/resources/tool-integrations/gemini-cli", "mainEntityOfPage": "https://runapi.ai/de/docs/resources/tool-integrations/gemini-cli" } ] ```