Crazyrouter
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-cliin 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:
| Model | Input Price | Output Price |
|---|---|---|
| gemini-2.5-pro | $0.625/1M tokens | $2.50/1M tokens |
| gemini-2.5-flash | $0.038/1M tokens | $0.15/1M tokens |
| gemini-2.5-flash-lite | $0.019/1M tokens | $0.075/1M tokens |
Alle Preise enthalten einen Rabatt von 45 % im Vergleich zu den offiziellen Tarifen.
Weiterführende Ressourcen#
Brauchst du Hilfe? Kontaktiere den Support oder sieh dir die Crazyrouter-Dokumentation für weitere Informationen an.
