Agent läuft weiter, Laptop zu: Claude Code mit tmux auf einem Server

Sie starten Claude Code auf einem Server, geben ihm eine längere Aufgabe, und dann reißt die Verbindung ab: WLAN weg, Laptop zugeklappt, Neustart für ein Update. Ohne Vorkehrungen ist die Arbeit des Agenten damit verloren. Mit tmux passiert das nicht mehr.

Warum der Agent stirbt, wenn die Verbindung abreißt

Alles, was Sie in einer SSH-Sitzung starten, hängt an dieser Sitzung. Endet sie, schickt das System den laufenden Programmen ein Signal zum Beenden (SIGHUP). Claude Code wird mitten in der Aufgabe gestoppt.

Die Lösung ist ein Terminal-Multiplexer wie tmux. tmux läuft auf dem Server weiter, unabhängig von Ihrer Verbindung. Sie klinken sich ein, arbeiten, klinken sich wieder aus, und die Programme darin laufen einfach weiter.

tmux in fünf Minuten

Installieren Sie tmux auf dem Server, unter Debian oder Ubuntu so:

sudo apt install tmux

Starten Sie eine Sitzung mit dem Namen main oder hängen Sie sich an eine bestehende an:

tmux new -A -s main

Starten Sie darin claude und geben Sie Ihre Aufgabe ein. Zum Abkoppeln drücken Sie Strg+b und danach d. Die Sitzung läuft weiter, auch wenn Sie sich abmelden. Später holen Sie sie zurück:

tmux attach -t main

Alle laufenden Sitzungen zeigt tmux ls.

Automatisch in dieselbe Sitzung

Noch bequemer ist es, wenn jede SSH-Anmeldung automatisch in derselben tmux-Sitzung landet. Fügen Sie dazu am Ende der Datei ~/.bashrc auf dem Server ein:

if [[ -n "$SSH_CONNECTION" && -z "$TMUX" && $- == *i* && "$TERM_PROGRAM" != "vscode" ]]; then
  exec tmux new -A -s main
fi

Die Bedingungen sorgen dafür, dass das nur bei interaktiven SSH-Anmeldungen passiert. Dateiübertragungen mit scp oder rsync bleiben unberührt. Das Terminal von VS Code ist ausgenommen, weil VS Code seine Terminals selbst verwaltet.

Ab jetzt reicht ssh meinserver, und Sie sind genau dort, wo Sie aufgehört haben.

Wenn der Prozess doch beendet wurde

Auch ohne tmux ist nicht alles verloren, denn Claude Code speichert Ihre Gespräche. Mit diesem Befehl setzen Sie das letzte Gespräch im aktuellen Verzeichnis fort:

claude --continue

Die Kurzform ist claude -c. Mit claude --resume wählen Sie stattdessen aus einer Liste früherer Sitzungen. Eine abgebrochene Aufgabe läuft dabei nicht von selbst weiter: Bitten Sie den Agenten einfach, dort weiterzumachen, wo er aufgehört hat.

Vom Handy aus weitermachen

Mit Remote Control steuern Sie eine laufende Claude-Code-Sitzung aus dem Browser oder vom Handy. Starten Sie Claude Code dazu so:

claude --remote-control

In einer bereits laufenden Sitzung tippen Sie stattdessen /remote-control, kurz /rc. Die Sitzung öffnen Sie dann über claude.ai/code oder in der Claude-App. Sie läuft weiterhin auf Ihrem Server, Browser und App sind nur das Fenster dazu. Kombiniert mit tmux arbeitet der Agent also auf dem Server weiter, und Sie schauen von unterwegs nach.

Remote Control gibt es in den Plänen Pro, Max, Team und Enterprise. Bei Team und Enterprise muss es zuerst ein Admin in den Einstellungen freischalten.

Fazit

tmux auf dem Server, der automatische Einstieg über die .bashrc und bei Bedarf Remote Control: So arbeitet Ihr Agent weiter, egal was mit Ihrem Laptop passiert. In der euhost Box ist das alles schon eingerichtet.