Skip to main content
Die Linux-Unterstützung für die Claude-Desktop-App befindet sich in der Beta-Phase.
Die Desktop-App unter Linux bietet Ihnen die gleiche Chat-, Cowork- und Claude Code-Erfahrung wie auf macOS und Windows: parallele Sitzungen, visuelle Diff-Überprüfung, ein integriertes Terminal und Editor sowie Live-App-Vorschau. Siehe Claude Code Desktop verwenden für die Funktionsreferenz.

​
Anforderungen

  • Eine Debian-basierte Distribution: Ubuntu 22.04 oder später oder Debian 12 oder später
  • x86_64 oder arm64
Andere Debian-basierte Distributionen, die diese Anforderungen erfüllen, funktionieren möglicherweise, werden aber nicht offiziell getestet. Auf Distributionen, die nicht Debian-basiert sind, wie Fedora oder Arch, führen Sie stattdessen die CLI aus. Wenn Sie unter Windows mit WSL 2 arbeiten, installieren Sie die Windows-Desktop-App und führen Sie Sitzungen in Ihrer Distribution aus; siehe Claude Code Desktop in WSL.

​
Cowork-Anforderungen

Cowork ist die Desktop-Registerkarte für Dispatch und längere agentengestützte Arbeiten. Unter Linux führt Cowork diese Aufgaben in einer virtuellen Maschine aus, die die Desktop-App mit QEMU und KVM hostet. Um Cowork zu verwenden, benötigt Ihr Computer:
  • Hardware-Virtualisierung: aktiviert in Ihren Firmware-Einstellungen. Ohne diese meldet die Cowork-Registerkarte „Cowork requires hardware virtualization (KVM)”.
  • QEMU und UEFI-Firmware: qemu-system-x86, ovmf und virtiofsd auf x86_64 oder qemu-system-arm, qemu-efi-aarch64 und virtiofsd auf arm64. apt install claude-desktop installiert diese standardmäßig als empfohlene Pakete. Wenn Sie mit --no-install-recommends installiert haben oder Ihr System ein minimales Image ist, das empfohlene Pakete überspringt, meldet die Cowork-Registerkarte „Cowork requires QEMU” und zeigt den auszuführenden apt install-Befehl an. Ubuntu 22.04 hat kein virtiofsd-Paket; die App verwendet dort eine gebündelte Kopie.
  • Zugriff auf /dev/kvm: Fügen Sie Ihren Benutzer mit sudo usermod -aG kvm $USER zur kvm-Gruppe hinzu, melden Sie sich dann ab und wieder an. Einige Desktop-Umgebungen gewähren dem angemeldeten Benutzer Zugriff auf /dev/kvm ohne die Gruppe, aber Cowork benötigt auch /dev/vhost-vsock, auf das nur Mitglieder der kvm-Gruppe zugreifen können. Treten Sie der Gruppe bei, auch wenn /dev/kvm bereits für Sie funktioniert.
Die App überprüft diese Anforderungen einmal beim Start: Starten Sie sie neu, nachdem Sie Pakete installiert haben, und melden Sie sich ab und wieder an, nachdem Sie der Gruppe beigetreten sind. Wenn /dev/vhost-vsock fehlt und Ihr laufender Kernel kein Modulverzeichnis unter /lib/modules hat, meldet die Cowork-Registerkarte, dass der Kernel die Virtualisierungsunterstützung, die Cowork benötigt, nicht enthält und dass diese nicht manuell hinzugefügt werden kann. Diese Kombination ist häufig auf ChromeOS und in containergestützten Linux-Umgebungen anzutreffen.

​
Installation

Installieren Sie aus dem apt-Repository von Anthropic, damit Updates über die regulären Paketaktualisierungen Ihres Systems ankommen. Öffnen Sie ein Terminal und führen Sie die Befehle in jedem Schritt aus.
1

Anthropics apt-Repository hinzufügen

Dieser Schritt lädt den Signaturschlüssel mit curl herunter und überprüft ihn mit gpg, die frische Debian- und Ubuntu-Installationen möglicherweise nicht enthalten. Wenn einer der Befehle command not found meldet, installieren Sie zunächst beide:
Laden Sie den Signaturschlüssel von Anthropic herunter:
Der Befehl gibt nichts aus, wenn er erfolgreich ist, und einen curl:-Fehler, wenn er nicht erfolgreich ist. Ein fehlender oder falscher Schlüssel führt dazu, dass apt update später mit NO_PUBKEY BAA929FF1A7ECACE fehlschlägt. Bestätigen Sie daher, dass der Schlüssel heruntergeladen wurde und zu Anthropic gehört, bevor Sie fortfahren:
Der Fingerabdruck, den gpg ausgibt, sollte 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE sein. Wenn gpg meldet, dass die Datei nicht geöffnet werden kann oder keine gültigen OpenPGP-Daten enthält, ist der Download fehlgeschlagen oder hat den falschen Inhalt zurückgegeben: Bestätigen Sie, dass Ihr Netzwerk downloads.claude.ai erreichen kann, und führen Sie dann den Download-Befehl erneut aus.Registrieren Sie das Repository:
2

Installieren Sie das Paket

3

Starten und anmelden

Starten Sie Claude über Ihren Anwendungsstarter oder führen Sie claude-desktop von einem Terminal aus aus und melden Sie sich mit Ihrem Anthropic-Konto an.Die Linux-App meldet sich auf die gleiche Weise an wie auf macOS und Windows: mit einem claude.ai-Abonnement oder über das SSO Ihrer Organisation. Desktop akzeptiert keinen Claude Console API-Schlüssel direkt; verwenden Sie die CLI für die API-Schlüssel-Authentifizierung. Für Enterprise-Bereitstellungen, die Desktop zu Googles Agent Platform oder einem LLM-Gateway weiterleiten, siehe Claude Desktop auf 3P und Netzwerkkonfiguration.

​
Installation aus einer heruntergeladenen Datei

Wenn Sie das apt-Repository nicht verwenden können, laden Sie das .deb-Paket direkt aus dem Repository-Paketpool herunter. Dieser Befehl sucht das neueste Paket für Ihre Architektur im Repository-Index auf und lädt es dann in das aktuelle Verzeichnis herunter:
Wenn der Befehl mit Remote file name has no length fehlschlägt, hat die Suche keinen Paketpfad zurückgegeben. Dies kann bedeuten, dass der Repository-Index nicht abgerufen werden konnte, beispielsweise wenn Ihr Netzwerk downloads.claude.ai blockiert, oder dass kein Paket für Ihre Architektur vorhanden ist. Bestätigen Sie, dass Ihr Netzwerk downloads.claude.ai erreichen kann und dass dpkg --print-architecture amd64 oder arm64 ausgibt; das Repository veröffentlicht keine Pakete für andere Architekturen. Um ohne Registrierung von Anthropics apt-Repository zu installieren, erstellen Sie zunächst /etc/default/claude-desktop mit der Zeile CLAUDE_DESKTOP_ADD_REPO="false". Ohne das Repository liefert apt keine neuen Versionen; zum Aktualisieren führen Sie den Download-Befehl erneut aus und installieren neu, oder registrieren Sie das Repository später. Öffnen Sie dann die heruntergeladene Datei mit Ihrem Software-Installer, z. B. GNOME Software, oder installieren Sie sie mit apt aus dem Verzeichnis, das die heruntergeladene Datei enthält:
Wenn apt E: Unsupported file ./claude-desktop_*.deb given on commandline meldet, hat das Muster keine .deb-Datei im aktuellen Verzeichnis gefunden. Bestätigen Sie, dass der Download abgeschlossen ist, und führen Sie den Befehl erneut aus dem Verzeichnis aus, das die Datei enthält. Das .deb-Paket enthält den Signaturschlüssel von Anthropic und installiert ihn unter /usr/share/keyrings/claude-desktop-archive-keyring.asc, sodass Sie den Schlüssel nicht selbst herunterladen müssen. Sofern Sie die Registrierung nicht mit CLAUDE_DESKTOP_ADD_REPO deaktiviert haben, registriert das Paket außerdem das apt-Repository unter /etc/apt/sources.list.d/claude-desktop.list, sodass zukünftige Updates mit den regulären Paketaktualisierungen Ihres Systems ankommen.

​
Aktualisierung

Die Desktop-App aktualisiert sich unter Linux nicht selbst. Updates kommen mit den regulären Paketaktualisierungen Ihres Systems: