Gemini CLI auf Ubuntu 22.04 24.04 26.04 installieren: Node.js npm Leitfaden & Fehlerbehebung

Voraussetzungen

Bevor Sie mit der Installation der Gemini CLI auf Ubuntu beginnen, bereiten Sie Folgendes vor:

Ubuntu-Version: 20.04 LTS oder neuer (22.04, 24.04 und 26.04 werden vollständig unterstützt).
Administrativer Zugang: Sudo-Rechte für die Paketverwaltung.
Internetverbindung: Erforderlich zum Herunterladen von Node.js, npm-Paketen und für die Authentifizierung.
Google-Konto: Benötigt für die OAuth-Anmeldung, um auf Gemini-Modelle zugreifen zu können.
Empfohlene Hardware: Mindestens 4 GB RAM und 2 CPU-Kerne für eine flüssige Leistung während interaktiver Sitzungen.

Grundlegendes Wissen wird vorausgesetzt: Sie wissen, wie Sie ein Terminal öffnen und grundlegende apt- und bash-Befehle ausführen.

Schritt 1: Systempakete aktualisieren

Beginnen Sie, indem Sie Ihre Paketliste aktualisieren und bestehende Pakete upgraden, um Abhängigkeitskonflikte zu vermeiden:

sudo apt update && sudo apt upgrade -y

Dieser Schritt stellt sicher, dass Sie die neuesten Sicherheitsupdates und Repository-Informationen haben.

Schritt 2: Node.js 20 oder höher installieren

Gemini CLI erfordert Node.js Version 20 oder neuer. Die Standard-Repositorys von Ubuntu enthalten oft ältere Versionen (z.B. Node 18 auf Ubuntu 24.04).

Empfohlene Methode: NodeSource-Repository

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Alternative: Verwenden von nvm (Node Version Manager)

Für eine einfachere Versionsverwaltung:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20

Überprüfen Sie die Installation:

node --version
npm --version

Sie sollten eine Ausgabe ähnlich zu v20.x.x für Node.js und eine passende npm-Version sehen.

Schritt nine 3: Gemini CLI installieren

Globale Installation (Empfohlen für tägliche Nutzung)

npm install -g @google/gemini-cli

Dies macht den gemini-Befehl systemweit verfügbar.

Schnelltest ohne permanente Installation

Wenn Sie es zuerst ausprobieren möchten:

npx @google/gemini-cli

Benutzerebene-Installation (Vermeidung von Berechtigungsproblemen)

Wenn Sie Berechtigungsfehler bei der globalen Installation erhalten:

mkdir -p ~/.local/bin
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli

Schritt 4: Die Installation überprüfen

Prüfen Sie, ob Gemini CLI korrekt installiert ist:

gemini --version

Die erwartete Ausgabe zeigt die aktuelle Version der Gemini CLI.

Schritt 5: Starten und Authentifizieren

Führen Sie die CLI zum ersten Mal aus:

gemini

Das Tool fordert Sie auf, sich mit Google anzumelden. Ein Browserfenster öffnet sich automatisch. Schließen Sie den OAuth-Flow ab und kehren Sie zum Terminal zurück.

Nach erfolgreicher Authentifizierung lädt die interaktive Gemini CLI-Oberfläche. Verwenden Sie /help, um die verfügbaren Befehle zu sehen.

Beste Praxis: Navigieren Sie zu Ihrem Projektverzeichnis, bevor Sie starten:

cd ~/my-project
gemini

Häufige Probleme & Fehlerbehebung

'gemini: command not found': Starten Sie Ihr Terminal neu oder führen Sie source ~/.bashrc aus. Überprüfen Sie Ihren PATH mit echo $PATH.
Berechtigung verweigert während npm install: Verwenden Sie die oben beschriebene Installation auf Benutzerebene anstelle von sudo npm.
Node.js Version-Fehler: Führen Sie das NodeSource-Setup erneut aus oder wechseln Sie die Versionen mit nvm. Bestätigen Sie mit node --version.
Authentifizierung schlägt fehl: Deaktivieren Sie Pop-up-Blocker im Browser, stellen Sie sicher, dass Cookies aktiviert sind, und versuchen Sie es erneut. Löschen Sie bei Bedarf den npm-Cache: npm cache clean --force.
Netzwerk-Timeout oder Download-Fehler (z. B. ripgrep prebuilt): Stellen Sie eine stabile Internetverbindung sicher. Wiederholen Sie die Installation oder verwenden Sie npx als Workaround.
Fehlende Build-Tools: Installieren Sie Entwicklungsabhängigkeiten:

sudo apt install -y build-essential python3

WSL-spezifische Probleme: Führen Sie Befehle in einem standardmäßigen Ubuntu-Terminal aus, nicht in WSL, wenn Kompilierungsfehler auftreten.

Für weitere Hilfe konsultieren Sie das offizielle GitHub-Repository: https://github.com/google-gemini/gemini-cli.

Nächste Schritte

Kernbefehle erkunden: Geben Sie /help, /model oder /settings innerhalb der CLI ein.
In Projekten verwenden: Lassen Sie sich Code von Gemini erklären, Funktionen umstrukturieren oder neue Dateien mit natürlichen Sprachaufforderungen generieren.
Anpassen: Bearbeiten Sie Konfigurationsdateien in ~/.config/gemini-cli/ für Themes, Standardmodelle und Erweiterungen.
Regelmäßig aktualisieren: Führen Sie npm update -g @google/gemini-cli aus, um die neuesten Verbesserungen zu erhalten.
Tools integrieren: Experimentieren Sie mit integrierten Erweiterungen und MCP-Servern für fortgeschrittene agentische Workflows, wie z. B. Git-Integration.

Sie können die Gemini CLI jetzt als leistungsstarken KI-Coding-Assistenten direkt in Ihrem Ubuntu-Terminal nutzen. Beginnen Sie mit einfachen Aufforderungen in einem Projektordner und entwickeln Sie schrittweise komplexere agentische Aufgaben.

Viel Spaß beim Codieren mit Gemini!