Gemini CLI vs Claude Code ist Googles Terminal-Agent gegen den von Anthropic. Gemini CLI ist ein Open-Source-KI-Agent (Apache 2.0), der Gemini-Modelle in deinem Terminal ausführt: Er liest und bearbeitet Dateien, führt Shell-Befehle aus, durchsucht das Web, verbindet sich mit MCP-Servern und nimmt Projektanweisungen aus GEMINI.md. Claude Code erledigt dieselbe Arbeit mit Claude-Modellen und CLAUDE.md. Die größte Neuigkeit ist keine Funktion: Seit dem 18. Juni 2026 bedient Gemini CLI keine kostenlosen privaten Accounts mehr. Nutzer der kostenlosen Stufe und von Google One wurden zur Antigravity CLI umgezogen, und Gemini CLI ist jetzt für bezahlte API-Keys, Vertex AI und Code-Assist-Geschäftslizenzen da.
Dieser Beitrag erklärt, was Gemini CLI heute ist, wie du es installierst und dich anmeldest, wie GEMINI.md, MCP und die Sandbox funktionieren und wie es sich mit Claude Code vergleicht. Keine Benchmark-Werte; sie ändern sich mit jedem Modell-Release. Für den anderen großen Vergleich siehe Claude Code vs Codex.
Was ist Gemini CLI?
Gemini CLI ist Googles Coding-Agent für die Kommandozeile. Du führst gemini in einem Projektordner aus und sprichst mit ihm. Eingebaute Tools lassen ihn Dateien lesen und schreiben, Shell-Befehle ausführen, Webseiten abrufen und Google durchsuchen. Er funktioniert interaktiv oder headless mit -p, sodass du ihn aus Skripten und CI aufrufen kannst.
# interactive
gemini
# one-shot, with JSON output for scripts
gemini -p "summarize the changes in the last commit" --output-format json
# pick a model and add another directory to the context
gemini -m gemini-2.5-flash --include-directories ../shared
Der Quellcode liegt auf GitHub unter Apache 2.0. Stabile Releases erscheinen wöchentlich, mit Preview- und Nightly-Kanälen für alle, die Änderungen früher wollen.
Die Änderung vom Juni 2026: Antigravity CLI
Google hat angekündigt, dass Gemini CLI für Privatnutzer durch die Antigravity CLI ersetzt wird. Laut Googles Entwicklerblog und der README von Gemini CLI:
- Ab dem 18. Juni 2026 hat Gemini CLI keine Anfragen mehr für Google-AI-Pro- und -Ultra-Nutzer und für Gemini Code Assist for individuals ohne Kosten bedient. Die README formuliert es so: „Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI.“
- Für Organisationen mit Gemini Code Assist Standard oder Enterprise, für Code Assist for GitHub über Google Cloud und für bezahlte Gemini-API-Keys bleibt der Zugang gleich.
- Die README sagt außerdem, dass Gemini CLI nicht für Googles neueste Modelle optimiert wurde, und verweist dafür auf Antigravity.
Die Antigravity CLI läuft als agy. Sie erkennt bestehende Gemini-CLI-Setups, liest GEMINI.md und AGENTS.md, behält Agent-Skills, Hooks und Subagenten und wandelt Gemini-CLI-Erweiterungen mit agy plugin import gemini in Antigravity-Plugins um. Google sagt, es werde keine Funktionsgleichheit eins zu eins geben, prüfe also den Migrationsleitfaden, bevor du ein Team umstellst.
Wenn du Gemini CLI genutzt hast, weil es kostenlos war, ist das der Teil, auf den es ankommt. Der Rest dieses Beitrags gilt für Gemini CLI mit bezahltem Key oder Geschäftslizenz, und vieles davon lässt sich auf Antigravity übertragen.
Installation
Gemini CLI ist ein Node.js-Paket:
# try it without installing
npx @google/gemini-cli
# install globally
npm install -g @google/gemini-cli
# or with Homebrew
brew install gemini-cli
Release-Kanäle sind npm-Tags: @latest (stabil, wöchentlich), @preview (wöchentlich) und @nightly.
Anmeldeoptionen
Wenn du gemini zum ersten Mal startest, fragt es, wie du dich authentifizieren willst. Die dokumentierten Optionen:
| Methode | Was du setzt | Status nach dem 18. Juni 2026 |
|---|---|---|
| Sign in with Google | Browser-Login; eine bezahlte Code-Assist-Lizenz braucht außerdem GOOGLE_CLOUD_PROJECT | Funktioniert für Code Assist Standard und Enterprise; private und Google-One-Accounts zogen zu Antigravity um |
| Gemini-API-Key | GEMINI_API_KEY aus Google AI Studio | Bezahlte Keys funktionieren weiter |
| Vertex AI | GOOGLE_CLOUD_PROJECT und GOOGLE_CLOUD_LOCATION, plus ADC (gcloud auth application-default login), ein Service-Account oder GOOGLE_API_KEY | Funktioniert weiter |
export GEMINI_API_KEY="your-key"
gemini
Workspace- und Organisations-Accounts brauchen ein Google-Cloud-Projekt. Googles Quota-Seite hat tägliche Anfragezahlen pro Authentifizierungsart aufgeführt; manche dieser Zahlen stammen aus der Zeit vor der Änderung im Juni, prüfe also die aktuelle Seite und deine Cloud-Konsole statt einer Zahl in einem Blogbeitrag.
GEMINI.md: Projektanweisungen
GEMINI.md ist die Antwort von Gemini CLI auf CLAUDE.md. Es wird in Schichten geladen:
- Global:
~/.gemini/GEMINI.mdfür Regeln, die du überall willst. - Workspace:
GEMINI.md-Dateien in deinen Workspace-Verzeichnissen und deren Eltern. - Just in time: Wenn ein Tool einen Pfad berührt, lädt Gemini CLI auch
GEMINI.md-Dateien in der Nähe dieses Pfads.
Du kannst eine lange Datei aufteilen und Teile mit @file.md importieren. In einer Sitzung gibt /memory show den kombinierten Kontext aus, und /memory reload liest die Dateien neu ein.
Um eine Datei mit anderen Agenten zu teilen, änderst du in ~/.gemini/settings.json oder der .gemini/settings.json des Projekts den Dateinamen, nach dem gesucht wird:
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}
Claude Code liest CLAUDE.md und kann AGENTS.md mit @AGENTS.md importieren. Mit beiden Einstellungen steuert eine AGENTS.md beide Agenten. CLAUDE.md und AGENTS.md schreiben behandelt, was hineingehört.
MCP in Gemini CLI
Gemini CLI verbindet sich mit MCP-Servern, die unter mcpServers in settings.json deklariert sind. Ein Server kann ein lokaler Befehl (command, args, env, cwd) oder ein entfernter sein (url für SSE, httpUrl für Streamable HTTP).
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
}
}
}
Oder füge einen über die Kommandozeile hinzu:
gemini mcp add -s user -t http docs https://example.com/mcp
-s wählt den Geltungsbereich (project standardmäßig oder user) und -t den Transport (stdio, sse oder http). In einer Sitzung listet /mcp Server und ihre Tools auf, und /mcp auth übernimmt OAuth für Server, die es brauchen. Bei Claude Code sieht es fast gleich aus: claude mcp add, mit Projektservern in .mcp.json. Neu beim Protokoll? Beginne mit Was ein MCP-Server ist.
Sandbox und Freigaben
Hier ist Gemini CLI am stärksten. Sandboxing ist standardmäßig aus, und du schaltest es mit --sandbox (-s), der Umgebungsvariable GEMINI_SANDBOX oder "sandbox": true unter tools in den Einstellungen ein.
- macOS: Seatbelt (
sandbox-exec), standardmäßig mit dem Profilpermissive-open; andere Profile überSEATBELT_PROFILE. - Container: Docker oder Podman, mit dem Image
ghcr.io/google/gemini-cli. - Weitere: eine native Windows-Sandbox, gVisor (
runsc) und LXC (experimentell).
gemini --sandbox
GEMINI_SANDBOX=docker gemini
Freigabemodi sind von der Sandbox getrennt. default fragt vor Änderungen und Befehlen, auto_edit übernimmt Dateiänderungen ohne Rückfrage, und plan ist schreibgeschützt. YOLO (alles genehmigen) gibt es nur über die Kommandozeile mit --yolo oder --approval-mode=yolo. Schaltest du Checkpointing in den Einstellungen ein, kann /restore Dateien auf einen Snapshot zurücksetzen, der vor dem Lauf eines Tools erstellt wurde.
Claude Code hat Berechtigungsmodi (fragen, Änderungen akzeptieren, plan, bypass) und eine Opt-in-Sandbox für sein Bash-Tool. Gemini CLI bietet dir mehr Sandbox-Backends zur Auswahl. Welches du auch nutzt, die sichere Regel ist dieselbe: Gib einem Agenten nie vollen Zugriff außerhalb eines Containers oder eines Wegwerf-Worktrees. Sicherheit bei KI-Coding-Agenten geht auf die Bedrohungen ein.
Gemini CLI vs Claude Code im Überblick
| Gemini CLI | Claude Code | |
|---|---|---|
| Anbieter, Modelle | Google, Gemini-Modelle | Anthropic, Claude-Modelle |
| Quellcode | Open Source, Apache 2.0 | Proprietär |
| Installation | npm install -g @google/gemini-cli, brew install gemini-cli | curl -fsSL https://claude.ai/install.sh | bash, Homebrew, WinGet |
| Wer es jetzt nutzen kann | Bezahlte Gemini-API-Keys, Vertex AI, Code Assist Standard/Enterprise | Bezahlte Claude-Tarife oder Anthropic-API |
| Anweisungsdatei | GEMINI.md (konfigurierbar mit context.fileName) | CLAUDE.md |
| MCP | mcpServers in settings.json, gemini mcp add | .mcp.json, claude mcp add |
| Sandbox | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Opt-in-Sandbox für das Bash-Tool |
| Freigabemodi | default, auto_edit, plan, YOLO per Flag | Default, Änderungen akzeptieren, plan, bypass |
| Rückgängig | Checkpointing mit /restore | Checkpoints mit Rewind |
| Headless | gemini -p, JSON- und Stream-JSON-Ausgabe | claude -p, JSON- und Stream-JSON-Ausgabe |
| Extras | Erweiterungen, Websuche eingebaut | Hooks, Skills, Subagenten, Plugins |
Wann was nutzen
Nutze Gemini CLI, wenn:
- Deine Firma Gemini ohnehin über Google Cloud kauft oder Code Assist Standard oder Enterprise hat.
- Du ein echtes Sandbox-Backend (Docker, gVisor, Seatbelt-Profile) im Agenten verdrahtet haben willst.
- Du den Quellcode des Agenten lesen oder ändern willst; er ist Open Source.
- Du Google-Search-Grounding eingebaut brauchst.
Nutze Claude Code, wenn:
- Du ein Claude-Abo hast und den Agenten auf Claude-Modelle abgestimmt willst.
- Du dich auf Plan-Modus, Hooks, Skills oder Subagenten verlässt.
- Du ihn mit demselben Setup im Terminal, in einer IDE-Erweiterung, in der Desktop-App und im Web nutzen willst.
Erwäge die Antigravity CLI, wenn du Gemini CLI als privater oder Google-One-Nutzer verwendet hast. Dorthin schickt Google dich jetzt.
Beide betreiben
Zwei Agenten von zwei Anbietern zu betreiben ist aus denselben Gründen üblich wie bei jedem Paar: eine zweite Meinung zu wichtigen Änderungen, ein zweiter Nutzungspool, wenn einer ausgeht, und das Modell, das zur Aufgabe passt. Das Setup, das funktioniert:
- Eine Regeldatei. Lege gemeinsame Regeln in
AGENTS.md, setzecontext.fileNamevon Gemini so, dass sie enthalten ist, und importiere sie ausCLAUDE.md. - Getrennte Ordner. Gib jedem Agenten einen eigenen Git-Worktree und Branch, damit sie nie dieselbe Datei bearbeiten.
- Getrennte MCP-Konfiguration. Jedes Tool hat seine eigenen MCP-Einstellungen; füge dieselben Server zu beiden hinzu oder registriere sie einmal in AgentVera, das sie an beide weitergibt.
- Ein Reviewer. Lass einen Agenten den Branch des anderen prüfen, bevor du mergst.
Gemini CLI, Antigravity und Claude Code in AgentVera
AgentVera ist eine Desktop-App für macOS, Windows und Linux, die Terminal-Coding-Agenten in echten Terminals ausführt, in einem Raster pro Projekt, mit deinen vorhandenen Logins. Gemini CLI, Antigravity CLI und Claude Code stehen alle im Dialog “New agent”; eine CLI, die noch nicht installiert ist, erscheint als Not installed.
| Bedarf | In AgentVera |
|---|---|
| Anmeldung | Gemini CLI nutzt sein eigenes Google-Login oder GEMINI_API_KEY; AgentVera ersetzt es nicht |
| Modell wählen | Leer lassen für den Standard von Gemini CLI oder eines wählen, dann wird es mit --model übergeben |
| Berechtigungen | Ask, Auto oder Full access pro Agent; bei Gemini CLI ist Auto --approval-mode auto_edit und Full access --approval-mode yolo |
| Sitzungen behalten | Jeder Gemini-Agent startet mit eigener --session-id und öffnet mit --resume erneut |
| Arbeit prüfen | Automatisches Code-Review, wenn ein Turn endet |
| Agenten verketten | Flows: Gemini CLI kann Quelle oder Ziel sein (Pro und Team) |
Sei dir auch über die Grenzen im Klaren. Die MCP-Server von AgentVera und sein Browser erreichen Gemini CLI: Sie werden bei jedem Start angehängt und nach Namen mit deinen eigenen mcpServers zusammengeführt. Gemini CLI hat kein Flag für zusätzliche Anweisungen, daher erreicht das Feld “Role and instructions” es nicht; nutze AGENTS.md oder GEMINI.md. Und Full access fragt nie, hebe es dir also für Agenten in einem Worktree oder Container auf.
Das Raster, Worktrees und Code-Review sind im kostenlosen Tarif enthalten. Lade AgentVera herunter, öffne einen Gemini-CLI- oder Antigravity-Agenten neben Claude Code in zwei Worktrees und vergleiche sie an deinem eigenen Repo.
Die kurze Antwort
Gemini CLI ist ein leistungsfähiger Open-Source-Terminal-Agent mit großer Auswahl an Sandbox-Backends, aber seit Juni 2026 ein Werkzeug für bezahlte API-Keys und Google-Cloud-Kunden. Claude Code ist die stärkere Wahl, wenn du einen Claude-Tarif hast und Hooks, Skills und Subagenten willst. Warst du in der kostenlosen Stufe von Gemini CLI, schau dir die Antigravity CLI an. Und wenn du kannst, halte eine AGENTS.md und betreibe zwei Agenten.