46 46
47Bevor Sie Ihre erste Nachricht senden, konfigurieren Sie vier Dinge im Eingabebereich:47Bevor Sie Ihre erste Nachricht senden, konfigurieren Sie vier Dinge im Eingabebereich:
48 48
49* **Umgebung**: Wählen Sie, wo Claude ausgeführt wird. Wählen Sie **Lokal** für Ihren Computer, **Cloud** für eine [Cloud-Sitzung](#cloud-sessions), die nach dem Schließen der App fortgesetzt wird, eine [**SSH-Verbindung**](#ssh-sessions) für einen von Ihnen verwalteten Remote-Computer oder unter Windows eine [**WSL-Distribution**](/docs/de/desktop-wsl). Siehe [Umgebungskonfiguration](#environment-configuration).49* **Umgebung**: Wählen Sie, wo Claude ausgeführt wird. Wählen Sie **Lokal** für Ihren Computer, **Cloud** für eine [Cloud-Sitzung](#cloud-sessions), die nach dem Schließen der App fortgesetzt wird, eine [**SSH-Verbindung**](#ssh-sessions) für einen von Ihnen verwalteten Remote-Computer oder unter Windows eine [**WSL-Distribution**](/docs/de/desktop-wsl). Eine Aufgabe in einer SSH-Sitzung kann [weiterlaufen, während Desktop getrennt ist](#keep-a-task-running-while-desktop-is-disconnected), kann bei einem Claude-Konto jedoch anhalten, wenn dessen Anmeldung abläuft. Siehe [Umgebungskonfiguration](#environment-configuration).
50* **Projektordner**: Wählen Sie den Ordner oder das Repository aus, in dem Claude arbeitet. Für Cloud-Sitzungen können Sie [mehrere Repositories](#run-long-running-tasks-in-the-cloud) hinzufügen.50* **Projektordner**: Wählen Sie den Ordner oder das Repository aus, in dem Claude arbeitet. Für Cloud-Sitzungen können Sie [mehrere Repositories](#run-long-running-tasks-in-the-cloud) hinzufügen.
51* **Modell**: Wählen Sie ein [Modell](/docs/de/model-config#available-models) aus dem Dropdown neben der Schaltfläche „Senden“. Sie können dies während der Sitzung ändern.51* **Modell**: Wählen Sie ein [Modell](/docs/de/model-config#available-models) aus dem Dropdown neben der Schaltfläche „Senden“. Sie können dies während der Sitzung ändern.
52* **Berechtigungsmodus**: Wählen Sie, wie viel Autonomie Claude aus dem [Moduswahlschalter](#choose-a-permission-mode) hat. Sie können dies während der Sitzung ändern.52* **Berechtigungsmodus**: Wählen Sie, wie viel Autonomie Claude aus dem [Moduswahlschalter](#choose-a-permission-mode) hat. Sie können dies während der Sitzung ändern.
236 Führen Sie Befehle im Terminal aus236 Führen Sie Befehle im Terminal aus
237</h3>237</h3>
238 238
239Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Klicken Sie in der Titelleiste der Sitzung auf **Terminal** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Um eine zweite Terminal-Registerkarte zu öffnen, klicken Sie auf **+** in der Terminal-Pane-Kopfzeile oder klicken Sie mit der rechten Maustaste auf einen Ordner im Chat, um **Im Terminal öffnen** zu wählen. Das Terminal ist in lokalen und [SSH](#ssh-sessions)-Sitzungen verfügbar.239Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Klicken Sie in der Titelleiste der Sitzung auf **Terminal** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Um eine zweite Terminal-Registerkarte zu öffnen, klicken Sie auf **+** in der Terminal-Pane-Kopfzeile oder klicken Sie mit der rechten Maustaste auf einen Ordner im Chat, um **Im Terminal öffnen** zu wählen.
240
241Das Terminal ist in lokalen und [SSH](#ssh-sessions)-Sitzungen verfügbar, mit einer Einschränkung auf [Windows-Remote-Rechnern](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Öffnen und bearbeiten Sie Dateien244 Öffnen und bearbeiten Sie Dateien
468 470
469Siehe [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web) für mehr darüber, wie Cloud-Sitzungen funktionieren. Wenn ein Körper von Arbeit viele Cloud-Sitzungen benötigt, wählen Sie **Projekte** in der Seitenleiste, um ein [Projekt](/docs/de/claude-projects) zu erstellen, in dem Claude die Sitzungen für Sie aus einem Gespräch heraus startet und verfolgt.471Siehe [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web) für mehr darüber, wie Cloud-Sitzungen funktionieren. Wenn ein Körper von Arbeit viele Cloud-Sitzungen benötigt, wählen Sie **Projekte** in der Seitenleiste, um ein [Projekt](/docs/de/claude-projects) zu erstellen, in dem Claude die Sitzungen für Sie aus einem Gespräch heraus startet und verfolgt.
470 472
473<Note>
474 Eine Aufgabe in einer [SSH-Sitzung](#ssh-sessions) kann ebenfalls [weiterlaufen, während Desktop getrennt ist](#keep-a-task-running-while-desktop-is-disconnected), kann jedoch mit einem Claude-Konto anhalten, wenn ihre Anmeldung abläuft.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Fortsetzen auf einer anderen Oberfläche478 Fortsetzen auf einer anderen Oberfläche
473</h3>479</h3>
772 778
773* **Lokal**: läuft auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien779* **Lokal**: läuft auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien
774* **Cloud**: läuft standardmäßig auf Anthropic-verwalteter Infrastruktur. Sitzungen werden fortgesetzt, auch wenn Sie die App schließen.780* **Cloud**: läuft standardmäßig auf Anthropic-verwalteter Infrastruktur. Sitzungen werden fortgesetzt, auch wenn Sie die App schließen.
775* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container781* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container. Eine laufende Aufgabe kann [weiterlaufen, während Desktop nicht verbunden ist](#keep-a-task-running-while-desktop-is-disconnected), mit einem Claude-Konto kann sie jedoch stoppen, wenn ihre Anmeldung abläuft.
776* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/docs/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade782* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/docs/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813SSH-Sitzungen ermöglichen es Ihnen, Claude Code auf einem Remote-Computer auszuführen, während Sie die Desktop-App als Ihre Schnittstelle verwenden. Dies ist nützlich für die Arbeit mit Codebases, die auf Cloud-VMs, Dev-Containern oder Servern mit spezifischer Hardware oder Abhängigkeiten vorhanden sind.819SSH-Sitzungen ermöglichen es Ihnen, Claude Code auf einem Remote-Computer auszuführen, während Sie die Desktop-App als Ihre Schnittstelle verwenden. Dies ist nützlich für die Arbeit mit Codebases, die auf Cloud-VMs, Dev-Containern oder Servern mit spezifischer Hardware oder Abhängigkeiten vorhanden sind.
814 820
821<Note>
822 Wenn Sie Desktop mit einem [Drittanbieter](/docs/de/third-party-integrations) verwenden, benötigen SSH-Sitzungen eine eigene Einrichtung. Siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Um eine SSH-Verbindung hinzuzufügen, öffnen Sie vor dem Starten einer Sitzung das Umgebungs-Dropdown im Eingabefeld, wählen Sie dann **SSH > Add SSH connection…** und füllen Sie die Verbindungsdetails aus:825Um eine SSH-Verbindung hinzuzufügen, öffnen Sie vor dem Starten einer Sitzung das Umgebungs-Dropdown im Eingabefeld, wählen Sie dann **SSH > Add SSH connection…** und füllen Sie die Verbindungsdetails aus:
816 826
817* **Name**: ein freundlicher Bezeichner für diese Verbindung827* **Name**: ein freundlicher Bezeichner für diese Verbindung
822 832
823Nach dem Hinzufügen wird die Verbindung im Umgebungs-Dropdown unter **SSH** angezeigt. Wählen Sie sie aus, um eine Sitzung auf diesem Computer zu starten. Claude läuft auf dem Remote-Computer mit Zugriff auf seine Dateien und Tools.833Nach dem Hinzufügen wird die Verbindung im Umgebungs-Dropdown unter **SSH** angezeigt. Wählen Sie sie aus, um eine Sitzung auf diesem Computer zu starten. Claude läuft auf dem Remote-Computer mit Zugriff auf seine Dateien und Tools.
824 834
825Der Remote-Computer muss Linux oder macOS ausführen. Die Desktop-App installiert Claude Code auf dem Remote-Computer automatisch beim ersten Verbindungsaufbau. Nach der Verbindung unterstützen SSH-Sitzungen Berechtigungsmodi, Konnektoren, Plugins und MCP-Server.835Auf dem Remote-Computer kann Linux, macOS oder [Windows](#windows-remote-machines) laufen. Desktop installiert Claude Code auf dem Remote-Computer automatisch beim ersten Verbindungsaufbau. Nach der Verbindung unterstützen SSH-Sitzungen Berechtigungsmodi, Konnektoren, Plugins und MCP-Server.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Anforderungen an den Remote-Computer für SSH-Sitzungen
839</h4>
840
841Ein Linux- oder macOS-Remote-Computer benötigt einen unterstützten Prozessor, einen SSH-Server mit SFTP, einen Installationsordner, der nicht mit `noexec` eingehängt ist, eine funktionierende Shell und Netzwerkzugriff. Prüfen Sie jede Anforderung, bevor Sie sich verbinden oder wenn eine Verbindung nach der Anmeldung fehlschlägt:
842
843* **System**: ein x86\_64- oder arm64-Prozessor. Der Computer muss außerdem die [Systemanforderungen](/docs/de/setup#system-requirements) von Claude Code erfüllen.
844* **SFTP**: Der SSH-Server muss das SFTP-Subsystem anbieten, das durch eine Zeile `Subsystem sftp` in seiner `sshd_config` aktiviert wird. Verbinden Sie sich zur Überprüfung in einem Terminal auf Ihrem Computer mit `sftp` mit demselben Host und Port. Ein funktionierender Server zeigt die Eingabeaufforderung `sftp>` an.
845* **Sitzungen pro Verbindung**: Desktop unter macOS und Linux öffnet mehrere Sitzungen über eine SSH-Verbindung. Wenn die `sshd_config` des Servers `MaxSessions 1` festlegt, erhöhen Sie den Wert, zum Beispiel auf den OpenSSH-Standard von 10.
846* **Installationsordner**: Desktop installiert ein Hilfsprogramm und Claude Code unter `~/.claude/remote/` in Ihrem Home-Verzeichnis. Es führt sie von dort aus, daher darf dieser Ordner nicht auf einem mit `noexec` eingehängten Dateisystem liegen. Planen Sie etwa 1 GB Speicherplatz im Home-Verzeichnis jedes Benutzers ein, der sich verbindet.
847* **Shell**: Die für Ihr Konto auf dem Remote-Computer festgelegte Shell muss über SSH gesendete Befehle ausführen, wie es Bash, Zsh und `sh` tun
848* **Netzwerk**: Claude Code läuft auf dem Remote-Computer und stellt seine Netzwerkanfragen von dort aus, daher benötigt der Computer den [Netzwerkzugriff, den Claude Code erfordert](/docs/de/network-config#network-access-requirements). Wenn der Computer Claude Code nicht herunterladen kann, lädt Desktop es auf Ihren Computer herunter und überträgt es hoch. Die übrigen Anfragen von Claude Code gehen weiterhin vom Remote-Computer aus.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Ihre SSH-Konfiguration unter macOS und Linux verwenden
852</h4>
853
854Unter macOS und Linux verbindet sich Desktop, indem es den OpenSSH-Client auf Ihrem Computer ausführt, und verwendet daher Ihre `~/.ssh/config`. Die Verbindung über den OpenSSH-Client erfordert Claude Desktop v1.37937.0 oder höher. Geben Sie im Feld **SSH host** einen `Host`-Namen aus dieser Datei ein, um die Einstellungen seines Eintrags zu verwenden, z. B. `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` und `ProxyCommand`.
855
856Bevor Sie die Verbindung hinzufügen, prüfen Sie den Client und den Eintrag in einem Terminal auf Ihrem Computer:
857
858* **Client-Version**: Führen Sie `ssh -V` aus. Der Client muss OpenSSH 7.6 oder höher sein.
859* **Eintrag**: Führen Sie `ssh` mit dem `Host`-Namen aus, z. B. `ssh devbox`. Wenn das fehlschlägt, korrigieren Sie zuerst den Eintrag.
860
861Sie können die Felder **SSH port** und **SSH key (optional)** leer lassen. Wenn Sie eines ausfüllen, verwendet Desktop es zusammen mit dem Eintrag:
862
863* **SSH port**: Ein Wert hier überschreibt den `Port` des Eintrags
864* **SSH key (optional)**: Desktop bietet die von Ihnen gewählte Schlüsseldatei zusätzlich zum `IdentityFile` des Eintrags und den Schlüsseln in Ihrem SSH-Agenten an
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Einen Computer hinter einem Jump-Host erreichen
868</h5>
869
870Um einen Computer hinter einem Jump-Host, auch Bastion genannt, zu erreichen, setzen Sie `ProxyJump` oder `ProxyCommand` im Eintrag. Der folgende Eintrag erreicht `devbox.internal.example.com` über `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Geben Sie `devbox` im Feld **SSH host** ein.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Den SSH-Verbindungs-Timeout erhöhen
883</h5>
884
885Wenn Ihre SSH-Konfiguration keinen `ConnectTimeout` für den Host festlegt, gibt Desktop `ssh` 30 Sekunden für den Verbindungsaufbau. Bei einem Jump-Host oder einem `ProxyCommand` umfasst diese Zeit die Zeit, die die Route für den Verbindungsaufbau benötigt. Wenn Ihre Route länger braucht, fügen Sie dem Eintrag einen höheren Wert hinzu:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` verwendet den ersten Wert, den es für einen Host findet, daher platzieren Sie den Eintrag oberhalb jedes `Host *`-Eintrags, der `ConnectTimeout` festlegt. Führen Sie zur Bestätigung `ssh -G devbox` in einem Terminal auf Ihrem Computer aus. Die Ausgabe enthält `connecttimeout 120`. Nachdem Sie den Wert geändert haben, beenden Sie Desktop und öffnen Sie es erneut.
896
897<h4 id="windows-remote-machines">
898 Windows-Remote-Computer
899</h4>
900
901Ein Windows-Remote-Computer erfordert Claude Desktop v2.31226.0 oder höher.
902
903Verwenden Sie den OpenSSH Server von Microsoft. Der Computer kann x64 oder ARM64 sein. Die Shell, die der SSH-Server startet, kann `cmd.exe`, Windows PowerShell 5.1 oder Git Bash sein.
904
905Windows-Remote-Computer werden weniger getestet als Linux-Computer. Probieren Sie Ihre eigene Arbeit dort aus, bevor Sie sich darauf verlassen.
906
907Rechnen Sie auf einem Windows-Remote-Computer unter anderem mit diesen Einschränkungen:
908
909* **Terminal**: Das [Terminal](#run-commands-in-the-terminal) öffnet sich nicht in einer Sitzung, deren Ordner ein Windows-Pfad ist, z. B. `C:/projects/app`
910* **Sandbox**: Claude Code läuft dort unter nativem Windows, wo es Befehle ohne Sandbox ausführt. Siehe [wo die Sandbox läuft](/docs/de/sandboxing).
911* **Plugins**: Desktop kopiert kein Plugin, das einen Datei- oder Ordnernamen enthält, den Windows nicht speichern kann, z. B. einen Namen mit `:`. Die Sitzung listet die Plugins auf, die Desktop ausgelassen hat.
912* **MCP-Server**: Auf einigen Windows-Remote-Computern laufen die Aufrufe von Claude an MCP-Server aus `claude_desktop_config.json` über Desktop, sodass Claude deren Tools [nicht aufrufen kann, während Desktop nicht verbunden ist](#limits-while-desktop-is-disconnected). Vor Claude Desktop v2.37337.0 gilt dies für jeden Windows-Remote-Computer.
913* **Worktrees**: Worktrees werden in `<project-root>/.claude/worktrees/` abgelegt. Wenn Sie [einen anderen Ordner wählen](#choose-where-ssh-session-worktrees-go), ignoriert Desktop ihn.
914* **Frühere Nachrichten**: Wenn die Shell des SSH-Servers `cmd.exe` oder Windows PowerShell ist, müssen Sie sich möglicherweise verbinden, bevor Sie die früheren Nachrichten einer Sitzung sehen
915* **Forks**: Wenn die Shell des SSH-Servers `cmd.exe` oder Windows PowerShell ist, können Sie eine Sitzung nur bei ihrer ersten Nachricht forken
916* **Ausführung ohne Verbindung**: Eine Aufgabe [läuft nur dann weiter, während Desktop nicht verbunden ist](#keep-a-task-running-while-desktop-is-disconnected), wenn der SSH-Server einem Programm erlaubt, die Verbindung zu überdauern, die es gestartet hat. Um das herauszufinden, [testen Sie den Remote-Computer](#prepare-a-long-task).
917* **Verbliebene Prozesse**: Prüfen Sie nach dem Ende einer Sitzung den Computer auf Programme, die Claude Code gestartet hat, da sie weiterlaufen können. Das [Hintergrund-Hilfsprogramm](#keep-a-task-running-while-desktop-is-disconnected), das Desktop installiert, beendet sich dort nicht von selbst.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Eine Aufgabe weiterlaufen lassen, während Desktop nicht verbunden ist
921</h4>
922
923Wenn Ihr Computer in den Ruhezustand wechselt, Sie die Netzwerkverbindung verlieren oder Sie Desktop beenden, läuft die Aufgabe weiter, bis sie abgeschlossen ist, Sie benötigt oder eine der [Grenzen](#limits-while-desktop-is-disconnected) erreicht. Das Schließen des Deckels zählt als Ruhezustand. Ein Neustart von Desktop oder Ihres Computers, auch für ein Update, zählt als Beenden.
924
925Claude Code läuft als Prozess auf dem Remote-Computer unter einem Hintergrund-Hilfsprogramm, das Desktop dort installiert, und benötigt daher Ihre SSH-Verbindung nicht, um weiterzulaufen. Das Verhalten in diesem Abschnitt erfordert Claude Desktop v2.31226.0 oder höher.
926
927<Warning>
928 Wenn Sie sich mit einem Claude-Konto bei Desktop anmelden, verlassen Sie sich nicht darauf, dass eine Aufgabe über Nacht läuft. Desktop erneuert diese Anmeldung für die Aufgabe nur, solange Desktop läuft und verbunden ist. Daher kann die Anmeldung der Aufgabe ablaufen, nachdem Sie die Verbindung getrennt haben, und die Aufgabe stoppt dann. Wie viel Zeit beim Trennen noch verbleibt, variiert.
929
930 Die bisher erledigte Arbeit bleibt auf dem Remote-Computer, und Sie können nach Ihrer Rückkehr mit einer Nachricht fortfahren.
931
932 Wenn die Aufgabe die Nacht hindurch laufen muss:
933
934 * [Halten Sie Ihren Computer wach](/docs/de/desktop-scheduled-tasks#how-scheduled-tasks-run) und online, mit geöffnetem Deckel und laufendem Desktop
935 * Verwenden Sie für den Remote-Computer und für jeden Jump-Host auf dem Weg eine Anmeldung, die ohne Abfrage funktioniert, z. B. einen Schlüssel, den Ihr SSH-Agent hält. Desktop kann sich dann nach einem Verbindungsabbruch selbstständig wieder verbinden.
936
937 Für eine Aufgabe, die laufen muss, während Ihr Computer im Ruhezustand oder ausgeschaltet ist, starten Sie stattdessen eine [Cloud-Sitzung](#run-long-running-tasks-in-the-cloud).
938</Warning>
939
940* **Nach Ruhezustand oder Netzwerkverlust**: Sie erhalten die laufende Aufgabe zurück, wenn der Prozess [noch läuft](#limits-while-desktop-is-disconnected) und Desktop sich ohne Abfrage anmelden kann. Wenn nicht, [senden Sie eine Nachricht](#reconnect-after-sleep-or-a-network-loss).
941* **Nach dem Beenden, mit Desktop unter macOS oder Linux und einem Claude-Konto**: Sie erhalten die laufende Aufgabe zurück, wenn Desktop sich [wieder mit dem Prozess verbinden kann](#reopen-a-session-after-you-quit-desktop). Wenn nicht, stoppt die Aufgabe. Wenn sie gestoppt bleibt, senden Sie eine Nachricht.
942* **Nach dem Beenden, mit Desktop unter Windows oder einem [Drittanbieter](/docs/de/third-party-integrations)**: Sie verlieren die laufende Aufgabe, da Desktop den Prozess beendet, wenn die Sitzung geöffnet wird. Senden Sie eine Nachricht, um fortzufahren.
943
944Wenn Sie zurückkommen und die Aufgabe nicht erledigt ist, prüfen Sie, ob gemeldet wird, dass Desktop sich nicht wieder verbinden kann, ob ein Authentifizierungsfehler vorliegt oder ob eine Anfrage wartet:
945
946* **Desktop kann sich nicht wieder verbinden**: Die Sitzung nennt den Grund, und möglicherweise auch eine Benachrichtigung. Eventuell [müssen Sie sich anmelden](#reconnect-after-sleep-or-a-network-loss).
947* **Authentifizierungsfehler**: Das [Anmelde-Token oder die Anmeldedaten](#limits-while-desktop-is-disconnected) sind möglicherweise abgelaufen. Mit einem Claude-Konto senden Sie eine Nachricht, um fortzufahren. Mit einem Drittanbieter siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Wartende Anfrage**: [Beantworten Sie sie](#handle-requests-that-arrive-while-you-are-away)
949* **Nichts davon**: Senden Sie eine Nachricht, um fortzufahren
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Eine lange Aufgabe vorbereiten
955</h5>
956
957* **Zuerst aktualisieren**: Aktualisieren Sie Desktop, bevor Sie eine lange Aufgabe starten. Unter macOS und Windows kann Desktop sich selbstständig neu starten, um ein heruntergeladenes Update zu installieren. Dieser Neustart wartet, während Claude an einer SSH-Aufgabe arbeitet. Unter macOS mit einem Claude-Konto kann der Neustart standardmäßig dennoch erfolgen, sobald das Update 72 Stunden gewartet hat.
958* **Desktop nicht beenden**: Wenn Desktop unter Windows läuft oder einen Drittanbieter verwendet, lassen Sie es geöffnet, während die lange Aufgabe läuft. Nach dem Beenden [beendet es die laufende Aufgabe](#reopen-a-session-after-you-quit-desktop), wenn die Sitzung geöffnet wird. Das Geöffnetlassen schützt keine Anfrage, die [auf Sie wartet](#handle-requests-that-arrive-while-you-are-away).
959* **Anfragen reduzieren**: Wählen Sie einen Berechtigungsmodus, Regeln oder Hooks, die [die Aufgabe seltener auf Sie warten lassen](#handle-requests-that-arrive-while-you-are-away)
960* **Jump-Host prüfen**: Wenn Ihr Jump-Host eine Anmeldung verlangt, z. B. über eine Push-Benachrichtigung auf ein Telefon, wechseln Sie zu einer Anmeldung, die ohne Abfrage funktioniert. Andernfalls kann Desktop bei jedem Versuch, sich wieder zu verbinden, eine weitere Push-Benachrichtigung auslösen.
961* **Remote-Computer testen**: Starten Sie eine kurze Aufgabe, beenden Sie Desktop, während die Aufgabe noch läuft, und öffnen Sie die Sitzung erst deutlich nach dem Zeitpunkt erneut, zu dem die Aufgabe fertig sein sollte. Wenn die Aufgabe nicht abgeschlossen ist und die Sitzung keinen Authentifizierungsfehler zeigt, prüfen Sie den Remote-Computer darauf, [was eine Aufgabe beenden kann](#limits-while-desktop-is-disconnected).
962* **Befehle aus dem Terminal von Desktop heraushalten**: Wenn der Remote-Computer [inaktive Terminals abmeldet](#limits-while-desktop-is-disconnected), führen Sie Ihre eigenen Befehle über eine SSH-Anmeldung außerhalb von Desktop aus
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Grenzen, während Desktop nicht verbunden ist
968</h5>
969
970Eine Aufgabe, die Sie laufen lassen, kann enden, wenn ihre Anmeldung abläuft, wenn der Remote-Computer sie beendet oder wenn das Hilfsprogramm stoppt oder ersetzt wird:
971
972* **Anmelde-Token oder Anmeldedaten**: Mit einem Claude-Konto stoppt die Aufgabe mit einem Authentifizierungsfehler, wenn das Token abläuft. Mit einem Drittanbieter gilt dasselbe für Anmeldedaten, die ablaufen, z. B. solche aus Single Sign-On oder einem Credential Helper. Siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Mit einem Claude-Konto [lassen Sie Desktop laufen und verbunden](#keep-a-task-running-while-desktop-is-disconnected), damit es die Anmeldung erneuern kann.
973* **Der Remote-Computer**: Wenn der Remote-Computer neu startet oder Ihre Prozesse beendet, sobald Ihre SSH-Verbindung geschlossen wird, endet die laufende Aufgabe. Nichts startet sie erneut, während Desktop nicht verbunden ist. Linux-Computer, auf denen `KillUserProcesses` von systemd-logind auf `yes` steht und für Ihren Benutzer gilt, beenden Ihre Prozesse auf diese Weise. Um dort eine Aufgabe weiterlaufen zu lassen, bitten Sie den Administrator, Ihren Benutzer auszunehmen, z. B. mit `KillExcludeUsers`.
974* **Inaktive Terminals**: Einige Linux-Remote-Computer melden ein Terminal ab, in dem für eine festgelegte Zeit niemand tippt (`StopIdleSessionSec` von systemd-logind). Mit Desktop unter macOS oder Linux teilen sich das [Terminal](#run-commands-in-the-terminal) einer Sitzung und `!`-Befehle standardmäßig die SSH-Verbindung von Desktop. Diese Abmeldung beendet dann die Verbindung, während Desktop verbunden ist, und die laufende Aufgabe kann damit enden. Das Schließen des Terminalbereichs verhindert das nicht, daher [halten Sie Befehle aus diesem Terminal heraus](#prepare-a-long-task).
975* **Desktop-Updates**: Wenn ein Update ein neues Hilfsprogramm mitbringt, ersetzt Desktop das Hilfsprogramm auf dem Remote-Computer bei einer späteren Verbindung, was eine noch laufende Aufgabe beenden kann
976* **Lange Abwesenheiten**: Wenn Desktop sich 30 Tage lang nicht mit einem Linux- oder macOS-Remote-Computer verbindet, stoppt das Hilfsprogramm dort und beendet jeden Claude Code-Prozess, der darunter läuft. Verbinden Sie sich vorher.
977
978Dateibearbeitungen und einige Tools können fehlschlagen, während Desktop nicht verbunden ist. Wenn die Aufgabe sie benötigt, halten Sie Desktop verbunden:
979
980* **Worktrees**: In einer Sitzung, die einen [Worktree](#work-in-parallel-with-sessions) verwendet, prüft Desktop jede Dateibearbeitung, bevor Claude sie vornimmt. Während Desktop nicht verbunden ist, wartet jede Bearbeitung etwa 30 Sekunden und schlägt dann fehl. Shell-Befehle laufen weiterhin. Auf einem Linux- oder macOS-Remote-Computer [können Bearbeitungen weiterhin funktionieren](#worktree-edits-while-disconnected). Wenn Sie unsicher sind, starten Sie die Sitzung ohne Worktree.
981* **Ordnerbeschränkungen**: Wenn Ihre Organisation einschränkt, welche Ordner Sitzungen verwenden dürfen, prüft Desktop jedes Lesen, jede Suche und jede Bearbeitung von Dateien, mit oder ohne Worktree. Während Desktop nicht verbunden ist, wartet jeder dieser Vorgänge bis zu 10 Minuten und schlägt dann fehl.
982* **Konnektoren**: [Konnektoren](#connect-external-tools) und andere Tools, die Desktop bereitstellt, laufen über Desktop, daher schlägt jeder Aufruf nach etwa 30 Sekunden fehl, während es nicht verbunden ist
983* **Workflows**: Desktop prüft jeden neuen [Workflow](/docs/de/workflows), bevor er startet, daher wartet ein neuer Workflow, während Desktop nicht verbunden ist, bis zu 10 Minuten und schlägt dann fehl
984* **MCP-Server**: MCP-Server, die Claude Code auf dem Remote-Computer startet, laufen nicht über Desktop, sodass Claude ihre Tools weiterhin aufrufen kann. Server aus `claude_desktop_config.json` gehören nur dann dazu, wenn Desktop nicht seinen [integrierten SSH-Client](#worktree-edits-while-disconnected) verwendet. Andernfalls, und auf [einigen Windows-Remote-Computern](#windows-remote-machines), kann Claude ihre Tools nicht aufrufen, während Desktop nicht verbunden ist.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Wann Bearbeitungen in einem Worktree weiterhin funktionieren">
989 Auf einem Linux- oder macOS-Remote-Computer läuft die Prüfung nicht über Desktop, sodass Bearbeitungen innerhalb des Worktrees weiterhin funktionieren, während Desktop nicht verbunden ist. Vor Claude Desktop v2.37337.0 gilt dies nur für einen Linux-Remote-Computer.
990
991 Bearbeitungen schlagen in einigen Fällen dennoch fehl, darunter diese:
992
993 * **Integrierter SSH-Client**: Desktop verwendet ihn, z. B. bei einer Installation aus dem Microsoft Store, auf einem Windows-Computer ohne Microsofts OpenSSH 9.4 oder höher oder standardmäßig unter Windows mit einem Drittanbieter
994 * **Speicherort des Repositorys**: Das Repository ist Ihr Home-Verzeichnis, ein darüberliegender Ordner oder `~/.claude`
995 * **macOS-Pfade**: Auf einem macOS-Remote-Computer liegt das Repository unter `/Volumes`, oder ein Ordnername im Pfad des Repositorys oder des Worktrees enthält ein `~` oder ein Nicht-ASCII-Zeichen
996 * **Ordnerbeschränkungen**: Ihre Organisation schränkt ein, welche Ordner Sitzungen verwenden dürfen
997 * **Unternehmens-Launcher**: Vor Claude Desktop v2.37337.0: Sie melden sich mit einem Claude-Konto an, und Ihre Organisation startet Claude Code auf dem Remote-Computer über einen [Unternehmens-Launcher](/docs/de/corporate-launcher)
998
999 Eine Sitzung ohne Worktree hat keine solche Prüfung, es sei denn, Ihre Organisation schränkt ein, welche Ordner Sitzungen verwenden dürfen.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Anfragen bearbeiten, die während Ihrer Abwesenheit eingehen
1006</h5>
1007
1008Wenn Claude Ihre Genehmigung benötigt oder Ihnen eine Frage stellt, während Desktop nicht verbunden ist, wartet Claude auf dem Remote-Computer. Das Warten hat keine eigene Zeitbegrenzung. Wenn Desktop sich wieder mit dem Prozess verbindet, zeigt es Ihnen die Anfrage. Wenn Desktop stattdessen einen neuen Prozess startet, verlieren Sie die Anfrage.
1009
1010Während eine Aufgabe auf Sie wartet, kann Desktop sich selbstständig neu starten, z. B. um ein Update zu installieren. Wenn Desktop unter Windows läuft oder einen Drittanbieter verwendet, verlieren Sie die Anfrage nach diesem Neustart.
1011
1012Wenn Sie eine Anfrage verlieren, senden Sie eine Nachricht, um fortzufahren.
1013
1014Um zu reduzieren, wie oft eine Aufgabe anhält, um auf Sie zu warten, und um während Ihrer Abwesenheit von ihr zu hören, richten Sie vorher eine der folgenden Möglichkeiten ein:
1015
1016* **Auto-Modus**: Wählen Sie den [Auto-Modus](#choose-a-permission-mode), wenn [er Ihnen zur Verfügung steht](#auto-mode-availability). Nach wiederholten Blockierungen werden Sie [erneut gefragt](/docs/de/permission-modes#when-auto-mode-falls-back).
1017* **allow-Regeln**: Fügen Sie in Ihrer Benutzereinstellungsdatei auf dem Remote-Computer, `~/.claude/settings.json`, [allow-Regeln](/docs/de/permissions#manage-permissions) für die Befehle hinzu, die die Aufgabe benötigt. Wenn Ihre Organisation [Berechtigungsregeln nur aus verwalteten Einstellungen akzeptiert](/docs/de/settings-reference#allowmanagedpermissionrulesonly), bitten Sie Ihren Administrator, sie den [verwalteten Einstellungen](#managed-settings) hinzuzufügen, die den Remote-Computer erreichen. Zu allow-Regeln in der `.claude/settings.json` eines Projekts siehe [allow-Regeln für Projekte und Workspace-Vertrauen](/docs/de/permissions#project-allow-rules-and-workspace-trust).
1018* **Ein Hook, der antwortet**: Konfigurieren Sie einen [`PermissionRequest`-Hook](/docs/de/hooks#permissionrequest) in `~/.claude/settings.json` auf dem Remote-Computer, um Anfragen an Ihrer Stelle zu erlauben oder abzulehnen
1019* **Ein Hook, der Sie benachrichtigt**: Konfigurieren Sie einen [`Notification`-Hook](/docs/de/hooks#notification) mit dem Matcher `permission_prompt` in derselben Datei, um sich eine Nachricht zu senden, wenn eine Anfrage wartet
1020* **Ein Hook, der Ihnen mitteilt, wann Claude fertig ist**: Konfigurieren Sie einen [`Stop`-Hook](/docs/de/hooks#stop) in derselben Datei, um sich eine Nachricht zu senden, wenn Claude seine Antwort abgeschlossen hat. Er läuft nicht, wenn ein API-Fehler den Turn beendet. Für diesen Fall konfigurieren Sie einen [`StopFailure`-Hook](/docs/de/hooks#stopfailure).
1021
1022Wenn Ihre Organisation [nur verwaltete Hooks ausführt](/docs/de/settings-reference#allowmanagedhooksonly), bitten Sie Ihren Administrator, den Hook den [verwalteten Einstellungen](#managed-settings) hinzuzufügen, die den Remote-Computer erreichen.
1023
1024Claude Code genehmigt [einige Aktionen](/docs/de/permission-modes#actions-no-mode-auto-approves) in keinem Berechtigungsmodus automatisch, auch nicht in Bypass permissions. Je nach Berechtigungsmodus lehnt Claude Code eine solche Aktion ab oder fragt Sie, und die Aufgabe wartet dann auf Ihre Antwort.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Nach Ruhezustand oder Netzwerkverlust wieder verbinden
1030</h5>
1031
1032Wenn Desktop sich bei Ihrer Rückkehr nicht wieder verbunden hat, senden Sie eine Nachricht in der Sitzung. Desktop verbindet sich nur dann selbstständig wieder, wenn es sich ohne Abfrage anmelden kann, z. B. mit einem Schlüssel, den Ihr SSH-Agent hält.
1033
1034* **Gespeichertes Passwort**: Ein Passwort, das Sie von Desktop speichern lassen, funktioniert ebenfalls ohne Abfrage, für eine lange Abwesenheit ist jedoch ein Schlüssel in Ihrem SSH-Agenten vorzuziehen. Wenn Anmeldungen mit diesem Passwort abbrechen oder hängen bleiben, kann Desktop aufhören, sich wieder zu verbinden, und auf Sie warten.
1035* **Jede andere Abfrage**: Wenn der Remote-Computer etwas anderes abfragt, z. B. einen Einmalcode, können Sie eine Benachrichtigung auf Ihrem Computer erhalten. Klicken Sie auf die Benachrichtigung oder senden Sie eine Nachricht in der Sitzung, und Desktop zeigt die Abfrage an.
1036
1037<Accordion title="Wenn ein Jump-Host eine Anmeldung verlangt, der Ausfall lange dauert, Ausgabe fehlt oder der Prozess nicht mehr existiert">
1038 - **Jump-Host, Push-Benachrichtigungen hören während Ihrer Abwesenheit auf**: Das kann mit Desktop unter macOS oder Linux passieren, wenn niemand auf die Anmeldung eines Jump-Hosts antwortet, z. B. eine Push-Benachrichtigung auf ein Telefon. Desktop hört dann auf, sich wieder zu verbinden, solange niemand an Ihrem Computer ist. Wenn Sie den Computer entsperren oder verwenden, können Sie eine weitere Push-Benachrichtigung erhalten, da Desktop es erneut versuchen kann. Nach drei unbeantworteten Versuchen wartet es, bis Sie es erneut versuchen oder eine Nachricht senden.
1039 - **Jump-Host, Push-Benachrichtigungen kommen weiterhin**: Wo Desktop nicht erkennen kann, dass niemand antwortet, wie bei Desktop unter Windows, versucht es weiter, solange es einen Prozess hat, mit dem es sich wieder verbinden kann, unabhängig davon, ob dieser Prozess noch läuft. Sie können bei jedem Versuch eine weitere Push-Benachrichtigung erhalten. Um die Versuche zu beenden, beenden Sie Desktop, was [Sie die laufende Aufgabe kosten kann](#reopen-a-session-after-you-quit-desktop).
1040 - **Langer Ausfall**: Desktop verlangsamt auf etwa einen Versuch alle fünf Minuten. Um sich früher wieder zu verbinden, versuchen Sie es in der Sitzung erneut oder senden Sie eine Nachricht, die Desktop zustellt, sobald es verbunden ist.
1041 - **Fehlende Ausgabe**: Während Desktop nicht verbunden ist, behält das Hilfsprogramm die neueste Claude Code-Ausgabe jeder Sitzung in einem 16-MiB-Puffer und verwirft ältere Ausgabe. Nachdem Desktop sich wieder verbunden hat, kann die Sitzung `Loading recent output from <host>…` anzeigen. Wenn Desktop nicht die gesamte Ausgabe laden kann, sehen Sie die Zeile `Some output produced while you were disconnected may be missing here.` Die Zeile bedeutet nicht, dass die Aufgabe gestoppt wurde.
1042 - **Prozess existiert nicht mehr**: Wenn der Prozess beim erneuten Verbinden nicht mehr existiert, kann Desktop einen neuen aus dem gespeicherten Verlauf der Konversation starten und Claude anweisen, die Aufgabe fortzusetzen. Desktop setzt die Aufgabe nicht selbstständig fort, wenn der Prozess immer wieder endet oder wenn Desktop einen Drittanbieter verwendet. Senden Sie eine Nachricht, um fortzufahren.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Eine Sitzung nach dem Beenden von Desktop erneut öffnen
1049</h5>
1050
1051Nachdem Sie Desktop beendet haben, läuft die Aufgabe auf dem Remote-Computer weiter, bis sie abgeschlossen ist, Sie benötigt oder eine der [Grenzen](#limits-while-desktop-is-disconnected) erreicht.
1052
1053* **Desktop unter macOS oder Linux, mit einem Claude-Konto**: Starten Sie Desktop und öffnen Sie die Sitzung. Sie erhalten die laufende Aufgabe zurück, wenn Desktop sich wieder mit dem Prozess verbinden kann. Das ist nicht immer möglich, z. B. nach manchen Desktop-Updates oder nachdem Ihre Organisation ihre verwalteten Einstellungen geändert hat.
1054* **Unter macOS oder Linux, wenn Desktop sich nicht wieder verbinden kann**: Desktop beendet den Prozess und startet einen neuen aus dem gespeicherten Verlauf der Konversation. Ihre laufende Aufgabe stoppt, und Sie verlieren jede Genehmigung oder Frage, die auf Sie gewartet hat. Nach einem Update kann Desktop Claude dann anweisen, fortzufahren. Wenn die Aufgabe gestoppt bleibt, senden Sie eine Nachricht.
1055* **Desktop unter Windows oder mit einem Drittanbieter auf beliebiger Plattform**: Starten Sie Desktop erst wieder, wenn Sie erwarten, dass die Aufgabe erledigt ist. Sie erhalten die laufende Aufgabe nicht zurück, da Desktop sich nach dem Beenden nie wieder mit dem Prozess verbindet. Es beendet den Prozess, wenn die Sitzung geöffnet wird, was bereits beim Start von Desktop geschehen kann. Senden Sie eine Nachricht, um fortzufahren.
1056
1057Für Bereitstellungen mit Drittanbietern siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Solange der Claude Code-Prozess einer Konversation noch läuft, führen Sie [`claude --resume`](/docs/de/cli-reference#cli-flags) dafür nicht auf dem Remote-Computer aus. Claude Code hält Sie nicht davon ab, und beide Prozesse schreiben dann in dieselbe Konversation. Wenn Sie unsicher sind, fügen Sie `--fork-session` hinzu, womit in einer Kopie der Konversation fortgefahren wird; beide Prozesse arbeiten jedoch weiterhin an denselben Dateien.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Festlegen, wo Worktrees von SSH-Sitzungen abgelegt werden1064 Festlegen, wo Worktrees von SSH-Sitzungen abgelegt werden
8342. [`worktree.location`](/docs/de/settings-reference#worktree-location) in `~/.claude/settings.json` auf dem Remote-Computer10702. [`worktree.location`](/docs/de/settings-reference#worktree-location) in `~/.claude/settings.json` auf dem Remote-Computer
8353. `<project-root>/.claude/worktrees/`, der Standard10713. `<project-root>/.claude/worktrees/`, der Standard
836 1072
837Jedes Projekt erhält einen eigenen Unterordner in dem von Ihnen festgelegten Ordner, sodass der Pfad eines Worktrees bei `~/worktrees` `~/worktrees/<project>-<id>/<worktree-name>` lautet. Wenn der festgelegte Ordner innerhalb des Projekts liegt, ignoriert Desktop ihn für dieses Projekt und verwendet den Standard.1073Jedes Projekt erhält einen eigenen Unterordner in dem von Ihnen festgelegten Ordner, sodass der Pfad eines Worktrees bei `~/worktrees` `~/worktrees/<project>-<id>/<worktree-name>` lautet. Wenn der festgelegte Ordner innerhalb des Projekts liegt, ignoriert Desktop ihn für dieses Projekt und verwendet den Standard. Auf einem [Windows-Remote-Computer](#windows-remote-machines) verwendet Desktop immer den Standard.
838 1074
839Um **Worktree folder** für eine Verbindung festzulegen, die Sie zuvor hinzugefügt haben oder die Ihre Organisation verwaltet, fahren Sie im Umgebungs-Dropdown mit der Maus darüber und klicken Sie auf das Zahnrad-Symbol.1075Um **Worktree folder** für eine Verbindung festzulegen, die Sie zuvor hinzugefügt haben oder die Ihre Organisation verwaltet, fahren Sie im Umgebungs-Dropdown mit der Maus darüber und klicken Sie auf das Zahnrad-Symbol.
840 1076
