Installationsanleitung

Installieren und konfigurieren Sie Gemini CLI auf Ihrem System

Systemanforderungen

Stellen Sie sicher, dass Ihr System diese Anforderungen erfüllt

Windows

  • Windows 10 oder höher
  • Node.js 18.0.0 oder höher
  • PowerShell 5.1 oder PowerShell Core 7+
  • Windows Terminal (empfohlen)

macOS

  • macOS 10.15 (Catalina) oder höher
  • Node.js 18.0.0 oder höher
  • Xcode Command Line Tools
  • Terminal oder iTerm2

Linux

  • Ubuntu 18.04+ / CentOS 8+ / Debian 10+
  • Node.js 18.0.0 oder höher
  • curl oder wget
  • bash oder zsh Shell

Installationsmethoden

Wählen Sie die Installationsmethode, die am besten zu Ihren Bedürfnissen passt

NPM Installation

Empfohlene Methode für die meisten Benutzer

Schritt 1: Global über npm installieren

Dies installiert Gemini CLI global auf Ihrem System

npm install -g @google/generative-ai-cli

Schritt 2: Installation überprüfen

Überprüfen Sie, dass die Installation erfolgreich war

gemini --version

Schritt 3: API-Schlüssel einrichten

Konfigurieren Sie Ihren Google AI API-Schlüssel

gemini config set api-key YOUR_API_KEY

Docker Installation

Containerisierte Umgebung für konsistente Bereitstellung

Schritt 1: Docker-Image herunterladen

Laden Sie das offizielle Docker-Image herunter

docker pull google/gemini-cli:latest

Schritt 2: Mit API-Schlüssel ausführen

Starten Sie einen Container mit Ihrem API-Schlüssel

docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latest

Schritt 3: Interaktiver Modus

Starten Sie eine interaktive Chat-Sitzung

docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chat

Aus Quellcode

Aus Quellcode für Entwicklung erstellen

Schritt 1: Repository klonen

Holen Sie sich den Quellcode von GitHub

git clone https://github.com/google-gemini/gemini-cli.git

Schritt 2: Abhängigkeiten installieren

Installieren Sie alle erforderlichen Abhängigkeiten

cd gemini-cli && npm install

Schritt 3: Erstellen und verknüpfen

Erstellen Sie das Projekt und erstellen Sie einen globalen Symlink

npm run build && npm link

API-Schlüssel Konfiguration

Richten Sie Ihren Google AI API-Schlüssel ein, um Gemini CLI zu verwenden

Holen Sie sich Ihren API-Schlüssel

  1. 1Besuchen Sie Google AI Studio
  2. 2Melden Sie sich mit Ihrem Google-Konto an
  3. 3Klicken Sie auf "API-Schlüssel erstellen" und kopieren Sie den Schlüssel

Schlüssel konfigurieren

Mit CLI-Befehl:

gemini config set api-key YOUR_API_KEY

Mit Umgebungsvariable:

export GEMINI_API_KEY=YOUR_API_KEY

Installation überprüfen

Testen Sie Ihre Installation, um sicherzustellen, dass alles funktioniert

Version überprüfen

gemini --version

Sollte die installierte Versionsnummer anzeigen

API-Verbindung testen

gemini ask "Hallo, können Sie mich hören?"

Sollte eine Antwort von Gemini zurückgeben

Konfiguration überprüfen

gemini config list

Sollte Ihre aktuellen Konfigurationseinstellungen anzeigen

Häufige Probleme

Lösungen für häufige Installationsprobleme

Befehl nicht gefunden

Wenn Sie nach der Installation "Befehl nicht gefunden" erhalten, enthält Ihr PATH möglicherweise nicht das globale bin-Verzeichnis von npm.

npm config get prefix

Fügen Sie das bin-Verzeichnis zu Ihrem PATH in Ihrem Shell-Profil (.bashrc, .zshrc, etc.) hinzu

Berechtigung verweigert

Unter macOS/Linux müssen Sie möglicherweise sudo verwenden oder npm so konfigurieren, dass es ein anderes Verzeichnis verwendet.

npm config set prefix ~/.npm-global

Fügen Sie dann ~/.npm-global/bin zu Ihrem PATH hinzu

Nächste Schritte

Jetzt, da Gemini CLI installiert ist, erkunden Sie diese Ressourcen

KonfigurationsanleitungVerwendungsbeispieleFehlerbehebung