# Wie man Gemini CLI auf Ubuntu installiert: Vollständige Schritt-für-Schritt-Anleitung

Schritt-für-Schritt-Anleitung zur Installation von Google Gemini CLI auf Ubuntu. Deckt Node.js 20+ Einrichtung, globale npm Installation, Authentifizierung, Überprüfung und Behebung häufiger Probleme auf Ubuntu LTS ab.

Canonical URL: https://a2a-mcp.org/blog/how-to-install-gemini-cli-on-ubuntu-de

Language: de

Published: 2026-04-07

Updated: 2026-04-07

## 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:

```bash
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

```bash
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:

```bash
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:

```bash
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)

```bash
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:

```bash
npx @google/gemini-cli
```

### Benutzerebene-Installation (Vermeidung von Berechtigungsproblemen)

Wenn Sie Berechtigungsfehler bei der globalen Installation erhalten:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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!