So verwenden Sie Claude Code auf dem Desktop— ein professioneller Leitfaden

Anthropic hat in diesem Monat eine Desktop-Vorschau von Claude Code veröffentlicht — eine native Desktop-App, die Anthropics agentenbasierte Coding-Workflows aus dem Terminal in eine grafische Umgebung bringt, mit integrierter Unterstützung für das parallele Ausführen mehrerer, isolierter Coding-Sitzungen. Die Desktop-Vorschau ist dafür konzipiert, neben den Web- und Mobilversionen von Claude Code zu bestehen und konzentriert sich auf zwei praktische Entwicklerprobleme: mehrere KI-Agenten im selben Repository ausführen, ohne sich gegenseitig in die Quere zu kommen, und das Starten lokaler oder Cloud-Sitzungen über eine einzige GUI zu vereinfachen.

Was ist Claude Code auf dem Desktop?

Claude Code auf dem Desktop ist die native (Vorschau-)Desktop-Anwendung, mit der Entwickler Claude-Code-Sitzungen entweder lokal oder auf Anthropics sicherer Cloud-Infrastruktur über eine GUI statt ausschließlich die CLI ausführen können. Sie kombiniert die zentralen agentenbasierten Coding-Fähigkeiten von Claude Code mit Desktop-Annehmlichkeiten: Sitzungsverwaltung, Integration in die lokale Umgebung und das Starten von Web-Sitzungen per Klick. Die App ist ausdrücklich als Begleiter zu den CLI- und Web-Angeboten von Claude Code positioniert; sie bündelt eine stabile Claude-Code-Laufzeitumgebung und verwaltet Versionen für Sie, um ein konsistentes und stabiles Erlebnis zu gewährleisten.

Warum ist das wichtig? Historisch liefen KI-Coding-Tools entweder rein im Terminal (Entwickler, die mit CLI-Workflows vertraut sind) oder ausschließlich in der Cloud (Browser-UIs). Die Desktop-App schlägt diese Brücke, indem sie lokale Läufe mit geringer Latenz ermöglicht und einen nahtlosen Wechsel zu von Anthropic gehosteten (Web-)Sitzungen erlaubt, wenn Sie isolierte Cloud-Rechenressourcen oder Enterprise-Kontrollen benötigen. Besonders erwähnenswert ist in der Desktop-Vorschau die Unterstützung von Multi-Session-Parallelität — Sie können mehrere unabhängige Claude-Code-Agenten gleichzeitig im selben Repository ausführen, jeweils in einem eigenen Git-Worktree (isolierter Branch-Workspace), damit die Agenten nicht miteinander in Konflikt geraten. Das ist die Hauptfunktion, die viele Teams sofort als nützlich empfinden werden.

Wie verhält sich die Desktop-Edition zu den Web- und CLI-Versionen?

Claude Code begann als Kommandozeilen-Tool und wurde später auf Web- und Mobiloberflächen erweitert; die Desktop-Vorschau baut auf diesen Grundlagen auf. Die Desktop-App spiegelt viele der im Web verfügbaren Fähigkeiten wider (Sitzungen starten, Repository-Verbindungen, sichtbare Fortschritte), konzentriert sich aber auf die Ergonomie lokaler Workflows — Desktop-UX, native Installation und engere Integrationen mit lokalen Git-Repositories über Worktrees — damit Sitzungen gleichzeitig laufen können, ohne sich gegenseitig im Dateistatus zu stören.

Siehe auch Claude Code Web: Was es ist und wie man es nutzt

7 hervorragende Funktionen von Claude Code auf dem Desktop

1) Multi-Session-Parallelität

Claude Code für Desktop unterstützt das gleichzeitige Ausführen mehrerer unabhängiger Claude-Sitzungen. Das bedeutet, Sie können eine Sitzung auf einen Bugfix fokussieren, eine weitere Tests schreiben lassen und eine dritte Dokumentation generieren — alle gleichzeitig statt in einer einzelnen Sitzung zu warten. Diese Parallelität beschleunigt Workflows und ermöglicht es, unterschiedliche Aufgaben gleichzeitig zu delegieren.

Zum Beispiel:

Angenommen, Sie haben ein Projekt namens my-app und möchten:

• Claude in einem Fenster die Homepage ändern lassen;
• Claude in einem anderen Fenster die Datenbanklogik optimieren lassen.

Claude Desktop erstellt automatisch für Sie:

~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/

Zwei unabhängige Kopien (ohne Konflikt). Das ist wie zwei Entwicklungs-Branches gleichzeitig auszuführen, wobei Claude jeweils die Arbeit übernimmt.

2. .worktreeinclude: Ignorierte Dateien für Claude sichtbar machen

Manchmal enthält Ihr Projekt Dateien wie .env oder .local, die üblicherweise von .gitignore ignoriert werden und daher nicht in das Claude-Arbeitsverzeichnis kopiert werden. Dateien, die in .gitignore aufgeführt sind, werden nicht automatisch in neue Worktrees kopiert. Claude stellt einen neuen Mechanismus bereit: Sie können im Projektstammverzeichnis eine .worktreeinclude-Datei erstellen, die angibt, welche Dateien kopiert werden sollen — eine Liste im Stil von .gitignore, die festlegt, welche ignorierten Dateien in neu erstellte Worktrees kopiert werden (zum Beispiel lokale .env-Dateien oder entwicklerspezifische Einstellungen). Nur Dateien, die beide in .worktreeinclude und .gitignore erscheinen, werden kopiert, wodurch das versehentliche Duplizieren getrackter Dateien vermieden wird. Das ist entscheidend, um pro Sitzung geheimen Umwelt- oder Konfigurationsdateien zu erhalten, ohne sie in Git einzuchecken.

Zum Beispiel:

.env
.env.local

.env.production

**/.claude/settings.local.json

Das bedeutet: Wenn Claude das Arbeitsverzeichnis erstellt, werden diese Dateien ebenfalls kopiert.

Hinweis:

• Es werden nur Dateien kopiert, die sowohl in .gitignore als auch in .worktreeinclude vorhanden sind;
• Vermeiden Sie das versehentliche Kopieren wichtiger, versionierter Dateien.

3) Starten und Synchronisieren mit Web-/Cloud-Sitzungen

Die Desktop-App kann als Launcher für Web-/Cloud-Sitzungen fungieren — das heißt, Sie können Cloud-basierte Claude-Code-Sitzungen aus der Desktop-UI starten und sie lokal überwachen oder steuern. Dieser Hybridmodus ist nützlich, wenn Sie die Bequemlichkeit lokaler Steuerungen mit dem Skalierungs- oder Berechtigungsmodell cloudgehosteter Läufe kombinieren möchten.

Hinweis:

• Bei der Ausführung in der Cloud werden Claudes Aufgaben auf dem Anthropic-Sicherheitsserver ausgeführt.
• Der Wechsel zwischen lokalen und Cloud-Umgebungen erfolgt nahtlos.
• Um eine Sitzung zu erstellen, wählen Sie einfach "remote environment".

4) Starten und Synchronisieren mit Web-/Cloud-Sitzungen

Die Desktop-App kann als Launcher für Web-/Cloud-Sitzungen fungieren — das heißt, Sie können Cloud-basierte Claude-Code-Sitzungen aus der Desktop-UI starten und sie lokal überwachen oder steuern (lokal für schnelle Aufgaben, Cloud für riskante oder ressourcenintensive Aufgaben).

5) Gebündelte Version und Enterprise-Konfiguration

Desktop enthält eine gebündelte, stabile Claude-Code-Laufzeit, die beim ersten Start heruntergeladen und automatisch verwaltet wird. Enterprise-Administratoren können die lokale Nutzung von Claude Code bei Bedarf deaktivieren (isClaudeCodeForDesktopEnabled Enterprise-Richtlinie). Desktop-Installer unterstützen gängige Enterprise-Bereitstellungsformate (MSIX für Windows, PKG für macOS), und Administratoren können Updates und Zugriff auf Erweiterungen steuern. Diese Kontrollen sollen die Einführung für große Teams erleichtern.

Hinweis:

• Die Anwendung wird beim ersten Öffnen automatisch heruntergeladen;
• Die Desktop-Anwendung verwaltet Versionsupdates automatisch;
• Sie bereinigt alte Versionen automatisch, um das System sauber zu halten;
• Auch wenn Sie die CLI-Version auf Ihrem Computer installiert haben, verwendet sie dennoch ihre eigene Version (für höhere Stabilität).
• Die Desktop-Version priorisiert Stabilität und Kompatibilität; die CLI (Kommandozeilenversion) kann schneller aktualisiert werden, aber neue Funktionen sind möglicherweise nicht sofort in der Desktop-Version verfügbar.

6) Benutzerdefinierte Umgebungsvariablen

Claude Desktop ermöglicht Ihnen das Setzen von Variablen wie in .env-Dateien.

Diese Variablen gelten nur innerhalb der Claude-Sitzung und sind ideal für Projektkonfigurationen.

Zum Beispiel:

API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"

7) Integration mit lokalen Tools und Umgebungen

Bei lokalen Sitzungen extrahiert die Desktop-App Ihr Shell-$PATH, sodass Sitzungsprozesse dieselben node-, npm-, yarn-, Python- oder anderen CLI-Tools verwenden können, auf die Sie sich verlassen. Außerdem bietet sie eine UI zum Hinzufügen benutzerdefinierter Umgebungsvariablen (im .env-Format), deren Werte aus Sicherheitsgründen maskiert werden. So wird das Ausführen von Tests oder Builds innerhalb einer agentischen Sitzung reibungsloser, da der Agent dieselbe Toolchain wie Ihr Terminal verwenden kann.

Wie installiere ich Claude Code auf dem Desktop?

Dieser Abschnitt führt mit minimalem Aufwand durch den Installationsprozess. Die folgenden Anweisungen gelten für die Desktop-Vorschau und verweisen auf die kanonischen Installer.

Voraussetzungen und Kontoeinrichtung

1. Anthropic-Konto und Workspace: Claude Code ist in die Anthropic Console eingebettet. Sie müssen einen OAuth-Flow in der Claude Console abschließen und über eine aktive Abrechnung oder Forschungs-Vorschau-Zugriffe verfügen, wie es das Workspace-Modell von Anthropic erfordert. Claude Code verwendet einen internen Workspace in der Console zur Nutzungsverfolgung; Sie können für diesen Workspace keine API-Schlüssel erstellen — er wird für die Nutzung von Claude Code verwaltet.
2. Git und Repo-Bereitschaft: Stellen Sie sicher, dass Git installiert ist und dass das Projekt, an dem Sie arbeiten möchten, ein Git-Repository ist (oder initialisieren Sie Git). Die Desktop-App erwartet gültige Repos für Funktionen wie Worktrees; wenn Sie einen Ordner ohne initialisiertes Git öffnen, wird kein Worktree erstellt.
3. OS-spezifisches: macOS- und Linux-Installationen sind im Allgemeinen native Binärdateien; Windows-Nutzern wird für vollständige Befehlskompatibilität in vielen Workflows die Nutzung von WSL empfohlen. Einige Community-Guides behandeln erweiterte Windows/WSL-Setups, falls Sie auf PATH- oder Distribution-Probleme stoßen.

Schritt-für-Schritt-Installation (kurz)

1. Öffnen Sie die Claude-Download-Seite und wählen Sie den richtigen Installer für Ihre Plattform.
2. Führen Sie den Installer aus (PKG auf macOS, MSIX oder EXE auf Windows). Für Enterprise-Flotten verwenden Sie die bereitgestellten MSIX/PKG-Pakete für die zentralisierte Bereitstellung.
3. Starten Sie die Claude-Desktop-App und melden Sie sich mit Ihrem Anthropic/Claude-Konto an. Ihre Unterhaltungen und Präferenzen werden zwischen Desktop, Web und Mobil synchronisiert.
4. Beim ersten Start lädt die App eine gebündelte Claude-Code-Laufzeit herunter. Lassen Sie diesen Download abschließen; er ist erforderlich und stellt sicher, dass eine stabile, verwaltete Version verwendet wird.

Überprüfungen nach der Installation

• Öffnen Sie Einstellungen > Umgebungen und bestätigen Sie, dass die Desktop-App Ihr Shell-$PATH extrahiert hat.
• Wählen Sie, ob Sie lokale Sitzungen aktivieren möchten (falls Ihr Rechner und Ihre Richtlinien dies erlauben) oder ob Ihr Workflow stattdessen Web-Sitzungen erstellt.

Optionaler Installationsweg, falls gewünscht

• Native Installer (empfohlen): Verwenden Sie den nativen OS-Installer für die einfachste und am besten integrierte Erfahrung.
• Homebrew (macOS): Praktisch für macOS-Nutzer, die Apps mit Homebrew verwalten.
• NPM- oder skriptbasierte Installer: Nützlich für stärker automatisierte oder geskriptete Setups (CI oder Provisionierung) oder für Linux-Distributionen, bei denen ein einfacher Installer-Skript bevorzugt wird.

Installation: macOS, Linux, WSL (empfohlener Ablauf)

1. Laden Sie den Desktop-Vorschau-Installer von der Claude-Code-Download-Seite herunter (die In-App-Dokumentation enthält den Installer-Link).
2. Führen Sie den Installer aus und öffnen Sie die Claude-Desktop-App.
3. Schließen Sie die OAuth-Anmeldung über den In-App-Flow der Claude Console ab.
4. Konfigurieren Sie den standardmäßigen Worktree-Speicherort sowie Präferenzen für lokale/remote Ausführung in den Desktop-Einstellungen.
5. Öffnen Sie einen Projektordner oder klonen Sie ein Repo über die UI, um zu beginnen.

Öffnen Sie ein Terminal und führen Sie — sofern Sie der Quelle vertrauen — das von Anthropic bereitgestellte Installationsskript aus (dies ist die typische, empfohlene Komfortoption). Beispiel (paraphrasiert):

# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash

Alternativ, wenn Sie Homebrew auf macOS bevorzugen:

brew install --cask claude-code

Installation: Windows

WSL:

1. Installieren Sie WSL (Ubuntu ist üblich) und richten Sie eine saubere WSL-Umgebung ein. Beheben Sie PATH- und Interop-Probleme, sodass die WSL-Integration der Desktop-App auf die Distribution zugreifen kann.
2. Installieren Sie Git und alle Laufzeitumgebungen in WSL, die Claude für lokale Läufe benötigen könnte (node, python, etc.).
3. Installieren oder führen Sie die Desktop-App unter Windows aus, verweisen Sie sie auf Ihr WSL-Projektverzeichnis (oder starten Sie die Desktop-App innerhalb von WSL, falls unterstützt), und folgen Sie demselben OAuth-Flow.

PowerShell-Beispiel (paraphrasiert):

# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex

CMD-Beispiel (paraphrasiert):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Wie nutze ich Claude Code auf dem Desktop im Alltag?

Welche Muster zur Sitzungsanlage werden empfohlen?

Kurze, unabhängige Aufgaben vs. lang laufende Refactorings

• Für kurze, klar abgegrenzte Aufgaben (Bugfix, Änderung an einer einzelnen Datei, kleine Refactorings) erstellen Sie pro Aufgabe eine Sitzung und lassen Sie Claude einen fokussierten Commit erzeugen. Prüfen und mergen Sie zeitnah.
• Für langfristige Vorhaben (große Refactorings, Feature-Entwicklung) sollten Sie eine Sitzung erstellen, die häufige Checkpoints setzt und die Fortschrittssteuerung der Desktop-UI nutzt, um die Arbeit zu lenken oder zu pausieren. Halten Sie Sitzungen auf Feature-Branches, um versehentliche Merges zu vermeiden.

Pflegen Sie eine CLAUDE.md oder eine Promptvorlage in Ihrem Repo, um zu standardisieren, wie Sitzungen promptet werden sollen (Kontext, auszuführende Tests, Stilregeln). Diese Praxis reduziert Variabilität und hilft Claude, konsistente Ergebnisse über Sitzungen hinweg zu liefern. Viele Teams speichern Standard-Prompts oder Leitplanken in Repo-Metadaten, um vorhersehbares Agentenverhalten sicherzustellen.

Eine Sitzung starten und benennen

1. Öffnen Sie die Desktop-App und wählen oder klonen Sie ein Repository.
2. Klicken Sie auf „New Session“ (oder Entsprechung) und geben Sie der Sitzung einen beschreibenden Namen (z. B. bugfix/cs-142 oder add-tests-login). Das Benennen hilft, gleichzeitige Sitzungen in der UI zu unterscheiden.
3. Wählen Sie lokale oder remote Ausführung, wählen Sie einen Ziel-Branch (oder lassen Sie den Agenten einen Branch in einem neuen Worktree erstellen) und starten Sie die Sitzung. Die App erstellt automatisch einen dedizierten Git-Worktree für die Sitzung.

Den Agenten steuern: Prompts und Aufgaben

• Verwenden Sie klare, abgegrenzte Prompts. Beispiel: „Finde den fehlschlagenden Unit-Test für AuthService und erstelle einen Fix, der die bestehende öffentliche API bewahrt; führe Tests aus und berichte die Ergebnisse.“
• Für schrittweise Aufgaben bitten Sie Claude zunächst, einen Plan zu erstellen (eine kurze Checkliste), und fordern Sie dann die spezifischen Codeänderungen Schritt für Schritt an. Inkrementeller Fortschritt reduziert das Risiko von Halluzinationen und macht Diffs leichter prüfbar. Anthropic empfiehlt diesen Ansatz als Best Practice.

Fortschritt beobachten und interagieren

Die Desktop-UI zeigt Aktionslogs und Diffs, während der Agent arbeitet. Sie können eine Sitzung pausieren, Anweisungen ändern oder einen laufenden Job abbrechen. Wenn der Agent Änderungen vorschlägt, zeigt die UI Datei-Diffs und eine Erklärung, was geändert wurde. Genehmigen, bearbeiten oder verwerfen Sie die vorgeschlagenen Diffs vor dem Commit.

Commit-, Branch- und PR-Flows

Nachdem Sie Änderungen genehmigt haben, kann die Desktop-App in den Branch des Sitzungs-Worktrees committen. Von dort können Sie zu origin pushen und über die UI einen Pull Request öffnen (wenn Sie den GitHub-Zugriff autorisiert haben). Der Branch jeder Sitzung bleibt isoliert, bis Sie mergen, was die menschliche Prüfung vereinfacht.

Wie funktionieren Git-Isolation und Multi-Session-Parallelität tatsächlich?

Git-Worktrees: der Isolationsmechanismus

Anthropics Desktop verwendet Git-Worktrees, um pro Sitzung Kopien des Arbeitsbaums eines Repositorys zu erstellen, die an separate Branches gebunden sind. Worktrees sind leichter als vollständige Klone — sie teilen sich bei Bedarf dasselbe .git-Metadatenverzeichnis, bieten aber unabhängige Arbeitsverzeichnisse, sodass gleichzeitige Änderungen keine Konflikte verursachen oder zwischen Sitzungen übergreifen. Die Desktop-App platziert diese automatisch erstellten Worktrees in einem konfigurierbaren Verzeichnis (Standard ~/.claude-worktrees). Dieses Design ermöglicht sichere Gleichzeitigkeit für agentische Operationen.

Warum Worktrees statt Klone

Worktrees sind schneller zu erstellen und leichter mit derselben zugrunde liegenden Git-Historie zu korrelieren, bieten aber dennoch die notwendige Trennung im Dateisystem, um Kreuzkontaminationen zwischen Sitzungen zu vermeiden. Für die meisten Workflows ist dies gegenüber mehreren vollständigen Klonen vorzuziehen; wenn Sie jedoch vollständig isolierte Laufzeitumgebungen mit unterschiedlichen Abhängigkeiten benötigen, kann ein separates Klon-Repo oder ein Container weiterhin sinnvoll sein.

Koordination und Konfliktbehandlung

Da jede Sitzung in einem isolierten Branch/Worktree arbeitet, werden Konflikte minimiert. Wenn zwei Sitzungen unabhängig denselben logischen Code ändern und später beide in denselben Ziel-Branch gemergt werden, greift die normale Git-Merge-Konfliktbehandlung — und das ist der korrekte Zeitpunkt für eine menschliche Prüfung und Auflösung. Anthropics Modell stellt Commits bewusst als prüfbare PRs dar und hält Menschen im Merge-Prozess.

Häufige Schritte zur Fehlerbehebung und Einschränkungen

Wenn eine Sitzung nicht startet oder hängt

• Bestätigen Sie, dass Repository-Zugriffstoken gültig sind und nicht rate-limitiert.
• Prüfen Sie lokalen Festplattenspeicher und Berechtigungen für das Worktrees-Verzeichnis (z. B. ~/.claude-worktrees).
• Überprüfen Sie die Desktop-App-Logs auf Fehlermeldungen; die App zeigt in der Regel eine Diagnostikansicht oder Logdatei an.

Wenn Sitzungen sich gegenseitig kontaminieren

• Bestätigen Sie, dass die Desktop-App separate Worktrees erstellt (prüfen Sie das Verzeichnis ~/.claude-worktrees oder den in den App-Einstellungen gesetzten Worktree-Speicherort).
• Wenn Sie geteilten Zustand sehen, stellen Sie sicher, dass Sie die neueste Desktop-Vorschau verwenden, oder konsultieren Sie die Anthropic-Dokumentation — diese Version adressiert die Sitzungsisolation speziell.

Wenn ignorierte Dateien in Sitzungen nicht verfügbar sind

Fügen Sie die Dateinamen zu Ihrer .worktreeinclude-Konfiguration (oder dem entsprechenden Desktop-UI-Eintrag) hinzu, damit die App erforderliche ignorierte Dateien (z. B. .env) sicher in jeden Worktree kopiert. Vermeiden Sie das Speichern oder Offenlegen von Geheimnissen in Worktrees ohne angemessenes Secrets-Management.

Fazit

Die Desktop-Vorschau von Claude Code stellt eine bedeutende Weiterentwicklung dar, wie agentische Coding-Tools in Entwickler-Workflows passen: Sie bewahrt die Geschwindigkeit und Ausdruckskraft von KI-Agenten und löst zugleich mehrere praktische Koordinationsprobleme, die Entwickler haben, wenn mehrere Agenten auf derselben Codebasis arbeiten müssen. Ob Sie sie für die Produktivität eines einzelnen Entwicklers einsetzen oder um mehrere Agentenaufgaben im Team zu koordinieren: Das Verständnis von Git-Worktrees, .worktreeinclude und dem Unterschied zwischen lokalen und Web-Sitzungen macht Ihre erste Woche mit der Desktop-Vorschau deutlich produktiver.

Bereit, Claude Code cli zu nutzen? Konsultieren Sie den API-Guide für detaillierte Anweisungen.

Entwickler können über CometAPI auf die Claude Opus 4.5 API usw. zugreifen, die neueste Modellversion wird stets mit der offiziellen Website aktualisiert. Um zu beginnen, erkunden Sie die Fähigkeiten des Modells im Playground und konsultieren Sie den API-Guide für detaillierte Anweisungen. Bevor Sie auf die Schnittstelle zugreifen, stellen Sie bitte sicher, dass Sie sich bei CometAPI angemeldet und den API-Schlüssel erhalten haben. CometAPI bietet einen deutlich niedrigeren Preis als der offizielle, um Ihnen die Integration zu erleichtern.

Bereit loszulegen?→ Kostenlose Testversion von Claude opus 4.5 !

Wenn Sie weitere Tipps, Guides und Neuigkeiten zu KI erfahren möchten, folgen Sie uns auf VK, X und Discord!