Claude Code nach einem SSH-Abbruch weiterlaufen lassen: ein tmux-Rezept
Halte Claude Code nach einem SSH-Abbruch mit tmux am Laufen. Verbinde dich wieder mit demselben Prozess, prüfe die Persistenz und nutze die Opt-in-Einstellung von AgentsRoom.
Der Agent arbeitet auf deinem Server. Du klappst den Laptop zu. Wenn du zurückkommst, gibt es keinen Prozess mehr, zu dem du zurückkehren kannst.
Genau diese Anfrage haben wir bekommen: persistente Remote-Sitzungen, die einen Verbindungsabbruch des Clients überleben, damit man auf einem anderen Rechner weitermachen kann. Unser SSH-Start führte das CLI bereits auf dem Host aus. Das reichte nicht: Der Prozess hing weiterhin vom interaktiven SSH-Terminal ab.
Wir haben die Änderung in AgentsRoom 1.198.0 veröffentlicht. Hier zuerst das manuelle Rezept, dann was die App daraus macht. Dasselbe Lebenszyklusproblem betrifft Claude Code, Codex und andere interaktive Coding-CLIs.
Das Terminal muss die Verbindung überdauern
Unser normaler Remote-Start nutzte einen SSH-Kanal mit angehängtem Terminal. Verschwindet dieser Kanal, kann der Host ein Hangup-Signal senden, und der Agent stirbt. Dass ein Prozess entfernt läuft, macht ihn noch nicht persistent.
tmux gibt dem Prozess ein Terminal, das auf dem Host unabhängig vom Betrachter lebt. Sein Einstiegsleitfaden beschreibt genau diesen Zweck: entfernte Programme vor Verbindungsabbrüchen schützen und von einem anderen Computer aus auf sie zugreifen.
Hier geht es darum, einen Prozess am Leben zu halten. Für die grundsätzliche Wahl zwischen Cloud-Sitzungen, einer Fernsteuerung per Handy und deinem eigenen Server lies die drei Bedeutungen von Remote-Agenten.
tmux vor dem Agenten starten
Verbinde dich auf einem Unix-ähnlichen Host mit deinem üblichen SSH-Alias. Ersetze den Repository-Pfad durch deinen:
ssh my-server
tmux -V
tmux new-session -s coding
cd ~/projects/my-repo
claude
Für Codex nimmst du in der letzten Zeile stattdessen codex. Das CLI muss auf dem Server installiert und angemeldet sein. Fang mit einem Repository an, mit dem du gefahrlos experimentieren kannst.
Trenne dich mit Ctrl+B, dann D. Später verbindest du dich wieder:
ssh my-server
tmux list-sessions
tmux attach-session -t coding
Das tmux-Handbuch dokumentiert Trennen (detach) und Anhängen (attach). Das erneute Anhängen bringt dich zum laufenden Terminal zurück. Es sendet die Aufgabe nicht erneut und startet keinen weiteren Agenten.
Den Lebenszyklus prüfen, bevor er echte Arbeit bekommt
Du kannst das Rezept prüfen, ohne Agenten-Kontingent zu verbrauchen. Führe in der neuen tmux-Sitzung statt eines CLI diesen endlichen Befehl aus:
python3 -u -c 'import time; [(print(i, flush=True), time.sleep(1)) for i in range(60)]'
Trenne dich von tmux, beende die SSH-Verbindung und hänge dich innerhalb einer Minute wieder an. Die Zahlen sollten weitergelaufen sein, während du weg warst. Das ist ein Ablauf für deinen Host, kein Benchmark, den wir über alle Serverkonfigurationen hinweg durchgeführt haben.
Probiere danach eine kurze Agenten-Aufgabe. Prüfe nach dem Wiederverbinden die geänderten Dateien und ob der Agent eine Antwort braucht. Eine Sitzung kann überleben, während der Agent an einer Berechtigungsabfrage wartet. Ihn am Leben zu halten, macht ihn nicht autonom.
Was wir in AgentsRoom geändert haben
Öffne die gespeicherte SSH-Verbindung und aktiviere Agenten auf diesem Host weiterlaufen lassen, wenn AgentsRoom geschlossen wird. Die Option ist standardmäßig aus. Der Host braucht tmux 3.0 oder neuer.
Öffne dann ein Remote-Projekt und starte dort einen Agenten. Das CLI läuft in einer benannten tmux-Sitzung auf dem Host. AgentsRoom zu beenden, den Laptop in den Ruhezustand zu versetzen oder die Verbindung zu verlieren lässt diese Sitzung unberührt. Öffnest du denselben gespeicherten Agenten erneut, hängt er sich an sie an, auch von einem anderen Computer deines Kontos.
Wir haben vier Umsetzungsentscheidungen getroffen, weil jede davon ändert, was ein Benutzer erlebt:
- Der Sitzungsname folgt der Identität des Agenten. Öffnest du diesen Agenten erneut, findet er seinen Prozess; ein neuer Agent bekommt eine neue Sitzung.
- Die App nutzt einen eigenen tmux-Server und überspringt deine persönliche tmux-Konfiguration. Sie bringt die Sitzungen, die du von Hand verwaltest, nicht durcheinander.
- Das tmux-Präfix ist in der App deaktiviert. Ctrl+B bleibt für das Coding-CLI verfügbar, und Escape erreicht es ohne die übliche Verzögerung von tmux.
- Ein ausdrücklicher Neustart des Agenten ersetzt den entfernten Prozess. Das Beenden der App trennt nur ihre Ansicht. Diese Gesten müssen unterschiedliche Wirkungen haben.
Die letzte Unterscheidung ist die wichtigste. Den Agenten-Tab zu schließen ist nicht der Weg, ihn weiterarbeiten zu lassen. Beende die App oder trenne die Ansicht. Schließt du den Agenten ausdrücklich oder startest ihn neu, versucht AgentsRoom, auch die entfernte Sitzung zu stoppen; ist der Host nicht erreichbar, kann es diesen Stopp nicht garantieren.
Fehlt tmux oder ist es zu alt, startet die App wie bisher. Verlass dich nicht darauf, dass das Häkchen allein Persistenz beweist: Prüfe den Host und mach die Übung mit dem Trennen. Diese Details wurden am 7. Oktober 2026 an der veröffentlichten Implementierung überprüft.
Wenn die Agenten gar nicht mehr von deinem Rechner abhängen sollen
Die Einstellung oben hält den Agenten auf dem Host am Leben, aber AgentsRoom läuft weiterhin auf deinem Rechner, also stoppen Team-Läufe und Trigger, sobald es stoppt. Seit Version 1.252.0 (November 2026) kann die App selbst auf dem Server leben:
sudo apt install ./desktop_<version>_amd64.deb
agentsroom --server
Nimm auf einem ARM-Server das arm64-Paket. Der Server gibt einen Link und einen kurzen Code aus. Öffne den Link auf deinem Rechner oder deinem Smartphone, prüfe die Maschine und den Code und klicke auf Verbinden. Danach öffnet agentsroom --server --open ~/my-repo ein Projekt.
Es gibt kein Fenster, kein Xvfb und kein VNC. Dein Smartphone und deine anderen Rechner sehen die Projekte des Servers, starten seine Agenten und beantworten ihre Fragen über das Ende-zu-Ende-verschlüsselte Relay, ohne eingehenden Port. Du installierst jedes Agenten-CLI auf dem Server und meldest dich dort an, wie auf einem Laptop.
Zwei Kostenpunkte solltest du abwägen. Es ist die vollständige App: etwa 400 MB Arbeitsspeicher im Leerlauf, dazu die CLIs. Und eine Maschine ohne Bildschirm hat meist keinen Schlüsselbund, gespeicherte SSH- und Datenbankpasswörter werden dort also abgelehnt. Wenn du nur Agenten auf einer leistungsstarken Maschine willst, während du arbeitest, bleibt die SSH-Option oben einfacher.
Wo nohup und Mosh hineinpassen
nohup lässt einen Befehl Hangup-Signale ignorieren, wie sein Handbuch erklärt. Es gibt dir kein interaktives Terminal, an das du dich später anhängen kannst. Es eignet sich besser für einen Batch-Befehl mit umgeleiteter Ein- und Ausgabe als für einen Agenten, der eine Frage stellen könnte.
Mosh kommt mit unterbrochenen Verbindungen und Netzwerkwechseln zurecht. Seine Dokumentation warnt auch, dass es den sichtbaren Bildschirm synchronisiert, nicht den kompletten Scrollback. Es lässt sich mit tmux kombinieren; eine Sitzung verfügbar zu halten, nachdem man den Client bewusst beendet hat, ist ein anderes Thema als das Wechseln zwischen Netzwerken.
Was Persistenz nicht löst
Der Host muss weiterhin eingeschaltet bleiben. Ein Neustart beendet seine laufenden Prozesse. Ein Kontingentlimit, ein Absturz des CLI oder eine Berechtigungsfrage kann den Fortschritt trotzdem stoppen. Du verbindest dich mit dem aktuellen Bildschirm; dass der Konsolenverlauf, den dein anderer Computer angezeigt hat, vollständig wieder erscheint, ist nicht versprochen.
Halte die Arbeit in Dateien fest, die die nächste Sitzung lesen kann: eine kurze Aufgabennotiz, die Änderungen selbst und das Ergebnis der Überprüfung. Ein überlebendes Terminal ist nützlich. Eine Aufgabe, deren Stand nur in diesem Terminal existiert, bleibt trotzdem fragil.
Die Seite zum Fernzugriff erklärt, wie du deine Agenten erreichst. Dieses Rezept beantwortet die nächste Frage: ob es nach dem Verbindungsverlust überhaupt noch einen Agenten zu erreichen gibt.
Fragen
Überlebt ein Coding-Agent auf einem Server einen SSH-Abbruch?
Ein einfaches interaktives SSH-Terminal ist kein Persistenzmechanismus. Verliert der Agent sein Terminal, kann er stoppen. Starte ihn vor dem Trennen in tmux auf dem Server und hänge dich danach wieder an diese Sitzung an. Der Server muss weiterlaufen, und der Agent kann trotzdem aus eigenen Gründen anhalten.
Kann ich mich von einem anderen Computer aus wieder verbinden?
Ja, verbinde dich mit demselben Server als derselbe Benutzer auf dem Host und hänge dich an die benannte tmux-Sitzung an. Aktiviere in AgentsRoom die persistenten Sitzungen für die SSH-Verbindung und öffne dann denselben gespeicherten Agenten von einem anderen Computer deines Kontos. Ein anderer Agent erzeugt eine andere Sitzung.
Ist Wiederverbinden dasselbe wie eine Unterhaltung fortsetzen?
Nein. Wer sich an eine laufende tmux-Sitzung anhängt, kehrt zu einem Prozess zurück, der nie gestoppt wurde. Eine gespeicherte Unterhaltung fortzusetzen startet einen Prozess, der den Verlauf des CLI liest. Eine Unterhaltungsdatei kann weder einen laufenden Befehl noch einen beendeten Terminal-Prozess wiederherstellen.
Stoppt das Schließen von AgentsRoom einen persistenten Remote-Agenten?
Das Beenden der App lässt ihn weiterlaufen, wenn die Option für persistente Sitzungen der SSH-Verbindung aktiviert ist und auf dem Host tmux 3.0 oder neuer verfügbar ist. Den Agenten ausdrücklich zu schließen oder neu zu starten fordert an, seinen Prozess zu stoppen oder zu ersetzen; ein nicht erreichbarer Host kann diese Aktion nicht bestätigen. Ohne unterstütztes tmux fällt der Start auf das normale SSH-Verhalten zurück.
AgentsRoom herunterladen
Führe alle deine KI-Agenten aus, in all deinen Projekten, aus einem einzigen Fenster.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutze Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.
Weiterlesen
Was „Claude remote agents“ wirklich bedeutet: Cloud Sessions, eine ferngesteuerte lokale Sitzung oder eine Maschine, die dir gehört
Wer nach „Claude remote agents“ sucht, landet bei drei verschiedenen Dingen: den Cloud Sessions von Anthropic (Claude Code on the web, claude --cloud, geplante Aufgaben, früher Routines), Remote Control (eine Sitzung auf deiner eigenen Maschine, vom Handy aus gesteuert) und einem Agenten, der per SSH auf einer Maschine läuft, die dir gehört. Hier steht, was jedes davon ist, geprüft in der Dokumentation von Anthropic am 28. September 2026, wo es läuft, was es braucht und wie wir jeden Fall mit jedem Agenten-CLI handhaben.
Zum ArtikelSehen, was dein KI-Coding-Agent auf deinen Servern ausführt
Dein Agent arbeitet auf einem Produktionsserver, und sein Terminal sagt nur, dass er ein Tool aufruft. Welchen Befehl hat er ausgeführt, und was hat die Maschine geantwortet? Das Transkript verrät es dir hinterher. So haben wir es sichtbar gemacht, während es passiert, das haben wir zuerst probiert, und so bekommst du dasselbe ohne unsere App.
Zum ArtikelRoutines in Claude Code: Was in der Cloud läuft, was auf deiner Maschine bleibt und wie du wählst
Routines, die Anthropic inzwischen scheduled tasks (geplante Aufgaben) nennt, sind der Weg von Claude Code, einen gespeicherten Prompt ohne dich auszuführen: nach Zeitplan, auf einen API-Aufruf hin oder bei einem GitHub-Ereignis, als Cloud Session auf einem frischen Klon deines Repositorys. Sie sind in der Research Preview. Claude Code hat außerdem zwei lokale Wege, Arbeit zu planen, die geplanten Aufgaben der Desktop-App und /loop, und die drei verhalten sich nicht gleich: minimales Intervall, Zugriff auf deine lokalen Dateien, Berechtigungsabfragen, was passiert, wenn der Laptop schläft. Dieser Leitfaden stellt die drei mit den Grenzen aus der Dokumentation vor und erklärt dann, warum unsere eigenen sieben nächtlichen Agenten stattdessen auf einer lokalen Maschine laufen.
Zum Artikel