Zum Hauptinhalt springen
Claude Code auf der Desktop-Oberfläche

​
Claude Code auf dem Desktop (Vorschau)

Die Claude-Desktop-App bietet eine native Schnittstelle zum Ausführen mehrerer Claude Code-Sitzungen auf Ihrem lokalen Computer und eine nahtlose Integration mit Claude Code im Web.

​
Funktionen

Claude Code auf dem Desktop bietet:
  • Parallele lokale Sitzungen mit git Worktrees: Führen Sie mehrere Claude Code-Sitzungen gleichzeitig im selben Repository aus, jede mit ihrem eigenen isolierten git Worktree
  • Dateien aus Ihrer .gitignore in Ihre Worktrees einbeziehen: Kopieren Sie automatisch Dateien in Ihrer .gitignore, wie .env, in neue Worktrees mit .worktreeinclude
  • Claude Code im Web starten: Starten Sie sichere Cloud-Sitzungen direkt von der Desktop-App aus

​
Installation

Laden Sie die Claude Desktop-App herunter und installieren Sie sie von claude.ai/download
Lokale Sitzungen sind auf Windows arm64-Architekturen nicht verfügbar.

​
Verwendung von Git Worktrees

Claude Code auf dem Desktop ermöglicht das Ausführen mehrerer Claude Code-Sitzungen im selben Repository mit Git Worktrees. Jede Sitzung erhält ihren eigenen isolierten Worktree, sodass Claude an verschiedenen Aufgaben arbeiten kann, ohne dass Konflikte entstehen. Der Standardort für Worktrees ist ~/.claude-worktrees, kann aber in Ihren Einstellungen in der Claude-Desktop-App konfiguriert werden.
Wenn Sie eine lokale Sitzung in einem Ordner starten, der nicht mit Git initialisiert ist, erstellt die Desktop-App keinen neuen Worktree.

​
Kopieren von Dateien, die mit .gitignore ignoriert werden

Wenn Claude Code einen Worktree erstellt, sind Dateien, die über .gitignore ignoriert werden, nicht automatisch verfügbar. Das Einschließen einer .worktreeinclude-Datei löst dieses Problem, indem angegeben wird, welche ignorierten Dateien in neue Worktrees kopiert werden sollen. Erstellen Sie eine .worktreeinclude-Datei im Stammverzeichnis Ihres Repositorys: 
.env
.env.local
.env.*
**/.claude/settings.local.json
Die Datei verwendet .gitignore-ähnliche Muster. Wenn ein Worktree erstellt wird, werden Dateien, die diesen Mustern entsprechen und auch in Ihrer .gitignore aufgelistet sind, aus Ihrem Hauptrepository in den Worktree kopiert.
Nur Dateien, die sowohl von .worktreeinclude ALS AUCH in .gitignore aufgelistet sind, werden kopiert. Dies verhindert das versehentliche Duplizieren von verfolgten Dateien.

​
Claude Code im Web starten

Von der Desktop-App aus können Sie Claude Code-Sitzungen starten, die auf der sicheren Cloud-Infrastruktur von Anthropic ausgeführt werden. Um eine Web-Sitzung vom Desktop aus zu starten, wählen Sie eine Remote-Umgebung beim Erstellen einer neuen Sitzung aus. Weitere Details finden Sie unter Claude Code im Web.

​
Gebündelte Claude Code-Version

Claude Code auf dem Desktop enthält eine gebündelte, stabile Version von Claude Code, um eine konsistente Erfahrung für alle Desktop-Benutzer zu gewährleisten. Die gebündelte Version ist erforderlich und wird beim ersten Start heruntergeladen, auch wenn eine Version von Claude Code auf dem Computer vorhanden ist. Desktop verwaltet Versionsaktualisierungen automatisch und bereinigt alte Versionen.
Die gebündelte Claude Code-Version in Desktop kann sich von der neuesten CLI-Version unterscheiden. Desktop priorisiert Stabilität, während die CLI möglicherweise neuere Funktionen hat.

​
Umgebungskonfiguration

Für lokale Umgebungen extrahiert Claude Code auf dem Desktop automatisch Ihre $PATH-Umgebungsvariable aus Ihrer Shell-Konfiguration. Dies ermöglicht lokalen Sitzungen den Zugriff auf Entwicklungstools wie yarn, npm, node und andere Befehle, die in Ihrem Terminal verfügbar sind, ohne zusätzliche Einrichtung.

​
Benutzerdefinierte Umgebungsvariablen

Wählen Sie “Local” (Lokal), dann wählen Sie rechts die Schaltfläche “Einstellungen”. Dies öffnet einen Dialog, in dem Sie lokale Umgebungsvariablen aktualisieren können. Dies ist nützlich zum Festlegen projektspezifischer Variablen oder API-Schlüssel, die Ihre Entwicklungs-Workflows benötigen. Umgebungsvariablenwerte werden aus Sicherheitsgründen in der Benutzeroberfläche maskiert.
Umgebungsvariablen müssen als Schlüssel-Wert-Paare im .env-Format angegeben werden. Zum Beispiel:
API_KEY=your_api_key
DEBUG=true

# Multiline values - wrap in quotes
CERT="---BEGIN CERT---
MIIE...
---END CERT---"

​
Enterprise-Konfiguration

Organisationen können die lokale Claude Code-Nutzung in der Desktop-Anwendung mit der isClaudeCodeForDesktopEnabled Enterprise-Richtlinienoption deaktivieren. Zusätzlich kann Claude Code im Web in Ihren Admin-Einstellungen deaktiviert werden.

​
Verwandte Ressourcen