Claude Code Desktop: Die vollständige Anleitung für Windows und macOS

Claude Code Desktop bringt die KI-gestützte Entwicklungsumgebung von Anthropic auf deinen Rechner – als native Applikation für macOS und Windows. Statt ausschließlich im Terminal zu arbeiten, öffnest du ein vollwertiges Desktop-Interface, das Sitzungen verwaltet, Remote-Verbindungen aufbaut und alle Einstellungen grafisch zugänglich macht. Dieser Artikel zeigt dir jeden Schritt: von der Installation bis zur produktiven Nutzung auf echten Servern.

Was ist Claude Code Desktop und wie funktioniert es?

Claude Code ist Anthropics KI-Assistent für Entwickler, der direkt im Terminal läuft und Codebasen liest, bearbeitet und erklärt. Claude Code Desktop ist die grafische Benutzeroberfläche rund um diesen Kern. Die Desktop-App gibt dir ein strukturiertes Interface, ohne auf die volle Leistung der CLI zu verzichten.

Im Hintergrund läuft weiterhin derselbe Node.js-Prozess, den du aus dem Terminal kennst. Die Desktop-Applikation umhüllt ihn mit einem Fensterrahmen, einer Sitzungsverwaltung und persistenten Einstellungen. Du kannst mehrere Sessions parallel öffnen, zwischen Projekten wechseln und Verbindungen zu Remote-Servern speichern – alles ohne manuelle Konfiguration beim nächsten Start.

Der Unterschied zur reinen CLI-Nutzung liegt vor allem in der Arbeitsgeschwindigkeit. Eine neue Sitzung startest du per Klick statt per Befehl, gespeicherte Server-Profile laden automatisch, und du siehst den Status aller laufenden Prozesse auf einen Blick. Für Teams, die Claude Code täglich einsetzen, reduziert das die Reibung im Alltag spürbar.

Die technische Architektur im Überblick

Claude Code Desktop basiert auf Electron, dem Framework hinter Applikationen wie VS Code oder Slack. Es kombiniert einen Chromium-Renderer mit einem Node.js-Backend. Das bedeutet: Die Oberfläche verhält sich wie eine native App, nutzt aber dieselben npm-Pakete und JavaScript-APIs wie die CLI-Version.

Die Kommunikation mit den Anthropic-Modellen läuft über die offizielle API. Dein API-Schlüssel liegt lokal in einer verschlüsselten Konfigurationsdatei, nicht auf einem Drittserver. Pro Sitzung baut die App eine eigene Verbindung auf – du siehst Token-Verbrauch und Modellauswahl direkt im Interface.

Wenn du mit einem OpenClaude-basierten Setup arbeitest oder andere Anthropic-Modelle über kompatible Endpunkte nutzt, kannst du auch diese in Claude Code Desktop einbinden. Die Basis-URL ist in den Einstellungen frei konfigurierbar.

Session-Konzept und Datenpersistenz

Jede Sitzung in Claude Code Desktop ist ein eigenständiger Konversationskontext. Claude kennt innerhalb einer Session den gesamten Gesprächsverlauf, gelesene Dateien und ausgeführte Befehle. Schließt du eine Session, bleibt der Verlauf als lokales Log gespeichert – du kannst ihn später nachlesen, aber nicht in einen neuen Kontext laden.

Projekte speichert die App als Einträge in einer lokalen SQLite-Datenbank. Dazu gehören: Wurzelpfad des Projekts, bevorzugtes Modell, benutzerdefinierte Systembefehle und verknüpfte Remote-Server-Profile. Das spart Zeit beim täglichen Öffnen häufig genutzter Arbeitsumgebungen.

Claude Code Desktop für macOS herunterladen und installieren

Die Installation auf einem Mac läuft in wenigen Minuten durch. Du brauchst einen Anthropic-Account mit aktivem API-Zugang und eine aktuelle macOS-Version. Apple Silicon und Intel-Macs werden beide unterstützt – es gibt separate Builds für beide Architekturen.

Systemvoraussetzungen für macOS

Prüfe vor der Installation, welche Node.js-Version auf deinem Mac läuft. Claude Code Desktop bringt zwar eine eingebettete Runtime mit, aber das globale npm-Paket, das die CLI bereitstellt, nutzt deine Systeminstallation.

Schritt-für-Schritt-Installation auf dem Mac

Zuerst stellst du sicher, dass Node.js in einer kompatiblen Version vorhanden ist. Öffne das Terminal und führe aus:

node --version
npm --version

Falls Node.js fehlt oder veraltet ist, installierst du es am schnellsten über Homebrew:

brew install node@20
echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Danach installierst du das Claude Code CLI-Paket global über npm. Dieses Paket ist die Basis, auf der die Desktop-App aufbaut:

npm install -g @anthropic-ai/claude-code

Jetzt lädst du den macOS-Installer von der offiziellen Anthropic-Dokumentation herunter. Wähle den passenden Build für deine Architektur: „Apple Silicon (arm64)” für M1/M2/M3/M4-Macs oder „Intel (x64)” für ältere Modelle. Du erkennst deinen Prozessor unter „Apple-Menü → Über diesen Mac”.

Sobald der Download abgeschlossen ist, öffnest du die .dmg-Datei per Doppelklick. Ziehe das Claude-Code-Desktop-Icon in den Applications-Ordner. macOS blockiert beim ersten Start möglicherweise die App, weil sie nicht aus dem App Store stammt. Gehe in diesem Fall zu „Systemeinstellungen → Datenschutz & Sicherheit” und klicke auf „Dennoch öffnen”.

Beim ersten Start fragt die App nach deinem Anthropic API-Schlüssel. Du findest ihn in der Anthropic Console unter „API Keys”. Kopiere den Schlüssel, füge ihn in das Eingabefeld ein und bestätige mit Enter. Claude Code Desktop speichert ihn verschlüsselt in der macOS Keychain.

Nach der Authentifizierung erscheint das Hauptfenster. Du siehst links die Projektliste, oben die Modellauswahl und in der Mitte den Chat-Bereich. Die erste Sitzung kannst du jetzt starten.

Installation per Homebrew Cask (alternativer Weg)

Wer Homebrew für alle Applikationen nutzt, kann Claude Code Desktop auch direkt darüber installieren:

brew install --cask claude-code-desktop

Homebrew übernimmt Download, Verifikation und Platzierung im Applications-Ordner automatisch. Updates führst du dann mit einem einzigen Befehl durch:

brew upgrade --cask claude-code-desktop

Claude Code Desktop für Windows herunterladen und installieren

Unter Windows läuft Claude Code Desktop als native Win32-Applikation, verpackt als NSIS-Installer. Die Voraussetzungen ähneln macOS, aber es gibt einige Windows-spezifische Punkte zu beachten – besonders rund um WSL und Pfadkonfigurationen.

Systemvoraussetzungen für Windows

Windows Subsystem for Linux (WSL 2) ist zwar keine Pflicht, aber stark empfohlen. Die meisten Entwickler-Workflows laufen unter Linux-Umgebungen stabiler, und Remote-Server-Verbindungen via SSH funktionieren in WSL reibungsloser als im nativen Windows-Terminal.

Schritt-für-Schritt-Installation unter Windows

Installiere zunächst Node.js für Windows. Lade den LTS-Installer von nodejs.org herunter und führe ihn aus. Wichtig: Hake „Add to PATH” an, damit npm global verfügbar ist. Nach der Installation öffnest du die Eingabeaufforderung (cmd) oder PowerShell und prüfst:

node --version
npm --version

Installiere jetzt das Claude Code CLI-Paket. Führe folgenden Befehl in einer Administrator-PowerShell aus:

npm install -g @anthropic-ai/claude-code

Falls npm mit einem Berechtigungsfehler abbricht, liegt das an der Standard-Execution-Policy von PowerShell. Setze sie temporär auf RemoteSigned:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Lade danach den Windows-Installer (claude-code-desktop-setup.exe) von der Anthropic-Website herunter. Führe die .exe-Datei aus – der NSIS-Installer führt dich durch Lizenzvereinbarung, Installationsverzeichnis und Startmenü-Eintrag. Der Standard-Installationspfad lautet:

C:\Users\<Benutzername>\AppData\Local\Programs\Claude Code Desktop

Nach Abschluss startest du Claude Code Desktop über das Startmenü oder den Desktop-Shortcut. Beim ersten Start gibst du deinen API-Schlüssel ein. Windows speichert ihn über Windows Credential Manager – du musst ihn nicht bei jedem Start neu eingeben.

WSL-Integration aktivieren

Wenn du WSL 2 auf deinem System hast, aktiviere die WSL-Integration direkt in den Einstellungen von Claude Code Desktop. Gehe zu „Settings → Terminal → Shell” und wähle „WSL (Ubuntu)” als Standard-Shell. Die App öffnet dann alle Terminal-Sitzungen innerhalb der Linux-Umgebung.

Das ist besonders nützlich, wenn du mit Python-Umgebungen, Docker-Containern oder Build-Tools arbeitest, die unter Linux besser laufen. Claude Code sieht das WSL-Dateisystem direkt und kann Befehle ohne Umwege ausführen:

wsl --install -d Ubuntu-24.04
wsl --set-default Ubuntu-24.04

Vom CLI zu Claude Code Desktop wechseln

Wer Claude Code bisher ausschließlich im Terminal genutzt hat, fragt sich zu Recht: Lohnt sich der Wechsel? Die Antwort hängt davon ab, wie du arbeitest. Für manche Teams ist die Desktop-App ein echter Produktivitätsgewinn – für andere Entwickler bleibt die CLI die schnellere Wahl.

Was sich gegenüber der reinen CLI-Nutzung ändert

Im Terminal startest du Claude Code mit einem Befehl in einem Verzeichnis:

cd /pfad/zum/projekt
claude

Das funktioniert, hat aber Grenzen: Du siehst immer nur eine Session, Konfigurationen tippst du manuell, und Verbindungen zu Remote-Servern musst du vorher per SSH aufbauen. Claude Code Desktop löst diese drei Punkte.

Die Sitzungsverwaltung ist der größte Unterschied. In der Desktop-App siehst du alle offenen und gespeicherten Sessions in einer Seitenleiste. Du wechselst zwischen ihnen per Klick, ohne das Terminal zu wechseln oder neue Tabs zu öffnen. Jede Session hat einen eigenen Kontext, und du kannst sie mit einem Namen beschriften – etwa „Backend-Refactoring” oder „Deploy-Pipeline-Debug”.

Die Konfiguration wird grafisch statt über Dateien verwaltet. In der CLI pflegst du Einstellungen in einer CLAUDE.md-Datei im Projektstamm oder in der globalen ~/.claude/settings.json. Claude Code Desktop liest diese Dateien weiterhin, bietet aber zusätzlich ein UI zum Bearbeiten der häufigsten Optionen.

Unterschiede zwischen CLI und Desktop-App im direkten Vergleich

Bestehende Projekte migrieren

Du musst nichts migrieren – Claude Code Desktop erkennt bestehende Konfigurationsdateien automatisch. Wenn du ein Projekt öffnest, liest die App die vorhandene CLAUDE.md und lädt alle darin definierten Systembefehle und Kontextinformationen.

Öffne ein vorhandenes Projekt über „File → Open Project” und navigiere zum Projektordner. Claude Code Desktop erstellt einen neuen Datenbankeintrag und verknüpft ihn mit dem Pfad. Die nächsten Male erscheint das Projekt in der Seitenleiste und du öffnest es per Klick.

Deine globale ~/.claude/settings.json bleibt unverändert aktiv. Einstellungen, die du dort definiert hast – etwa erlaubte Shell-Befehle oder gespeicherte Slash-Commands – greifen weiterhin in jeder Session. Du kannst sie zusätzlich über das Desktop-Interface bearbeiten.

Remote-Sessions und Server-Verbindungen einrichten

Remote-Server-Unterstützung gehört zu den stärksten Features von Claude Code Desktop. Du verbindest dich mit Produktions- oder Staging-Servern, ohne das Desktop-Interface zu verlassen. Claude kann dann direkt im Dateisystem des Servers arbeiten, Logs lesen und Befehle ausführen.

SSH-Verbindungen zu Remote-Servern aufbauen

Gehe zu „Settings → Remote Connections → Add Server”. Du gibst folgende Daten ein:

• Hostname: IP-Adresse oder Domain des Servers (z.B. 192.168.1.100 oder server.example.com)
• Port: Standard ist 22, bei abweichenden SSH-Ports entsprechend anpassen
• Benutzername: Dein SSH-Login auf dem Zielserver
• Authentifizierungsmethode: SSH-Key (empfohlen) oder Passwort
• Startverzeichnis: Pfad, in dem Claude Code auf dem Server startet

Für SSH-Key-Authentifizierung wählst du deinen privaten Schlüssel aus dem lokalen .ssh-Verzeichnis. Claude Code Desktop unterstützt RSA-, ECDSA- und Ed25519-Schlüssel. Passwort-gesicherte Keys entsperrst du einmalig beim Verbindungsaufbau.

Damit die Verbindung funktioniert, muss Claude Code auf dem Remote-Server installiert sein. Verbinde dich zunächst manuell per SSH und installiere das Paket:

ssh [email protected]
npm install -g @anthropic-ai/claude-code

Claude Code Desktop tunnelt dann die Kommunikation über die SSH-Verbindung. Der API-Schlüssel kommt von deinem lokalen Rechner – du musst ihn nicht auf dem Server hinterlegen. Das Modell läuft vollständig remote: Claude sieht das Server-Dateisystem, liest Konfigurationsdateien und führt Befehle direkt auf der Maschine aus.

SSH-Config für schnelleren Verbindungsaufbau

Wenn du mehrere Server verwaltest, lohnt es sich, die SSH-Konfigurationsdatei zu pflegen. Claude Code Desktop liest ~/.ssh/config und bietet gespeicherte Hosts automatisch als Auswahlmöglichkeit an:

Host prod-server
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519_prod
  Port 2222

Host staging
  HostName 203.0.113.20
  User dev
  IdentityFile ~/.ssh/id_ed25519_staging

Nach dem Speichern erscheinen „prod-server” und „staging” direkt in der Server-Auswahlliste von Claude Code Desktop. Ein Klick baut die Verbindung auf und startet eine neue Sitzung im konfigurierten Startverzeichnis.

Mehrere Sitzungen gleichzeitig verwalten

Claude Code Desktop erlaubt unbegrenzt viele parallele Sitzungen – lokal wie remote. Du findest alle offenen Sessions in der linken Seitenleiste. Per Klick springst du zwischen ihnen hin und her, ohne Kontext zu verlieren.

Eine typische Arbeitsumgebung sieht so aus: Links läuft eine lokale Session für Entwicklungsarbeit, rechts daneben eine Session auf dem Staging-Server für Tests, und eine dritte Session verbindet sich mit dem Produktionssystem für Log-Analyse. Du wechselst zwischen allen dreien per Klick in der Seitenleiste.

Jede Sitzung hat einen eigenen Token-Zähler. Du siehst auf einen Blick, wie viel Kontext in jeder Session verbraucht ist. Wenn eine Session den Kontextlimit nähert, startest du eine neue – dein Projekt bleibt dabei erhalten, nur der Gesprächsverlauf beginnt von vorn.

Persistente Sessions und automatische Wiederverbindung

Wenn die Netzwerkverbindung zu einem Remote-Server abbricht, zeigt Claude Code Desktop einen Verbindungsstatus-Indikator in der Sitzungsleiste. Per Klick auf „Reconnect” baut die App die SSH-Verbindung neu auf und setzt die Session fort – ohne dass du manuell eingreifen musst.

Sessions auf Remote-Servern laufen als tmux- oder screen-Prozesse, falls du das so konfigurierst. Das verhindert, dass laufende Operationen beim Verbindungsabbruch abgebrochen werden. In den Server-Einstellungen aktivierst du unter „Session Persistence → Use tmux” diese Option:

tmux new-session -d -s claude-session
tmux attach-session -t claude-session

Einstellungen und Konfiguration im Überblick

Der Einstellungsbereich von Claude Code Desktop teilt sich in vier Hauptbereiche: General, Models, Terminal und Remote Connections. Du erreichst ihn über das Menü „Claude Code → Preferences” auf macOS oder „Edit → Settings” unter Windows.

Arbeitsumgebung anpassen

Unter „General” stellst du das Theme (Hell/Dunkel/System), die Schriftgröße im Chat-Bereich und das Standardverhalten beim Start ein. Du entscheidest, ob Claude Code Desktop beim Systemstart automatisch öffnet, ob es im System-Tray minimiert bleibt und welches Projekt beim Start geladen wird.

Die Terminal-Einstellungen betreffen die integrierte Shell. Auf macOS wählst du zwischen zsh, bash und fish. Unter Windows stehen cmd, PowerShell und WSL zur Verfügung. Die Schriftart für den Terminal-Bereich lässt sich unabhängig vom Rest der App konfigurieren – das ist nützlich, wenn du eine monospace-Schrift bevorzugst, die Icons aus der Nerd Fonts-Sammlung darstellt:

# Beispiel: Nerd Font für Terminal-Icons
Font: "JetBrainsMono Nerd Font"
Font Size: 13
Line Height: 1.4

API-Schlüssel und Modelle konfigurieren

Unter „Models” verwaltest du alle API-Verbindungen. Der Anthropic API-Schlüssel steht ganz oben. Darunter wählst du das Standardmodell für neue Sitzungen. Claude Code Desktop unterstützt alle aktuellen Anthropic-Modelle:

• claude-opus-4: Maximale Intelligenz für komplexe Architekturentscheidungen und tiefes Code-Verständnis
• claude-sonnet-4: Ausgewogenes Verhältnis von Leistung und Geschwindigkeit für den täglichen Entwicklungseinsatz
• claude-haiku-3-5: Schnelle Antworten für einfache Aufgaben wie Syntaxprüfung oder kurze Erklärungen

Du kannst den Modellwechsel auch pro Session vornehmen, ohne die Einstellungen zu öffnen. Das Modell-Dropdown sitzt oben im Chat-Bereich. Modellwechsel mitten in einer Session übernehmen den bisherigen Kontext.

Benutzerdefinierte Basis-URL für alternative Endpunkte

Wenn du eigene Anthropic-kompatible Endpunkte nutzt – etwa für interne Unternehmensdeployments oder Proxy-Setups – trägst du die Basis-URL unter „Models → Custom Base URL” ein:

https://your-proxy.example.com/v1

Die App schickt alle API-Anfragen an diese Adresse statt an api.anthropic.com. Das ist besonders relevant für Unternehmen, die ausgehenden Traffic über eigene Gateway-Server routen. Zur nahtlosen Integration in bestehende Workflow-Automatisierungen kannst du diesen Endpunkt auch in CI/CD-Pipelines einbinden.

Slash-Commands und benutzerdefinierte Befehle

Claude Code Desktop unterstützt dieselben Slash-Commands wie die CLI. Du tippst im Chat-Bereich / und siehst eine Autovervollständigung aller verfügbaren Befehle. Eigene Commands legst du in ~/.claude/commands/ als Markdown-Dateien an:

mkdir -p ~/.claude/commands
cat > ~/.claude/commands/deploy.md << 'EOF'
Führe einen vollständigen Deployment-Check durch:
1. Alle Tests ausführen
2. Build erstellen
3. Docker-Image bauen und taggen
4. Deployment-Log der letzten Session prüfen
EOF

Nach dem Erstellen erscheint /deploy in der Autovervollständigung jeder neuen Session. Claude führt den definierten Ablauf aus, wenn du den Command eingibst.

Wofür solltest du Claude Code Desktop nutzen?

Claude Code Desktop ist kein universelles Werkzeug für jeden Entwicklungsschritt. Es entfaltet seinen Nutzen in spezifischen Szenarien – besonders wenn du mehrere Kontexte gleichzeitig brauchst oder regelmäßig auf Remote-Systemen arbeitest.

Szenarien, in denen die Desktop-App gewinnt

Multi-Server-Deployments gehören zu den stärksten Use-Cases. Du koordinierst Änderungen auf drei verschiedenen Servern, ohne das Fenster zu wechseln. Jede Session hat ihren eigenen Kontext und ihre eigene Serververbindung. Claude kennt in Server-A-Session die Produktionsdatenbank, in Server-B-Session den Staging-Stack.

Code-Reviews über mehrere Repositories laufen in der Desktop-App effizienter als in der CLI. Du öffnest für jedes Repository eine eigene Session und springst zwischen den Analysen hin und her. Der Kontext bleibt erhalten – du musst nicht neu laden oder Dateinamen erneut eingeben.

Für Teams, die Claude Code in ihre tägliche Arbeitsumgebung integrieren wollen, senkt die Desktop-App die Einstiegshürde. Entwickler, die weniger CLI-Erfahrung haben, finden sich im grafischen Interface schneller zurecht. Die Befehle und Fähigkeiten sind identisch – nur der Zugang ist zugänglicher.

Wenn die CLI die bessere Wahl bleibt

Automatisierte Skripte und CI/CD-Pipelines nutzen ausschließlich die CLI. Claude Code Desktop ist eine interaktive Anwendung, kein Kommandozeilenwerkzeug für Batch-Verarbeitung. Wenn du Claude Code in GitHub Actions oder Deployment-Skripten einsetzt, tust du das weiterhin über das CLI-Paket:

claude --print "Analysiere die Änderungen in diesem Commit" --no-interactive

Serverless-Environments und Container-Deployments laufen ebenfalls ohne Desktop-App. Dort installierst du nur das npm-Paket und rufst Claude Code über die Kommandozeile auf. Die Desktop-App ist für lokale und interaktive Nutzung ausgelegt.

Integration in bestehende Entwicklungsumgebungen

Claude Code Desktop ersetzt keine IDE. Es ergänzt sie. Du arbeitest in VS Code, öffnest parallel Claude Code Desktop für tiefgehende Analysen oder Refactoring-Sessions. Viele Entwickler nutzen beide nebeneinander: VS Code für das Schreiben von Code, Claude Code Desktop für komplexere Fragen an die Codebasis.

Die VS Code-Extension für Claude Code bleibt nutzbar, wenn du Claude Code Desktop installiert hast. Beide greifen auf dasselbe npm-Paket zurück und teilen die globale Konfiguration. Du entscheidest pro Aufgabe, welches Interface du bevorzugst. Wenn du mehr über KI-Unterstützung im Entwickleralltag erfahren möchtest, findest du unter KI-Unterstützung für Entwicklerteams weitere Ansätze für die praktische Integration.

Häufige Probleme und Lösungen

Installation und erste Nutzung verlaufen meistens reibungslos – aber es gibt typische Stolperfallen, die sich wiederholen. Hier sind die häufigsten Probleme und wie du sie behebst.

Installation schlägt fehl oder App startet nicht

Auf macOS blockiert Gatekeeper manchmal den Start. Die Lösung: Öffne „Systemeinstellungen → Datenschutz & Sicherheit" und scrolle nach unten zum Hinweis auf Claude Code Desktop. Klicke „Dennoch öffnen". Alternativ geht das über das Terminal:

xattr -cr /Applications/Claude\ Code\ Desktop.app

Unter Windows schlägt die Installation fehl, wenn der Benutzer keine Administratorrechte hat. Klicke die .exe-Datei mit Rechtsklick an und wähle „Als Administrator ausführen". Falls Windows Defender die Datei blockiert, prüfe den SHA256-Hash der heruntergeladenen Datei gegen die offizielle Prüfsumme auf der Anthropic-Website.

Wenn die App startet, aber sofort abstürzt, fehlt oft eine Node.js-Version. Prüfe:

# macOS / Linux
node --version  # Muss 18+ sein

# Windows PowerShell
node --version

API-Schlüssel wird nicht akzeptiert

Das häufigste Problem: Der API-Schlüssel hat kein ausreichendes Guthaben oder die falsche Berechtigung. Prüfe in der Anthropic Console, ob der Schlüssel aktiv ist und ob dein Account-Guthaben ausreicht. Claude Code benötigt Zugriff auf die Messages-API – nicht auf alle API-Produkte.

Wenn der Schlüssel korrekt ist, aber trotzdem abgelehnt wird, liegt das manchmal an einem gespeicherten falschen Schlüssel in der Keychain. Lösche den gespeicherten Eintrag:

# macOS: Keychain-Eintrag entfernen
security delete-generic-password -a "claude-code" -s "api-key"

# Windows: Credential Manager
cmdkey /delete:claude-code-api-key

Danach startest du Claude Code Desktop neu und gibst den Schlüssel erneut ein.

Remote-Server-Verbindung schlägt fehl

Verbindungsfehler zu Remote-Servern haben meist eine von drei Ursachen: falscher SSH-Port, veralteter Host-Key oder fehlendes Claude Code auf dem Zielserver.

Prüfe zunächst, ob die manuelle SSH-Verbindung funktioniert:

ssh -v [email protected] -p 2222

Das -v-Flag gibt ausführliche Debug-Informationen aus. Wenn die manuelle Verbindung funktioniert, aber Claude Code Desktop nicht verbindet, prüfe ob Node.js und Claude Code auf dem Server erreichbar sind:

ssh [email protected] "which claude && claude --version"

Falls claude nicht gefunden wird, installiere es erneut auf dem Server. Falls Node.js fehlt, installiere es zuerst:

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

Sitzungen werden nicht gespeichert oder gehen verloren

Claude Code Desktop speichert Sitzungsverläufe in einer SQLite-Datenbank unter:

• macOS: ~/Library/Application Support/Claude Code Desktop/sessions.db
• Windows: %APPDATA%\Claude Code Desktop\sessions.db

Wenn Sessions verschwinden, ist die Datenbank möglicherweise korrupt. Schließe die App und prüfe die Datei:

sqlite3 ~/Library/Application\ Support/Claude\ Code\ Desktop/sessions.db ".tables"

Gibt der Befehl einen Fehler zurück, ist die Datenbank defekt. Benenne die Datei um und starte Claude Code Desktop neu – die App erstellt eine neue, leere Datenbank:

mv ~/Library/Application\ Support/Claude\ Code\ Desktop/sessions.db \
   ~/Library/Application\ Support/Claude\ Code\ Desktop/sessions.db.bak

Hoher Speicher- oder CPU-Verbrauch

Claude Code Desktop ist eine Electron-App – Speicherverbrauch um 300–500 MB ist normal. Bei deutlich höherem Verbrauch (über 1 GB) prüfe, wie viele Sessions gleichzeitig offen sind. Jede aktive Session belegt Arbeitsspeicher für den Konversationskontext.

Schließe Sessions, die du nicht mehr brauchst. Unter „File → Session Manager" siehst du alle offenen und gespeicherten Sitzungen mit ihrem Speicherbedarf. Veraltete Sessions löschst du mit Rechtsklick → „Delete Session".

FAQ zu Claude Code Desktop

Was kostet Claude Code Desktop?

Die Desktop-App ist kostenlos und gehört zum Claude Code Ökosystem von Anthropic. Du zahlst ausschließlich für die API-Nutzung nach dem Token-Verbrauch deiner Sitzungen. Die Preise richten sich nach dem gewählten Modell und der Anzahl der Input- und Output-Tokens pro Anfrage. Eine Preisübersicht findest du in der Anthropic Console.

Kann ich Claude Code Desktop ohne Internetverbindung nutzen?

Nein. Alle Modellabfragen gehen über die Anthropic-API ins Internet. Claude Code Desktop funktioniert nicht offline. Für Remote-Server-Verbindungen benötigst du zusätzlich eine stabile Netzwerkverbindung zum Zielserver. Eine lokale Modellausführung ist aktuell nicht vorgesehen.

Wie viele Sessions kann ich gleichzeitig öffnen?

Claude Code Desktop setzt keine technische Obergrenze für parallele Sitzungen. Die praktische Grenze liegt bei deinem verfügbaren RAM. Jede Session belegt ungefähr 50–150 MB Arbeitsspeicher, je nach Konversationslänge. Auf einem Rechner mit 16 GB RAM laufen problemlos 8–10 aktive Sessions gleichzeitig.

Unterstützt Claude Code Desktop alle Programmiersprachen?

Ja. Claude Code ist sprachagnostisch – es liest, schreibt und erklärt Code in jeder Sprache, die das Modell kennt. Das umfasst alle gängigen Sprachen wie Python, JavaScript, TypeScript, Go, Rust, Java, C++, Ruby, PHP und viele mehr. Die Desktop-App fügt keine Sprachbeschränkungen hinzu.

Wie aktualisiere ich Claude Code Desktop auf die neueste Version?

Die App prüft beim Start automatisch auf neue Versionen und zeigt einen Update-Hinweis an. Du kannst die Prüfung auch manuell auslösen über „Claude Code → Check for Updates" (macOS) oder „Help → Check for Updates" (Windows). Homebrew-Nutzer auf macOS aktualisieren mit:

brew upgrade --cask claude-code-desktop

Nach einem Update musst du außerdem das npm-Paket aktualisieren, falls eine neue CLI-Version erschienen ist:

npm update -g @anthropic-ai/claude-code

Kann ich Claude Code Desktop mit VS Code verwenden?

Beide Tools laufen parallel nebeneinander. Claude Code Desktop und die VS Code-Extension greifen auf dieselbe globale Konfiguration zurück. Eine direkte Integration zwischen den beiden Anwendungen gibt es nicht – du arbeitest entweder im VS Code-Interface oder im Desktop-Interface. Viele Entwickler nutzen VS Code zum Schreiben und Claude Code Desktop für Analyse- und Refactoring-Sessions über größere Codebasen.

Ist der API-Schlüssel sicher gespeichert?

Ja. Claude Code Desktop nutzt den systemeigenen Schlüsselbund – Keychain auf macOS und Windows Credential Manager unter Windows. Der API-Schlüssel liegt nicht im Klartext in einer Konfigurationsdatei. Er verlässt deinen Rechner nur als HTTP-Header bei API-Anfragen an Anthropic, verschlüsselt via TLS.

Kann ich Claude Code Desktop in einer Docker-Umgebung betreiben?

Die Desktop-App ist für lokale Installationen auf echten Betriebssystemen ausgelegt und läuft nicht ohne grafische Oberfläche in reinen Docker-Containern. Das CLI-Paket eignet sich für containerisierte Deployments. Du installierst es im Dockerfile und rufst es über die Kommandozeile auf:

FROM node:20-slim
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=""
CMD ["claude", "--print", "Analysiere das Projekt"]