# Gemini CLI nutzen: Schritt-für-Schritt-Anleitung URL: https://agentvera.dev/de/blog/how-to-use-gemini-cli/ · Veröffentlicht: 2026-10-25 Gemini CLI nutzen: installieren, nach der Änderung vom Juni 2026 anmelden, GEMINI.md schreiben, settings.json, MCP-Server und Änderungen per Checkpoint zurücknehmen. **Kurz gesagt:** - Installiere Gemini CLI mit npm, Homebrew oder MacPorts oder probiere es mit npx aus, starte dann gemini in einem Projektordner und wähle eine Anmeldemethode. - Seit dem 18. Juni 2026 wurden Nutzer des kostenlosen Tarifs und von Google One zu Antigravity CLI verschoben; Gemini CLI läuft jetzt mit bezahlten Gemini-API-Keys, Vertex AI und Code Assist Standard oder Enterprise. - Projektregeln gehören in GEMINI.md, Einstellungen in .gemini/settings.json; MCP-Server fügst du mit gemini mcp add hinzu, und Checkpointing mit /restore nimmt Dateiänderungen zurück. Um Gemini CLI zu nutzen, installierst du es mit npm oder Homebrew, startest `gemini` in einem Projektordner, wählst eine Anmeldemethode und beschreibst dann in normaler Sprache, was du willst. Gemini liest deine Dateien, schlägt Änderungen und Shell-Befehle vor und fragt standardmäßig vor jedem einzelnen nach. Vorab ein wichtiger Hinweis. **Seit dem 18. Juni 2026 bedient Gemini CLI keine Nutzer des kostenlosen Tarifs und von Google One mehr.** Google hat diese Nutzer zu Antigravity CLI verschoben. Gemini CLI funktioniert weiter mit einem bezahlten Gemini-API-Key, Vertex AI oder einer Lizenz für Gemini Code Assist Standard oder Enterprise. Diese Anleitung behandelt Installation, Anmeldung, `GEMINI.md`, Einstellungen, MCP, Freigabemodi, Slash-Befehle, Checkpointing und das Fortsetzen von Sessions. Alles hier folgt der offiziellen Gemini-CLI-Dokumentation von Google mit Stand Oktober 2026. ## Was Gemini CLI ist Gemini CLI ist Googles Open-Source-Coding-Agent für das Terminal. Er nutzt Gemini-Modelle, liest und bearbeitet Dateien in dem Ordner, in dem du ihn startest, führt Shell-Befehle aus, sucht im Web, verbindet sich mit MCP-Servern und bezieht Projektanweisungen aus `GEMINI.md`. Er ist ein [Coding-Agent](/de/glossary/coding-agent/ "Was ist ein Coding-Agent") und keine Autovervollständigung: Du gibst ihm eine Aufgabe, und er arbeitet sie Schritt für Schritt ab. Einen Vergleich mit anderen Agenten findest du in [Gemini CLI vs. Claude Code](/de/blog/gemini-cli-vs-claude-code/ "Gemini CLI vs. Claude Code") und [Codex vs. Gemini CLI](/de/blog/codex-vs-gemini-cli/ "Codex vs. Gemini CLI"). ## Schritt 1: Gemini CLI installieren Gemini CLI braucht Node.js. Wähle die Installation, die zu deinem Setup passt: | Methode | Befehl | | --- | --- | | Ohne Installation testen | `npx @google/gemini-cli` | | npm (jede Plattform) | `npm install -g @google/gemini-cli` | | macOS, Linux (Homebrew) | `brew install gemini-cli` | | macOS (MacPorts) | `sudo port install gemini-cli` | Auf npm gibt es drei Release-Kanäle: `@latest` (stabil, wöchentlich), `@preview` (wöchentlich, dem stabilen Kanal voraus) und `@nightly`. Für die meisten ist der stabile Kanal richtig. Aktualisieren kannst du später mit `gemini update` oder über deinen Paketmanager. Prüfe die Installation: ```bash gemini --version ``` ## Schritt 2: Anmeldemethode wählen Wechsle in ein Projekt und starte Gemini CLI: ```bash cd mein-projekt gemini ``` Beim ersten Start fragt Gemini CLI, wie du dich authentifizieren willst. Es gibt drei Optionen: - **Sign in with Google:** öffnet den Browser. Nach der Änderung vom Juni 2026 ist das für Organisationen mit einer Lizenz für Gemini Code Assist Standard oder Enterprise gedacht; setze vor dem Start `GOOGLE_CLOUD_PROJECT` auf die ID deines Google-Cloud-Projekts. - **Gemini-API-Key:** Erstelle in Google AI Studio einen Key und setze `GEMINI_API_KEY`. Bei einem bezahlten Key wird pro Token abgerechnet. - **Vertex AI:** für Teams auf Google Cloud. Setze `GOOGLE_API_KEY` und `GOOGLE_GENAI_USE_VERTEXAI=true` oder nutze deine Cloud-Zugangsdaten. ```bash export GEMINI_API_KEY="dein-key" gemini ``` Mit `/auth` wechselst du die Methode später. Hast du Gemini CLI bisher mit einem kostenlosen privaten Account genutzt, verweist Googles Hinweis dich stattdessen auf Antigravity CLI; [Gemini CLI vs. Claude Code](/de/blog/gemini-cli-vs-claude-code/ "Gemini CLI vs. Claude Code") beschreibt den Umstieg ausführlich. Bevor du lange Sessions mit einem Key laufen lässt, wirf einen Blick auf [Googles Preise für die Gemini API](https://ai.google.dev/gemini-api/docs/pricing "Preise der Gemini API"). ## Schritt 3: deine erste Aufgabe Fang mit etwas Kleinem, aber Echtem an: ```text Erkläre, wie das Zahlungsmodul aufgebaut ist, füge dann eine Eingabeprüfung für den Refund-Endpoint hinzu und führe die Tests aus. ``` Gemini liest die nötigen Dateien, zeigt dir jede Änderung und jeden Befehl und wartet auf dein OK. Ein paar Kürzel helfen vom ersten Tag an: - `@pfad/zur/datei` hängt eine Datei (oder einen ganzen Ordner) an deinen Prompt. - `!git status` führt einen Shell-Befehl direkt aus. Ein einzelnes `!` schaltet den Shell-Modus ein und aus. - `gemini -p "fasse README.md zusammen"` führt einen einzelnen Prompt ohne interaktive Oberfläche aus und gibt die Antwort aus. Mit `--output-format json` kann ein Skript das Ergebnis lesen. - `/copy` kopiert die letzte Antwort in die Zwischenablage. ## Schritt 4: eine GEMINI.md schreiben `GEMINI.md` ist eine Markdown-Datei mit Anweisungen, die Gemini CLI lädt und mit jedem Prompt mitschickt: wie gebaut und getestet wird, Code-Stil, was tabu ist. Führe `/init` aus, und Gemini erzeugt aus deinem Projekt eine erste Version. Halte sie kurz und konkret: ```markdown # Projekt: billing-service ## Befehle - Installieren: npm ci - Testen: npm test (ausführen, bevor eine Aufgabe als fertig gilt) ## Stil - TypeScript, 2 Leerzeichen Einrückung, nur strikte Gleichheit. - Neue Endpoints kommen nach src/routes und brauchen einen Test. ## Nicht - Keine Dateien in src/generated bearbeiten. ``` Gemini CLI lädt Kontextdateien in Ebenen und fügt sie zusammen: 1. **Global:** `~/.gemini/GEMINI.md`, deine persönlichen Standards für jedes Projekt. 2. **Workspace:** `GEMINI.md`-Dateien in deinem Projektordner und seinen übergeordneten Ordnern. 3. **Just in time:** Greift ein Tool auf eine Datei in einem Unterordner zu, nimmt Gemini auch jede `GEMINI.md` in diesem Ordner und darüber mit. Eine lange Datei kannst du mit Imports aufteilen, etwa mit einer Zeile `@./docs/style-guide.md`. Was das Modell tatsächlich bekommt, zeigt `/memory show`; `/memory list` zeigt, welche Dateien geladen wurden. Hast du eine Datei mitten in der Session geändert, lädst du sie mit `/memory reload` neu. Gibt es in deinem Repo schon eine `AGENTS.md`, musst du sie nicht duplizieren. Setze `context.fileName` in den Einstellungen auf `["AGENTS.md", "GEMINI.md"]`. [CLAUDE.md und AGENTS.md](/de/blog/claude-md-agents-md/ "CLAUDE.md und AGENTS.md") erklärt, wie du einen Regelsatz für mehrere Agenten pflegst. ## Schritt 5: settings.json Gemini CLI liest seine Einstellungen aus JSON-Dateien: - `~/.gemini/settings.json` für deine Benutzereinstellungen; - `.gemini/settings.json` in einem Projekt für die Workspace-Einstellungen. Mit `/settings` änderst du die meisten Optionen in einem Editor innerhalb des CLI, statt das JSON von Hand zu bearbeiten. Ein kleines Beispiel: ```json { "general": { "defaultApprovalMode": "auto_edit", "checkpointing": { "enabled": true } }, "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } } ``` Das Modell setzt du pro Lauf mit `-m` / `--model`. Mit den Aliasen `auto` (Standard), `pro`, `flash` und `flash-lite` wählst du nach Tempo und Tiefe, ohne dir exakte Modellnamen zu merken; in einer Session wechselst du mit `/model`. ## Schritt 6: Freigabemodi und Sandbox Gemini CLI fragt, bevor es Tools ausführt, solange du nichts anderes sagst. Das Verhalten steuert das Flag `--approval-mode`: | Modus | Was passiert | | --- | --- | | `default` | Fragt vor jedem Tool-Aufruf | | `auto_edit` | Gibt Dateiänderungen automatisch frei, fragt vor anderen Tools wie Shell-Befehlen weiter | | `plan` | Nur lesen: Gemini kann sich umsehen und planen, aber nichts ändern | | `yolo` | Gibt jeden Tool-Aufruf frei; nur für eine isolierte Umgebung | Das ältere Flag `--yolo` gibt es noch, es ist aber zugunsten von `--approval-mode=yolo` veraltet. `auto_edit` oder `plan` kannst du in den Einstellungen zum Standard machen; yolo lässt sich nur über die Kommandozeile einschalten. Die Sandbox ist **standardmäßig aus**. Starte mit `--sandbox` (oder `-s`), um Tools in einer isolierten Umgebung auszuführen: Seatbelt unter macOS oder ein Docker- bzw. Podman-Container. Willst du `auto_edit` oder yolo regelmäßig nutzen, schalte zuerst die Sandbox ein. Warum Freigaben allein nicht reichen, erklärt [Sicherheit von KI-Coding-Agenten](/de/blog/ai-coding-agent-security/ "Sicherheit von KI-Coding-Agenten"). ## Schritt 7: MCP-Server verbinden [MCP](/de/glossary/mcp/ "Was ist MCP")-Server geben Gemini zusätzliche Tools: Dokumentationssuche, einen Browser, GitHub, deine Datenbank. Füge einen über die Shell hinzu: ```bash gemini mcp add github npx -y @modelcontextprotocol/server-github ``` Für einen HTTP-Server gibst du statt eines Befehls `--transport http` und eine URL an. `--env KEY=wert` übergibt Umgebungsvariablen, und `--scope user` macht den Server in jedem Projekt verfügbar statt nur in diesem. `gemini mcp list` zeigt, was eingerichtet ist, und `gemini mcp remove ` löscht einen Server. Unter der Haube landen sie im Abschnitt `mcpServers` der `settings.json`, du kannst sie also auch dort bearbeiten. In einer Session listet `/mcp` die Server und ihre Tools, `/mcp auth` meldet dich bei Servern mit OAuth an, und `/mcp reload` startet sie neu. Neu im Thema? Lies [was ist ein MCP-Server](/de/blog/what-is-mcp-server/ "Was ist ein MCP-Server"). Jeder Server fügt dem [Kontextfenster](/de/glossary/context-window/ "Was ist ein Kontextfenster") Tool-Beschreibungen hinzu, behalte also nur die, die du nutzt. ## Schritt 8: die Slash-Befehle, die du kennen solltest | Befehl | Was er tut | | --- | --- | | `/init` | Erzeugt eine `GEMINI.md` für das Projekt | | `/memory show` | Zeigt die Anweisungen, die das Modell bekommt | | `/settings` | Öffnet den Einstellungseditor | | `/model` | Wechselt das Modell | | `/auth` | Wechselt die Anmeldemethode | | `/mcp` | Listet MCP-Server und Tools | | `/tools` | Listet die Tools, die Gemini nutzen kann | | `/stats` | Nutzung von Session, Modell und Tools | | `/compress` | Ersetzt die Unterhaltung durch eine Zusammenfassung, um Tokens zu sparen | | `/clear` | Leert den Bildschirm und fängt neu an | | `/resume` | Gespeicherte Sessions durchsuchen und fortsetzen | | `/rewind` | In der Unterhaltung zurückgehen (auch zweimal Esc) | | `/restore` | Dateien aus einem Checkpoint wiederherstellen | | `/directory` | Weitere Ordner zum Workspace hinzufügen | | `/help` | Listet alle Befehle | Du kannst auch eigene Befehle schreiben. Eine `.toml`-Datei in `~/.gemini/commands/` wird zu einem persönlichen Slash-Befehl, eine in `.gemini/commands/` im Projekt teilst du mit allen, die das Repo nutzen. `/commands list` zeigt sie an. ## Schritt 9: Checkpointing und Rückgängig Checkpointing ist das Sicherheitsnetz von Gemini CLI und **standardmäßig aus**. Schalte es in der `settings.json` ein: ```json { "general": { "checkpointing": { "enabled": true } } } ``` Ab dann speichert Gemini jedes Mal, wenn du ein Tool freigibst, das Dateien ändert, vorher einen Snapshot deines Projekts in einem separaten Schatten-Git-Repository unter `~/.gemini/history/`. Deine eigene Git-Historie bleibt unberührt. `/restore` zeigt die Liste der Checkpoints, und `/restore ` setzt deine Dateien und die Unterhaltung auf diesen Punkt zurück. Gemini bietet dir dann den ursprünglichen Tool-Aufruf erneut an, sodass du ihn wiederholen, ändern oder überspringen kannst. Auch ohne Checkpointing kannst du mit `/rewind` (oder zweimal Esc) zu einem früheren Prompt zurückgehen und wählen, ob die Unterhaltung, die Codeänderungen oder beides zurückgenommen werden. ## Schritt 10: Sessions fortsetzen Gemini CLI speichert deine Sessions pro Projekt: - `gemini --resume latest` (oder `-r latest`) setzt die letzte Session fort. - `gemini --list-sessions` zeigt die gespeicherten Sessions mit Nummern; `gemini --resume 3` öffnet eine davon. - In einer Session kannst du mit `/resume` Unterhaltungen durchsuchen, speichern und wieder öffnen. Du kannst auch gleich einen neuen Prompt mitgeben: `gemini -r latest "prüfe auf Typfehler"`. ## Tipps für bessere Ergebnisse - **Vor großen Aufgaben committen.** Checkpoints sind gut, ein Git-Commit ist besser und funktioniert mit jedem Tool. - **Sag, wie geprüft wird.** „Führe `npm test` aus und behebe die Fehler“ schlägt „mach, dass es läuft“. - **Plan-Modus für größere Änderungen.** Lass Gemini sich umsehen und einen Plan vorschlagen, bevor es etwas bearbeitet. - **Dateien mit `@` angeben.** Das geht schneller, als darauf zu warten, dass Gemini sie findet, und hält den Kontext fokussiert. - **Zwischen Aufgaben verdichten oder leeren.** `/compress` behält eine Zusammenfassung, `/clear` fängt neu an. Beides spart Tokens. - **Ein Agent pro Worktree.** Lässt du mehrere Agenten laufen, gib jedem einen eigenen [Git-Worktree](/de/blog/git-worktree-parallel-agents/ "Git-Worktrees für parallele Agenten"), damit sie sich nicht gegenseitig überschreiben. ## Wenn ein Terminal nicht mehr reicht Gemini CLI ist oft einer von mehreren Agenten in einem Team. Sobald Gemini an einer Aufgabe arbeiten soll und Codex oder Claude Code an einer anderen, oder ein Agent die Arbeit eines anderen prüfen soll, wird ein einzelnes Terminal eng. AgentVera ist eine Desktop-App für macOS, Windows und Linux, die Gemini CLI (und andere CLI-Agenten) in echten Terminals nebeneinander ausführt. Jeder Gemini-Agent nutzt seine eigene Google-Anmeldung oder `GEMINI_API_KEY`; welche, fragt das Terminal beim ersten Start. Details findest du auf der Seite [Gemini CLI in AgentVera](/de/agents/gemini-cli/ "Gemini CLI in AgentVera"). - **[Workspace](/de/features/workspace/ "Workspace"):** ein Raster von Agenten pro Projekt, von 1×1 bis 5×4. Jeder Gemini-Agent startet mit seiner eigenen Session und öffnet sie nach einem Neustart wieder. - **Berechtigungen pro Agent:** Im Dialog „New agent“ wählst du Ask, Auto oder Full access. - **Anweisungen:** Gemini CLI hat kein Flag für zusätzliche Anweisungen, deshalb erreicht das Feld „Role and instructions“ von AgentVera es nicht. Schreib die Regeln stattdessen in `GEMINI.md` oder `AGENTS.md`. - **[MCP-Manager](/de/features/mcp-manager/ "MCP-Manager"):** Server, die du in AgentVera einrichtest, werden beim Start an Gemini angebunden und nach Namen mit deinen eigenen Gemini-Einstellungen zusammengeführt. - **[Flows](/de/features/flows/ "Flows"):** Gib das Ergebnis eines Agenten an den nächsten weiter, zum Beispiel schreibt Gemini und ein anderer Agent prüft. - **[Automatisches Code-Review](/de/features/code-review/ "Automatisches Code-Review"):** Lass die Änderungen eines Agenten am Ende eines Turns automatisch prüfen. - **Worktrees:** Erstelle einen im [Git-Panel](/de/features/git-and-github/ "Git und GitHub") und starte einen Agenten darin. Raster, Worktrees, Code-Review und MCP-Manager gehören zum Free-Tarif, Flows zu Pro und Team. [Lade AgentVera herunter](/de/download/ "AgentVera herunterladen") und probiere es in deinem eigenen Repo aus. Nutzt du einen kostenlosen Google-Account, unterstützt AgentVera auch [Antigravity](/de/agents/antigravity/ "Antigravity in AgentVera"). ## Fazit Installiere Gemini CLI, starte `gemini` und wähle eine Anmeldung, die nach Juni 2026 noch funktioniert: einen bezahlten API-Key, Vertex AI oder eine Code-Assist-Lizenz. Führe `/init` aus und halte deine `GEMINI.md` kurz, setze Standards mit `/settings` und füge MCP-Server nur hinzu, wenn du sie brauchst. Bleib im Standard-Freigabemodus, bis du deinem Setup vertraust, schalte Checkpointing ein, damit `/restore` Änderungen zurücknehmen kann, und nutze `--resume latest`, um weiterzumachen, wo du aufgehört hast. Zum Vergleich mit dem Agenten von OpenAI lies [Codex CLI nutzen](/de/blog/how-to-use-codex-cli/ "Codex CLI nutzen"). ## Häufige Fragen **Ist Gemini CLI noch kostenlos?** Für private Accounts nicht. Laut Googles Hinweis wurden Nutzer des kostenlosen Tarifs und von Google One am 18. Juni 2026 zu Antigravity CLI verschoben. Gemini CLI funktioniert weiter mit bezahlten Gemini-API-Keys, Vertex AI und Lizenzen für Gemini Code Assist Standard oder Enterprise. **Was ist der Unterschied zwischen GEMINI.md und AGENTS.md?** Beides sind Markdown-Dateien mit Projektanweisungen. Gemini CLI liest standardmäßig GEMINI.md. Führt dein Team seine Regeln schon in AGENTS.md, setze context.fileName in der settings.json auf eine Liste wie ["AGENTS.md", "GEMINI.md"], dann liest Gemini CLI beide. **Wie verhindere ich, dass Gemini CLI Befehle ohne Nachfrage ausführt?** Bleib im Standard-Freigabemodus, der vor jedem Tool-Aufruf fragt. auto_edit gibt Dateiänderungen frei, fragt aber vor anderen Tools weiter, und yolo gibt alles frei. Nutze yolo daher nur in einer Sandbox, der du vertraust. **Wie mache ich eine Änderung von Gemini CLI rückgängig?** Schalte Checkpointing in der settings.json ein. Gemini CLI speichert dann vor jeder Dateiänderung einen Snapshot, und /restore stellt deine Dateien wieder her. Auch ohne Checkpointing kannst du mit /rewind (oder zweimal Esc) in der Unterhaltung und ihren Dateiänderungen zurückgehen. **Wie setze ich eine frühere Gemini-CLI-Session fort?** Starte Gemini CLI mit --resume latest, um die letzte Session fortzusetzen, oder führe gemini --list-sessions aus und öffne eine Session über ihre Nummer. In einer Session kannst du mit /resume gespeicherte Unterhaltungen durchsuchen und eine auswählen. --- **Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/