Claude unter Linux: Desktop-App und CLI
Welche Claude-Oberflächen unter Linux nativ laufen: Beta-Desktop-App per apt, Claude Code CLI, Editor-Plugins und welcher Bezahlplan jeweils genügt.
Welche Teile von Claude laufen heute nativ unter Linux
Claude läuft unter Linux auf vier getrennten Ebenen. Seit Oktober 2026 funktionieren alle vier auf einem normalen Ubuntu- oder Debian-System. Die Desktop-App wird aus dem apt-Repository von Anthropic installiert und befindet sich in der Beta-Phase. Die Claude Code CLI (command line interface) ist eine kompilierte Binärdatei und läuft auf mehr Distributionen als die Desktop-App. Die Web-App unter claude.ai benötigt nur einen Browser. Die API ist ein HTTPS-Endpunkt, den Sie aus Ihrem eigenen Code aufrufen.
Drei Funktionen, die unter macOS und Windows verfügbar sind, fehlen in der Linux-Desktop-Beta oder sind eingeschränkt: Computer Use, bei dem Claude Anwendungen auf Ihrem Bildschirm steuert, Spracheingabe und der globale Hotkey Quick Entry. Anthropic dokumentiert Computer Use und Spracheingabe als unter Linux nicht verfügbar. Der Quick-Entry-Hotkey funktioniert in einer X11-Sitzung. In einer nativen Wayland-Sitzung benötigt er jedoch das GlobalShortcuts-Portal Ihrer Desktop-Umgebung. Ohne dieses Portal ist der Hotkey nicht verfügbar. echo $XDG_SESSION_TYPE gibt x11 oder wayland aus und zeigt Ihnen, welcher Fall vorliegt. Die CLI verfügt über eine eigene Spracheingabe. Die Einschränkung betrifft daher die Desktop-App und nicht Claude selbst.
Die Verfügbarkeit ändert sich. Lesen Sie diese Seite daher als Beschreibung der verschiedenen Ebenen und prüfen Sie den aktuellen Stand, bevor Sie Ihre Planung darauf ausrichten. Im letzten Abschnitt sind die zu prüfenden Seiten aufgeführt.
Claude-Desktop-App unter Ubuntu oder Debian installieren
Die dokumentierten Voraussetzungen sind Ubuntu 22.04 oder neuer beziehungsweise Debian 12 oder neuer auf x86_64 (das dpkg als amd64 bezeichnet) oder arm64. Andere Debian-basierte Distributionen funktionieren möglicherweise, wurden aber nicht getestet. Für Fedora und RHEL gibt es noch kein Paket. Verwenden Sie dort die CLI oder den Browser.
Installieren Sie die Anwendung aus dem apt-Repository und nicht aus einer heruntergeladenen .deb-Datei. Die Linux-Anwendung verfügt über keinen eigenen Updater. Neue Versionen erreichen Sie daher nur über den Paketmanager. Die Registrierung des Repositorys ermöglicht es apt upgrade, diese Versionen zu finden.
sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.ascgpg --show-keys sollte den Fingerabdruck 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE ausgeben. Vergleichen Sie ihn, bevor Sie das Repository registrieren. Andernfalls vertrauen Sie einem Signaturschlüssel, den Sie nicht geprüft haben. Wenn gpg meldet, dass die Datei keine gültigen OpenPGP-Daten enthält, ist der Download fehlgeschlagen. apt update schlägt dann später mit NO_PUBKEY BAA929FF1A7ECACE fehl.
Die Registrierung des Repositorys besteht aus einer einzigen deb-Zeile, die nach /etc/apt/sources.list.d/claude-desktop.list geschrieben wird. Kopieren Sie diese Zeile von der Linux-Installationsseite von Anthropic, code.claude.com/docs/en/desktop-linux, genau wie dort angegeben. Die Repository-Adresse ändert sich in diesem Verfahren am wahrscheinlichsten. Eine aus dem Gedächtnis eingegebene Zeile führt anschließend zu E: Unable to locate package claude-desktop. Lesen Sie die Zeile, bevor Sie sie einfügen: arch=amd64,arm64 legt fest, warum apt auf jeder anderen Architektur nichts findet. signed-by= verweist auf die gerade geprüfte Keyring-Datei. Dadurch wird dieser Schlüssel auf dieses eine Repository beschränkt, statt ihn für alle anderen von apt gelesenen Quellen zu verwenden.
sudo apt update && sudo apt install claude-desktopStarten Sie die Anwendung über den Anwendungsstarter oder führen Sie claude-desktop in einem Terminal aus. Melden Sie sich mit Ihrem claude.ai-Konto oder über das SSO (Single Sign-on) Ihrer Organisation an, sofern Ihr Unternehmen dieses eingerichtet hat. Anthropic nennt auf der Linux-Installationsseite diese beiden Anmeldeverfahren und verweist Benutzer von API keys auf die CLI. Anthropic beschreibt außerdem einen zweiten Bereitstellungsmodus derselben Anwendung separat: Wenn die Anwendung mit einem Inference-Provider (Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, einem LLM-Gateway oder direkt mit der Anthropic API) konfiguriert ist, bietet der Anmeldebildschirm an, die Anthropic-Authentifizierung zu überspringen. Der Provider übernimmt dann die Inferenz und Abrechnung für Chat, Cowork und Code. Diese Dokumentation nennt als Speicherort der verwalteten Konfiguration unter Linux /etc/claude-desktop/managed-settings.json. Die Linux-Installationsseite verweist inzwischen auf die Dokumentation für Bereitstellungen durch Drittanbieter. Auf Geräten ohne Claude-Desktop-Konfiguration bietet Claude Desktop 3.1623.1 oder neuer auf dem standardmäßigen Anmeldebildschirm außerdem die Option Use your Claude API account. Dort können Sie sich mit Claude Console anmelden oder ohne vorherige Konfiguration einen API key eingeben. In Claude Desktop 4.23118.0 oder neuer wird dieser Link bei einer Computeranmeldung ausgeblendet, wenn eine Organisation andere Konten blockiert, auch ohne Gerätemanagement.
Cowork-Aufgaben, die auf Ihrem eigenen Rechner ausgeführt werden, verwenden eine virtuelle Maschine. Dafür muss die Hardwarevirtualisierung aktiviert sein und Ihr Benutzer Mitglied der Gruppe kvm sein (sudo usermod -aG kvm $USER, danach ab- und wieder anmelden). Nicht jede Cowork-Aufgabe wird lokal ausgeführt. Seit dem 6. Oktober 2026 werden neue Cowork-Aufgaben in Pro-, Max- und Ultra-Tarifen in der Cloud von Anthropic ausgeführt. Es gibt keine Einstellung, mit der Sie diese Aufgaben auf Ihrem Rechner ausführen können. Auch Team- und Enterprise-Organisationen, in denen die einheitliche Chat- und Cowork-Erfahrung aktiviert ist, führen Aufgaben in der Cloud aus. Bei diesen Tarifen ist die virtuelle Maschine nur für Aufgaben relevant, die bereits auf Ihrem Rechner gestartet wurden. Anthropic verweist neue Arbeiten, die lokal bleiben müssen, auf Claude Code in der Desktop-Anwendung.
E: Unable to locate package claude-desktop bedeutet, dass apt das Repository nie gelesen hat. cat /etc/apt/sources.list.d/claude-desktop.list sollte die von Ihnen eingetragene deb-Zeile anzeigen. dpkg --print-architecture sollte amd64 oder arm64 ausgeben, da für andere Architekturen keine Pakete veröffentlicht werden. Updates erhalten Sie anschließend zusammen mit den übrigen Systemupdates über sudo apt update && sudo apt upgrade.
Was nur in einem Browser verfügbar ist
claude.ai funktioniert in jedem aktuellen Browser auf jeder Distribution. Damit ist es die Lösung für Fedora, RHEL, Arch, openSUSE und alle anderen Systeme ohne Paket. Der Browser bietet außerdem Claude Code im Web. Die Sitzung läuft dabei auf einer Cloud-Infrastruktur statt auf Ihrem Rechner: standardmäßig auf der Infrastruktur von Anthropic oder in der eigenen Self-Hosted-Umgebung Ihrer Organisation, wenn diese Sitzungen dorthin weiterleitet. Dabei werden immer Ihre Zugangsdaten für das Abonnement verwendet.
Die Einschränkung des Browsers ist der wichtige Punkt. Ein Browser allein kann die Dateien auf Ihrem eigenen Server weder lesen noch dort Befehle ausführen. Alles, was auf Ihren Rechner zugreift, benötigt Software auf diesem Rechner. Dafür kommen die CLI, die Desktop-Anwendung oder ein konfigurierter Self-Hosted-Runner infrage. Cowork-Cloud-Sitzungen können über die Desktop-Anwendung auf verbundene lokale Ordner zugreifen, solange diese geöffnet ist.
Was die CLI bietet, was die Webanwendung nicht bietet
Starten Sie claude in einem Verzeichnis. Das Programm arbeitet dann in diesem Verzeichnis. Das ist der Unterschied. Alles Weitere ergibt sich daraus.
- Die CLI liest und bearbeitet die Dateien in Ihrem Arbeitsverzeichnis. Im Manual-Modus fragt sie vor dem Anwenden von Änderungen nach. Der Auto-Modus wendet Änderungen mit Sicherheitsprüfungen im Hintergrund an. Er ist für aktuelle interaktive Sitzungen standardmäßig integriert, sofern Einstellungen oder Richtlinien dies nicht ändern. Starten Sie mit
claude --permission-mode default, um Aktionen selbst zu prüfen. - Die CLI führt Shell-Befehle im Berechtigungsmodus der Sitzung aus. Dadurch kann sie ein Projekt erstellen, eine Testsuite ausführen, ein Log lesen oder einen Dienst direkt auf dem Server untersuchen.
- Die CLI läuft auch ohne interaktive Sitzung:
claude -p "read the nginx error log and summarise it"gibt eine Antwort aus und beendet sich. Das verwenden Sie in einem cron-Job oder einer Pipeline. In Claude Code 2.1.302 oder höher starten diese Ausführungen im Manual-Modus, wenn kein Berechtigungsmodus festgelegt ist. Aktionen, die eine Genehmigung erfordern, werden dann abgelehnt, sofern Sie keinen Genehmigungsmechanismus bereitstellen. Übergeben Sie--permission-mode auto, damit der Klassifikator die Aktionen prüft. Sie legen selbst fest, wie diese Antwort formuliert ist, denn ein Ausgabestil bearbeitet den System-Prompt hinter jeder Antwort und kann eine skriptgesteuerte Ausführung knapp halten, während eine interaktive Sitzung ihre Vorgehensweise erläutert. - Die CLI verbindet MCP-Server (model context protocol) mit
claude mcp add. Dadurch erhält das Modell zusätzliche Werkzeuge über das Dateisystem hinaus. - Die CLI läuft auch dort, wo keine grafische Desktop-Umgebung vorhanden ist. Das gilt für jeden VPS (virtual private server), den Sie mieten werden.
Der letzte Punkt erklärt, warum ein Serverhandbuch die CLI behandelt. Ein gemieteter Server bietet SSH (secure shell) und sonst nichts. Das Terminal ist daher die einzige Oberfläche, die dort für Sie verfügbar sein kann. Für diese Betriebsart gelten eigene Regeln. Claude Code auf einem VPS innerhalb von tmux auszuführen behandelt sie vollständig. Claude für alltägliche Administrationsaufgaben zu verwenden beschreibt die Aufgaben, die Sie sinnvoll an die CLI übergeben können.
Editorintegrationen liegen zwischen beiden Varianten. Die VS-Code-Erweiterung benötigt VS Code 1.94.0 oder höher. Sie stellt ein grafisches Panel im Editor mit Diff-Ansicht und Planprüfung bereit. Für dieses Panel enthält sie eine private Kopie der CLI. claude wird dabei nicht in Ihren PATH eingetragen. Wenn Sie claude im integrierten Terminal eingeben, benötigen Sie daher weiterhin die eigenständige Installation. Editoren auf Basis von VS Code installieren dieselbe Erweiterung aus der Open-VSX-Registry. Außerdem gibt es ein JetBrains-Plugin.
Benötigen Sie Node.js, um Claude Code unter Linux auszuführen?
Nicht bei der empfohlenen Installation. Das native Installationsprogramm lädt eine kompilierte Binärdatei herunter. Diese Binärdatei läuft nicht unter Node.js.
curl -fsSL https://claude.ai/install.sh | bash
claude --versionclaude --version sollte eine Versionsnummer wie 2.1.211 (Claude Code) ausgeben. Wenn etwas nicht stimmt, führen Sie claude doctor aus. Der Befehl gibt schreibgeschützte Diagnosedaten zur Installation und zu Ihren Einstellungsdateien aus, ohne eine Sitzung zu starten.
Node.js ist nur für die npm-Installation erforderlich. Seit Oktober 2026 benötigt das npm-Paket Node.js 22 oder höher. Unter einer älteren Node.js-Version gibt npm eine EBADENGINE-Warnung aus, statt mit einem Fehler abzubrechen. Das Paket bindet dieselbe native Binärdatei als plattformspezifische Abhängigkeit ein und verknüpft sie am vorgesehenen Ort.
npm install -g @anthropic-ai/claude-codeUnter npm 12 wird der Postinstall-Schritt standardmäßig übersprungen. Dadurch kann claude nicht ausgeführt werden. Wenn npm --version mit 12 beginnt, verwenden Sie das oben beschriebene native Installationsprogramm oder fügen Sie Claude Code in Ihrer Benutzerkonfiguration für npm zu allow-scripts hinzu, bevor Sie die Installation erneut ausführen.
Führen Sie dies nicht mit sudo aus. Die Dokumentation warnt vor sudo npm install -g, weil dadurch Dateien im globalen npm-Präfix dem Benutzer root gehören. Die nächste Installation oder Aktualisierung ohne privilegierte Rechte schlägt dann wegen fehlender Berechtigungen fehl. Wenn das globale npm-Verzeichnis nicht beschreibbar ist, wird die automatische Aktualisierung im Hintergrund beendet. claude doctor listet die möglichen Lösungen auf.
Anthropic veröffentlicht außerdem signierte Paket-Repositories für Debian, Fedora, RHEL und Alpine. Daher funktioniert sudo apt install claude-code ähnlich wie das Paket für Desktop-Systeme. Der zugehörige Signaturschlüssel befindet sich unter https://downloads.claude.ai/keys/claude-code.asc.
Installation pro Benutzer oder systemweit?
Das native Installationsprogramm führt eine Installation pro Benutzer durch. Es legt unter ~/.local/bin/claude einen Launcher als Symlink auf ~/.local/share/claude/versions/ an, benötigt keinen root-Zugriff und aktualisiert sich im Hintergrund. Jeder Benutzer auf dem Rechner erhält eine eigene Kopie mit einer eigenen Version.
Eine Installation über einen Paketmanager erfolgt systemweit. Eine Binary steht allen Benutzern zur Verfügung, benötigt root-Zugriff und wird nicht automatisch über Claude Code aktualisiert. Sie aktualisieren sie mit sudo apt update && sudo apt upgrade claude-code, demselben Befehl, den Sie bereits für alle anderen Pakete auf dem System verwenden.
Wählen Sie die Installation pro Benutzer auf einem Rechner, an dem Sie sich mit Ihrem eigenen Benutzerkonto anmelden. Das deckt die meisten VPS-Szenarien ab. Wählen Sie die Paketinstallation auf einem gemeinsam verwendeten Server oder in einem Maschinen-Image, wenn für alle Benutzer eine Version gelten und deren Aktualisierung nach Ihrem Zeitplan erfolgen soll. Bei einer nativen Installation legen zwei Einstellungen in ~/.claude/settings.json fest, wie Aktualisierungen erfolgen:
{
"autoUpdatesChannel": "stable",
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}Der stable-Kanal verwendet eine Version, die ungefähr eine Woche alt ist, und überspringt Versionen mit schwerwiegenden Regressionen. DISABLE_AUTOUPDATER deaktiviert nur die Hintergrundprüfung. claude update funktioniert weiterhin, und Sie behalten die Kontrolle darüber, wann eine neue Version installiert wird. Das ist auf einem Server wichtig, auf dem ein längerer Auftrag unbeaufsichtigt läuft und sich die Binary währenddessen möglichst nicht ändern soll.
Per SSH anmelden und die Sitzung aktiv halten
Beim ersten Ausführen der CLI auf einem gemieteten Server treten zwei Linux-spezifische Probleme auf. Der Anmeldevorgang benötigt einen Browser, den der Server nicht hat. Wenn eine SSH-Verbindung abbricht, gehen die laufenden Arbeiten mit ihr verloren.
tmux löst das zweite Problem. Eine tmux-Sitzung gehört zum tmux-Server auf dem entfernten Rechner und nicht zu Ihrer Verbindung. Wenn die Verbindung abbricht, läuft der Prozess deshalb weiter.
tmux new -s claude
claudeTrennen Sie die Sitzung mit Ctrl-b und anschließend d. Mit tmux attach -t claude können Sie später zurückkehren.
Die Anmeldung ist das erste Problem. Führen Sie claude aus und kopieren Sie die separate Autorisierungs-URL, die oberhalb der Eingabeaufforderung zum Einfügen im Terminal angezeigt wird. Öffnen Sie diese URL im Browser auf Ihrem eigenen Computer. Nach der Anmeldung über diese URL zeigt der Browser einen Anmeldecode an, anstatt zu localhost zurückzukehren. Fügen Sie diesen Code im Terminal an der Eingabeaufforderung Paste code here if prompted ein. Das Terminal meldet anschließend Login successful.
Wenn eine Sitzung ohne Beaufsichtigung starten muss, öffnet claude setup-token dieselbe Browser-Autorisierung und gibt ein OAuth-Token mit einer Gültigkeit von einem Jahr im Terminal aus. Das Token wird nirgendwo gespeichert. Kopieren Sie es und setzen Sie es dort, wo Sie es benötigen.
export CLAUDE_CODE_OAUTH_TOKEN=your-tokenFür dieses Token ist ein kostenpflichtiger Tarif erforderlich. Es kann ausschließlich Modellanfragen ausführen. Behandeln Sie es wie ein Passwort mit einer Gültigkeit von einem Jahr. Wo Sie es aufbewahren und wie Sie verhindern, dass ein Agent es wieder ausliest, wird unter Secrets vor dem Zugriff durch KI-Agenten schützen behandelt.
Kleine Server stoßen an eine weitere Grenze. Für die Installation werden ungefähr 512 MB freier Speicher benötigt. Die dokumentierte Hardwareanforderung für den Betrieb beträgt 4 GB RAM oder mehr. Auf einer Instanz mit 1 GB RAM und wenig freiem Speicher kann der Out-of-Memory-Killer des Kernels daher die Installation beenden. Der Installer meldet dann:
Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.Fügen Sie Swap hinzu und führen Sie den Installer anschließend erneut aus. Swap ist Speicherplatz auf dem Datenträger, den der Kernel als Ausweichspeicher verwendet. Er ist deutlich langsamer als RAM, reicht aber aus, um eine Installation abzuschließen.
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileswapon aktiviert die Datei nur für diesen Bootvorgang. Fügen Sie für /swapfile eine Zeile zu /etc/fstab hinzu, wenn die Einstellung nach einem Reboot erhalten bleiben soll. Welche weiteren Maßnahmen Sie treffen sollten, bevor Sie einem Agenten das Ausführen von Befehlen auf einem aktiven Server erlauben, wird unter Claude Code sicher auf einem VPS ausführen behandelt.
Wo Ihre Claude-Anmeldedaten unter Linux gespeichert sind
Unter Linux schreibt /login die Anmeldedaten mit dem Dateimodus 0600 in ~/.claude/.credentials.json. macOS legt dieselben Anmeldedaten normalerweise im verschlüsselten Schlüsselbund ab. Wenn der Schlüsselbund den Schreibvorgang ablehnt, wird stattdessen auf dieselbe unverschlüsselte Datei zurückgegriffen. Unter Linux liegt das Token als unverschlüsselte Datei in Ihrem Home-Verzeichnis. Jeder Prozess, der unter Ihrem Benutzerkonto läuft, kann die Datei lesen. Mit CLAUDE_CONFIG_DIR wird die Datei stattdessen unter diesem Verzeichnis abgelegt.
Daraus ergeben sich zwei Folgen. Ein Backup von /home enthält eine gültige Anmeldung. Wenn Sie dieses Backup auf eine gemeinsam genutzte Maschine kopieren, übergeben Sie Ihr Konto an alle anderen Personen, die es lesen können. Ein Maschinen-Image, das auf einem System erstellt wurde, auf dem Sie sich angemeldet haben, übernimmt diese Anmeldung in jede daraus geklonte Instanz. Führen Sie /logout aus, bevor Sie einen Snapshot erstellen.
Die Priorität der Anmeldedaten führt häufig zu Problemen, wenn Sie gleichzeitig ein Abonnement und einen API-Schlüssel verwenden. Wenn ANTHROPIC_API_KEY in Ihrer Shell gesetzt ist, verwendet Claude Code diesen Wert, sobald Sie ihn bestätigen. Ihr Abonnement bleibt dann ungenutzt, während der Schlüssel pro Token abgerechnet wird. /status zeigt, welche Anmeldedaten aktiv sind. unset ANTHROPIC_API_KEY führt zurück zur Anmeldung mit dem Abonnement.
Anmeldungen laufen ab. Innerhalb von drei Tagen vor dem Ablauf zeigt die Startzeile Your login expires in 3 days an. Diese Warnung blockiert keine Anfragen. Nach dem Ablauf schlägt jede Modellanfrage mit Login expired · Please run /login fehl, wenn die Anmeldung nicht erneuert werden kann. Beachten Sie dies, bevor Sie eine unbeaufsichtigte Sitzung über ein Wochenende laufen lassen. Eine solche Sitzung macht dann keine Fortschritte mehr und kann sich nicht selbstständig wiederherstellen.
Deckt ein Claude-Abonnement alle Zugriffswege ab?
Ein kostenpflichtiger Tarif deckt alle Zugriffswege mit derselben Anmeldung ab. Ausnahmen gelten für einige Enterprise-Tarife. Mit einem Pro-, Max-, Ultra- oder Team-Konto melden Sie sich in einem Browser bei claude.ai, in der Desktop-App, in der CLI und in der VS-Code-Erweiterung an. Dabei handelt es sich jedes Mal um dasselbe Abonnement. Das gilt auch für ein Enterprise-Konto mit einem neuen oder selbst verwalteten Tarif außerhalb von HIPAA-fähigen Organisationen, wenn der einzelne Enterprise-Sitz Claude Code umfasst. Bei älteren Enterprise-Tarifen gibt es dagegen weiterhin getrennte Sitztypen. Dort benötigen die Claude-Code-Zugriffswege einen Chat + Claude Code-Sitz oder bei einem älteren sitzbasierten Tarif einen Premium-Sitz. Ein Chat-only- oder Standard-Sitz umfasst diese Zugriffswege nicht. HIPAA-fähige Enterprise-Organisationen verwenden ebenfalls getrennte Sitztypen für Chat und Chat + Claude Code. Bei einem HIPAA-fähigen Enterprise-Tarif erfordert Claude Code einen Chat + Claude Code-Sitz. Für die Abdeckung durch ein BAA für das Terminal und den Code-Tab von Claude Desktop ist außerdem die HIPAA-Konfiguration oder eine entsprechende Abdeckung durch Zero Data Retention erforderlich. Die VS-Code- und JetBrains-Erweiterungen sowie Cloud-Sitzungen werden nicht durch die HIPAA-Konfiguration abgedeckt. Bei Pro-, Max-, Ultra-, Team- und sitzbasierten Enterprise-Tarifen gibt es außerdem ein gemeinsames Nutzungskontingent für alle diese Zugriffswege. Ein langer CLI-Lauf auf Ihrem Server verringert also das verbleibende Kontingent der Desktop-App. Wenn einer der Zugriffswege die Verarbeitung verweigert, müssen Sie daher zuerst prüfen, welches Limitfenster Sie erreicht haben und was Sie dagegen tun können. Bei einem nutzungsbasierten Enterprise-Tarif gibt es kein enthaltenes Kontingent, das aufgebraucht werden kann. Jeder Zugriffsweg wird ab dem ersten Token nach API-Tarifen abgerechnet. Der kostenlose claude.ai-Tarif umfasst keinen Zugriff auf Claude Code. Ohne kostenpflichtigen Tarif kann sich die CLI mit einem Claude-Console-Konto anmelden. Wenn Ihre Organisation Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwendet, können Sie sich auch über diesen Anbieter authentifizieren, ohne eine Browser-Anmeldung zu verwenden. Bei einer claude.ai-Abonnement- oder SSO-Anmeldung benötigen die Claude-Code-Funktionen der Desktop-App einen kostenpflichtigen Tarif. Der oben beschriebene separat konfigurierte Drittanbietermodus und, sofern angeboten, die Option für ein Claude-API-Konto auf nicht verwalteten Geräten ermöglichen es der Desktop-App, stattdessen die Abrechnung über Console oder den jeweiligen Anbieter zu verwenden.
Die API ist ein anderes Produkt mit einer anderen Abrechnung. Bei einem Console-Konto zahlen Sie pro Token für die tatsächlich gesendeten Daten. Das eignet sich eher für einen Dienst, den Sie entwickeln, als für die Eingabe an einem Terminal. Wenn Sie ANTHROPIC_API_KEY setzen, wechselt die CLI zu diesem Abrechnungsmodell. Das ist eine bewusste Entscheidung und kein Fallback. Im Standardmodus meldet sich die Desktop-App über OAuth an. Im Drittanbietermodus verwendet sie die Zugangsdaten aus ihrer eigenen Konfiguration.
Preise und Tariflimits ändern sich zu häufig, um sie hier festzuhalten. Zwei Seiten enthalten die aktuellen Werte: was Claude Code tatsächlich kostet und welchen Claude-Tarif Sie benötigen. Wenn Sie eine Abrechnung pro Token mit einem Monatstarif vergleichen, erklärt die API im Vergleich zu einem Abonnement, wo der Break-even-Punkt liegt.
Die Installationsfehler, die tatsächlich auftreten
bash: claude: command not found direkt nach einer erfolgreichen Installation. Das Binary befindet sich unter ~/.local/bin/claude, aber dieses Verzeichnis ist nicht in der Suchpfadvariable Ihrer Shell enthalten. Prüfen Sie dies mit echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin". Der Befehl gibt nichts aus, wenn der Eintrag fehlt. Beheben Sie das für bash mit echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc und führen Sie anschließend source ~/.bashrc aus. Durch die alleinige Installation der VS Code-Erweiterung wird diese Datei nie erstellt, weil die Erweiterung ihre CLI-Kopie im Erweiterungsverzeichnis ablegt.
Error loading shared library libstdc++.so.6. Entweder hat das Installationsprogramm die falsche Binary-Variante heruntergeladen, normalerweise den musl-Build auf einem glibc-System, oder Sie verwenden ein musl-System, dem die Laufzeitbibliotheken fehlen. Die falsche Variante wird geladen, wenn musl-Cross-Compilation-Pakete vorhanden sind und die Erkennung diese falsch interpretiert. Führen Sie ldd --version 2>&1 | head -1 aus: Die Ausgaben GNU libc oder GLIBC bedeuten, dass Sie glibc verwenden und das falsche Binary erhalten haben. Entfernen Sie die Installation und führen Sie das Installationsprogramm erneut aus. Auf Alpine und anderen musl-Systemen ist die Lösung umgekehrt: apk add libgcc libstdc++ ripgrep.
Zwei Kopien von claude auf einem System. which -a claude listet jeden Treffer in Ihrem PATH auf. Eine native Installation ist ein Symlink von ~/.local/bin/claude nach ~/.local/share/claude/versions/, eine ältere lokale npm-Installation befindet sich unter ~/.claude/local/, und npm -g ls @anthropic-ai/claude-code zeigt eine globale npm-Installation an. Entfernen Sie die nicht benötigten Kopien. Eine veraltete Kopie, die weiter vorne in Ihrem PATH steht, lässt einen behobenen Fehler weiterhin bestehen.
Wo Sie den aktuellen Stand prüfen
- Status, Voraussetzungen und Installationsbefehle für den Linux-Desktop: code.claude.com/docs/en/desktop-linux
- Unterstützte Distributionen und alle Installationsmethoden für die CLI: code.claude.com/docs/en/setup
- Plattformen, für die überhaupt eine App zum Download verfügbar ist: claude.com/download
- Welche Leistungen in welchem Tarif enthalten sind und was sie kosten: claude.com/pricing
Die Anmelderichtlinie für Claude-API-Konten, die Standardberechtigungen für unbeaufsichtigte Ausführung, der SSH-Anmeldeablauf und die Speicherung von Zugangsdaten wurden am November 7, 2026 geprüft. Die übrigen Versionsnummern und Datumsangaben in diesem Leitfaden sind weiterhin Momentaufnahmen aus dem Oktober 2026. Dauerhaft relevant ist die Struktur: vier Oberflächen, eine Anmeldung für die kostenpflichtigen Oberflächen und eine Entscheidung darüber, ob die CLI zu Ihrem Benutzerkonto oder zum gesamten System gehört.
FAQ
Gibt es eine Claude-Desktop-App für Linux?
Ja. Seit Oktober 2026 befindet sie sich in der Betaphase und unterstützt Ubuntu 22.04 oder höher sowie Debian 12 oder höher auf amd64 oder arm64. Installieren Sie sie mit sudo apt install claude-desktop, nachdem Sie das apt-Repository von Anthropic und dessen Signaturschlüssel hinzugefügt haben. Neue Versionen werden dann mit Ihren normalen Systemaktualisierungen installiert. Die Linux-Version enthält dieselben Tabs wie die macOS-App, einschließlich des Tabs Claude Code. Computer Use und Spracheingabe sind in der Linux-Version noch nicht verfügbar. Der globale Hotkey Quick Entry funktioniert unter X11, benötigt in einer nativen Wayland-Sitzung jedoch das GlobalShortcuts-Portal Ihrer Desktop-Umgebung. Für Fedora und RHEL gibt es kein Paket. Verwenden Sie auf diesen Distributionen daher die CLI oder claude.ai im Browser.
Benötige ich Node.js, um Claude Code unter Linux auszuführen?
Nicht bei der empfohlenen Installation. curl -fsSL https://claude.ai/install.sh | bash lädt eine kompilierte Binärdatei herunter, die zur Laufzeit kein Node.js verwendet. Node.js wird nur benötigt, wenn Sie das npm-Paket installieren. Dieses verlangt seit Oktober 2026 Node.js 22 oder höher. Bei einer älteren Node.js-Version gibt npm eine EBADENGINE-Warnung aus. Die Installation wird trotzdem abgeschlossen, weil dieselbe native Binärdatei als plattformspezifische Abhängigkeit installiert wird. Installieren Sie das Paket niemals mit sudo npm install -g. Dadurch entstehen Dateien im npm-Präfix, die root gehören, und spätere Aktualisierungen schlagen fehl.
Wie melde ich mich über SSH bei Claude Code an?
Führen Sie claude aus und kopieren Sie die separate Autorisierungs-URL, die über der Eingabeaufforderung zum Einfügen im Terminal angezeigt wird. Öffnen Sie diese URL im Browser auf Ihrem eigenen Computer, nicht auf dem Server. Nach der Anmeldung über diese URL zeigt der Browser einen Anmeldecode an, anstatt zu localhost zurückzukehren. Fügen Sie diesen Code an der Paste code here if prompted-Eingabeaufforderung ein. Für Sitzungen, die ohne anwesenden Benutzer starten, führen Sie claude setup-token aus und setzen das ausgegebene Token als CLAUDE_CODE_OAUTH_TOKEN, wo es benötigt wird.
Wo speichert Claude Code meine Anmeldung unter Linux?
In ~/.claude/.credentials.json mit dem Dateimodus 0600 oder unter CLAUDE_CONFIG_DIR, wenn Sie diese Variable setzen. Unter Linux wird kein Schlüsselbund verwendet. macOS verwendet normalerweise den verschlüsselten Schlüsselbund, greift aber auf dieselbe Klartextdatei zurück, wenn der Schlüsselbund einen Schreibvorgang ablehnt. Jeder Prozess, der unter Ihrem Benutzerkonto läuft, kann die Linux-Anmeldedatei lesen. Ein /home-Backup oder ein Maschinen-Image enthält daher eine weiterhin gültige Anmeldung. Führen Sie /logout aus, bevor Sie ein System als Snapshot sichern oder kopieren. Wenn ANTHROPIC_API_KEY ebenfalls in Ihrer Umgebung gesetzt ist, hat diese Variable Vorrang vor der gespeicherten Abonnementanmeldung, sobald Sie sie freigeben. /status zeigt an, welche Anmeldung aktiv ist.
Deckt mein Claude-Pro-Abonnement sowohl die CLI als auch die Web-App ab?
Ja. Mit einem Pro-, Max-, Ultra- oder Team-Tarif melden Sie sich mit einem Konto bei claude.ai, der Desktop-App, der CLI und der VS-Code-Erweiterung an. Das gilt auch für Enterprise. Bei älteren und HIPAA-fähigen Enterprise-Tarifen ist Claude Code jedoch nur auf Sitzen enthalten, die diese Funktion umfassen, beispielsweise auf Chat + Claude Code-Sitzen. HIPAA-fähige Organisationen verwenden separate Sitztypen für Chat und Chat + Claude Code. Nur Chat + Claude Code-Sitze enthalten Claude Code. Der kostenlose claude.ai-Tarif umfasst Claude Code nicht. Für die Terminal-CLI benötigen Sie daher einen kostenpflichtigen Tarif, ein Claude-Console-Konto oder einen Cloud-Anbieter, den Ihre Organisation verwendet, beispielsweise Amazon Bedrock, die Agent Platform von Google Cloud oder Microsoft Foundry. Die Desktop-App unterstützt die Anmeldung per Abonnement oder SSO sowie konfigurierte Inferenz von Drittanbietern. Auf Geräten ohne Claude-Desktop-Konfiguration bietet Version 3.1623.1 oder höher außerdem eine Option für ein Claude-API-Konto. Diese akzeptiert die Anmeldung über Console oder einen API-Schlüssel ohne vorherige Konfiguration. In Version 4.23118.0 oder höher wird dieser Link bei einer Computeranmeldung ausgeblendet, wenn eine Organisation andere Konten blockiert, auch ohne Gerätemanagement. Die API wird bei einem Console-Konto separat pro Token abgerechnet. Sie ist ein anderes Produkt als ein Abonnement.