Gemini CLI nutzen: Schritt-für-Schritt-Anleitung

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 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 und Codex vs. Gemini CLI.

Schritt 1: Gemini CLI installieren

Gemini CLI braucht Node.js. Wähle die Installation, die zu deinem Setup passt:

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:

gemini --version

Schritt 2: Anmeldemethode wählen

Wechsle in ein Projekt und starte Gemini CLI:

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.

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 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.

Schritt 3: deine erste Aufgabe

Fang mit etwas Kleinem, aber Echtem an:

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:

# 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 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:

{
  "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:

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.

Schritt 7: MCP-Server verbinden

MCP-Server geben Gemini zusätzliche Tools: Dokumentationssuche, einen Browser, GitHub, deine Datenbank. Füge einen über die Shell hinzu:

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 <name> 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. Jeder Server fügt dem Kontextfenster Tool-Beschreibungen hinzu, behalte also nur die, die du nutzt.

Schritt 8: die Slash-Befehle, die du kennen solltest

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:

{
  "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 <id> 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, 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.

• 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: Server, die du in AgentVera einrichtest, werden beim Start an Gemini angebunden und nach Namen mit deinen eigenen Gemini-Einstellungen zusammengeführt.
• Flows: Gib das Ergebnis eines Agenten an den nächsten weiter, zum Beispiel schreibt Gemini und ein anderer Agent prüft.
• Automatisches Code-Review: Lass die Änderungen eines Agenten am Ende eines Turns automatisch prüfen.
• Worktrees: Erstelle einen im Git-Panel 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 und probiere es in deinem eigenen Repo aus. Nutzt du einen kostenlosen Google-Account, unterstützt AgentVera auch Antigravity.

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.