Gemini CLI mit eigenem Endpunkt und kostenlosen Modellen
Gemini CLI ist der Open-Source-Coding-Agent von Google für das Terminal. Er kann seine Anfragen an eine eigene Basis-URL senden. Diese Anleitung richtet Gemini CLI auf FreeLLMAPI aus, das die native Gemini API unter /v1beta bereitstellt. Ihre Anfragen gehen dann an Ihren Pool kostenloser Anbieter, zu dem auch kostenlose Gemini-API-Schlüssel gehören können.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
Die Änderung des kostenlosen Angebots von Gemini CLI im Jahr 2026
Lesen Sie dies zuerst. Google hat die kostenlose Nutzung von Gemini CLI im Jahr 2026 geändert. Die Quota-Seite von Gemini CLI sagt: „Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.“
Die Ankündigung von Google sagt, dass Gemini CLI über kostenpflichtige Gemini-API-Schlüssel und für Enterprise-Kunden verfügbar bleibt.
- Google-Anmeldung im kostenlosen Angebot: Für Verbraucherkonten wird Gemini CLI nicht mehr bereitgestellt.
- Gemini-API-Schlüssel mit eigener Basis-URL: Die Konfigurationsreferenz von Gemini CLI dokumentiert weiterhin
GOOGLE_GEMINI_BASE_URL. Mit dieser Variable sendet Gemini CLI seine Anfragen an die URL, die Sie setzen, nicht an Google. - Kostenlose Gemini-API-Schlüssel: Google AI Studio listet weiterhin ein kostenloses Angebot für die Gemini API. FreeLLMAPI kann diese Schlüssel zusammen mit Schlüsseln anderer Anbieter nutzen.
Diese Anleitung verwendet die zweite Methode. FreeLLMAPI beantwortet die Anfragen und sendet jede an ein kostenloses Modell in Ihrem Pool.
Schritt 1: FreeLLMAPI und Gemini CLI installieren
Beides installieren
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliÖffnen Sie http://localhost:3001. Fügen Sie auf der Seite Keys mindestens zwei kostenlose Anbieterschlüssel hinzu. Ein kostenloser Schlüssel von Google AI Studio ist ein guter erster Schlüssel. Kopieren Sie Ihren einheitlichen Schlüssel von derselben Seite.
Schritt 2: Gemini CLI auf das Gateway richten
Setzen Sie zwei Umgebungsvariablen und starten Sie Gemini CLI. Die Basis-URL ist der Server-Ursprung ohne /v1beta. Gemini CLI ergänzt den API-Pfad selbst.
macOS oder Linux
export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiWenn Gemini CLI nach einer Authentifizierungsmethode fragt, wählen Sie Use Gemini API key. Um die Wahl zu speichern, setzen Sie sie in ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Ein Problem in Gemini CLI berichtet, dass Version 0.44.x mit der Meldung „Invalid auth method selected“ fehlschlägt, wenn GOOGLE_API_KEY zusammen mit GOOGLE_GEMINI_BASE_URL verwendet wird. Ist GOOGLE_API_KEY gesetzt, entfernen Sie es mit unset GOOGLE_API_KEY.Schritt 3: Gemini-Modellnamen auf kostenlose Modelle abbilden
Gemini CLI fragt nach Gemini-Modellnamen, zum Beispiel gemini-2.5-flash. FreeLLMAPI sendet diese Namen nicht direkt an Google. Es löst sie über die Zuordnung der Gemini-Familien auf dem Tab Keys, Agents auf. Ordnen Sie jede Familie (Pro, Flash und Flash-Lite) Auto oder einem festgelegten Katalogmodell zu.
- Mit Auto wählt der Router für jede Anfrage ein kostenloses Modell aus. Sendet ein Anbieter den Fehler 429, versucht der Router den nächsten.
- Katalog-IDs funktionieren auch als Modellnamen. Starten Sie Gemini CLI mit
gemini -m <catalog-id>oder setzen SieGEMINI_MODEL. - Gemini CLI ist ein Agent mit Tools. Ordnen Sie die Familien Modellen mit Tool-Aufrufen und großem Kontextfenster zu.
Die erste Tabelle zeigt die heute im Katalog enthaltenen kostenlosen Gemini-Modelle. Die zweite Tabelle zeigt weitere kostenlose Modelle, die Sie einer Gemini-Familie zuordnen können.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.8 Live | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
Es werden 8 von 14 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 Anfragen/Min. 1 req/min per model | Ja | Nein |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 Anfragen/Min. 40 RPM | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nein |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 Anfragen/Min. 50 Anfragen/Tag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 Anfragen/Min. 50 Anfragen/Tag Shared rate limit | Ja | Nein |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 Anfragen/Min. 250 Anfragen/Tag 70,000 Token/Min. ~6M | Ja | Ja |
Es werden 8 von 104 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Limits des kostenlosen Gemini-Angebots
Die Seite zu den Rate Limits von Google sagt, dass Limits pro Projekt gelten, nicht pro API-Schlüssel. Mehr Schlüssel in einem Projekt bringen kein größeres Kontingent. Google sagt außerdem, dass Limits nicht garantiert sind, und dass Sie Ihre aktuellen Limits in Google AI Studio sehen können. Vorschau-Modelle haben niedrigere Limits.
Ein kostenloser Gemini-Flash-Schlüssel erlaubt nur wenige Anfragen pro Tag. Eine einzelne Aufgabe in Gemini CLI kann viele Anfragen senden. Fügen Sie Schlüssel anderer Anbieter hinzu, damit der Router weiterarbeiten kann, wenn das Gemini-Kontingent erschöpft ist. Die native Schnittstelle unterstützt generateContent, streamGenerateContent mit ?alt=sse, countTokens und die Modellliste.
FreeLLMAPI akzeptiert den Schlüssel im Header x-goog-api-key, als Bearer-Token oder im Query-Parameter ?key= von Gemini. Verwenden Sie bevorzugt einen Header, weil ein Schlüssel in einer URL in den Shell-Verlauf und in Proxy-Logs gelangen kann.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| Gemini CLI öffnet eine Google-Anmeldung | Der Authentifizierungstyp ist nicht auf Gemini-API-Schlüssel gesetzt | Wählen Sie Use Gemini API key oder setzen Sie security.auth.selectedType |
| „Invalid auth method selected“ (englische Fehlermeldung) | GOOGLE_API_KEY wird mit einer eigenen Basis-URL verwendet | Verwenden Sie GEMINI_API_KEY und heben Sie GOOGLE_API_KEY mit unset auf |
| Anfragen gehen an Google, nicht an das Gateway | GOOGLE_GEMINI_BASE_URL ist in dieser Shell nicht gesetzt | Exportieren Sie die Variable und starten Sie gemini erneut |
404 bei Modellaufrufen | Die Basis-URL enthält /v1beta | Verwenden Sie nur den Ursprung http://localhost:3001 |
| Tool-Aufrufe schlagen fehl | Die Gemini-Familie ist einem Modell mit schwacher Tool-Unterstützung zugeordnet | Ordnen Sie die Familie einem Modell aus den Tabellen oben zu |
| „All models rate-limited after N attempts“ (englische Fehlermeldung) | Alle Schlüssel haben ihr Limit erreicht | Fügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abkühlzeiten |
Häufig gestellte Fragen
Ist Gemini CLI noch kostenlos?
Google hat die kostenlose Nutzung von Gemini CLI mit einer Google-Anmeldung für Nutzer ohne Bezahlung und für Google-One-Nutzer am 18. Juni 2026 beendet. Die CLI unterstützt weiterhin eine eigene Basis-URL, sodass sie über ein kostenloses Gateway wie FreeLLMAPI laufen kann.
Wie verwende ich Gemini CLI mit einem eigenen Endpunkt?
Setzen Sie GOOGLE_GEMINI_BASE_URL auf den Ursprung des Endpunkts und GEMINI_API_KEY auf dessen Schlüssel. Wählen Sie dann Use Gemini API key. Der Endpunkt muss die native Gemini API unter /v1beta sprechen.
Kann Gemini CLI Modelle nutzen, die nicht von Gemini sind?
Ja, über FreeLLMAPI. Das Gateway ordnet die Familiennamen Gemini Pro, Flash und Flash-Lite Auto oder einem beliebigen Katalogmodell zu, zum Beispiel einem Qwen- oder GLM-Modell.
Wie hoch sind die Limits des kostenlosen Gemini-API-Angebots?
Google setzt die Limits pro Projekt, nicht pro Schlüssel, und zeigt die aktuellen Werte in Google AI Studio an. Die Tabelle auf dieser Seite zeigt die heutigen kostenlosen Gemini-Modelle und ihre Limits aus dem FreeLLMAPI-Katalog.
Warum erhalte ich die Meldung „Invalid auth method selected“?
Ein Problem in Gemini CLI meldet diesen Fehler in Version 0.44.x, wenn GOOGLE_API_KEY zusammen mit GOOGLE_GEMINI_BASE_URL verwendet wird. Verwenden Sie GEMINI_API_KEY und heben Sie GOOGLE_API_KEY mit unset auf.
Verwandte Anleitungen
- free gemini api
- Gemini-API-Kontingent überschritten (429 RESOURCE_EXHAUSTED)
- So nutzen Sie Claude Code kostenlos
- Codex CLI mit kostenlosen Modellen nutzen
- Beste kostenlose Coding-Modell-APIs
Quellen
- Gemini CLI docs: configuration reference (geprüft 20 November 2026)
- Gemini CLI docs: authentication (geprüft 20 November 2026)
- Gemini CLI docs: quota and pricing (geprüft 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (geprüft 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (geprüft 20 November 2026)
- Google AI Studio: rate limits (geprüft 20 November 2026)
- FreeLLMAPI docs: native Gemini API (geprüft 20 November 2026)