Gemini CLI Benutzerhandbuch – Google KI in deinem Terminal

Gemini CLI ist ein Open-Source-Kommandozeilen-KI-Tool von Google, das die Leistung von Gemini direkt in dein Terminal bringt. Es bietet eine leichtgewichtige Möglichkeit, auf Gemini zuzugreifen, und stellt den direktesten Weg vom Prompt zum Modell bereit. Durch die Konfiguration eines Proxys kannst du Gemini CLI-Dienste sogar in netzwerkbeschränkten Umgebungen nutzen.

Warum Gemini CLI verwenden?#

• Leistungsstarkes Gemini 2.5 Pro: Zugriff auf ein Kontextfenster mit 1 Million Tokens
• Integrierte Tools: Google Search Grounding, Datei-Operationen, Shell-Befehle, Web Scraping
• Erweiterbar: Unterstützt MCP (Model Context Protocol) für benutzerdefinierte Integrationen
• Terminal-First: Entwickelt für Developer, die in der Kommandozeile arbeiten
• Open Source: Apache 2.0 Lizenz

Installation#

Schnelle Installation#

Sofort mit npx ausführen (keine Installation erforderlich)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Globale Installation mit npm#

npm install -g @google/gemini-cli

Installation mit Homebrew (macOS/Linux)#

brew install gemini-cli

Systemanforderungen#

• Node.js Version 20 oder höher
• macOS, Linux oder Windows

Proxy konfigurieren#

Umgebungsvariablen setzen#

Bevor du den Proxy verwendest, konfiguriere die folgenden Umgebungsvariablen:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Tipp: Füge diese Umgebungsvariablen zu deiner .bashrc, .zshrc oder einer anderen Shell-Konfigurationsdatei hinzu, damit sie bei jedem Start des Terminals automatisch gesetzt werden.

Schnellstart#

Grundlegende Verwendung#

Im aktuellen Verzeichnis starten#

gemini

Mehrere Verzeichnisse einbeziehen#

gemini --include-directories ../lib,../docs

Ein bestimmtes Modell verwenden#

gemini -m gemini-2.5-flash

Nicht-interaktiver Script-Modus#

Eine einfache Textantwort erhalten:

gemini -p "Explain the architecture of this codebase"

Strukturierten JSON-Output erhalten:

gemini -p "Explain the architecture of this codebase" --output-format json

Schnelle Beispiele#

Ein neues Projekt starten#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Bestehenden Code analysieren#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Hauptfunktionen#

Code-Verständnis und -Generierung#

• Große Codebasen abfragen und bearbeiten
• Neue Anwendungen aus PDFs, Bildern oder Skizzen mithilfe multimodaler Fähigkeiten generieren
• Probleme debuggen und mit natürlicher Sprache analysieren

Automatisierung und Integration#

• Operative Aufgaben wie das Abfragen von Pull Requests oder das Handling komplexer Rebases automatisieren
• Neue Fähigkeiten über MCP-Server anbinden
• Nicht-interaktiv in Scripts für Workflow-Automatisierung ausführen

Erweiterte Funktionen#

• Echtzeitinformationen über integrierte Google Search abrufen
• Gesprächs-Checkpoints, um komplexe Sessions zu speichern und wiederherzustellen
• Benutzerdefinierte Kontextdateien (GEMINI.md), um das Verhalten für dein Projekt anzupassen

Häufige Befehle und Beispiele#

Codebasis erkunden#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Mit bestehendem Code arbeiten#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Workflows automatisieren#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Systeminteraktion#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

GitHub-Integration#

Verwende die Gemini CLI GitHub Action, um Gemini CLI direkt in deine GitHub-Workflows zu integrieren:

• Pull-Request-Reviews: Automatisierte Code-Reviews mit kontextbezogenem Feedback und Vorschlägen
• Issue-Triage: GitHub-Issues automatisch anhand der Inhaltsanalyse labeln und priorisieren
• Hilfe auf Abruf: Erwähne @gemini-cli in Issues und Pull Requests, um Hilfe bei Debugging, Erklärungen oder Aufgaben-Delegation zu erhalten
• Benutzerdefinierte Workflows: Automatisierte, geplante und bedarfsorientierte Workflows erstellen, zugeschnitten auf die Anforderungen deines Teams

Fehlerbehebung#

Wenn während der Nutzung Probleme auftreten, beachte Folgendes:

1. Umgebungsvariablen prüfen#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Netzwerkverbindung prüfen#

curl -I https://crazyrouter.com/

3. Fehlermeldungen prüfen#

Fehlermeldungen geben in der Regel Auskunft über das Problem. Häufige Ursachen sind:

• Ungültiges API-Key-Format
• Netzwerkverbindungsprobleme
• Falsche Proxy-Konfiguration

4. SOCKS-Proxy-Format#

Wenn ein SOCKS-Proxy verwendet wird, stelle sicher, dass das Format korrekt ist:

socks5://<user>:<pass>@<proxy>:<port>

5. Bugs melden#

Nutze den integrierten Befehl, um Probleme zu melden:

/bug

Release-Versionen#

Preview#

Neue Preview-Versionen erscheinen jeden Dienstag um 23:59 UTC:

npm install -g @google/gemini-cli@preview

Stable#

Neue Stable-Versionen erscheinen jeden Dienstag um 20:00 UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Nightly-Versionen erscheinen täglich um 00:00 UTC:

npm install -g @google/gemini-cli@nightly

MCP-Server-Nutzung#

Konfiguriere MCP-Server in ~/.gemini/settings.json, um Gemini CLI mit benutzerdefinierten Tools zu erweitern:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Pricing über Crazyrouter#

Greife zu vergünstigten Konditionen auf Gemini-Modelle zu:

Alle Preise enthalten einen Rabatt von 45 % im Vergleich zu den offiziellen Tarifen.

Weiterführende Ressourcen#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

Brauchst du Hilfe? Kontaktiere den Support oder sieh dir die Crazyrouter-Dokumentation für weitere Informationen an.