Chinesisches Gemini CLI-Benutzerhandbuch

Grundlegende Einführung

Gemini CLI ist ein von Google bereitgestelltes Open-Source-Befehlszeilen-KI-Tool, das die Leistung von Gemini direkt auf Ihr Terminal bringt. Es bietet einfachen Zugriff auf Gemini und ermöglicht Ihnen den direktesten Weg von der Eingabeaufforderung zum Modell. Durch die Einrichtung eines Relays (Proxys) können Sie den Gemini-CLI-Dienst normal nutzen, wenn das Netzwerk eingeschränkt ist.

🚀 Warum Gemini CLI wählen?

• 🧠 Leistungsstarkes Gemini 2.5 Pro: Zugriff auf 1 Million Token-Kontextfenster
• 🔧 Integrierte Tools: grundlegende Google-Suchfunktionen, Dateioperationen, Shell-Befehle, Web-Crawling
• 🔌 Erweiterbar: Unterstützt MCP (Model Context Protocol) für benutzerdefinierte Integration
• 💻 Terminal First: Entwickelt für Entwickler, die in der Befehlszeile arbeiten
• 🛡️ Open Source: Apache 2.0-Lizenz

📦 Installationsmethode

Schnelle Installation

Sofort mit npx ausführen (keine Installation erforderlich)

„Bash

Verwenden Sie das offizielle Repository

npx https://github.com/google-gemini/gemini-cli

„

Global mit npm installieren

„Bash
npm install -g @google/gemini-cli
„

Installation mit Homebrew (macOS/Linux)

„Bash
brew installiere gemini-cli
„

Systemanforderungen

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

Konfigurieren Sie die zu verwendende Übertragungsstation (Agent).

1. Umgebungsvariablen festlegen

Bevor Sie die Relaisstation verwenden, müssen Sie die folgenden Umgebungsvariablen konfigurieren:

„Bash

API-Schlüssel festlegen

export GEMINI_API_KEY=sk-xxxxx

#API-Übertragungsstationsadresse festlegen
GOOGLE_GEMINI_BASE_URL=https://yossapi.com exportieren

#cmd verwende dies

setze GEMINI_API_KEY=sk-xxxxx
Setzen Sie GOOGLE_GEMINI_BASE_URL=https://yossapi.com
„

Hinweis: Sie können diese Umgebungsvariablen auch zu einer „.bashrc“, „.zshrc“ oder einer anderen Shell-Konfigurationsdatei hinzufügen, sodass sie bei jedem Start des Terminals automatisch festgelegt werden.

🚀 Schnellstart

Grundlegende Verwendung

Starten Sie im aktuellen Verzeichnis

„Bash
Zwillinge
„

Enthält mehrere Verzeichnisse

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

Verwenden Sie ein bestimmtes Modell

„Bash
gemini -m gemini-2.5-flash
„

Nicht-interaktiver Skriptmodus

Erhalten Sie eine einfache Textantwort:

„Bash
gemini -p „Erklären Sie die Architektur dieser Codebasis“
„

Erhalten Sie eine strukturierte JSON-Ausgabe:

„Bash
gemini -p „Erklären Sie die Architektur dieser Codebasis“ –output-format json
„

Kurzes Beispiel

Starten Sie ein neues Projekt

„Bash
cd neues-projekt/
Zwillinge

Schreiben Sie einen Discord-Bot für mich, der Fragen mithilfe der von mir bereitgestellten FAQ.md-Datei beantwortet
„

Vorhandenen Code analysieren

„Bash
Git-Klon https://github.com/google-gemini/gemini-cli
cd gemini-cli
Zwillinge

Geben Sie mir eine Zusammenfassung aller gestrigen Änderungen
„

📋 Hauptfunktionen

Codeverständnis und -generierung

• Abfragen und Bearbeiten großer Codebasen
• Nutzen Sie multimodale Funktionen, um neue Apps aus PDFs, Bildern oder Skizzen zu generieren
• Fehlerbehebung und Fehlerbehebung mithilfe natürlicher Sprache

Automatisierung und Integration

• Automatisieren Sie betriebliche Aufgaben wie das Abfragen von Pull-Requests oder die Abwicklung komplexer Rebasing-Vorgänge
• Neue Funktionen mit MCP-Serververbindung
• Nicht-interaktive Ausführung in Skripten zur Workflow-Automatisierung

Erweiterte Funktionen

• Erhalten Sie Echtzeitinformationen mithilfe der integrierten Google-Suche
• Konversationskontrollpunkte zum Speichern und Wiederherstellen komplexer Konversationen
• Benutzerdefinierte Kontextdatei (GEMINI.md) zum Anpassen des Verhaltens für Ihr Projekt

Allgemeine Befehle und Funktionsbeispiele

Entdecken Sie die Codebasis

„

Beschreiben Sie die Hauptkomponenten dieser Systemarchitektur
Welche Sicherheitsmechanismen sind vorhanden?
Stellen Sie neuen Entwicklern ein Schritt-für-Schritt-Dokument mit den ersten Schritten zur Verfügung
„

Arbeiten mit vorhandenem Code

„

Implementieren Sie einen ersten Entwurf für GitHub-Problem Nr. 123
Helfen Sie mir, diese Codebasis auf die neueste Version von Java zu migrieren. Machen Sie zuerst einen Plan
„

Automatisierter Arbeitsablauf

„

Erstellen Sie eine Diashow, die den Git-Verlauf der letzten 7 Tage zeigt, gruppiert nach Funktion und Teammitglied
Erstellen Sie eine Vollbild-Web-App für eine Wandanzeige, die unsere interaktivsten GitHub-Ausgaben präsentiert
„

Systeminteraktion

„

Konvertieren Sie alle Bilder in diesem Verzeichnis in PNG und benennen Sie sie mit Datumsangaben aus Exif-Daten um
Meine PDF-Rechnungen nach Ausgabenmonat organisieren
„

GitHub-Integration

Integrieren Sie Gemini CLI direkt in Ihren GitHub-Workflow mit der Gemini CLI GitHub Action:

• Pull Request Review: Automatisierte Codeüberprüfung mit kontextbezogenem Feedback und Vorschlägen
• Problemklassifizierung: GitHub-Probleme automatisch markieren und priorisieren, basierend auf der Inhaltsanalyse
• Hilfe auf Anfrage: Erwähnen Sie „@gemini-cli“ in Problemen und Pull-Requests, um Hilfe beim Debuggen, bei Erklärungen oder beim Delegieren von Aufgaben zu erhalten
• Benutzerdefinierte Workflows: Erstellen Sie automatisierte, geplante und bedarfsgesteuerte Workflows, die den Anforderungen Ihres Teams entsprechen

Fehlerbehebung

Sollten bei der Nutzung Probleme auftreten, können Sie auf folgende Punkte verweisen:

1. Überprüfen Sie, ob die Umgebungsvariablen richtig eingestellt sind:
   „Bash
   echo GEMINI_API_KEY echo GOOGLE_GEMINI_BASE_URL
   „

2. Überprüfen Sie, ob die Netzwerkverbindung stabil ist und ob die Übergabestation erreichbar ist:
   „Bash
   Curl -I https://yossapi.com
   „

3. Überprüfen Sie, ob Fehlermeldungen ausgegeben werden. Diese Meldungen weisen normalerweise auf das Problem hin

4. Wenn Sie einen SOCKS-Proxy verwenden, stellen Sie sicher, dass das Proxy-Format korrekt ist, zum Beispiel „socks5://:@:“.

5. Ein Problem mit integrierten Befehlen melden:
   „Bash

   Fehler direkt in der CLI melden

   /bug
   „

Versionshinweise

Vorschau

Neue Vorschau-Builds werden jeden Dienstag um 23:59 UTC veröffentlicht. Installieren Sie mit dem Tag „preview“:

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

Stabile Version (Stabil)

Neue stabile Versionen werden jeden Dienstag um 20:00 UTC veröffentlicht. Installieren Sie mit dem Tag „latest“:

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

Nächtlich

Nächtliche Veröffentlichungen werden täglich um 00:00 UTC veröffentlicht. Installieren Sie mit dem Tag „nightly“:

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

MCP-Servernutzung

Konfigurieren Sie den MCP-Server in „~/.gemini/settings.json“, um die Gemini-CLI mit benutzerdefinierten Tools zu erweitern:

„Text

@github listet meine offenen Pull-Anfragen auf
@slack Senden Sie eine Zusammenfassung des heutigen Commits an den #dev-Kanal
@database führt eine Abfrage aus, um inaktive Benutzer zu finden
„

📚 Verwandte Ressourcen

• Offizielle Roadmap: Sehen Sie sich die kommenden Funktionen an
• NPM-Pakete: Paketregistrierung
• GitHub-Probleme: Melden Sie einen Fehler oder fordern Sie eine Funktion an
• Sicherheitsempfehlung: Sicherheitsupdates

Deinstallieren

Wenn Sie Gemini CLI deinstallieren müssen, lesen Sie bitte die offizielle Deinstallationsanleitung.