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

Du startest Claude Code auf einem Server, gibst 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 du in einer SSH-Sitzung startest, 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 deiner Verbindung. Du klinkst dich ein, arbeitest, klinkst dich wieder aus, und die Programme darin laufen einfach weiter.

tmux in fünf Minuten

Installiere tmux auf dem Server, unter Debian oder Ubuntu so:

sudo apt install tmux

Starte eine Sitzung mit dem Namen main oder hänge dich an eine bestehende an:

tmux new -A -s main

Starte darin claude und gib deine Aufgabe. Zum Abkoppeln drückst du Strg+b und danach d. Die Sitzung läuft weiter, auch wenn du dich abmeldest. Später holst du sie zurück:

tmux attach -t main

Alle laufenden Sitzungen zeigt dir tmux ls.

Automatisch in dieselbe Sitzung

Noch bequemer ist es, wenn jede SSH-Anmeldung automatisch in derselben tmux-Sitzung landet. Füge 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 du bist genau dort, wo du aufgehört hast.

Wenn der Prozess doch beendet wurde

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

claude --continue

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

Vom Handy aus weitermachen

Mit Remote Control steuerst du eine laufende Claude-Code-Sitzung aus dem Browser oder vom Handy. Starte Claude Code dazu so:

claude --remote-control

In einer bereits laufenden Sitzung tippst du stattdessen /remote-control, kurz /rc. Die Sitzung öffnest du dann über claude.ai/code oder in der Claude-App. Sie läuft weiterhin auf deinem Server, Browser und App sind nur das Fenster dazu. Kombiniert mit tmux arbeitet der Agent also auf dem Server weiter, und du schaust 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 dein Agent weiter, egal was mit deinem Laptop passiert. In der euhost Box ist das alles schon eingerichtet.