„Kostenlos? Das kann doch nicht so gut sein wie Claude Code..." Das war mein erster Gedanke, als ich von Gemini CLI gehört habe. Google hatte gerade ihr KI-Terminal als Open Source veröffentlicht.
Spoiler: Nach drei Monaten intensiver Nutzung muss ich sagen - für manche Aufgaben ist es sogar besser. Besonders wenn du mit großen Codebasen arbeitest. Das 1-Million-Token-Context-Window ist kein Marketing-Gag, sondern ein echter Game-Changer. Laut Google I/O 2025 nutzen bereits über 7 Millionen Entwickler weltweit Gemini-Modelle - eine Verfünffachung gegenüber dem Vorjahr.
In diesem Artikel zeige ich dir alle Gemini CLI Befehle - von der Installation bis zu versteckten MCP-Integrationen. Dies ist die vollständigste deutsche Referenz, die du finden wirst. Nach diesem Guide kennst du jeden verfügbaren Befehl und weißt genau, wann du Gemini CLI statt Claude Code einsetzen solltest.
- Gemini CLI bietet über 20 verschiedene Befehle für KI-gestützte Entwicklung direkt im Terminal
- /commit, /cat und /chat sind die wichtigsten Slash-Commands für den täglichen Workflow
- Erweiterte Befehle ermöglichen MCP-Integration, Token-Counting und spezielle Modellkonfigurationen
Gemini CLI installieren: Drei Wege zum Ziel
Die Installation von Gemini CLI ist erfrischend unkompliziert. Du brauchst nur Node.js 18+ (ich empfehle Version 20) und eine Internetverbindung:
# Methode 1: Sofort loslegen (ohne Installation)
npx https://github.com/google-gemini/gemini-cli
# Methode 2: Global installieren (meine Empfehlung)
npm install -g @google/gemini-cli
# Methode 3: Homebrew (für Mac/Linux-Fans)
brew install gemini-cli
npx
-Kommando ist zwar praktisch für den ersten Test, aber bei täglicher Nutzung nervt das ständige Herunterladen.Authentifizierung: OAuth vs. API-Key
Google bietet drei Authentifizierungsmethoden. Nach ausgiebigem Testen rate ich dir zu OAuth - es ist kostenlos und hat die großzügigsten Limits:
# Option 1: Google OAuth (kostenlos, empfohlen)
gemini # Öffnet Browser für Login
# Option 2: API-Schlüssel (für Automatisierung)
export GEMINI_API_KEY="dein-key-von-aistudio.google.com"
gemini
# Option 3: Vertex AI (für Unternehmen)
export GOOGLE_API_KEY="enterprise-key"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
Grundbefehle: Der tägliche Workflow
Lass uns mit den Befehlen starten, die ich wirklich jeden Tag nutze. Die Gemini CLI Befehle sind übersichtlicher strukturiert als bei Claude Code. Das ist kein Zufall - laut Stack Overflow Developer Survey 2025 nutzen oder planen bereits 84 % aller Entwickler den Einsatz von KI-Tools in ihrem Entwicklungsprozess. Dabei bevorzugen über 63 % der Entwickler das Terminal als primäres Arbeitsinstrument.
Interaktiver Modus starten
# Einfacher Start im aktuellen Verzeichnis
gemini
# Mit spezifischen Verzeichnissen
gemini --include-directories ../lib,../docs
# Mit bestimmtem Modell (Flash ist schneller, Pro ist schlauer)
gemini -m gemini-2.5-flash
# Mit automatischer Tool-Genehmigung (YOLO-Modus)
gemini --yolo
--yolo
) führt alle Tool-Aufrufe automatisch aus. Nutze das nur in Projekten, wo nichts kaputt gehen kann!Nicht-interaktiver Modus (für Skripte)
Für Automatisierung und CI/CD-Pipelines ist der nicht-interaktive Modus Gold wert:
# Schnelle Frage ohne Session
gemini -p "Erkläre die Architektur dieser Codebasis"
# Datei analysieren
gemini -p "Finde Bugs in dieser Datei @./src/main.js"
# Mit Unix-Pipes
echo "Schreibe einen Unittest für function add(a,b)" | gemini
# Git-Diff analysieren
git diff | gemini -p "Schreibe eine Commit-Message für diese Änderungen"
Alle Slash-Commands im Detail
Hier kommt die komplette Liste aller Slash-Befehle. Ich habe sie nach Nutzungshäufigkeit sortiert - die wichtigsten zuerst:
Befehl | Beschreibung | Beispiel / Tipp |
---|---|---|
/help | Zeigt alle verfügbaren Befehle | /help tools |
/clear | Löscht Bildschirm und Kontext | /clear |
/memory add | Fügt wichtige Infos zum KI-Gedächtnis hinzu | /memory add Verwende immer TypeScript |
/tools | Listet verfügbare Tools auf | /tools verbose |
/chat save | Speichert aktuelle Unterhaltung | /chat save feature-implementation |
/stats | Zeigt Token-Nutzung und Kosten | /stats |
/compress | Komprimiert Kontext bei Token-Limit | /compress |
/mcp | Verwaltet MCP-Server | /mcp refresh |
/exit | Beendet Gemini CLI sauber | /exit oder /quit |
/copy | Kopiert letzte Antwort | /copy |
/memory show | Zeigt gesamtes KI-Gedächtnis | Check regelmäßig, was die KI weiß |
/restore | Stellt gespeicherten Chat wieder her | Perfekt um nach Fehlern zurückzuspringen |
/tools schema | Zeigt JSON-Schema der Tools | Nützlich für MCP-Entwicklung |
/settings | Öffnet Konfiguration | Hier kannst du Default-Model setzen |
/theme | Ändert Farbschema | Dark Mode für lange Sessions |
/vim | Aktiviert Vim-Modus | Für Vim-Enthusiasten ein Muss |
/privacy | Zeigt Datenschutz-Info | Wichtig für DSGVO-Compliance |
/bug | Meldet Bug an Google | Die reagieren tatsächlich schnell! |
/memory add
Befehl ist unterschätzt! Ich füge projektspezifische Regeln hinzu wie "Verwende immer deutsche Kommentare" oder "Bevorzuge funktionale Programmierung". Das spart massiv Zeit.Datei-Referenzierung mit @-Symbol
Eine der elegantesten Features von Gemini CLI ist die Datei-Referenzierung. Statt umständlich Dateien zu kopieren, nutzt du einfach das @-Symbol:
# Einzelne Datei analysieren
"Erkläre mir diese Funktion @./src/utils.js"
# Ganzes Verzeichnis einbeziehen
"Refaktoriere die API @./api/"
# Mehrere Dateien gleichzeitig
"Finde Gemeinsamkeiten zwischen @./old.js und @./new.js"
# Mit Wildcards (experimentell)
"Überprüfe alle Tests @./tests/*.spec.js"
Shell-Integration: Der !-Operator
Mit dem Ausrufezeichen führst du Shell-Befehle direkt aus Gemini CLI aus:
# Einzelner Befehl
!git status
# In den Shell-Modus wechseln
!
# Jetzt bist du in einer persistenten Shell
# Tippe 'exit' zum Verlassen
# Output direkt an Gemini weiterleiten
!npm test
"Erkläre mir diese Fehler und schlage Fixes vor"
CLI-Flags
Die CLI-Flags von Gemini sind mächtiger als sie auf den ersten Blick erscheinen. Hier alle wichtigen Optionen:
Flag | Beschreibung | Beispiel |
---|---|---|
-m, --model | Wählt das KI-Modell | gemini -m gemini-2.5-pro |
-p, --prompt-interactive | Startet mit initialem Prompt | gemini -p "Analysiere Package.json" |
--yolo | Auto-genehmigt alle Tool-Aufrufe | gemini --yolo |
--include-directories | Lädt zusätzliche Verzeichnisse | gemini --include-directories ./src,./tests |
--sandbox | Sichere Ausführung mit Docker | gemini --sandbox |
-d, --debug | Aktiviert Debug-Output | gemini -d |
--checkpointing | Speichert Projekt-Snapshots | gemini --checkpointing |
--no-history | Deaktiviert Session-Historie | gemini --no-history |
Shortcuts
Diese Shortcuts machen den Unterschied zwischen "ganz okay" und "richtig produktiv":
Tastenkürzel | Funktion | Wann nutzen? |
---|---|---|
Ctrl+L | Bildschirm löschen | Wenn Terminal zu voll wird |
Ctrl+V | Text/Bild einfügen | Screenshots direkt analysieren |
Ctrl+Y | YOLO-Modus toggle | Schnell zwischen Modi wechseln |
Ctrl+X | Externen Editor öffnen | Für lange Prompts |
Tab | Auto-Vervollständigung | Bei Dateinamen nach @ |
Ctrl+C | Abbrechen | Wenn Gemini zu lange braucht |
MCP
Model Context Protocol (MCP) ist der Grund, warum ich Gemini CLI für bestimmte Aufgaben Claude Code vorziehe. Du kannst beliebige Services einbinden:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_dein_token"
},
"trust": false,
"includeTools": ["create_repository", "search_repositories"],
"excludeTools": ["delete_repository"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost/db"
},
"trust": true
}
}
}
Nach der Konfiguration hast du Zugriff auf erweiterte Funktionen:
# GitHub-Integration nutzen
"Erstelle ein neues Repository für mein React-Projekt"
# Gemini nutzt automatisch den GitHub MCP-Server
# Datenbank-Queries
"Zeige mir alle User, die sich diese Woche registriert haben"
# Führt SQL aus und zeigt Ergebnisse
# MCP-Server verwalten
/mcp # Listet alle Server
/mcp refresh # Lädt Verbindungen neu
/mcp refresh
oder ein Neustart von Gemini CLI.Custom Commands
Eines meiner Lieblings-Features: Du kannst eigene Befehle erstellen. Ich habe etwa 15 Custom Commands für wiederkehrende Aufgaben:
---
description: Führt komplette Test-Suite aus
model: gemini-2.5-flash
tools: [terminal]
---
Führe folgende Tests nacheinander aus und gib mir eine Zusammenfassung:
1. npm test
2. npm run lint
3. npm run typecheck
4. npm run test:e2e
Zeige nur Fehler und Warnungen, keine erfolgreichen Tests.
Nach dem Speichern kannst du einfach /test-all
eingeben. Gemini führt deine komplette Test-Suite aus und fasst die Ergebnisse zusammen.
Token-Optimierung
Die kostenlosen Limits sind großzügig, aber mit ein paar Tricks holst du noch mehr raus:
# Kontext regelmäßig komprimieren
/compress
# Nur relevante Verzeichnisse laden
gemini --include-directories ./src --exclude node_modules,dist
# Flash-Modell für einfache Aufgaben
gemini -m gemini-2.5-flash
# Historie deaktivieren bei großen Sessions
gemini --no-history
# Checkpoints für Zwischenstände
/chat save checkpoint-1
# Bei Problemen zurückspringen
/restore checkpoint-1
Debugging
Auch Googles KI hat mal einen schlechten Tag. Hier meine erprobten Lösungen für die häufigsten Probleme:
Problem | Wahrscheinliche Ursache | Lösung |
---|---|---|
Authentifizierung schlägt fehl | Veralteter Token | Browser-Cache löschen, neu einloggen |
MCP-Server verbindet nicht | Fehlende Dependencies | npx installieren, /mcp refresh |
Token-Limit erreicht | Zu viel Kontext | /compress oder /clear nutzen |
Langsame Antworten | Pro-Modell überlastet | Auf Flash-Modell wechseln |
Shell-Befehle funktionieren nicht | Sandbox-Modus aktiv | Ohne --sandbox starten |
Dateien werden nicht gefunden | Falscher Pfad | Absolute Pfade verwenden |
Für hartnäckige Probleme gibt es Debug-Befehle:
# Verbose-Modus für Details
gemini -d
# System-Informationen
/stats
# MCP-Debug
gemini --mcp-debug
# Tool-Schemas überprüfen
/tools schema
# Kompletter Reset
rm -rf ~/.gemini/cache
gemini