Claude Code remote nutzen: tmux, SSH und Worktrees

Entscheidend ist, auf welchem Rechner die Arbeit läuft. tmux erhält eine Terminalsitzung, wenn die Verbindung abbricht. Es kann weder einen Laptop im Ruhezustand weiterrechnen lassen noch einen ausgeschalteten Server am Leben halten oder einen abgestürzten Claude-Prozess neu starten. Anthropic empfiehlt ausdrücklich tmux oder screen, wenn eine entfernte Claude-Sitzung einen SSH-Verbindungsabbruch überstehen soll. Anthropics Dokumentation zu Remote Control.

Claude Code remote: die dokumentierte tmux-Konfiguration

Die Konfiguration gehört auf den Rechner, auf dem Claude Code läuft. Bei der Arbeit auf einem entfernten Rechner ist das dessen Datei ~/.tmux.conf. Falls nötig, tmux dort über die Paketverwaltung installieren und vor dem nächsten Schritt mit tmux -V und claude --version die Versionen prüfen.

Den folgenden Block in die vorhandene ~/.tmux.conf übernehmen. Die ersten drei Zeilen entsprechen der von Anthropic dokumentierten Einrichtung. Die auskommentierte Maussteuerung ist eine optionale Einstellung und keine Vorgabe von Anthropic.

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

# Optional preference: enable mouse interaction in tmux.
# set -g mouse on

Passthrough lässt Benachrichtigungen und Fortschrittsanzeigen bis zum äußeren Terminal durch. Erweiterte Tastencodes ermöglichen es tmux, Shift+Enter von Enter zu unterscheiden. Ein laufender tmux-Server übernimmt die Konfiguration mit tmux source-file ~/.tmux.conf; ein neuer Server liest die Datei beim Start ein. Anthropics Terminalkonfiguration.

Wenn noch kein tmux-Server läuft, zuerst die unten beschriebene erste Sitzung anlegen und erst danach den Befehl zum Neuladen ausführen. Für die Ersteinrichtung sind keine Plugins von Drittanbietern nötig: Der gesamte Ablauf funktioniert ohne sie.

Für jeden Worktree eine eigene benannte Sitzung

Ein Git-Worktree ist ein weiterer Checkout mit eigenen Dateien und eigenem Branch, der sich die Historie mit dem Repository teilt. Eine tmux-Sitzung bündelt Terminalfenster unter einem Namen; ein Pane ist ein Teilbereich eines Fensters. Bildlich gesprochen ist der Worktree die Werkbank und tmux der Raum, den man verlassen und später wieder betreten kann. Anthropics Worktree-Anleitung.

Ein einheitliches Namensschema macht schon am Sitzungsnamen erkennbar, welcher Checkout darin liegt. Die folgende Aufteilung ist ein Vorschlag, keine Standardeinstellung von Claude Code:

Das folgende Beispiel für die Ersteinrichtung setzt ein vorhandenes Repository unter ~/src/project mit mindestens einem Commit voraus. Die verwendeten Branch-, Verzeichnis- und Sitzungsnamen müssen noch frei sein. dev@devbox und den Projektpfad entsprechend ersetzen. Ausgangspunkt ist die normale Shell auf dem Laptop, außerhalb von tmux. Die Worktree-Befehle folgen Anthropics manuellem Ablauf; die Zuordnung zu benannten Sitzungen ist das Vorgehen dieser Anleitung.

ssh dev@devbox
cd ~/src/project

git worktree add ../project-feature-a -b feature-a
git worktree add ../project-bugfix -b bugfix

tmux new-session -d -s cc-feature-a -n claude -c "$HOME/src/project-feature-a"
tmux new-session -d -s cc-bugfix -n claude -c "$HOME/src/project-bugfix"

tmux attach-session -t cc-feature-a
# Now inside the feature worktree's tmux shell:
claude

Nach dem SSH-Verbindungsaufbau werden die übrigen Befehle auf dem entfernten Rechner eingegeben. Die beiden zunächst abgekoppelten Sitzungen enthalten jeweils eine Shell. Wer sich mit einer davon verbindet und claude ausführt, startet die Coding-Sitzung sichtbar im Terminal, einschließlich der üblichen Einrichtungsabfragen. Für die zweite Aufgabe die aktuelle Sitzung abkoppeln, mit cc-bugfix verbinden und dort ebenfalls claude starten.

Jeder Worktree braucht seine eigene Projekteinrichtung, also auch Abhängigkeiten und die erforderliche lokale Konfiguration. Vor einem Bearbeitungsauftrag an Claude deshalb Verzeichnis und Branch prüfen. Anthropics Anleitung zur manuellen Worktree-Verwaltung.

Für eine zusätzliche Test-Shell im Feature-Checkout auf dem Host tmux new-window -t cc-feature-a -n checks -c "$HOME/src/project-feature-a" ausführen. Prüfungen bleiben so bei der Aufgabe, zu der sie gehören. Der Haupt-Checkout sollte nicht als gemeinsames Arbeitsverzeichnis für beide Agenten dienen.

Wer auch Codex verwendet, findet dessen Ablauf in unserer separaten Anleitung zu Worktrees mit Codex CLI.

Sitzung abkoppeln, Laptop zuklappen, per SSH zurückkehren

Mit der standardmäßigen tmux-Präfixtaste lautet die Folge: Ctrl+B drücken, beide Tasten loslassen, dann D drücken. Das koppelt den Client ab und führt zurück zur Shell auf dem entfernten Rechner. Anschließend lässt sich die SSH-Verbindung trennen. Claude läuft dabei in seiner Sitzung weiter.

Für die Rückkehr zunächst ssh dev@devbox, dann tmux list-sessions und schließlich tmux attach-session -t cc-feature-a ausführen. Dabei denselben entfernten Rechner und dasselbe Benutzerkonto verwenden. Vom Laptop aus geht es auch mit einem einzigen Befehl: ssh -t dev@devbox 'tmux attach-session -t cc-feature-a'.

Diese Tastenkombinationen setzen das Standardpräfix voraus. Bei einer eigenen Konfiguration gilt stattdessen die dort festgelegte Präfixtaste. Innerhalb von tmux zwischen Sitzungen wechseln, statt einen weiteren tmux-Client darin zu verschachteln.

Das erneute Verbinden führt zum bestehenden Terminalprozess zurück. Ist dieser bereits beendet, muss stattdessen der Gesprächsverlauf wieder aufgenommen werden: claude --continue setzt das letzte Gespräch im aktuellen Verzeichnis fort, claude --resume öffnet eine Auswahl. Beide Befehle ersetzen keinen weiterlaufenden Originalprozess. Anthropics Anleitung zum Fortsetzen von Sitzungen.

Für den Zugriff per Smartphone oder Browser gibt es Claude Code Remote Control. Auch dabei läuft die Ausführung weiterhin auf dem Host, der eingeschaltet bleiben muss. Anthropics Dokumentation zu Remote Control.

Ein Agententeam ergänzen, wenn Abstimmung nötig ist

Agententeams sind experimentell und standardmäßig deaktiviert. In einer tmux-Shell startet CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --teammate-mode tmux eine neue interaktive Sitzung mit einem leitenden Agenten. Die Umgebungsvariable aktiviert Teams für diesen Start; das Flag wählt die Darstellung in geteilten Terminalbereichen. Anthropics Anleitung zur Einrichtung von Agententeams.

Der aktuelle Standard ist in-process. Mit auto werden innerhalb von tmux geteilte Terminalbereiche verwendet und bei Bedarf ein anderer Modus gewählt; tmux wählt den Modus mit geteilten Terminalbereichen und Terminalerkennung. Dauerhaft lässt sich die Einstellung über teammateMode in ~/.claude/settings.json festlegen. In geteilten Terminalbereichen erhält jedes Teammitglied ein eigenes sichtbares Terminal. Anthropic führt das integrierte Terminal von VS Code, Windows Terminal und Ghostty für diesen Modus als nicht unterstützt auf. Anthropics Anzeigemodi und Einschränkungen.

Für einen ersten Versuch würde ich dem leitenden Agenten einen eng umrissenen Auftrag geben:

Die manuell gestarteten Sitzungen cc-feature-a und cc-bugfix werden nicht allein dadurch zu Teammitgliedern, dass beide in tmux laufen. Mit einem Team fällt eine separate Entscheidung darüber, wer Arbeit verteilt und Befunde zusammenführt. Für klar abgegrenzte Teilaufgaben innerhalb einer Sitzung sind Claude Code Subagents vorzuziehen.

Ein Pane ist kein eigener Checkout. Für unabhängige Bearbeitungen unterschiedliche Dateien zuweisen oder getrennte Worktrees verwenden. Teams verbrauchen außerdem mehr Tokens; tmux senkt diesen Verbrauch nicht. Das erneute Verbinden erhält den Zugriff auf ein laufendes Terminal, während /resume keine Teammitglieder im In-Process-Modus wiederherstellt. Anthropics Hinweise zu Agententeams.

Fünf Einsatzfälle für diese Aufteilung

Ich würde diese Einsatzfälle in der folgenden Reihenfolge angehen. Jeder beschreibt einen möglichen Arbeitsablauf, keinen gemessenen Produktivitätsgewinn.

Vor weiterer Automatisierung lohnt es sich, den Aufwand durch Unterbrechungen zu messen. Ein Rechenbeispiel: Fünf Unterbrechungen, bei denen jeweils vier Minuten für den Wiedereinstieg nötig sind, kosten zwanzig Minuten pro Woche. Das sind hypothetische Annahmen, keine Benchmark-Ergebnisse. Entscheidend sind die selbst erfassten Zeiten für Wiedereinstieg, Einrichtung und Prüfung. Die Arbeitsweise lohnt sich, wenn die Gesamtzeit sinkt. Mehr gleichzeitig laufende Agenten rechnen sich nicht automatisch.

Zwei kleine Tools, die sich darauf aufbauen lassen

Die aussichtsreichere Idee ist ein Worktree- und Sitzungsstarter für Entwicklungsteams. Ein Plattformteam könnte dafür bezahlen, dass Aufgabennamen, Checkout-Pfade und Verbindungsbefehle für alle Entwickler einheitlich sind. Die kleinste nützliche Version würde einen Worktree anlegen oder finden, die zugehörige benannte tmux-Sitzung öffnen und vor dem Start von Claude Branch und Pfad anzeigen. Vor dem Aufräumen eines Checkouts sollte das Tool nachfragen.

Die am 12. Oktober 2026 abgerufene DataForSEO-Schätzung für die USA liegt bei 480 monatlichen Suchanfragen nach „tmux claude code“. Das ist ein eng begrenztes Signal für Interesse an der Einrichtung, keine Käuferzahl. Die Schwierigkeit: Ein kurzes internes Skript könnte bereits genügen. Ein kostenpflichtiges Produkt braucht daher teamspezifische Einrichtung oder Unterstützung, die wiederkehrende Arbeit erspart.

Eine Übersicht entfernter Sitzungen ist eine zweite, enger gefasste Produktidee. Ein kleines Entwicklungsteam könnte darin freigegebene Host-Aliasse, Sitzungsnamen und Checkout-Pfade zentral erfassen, jeweils mit einem kopierbaren SSH-Befehl zum Verbinden. Am Anfang stehen das Auffinden und der Zugang; Funktionen zur Verwaltung des Lebenszyklus kommen erst hinzu, wenn sie gebraucht werden.

Dieselbe DataForSEO-Abfrage schätzt 1,600 monatliche Suchanfragen in den USA nach „claude code remote“ und 70 nach „claude code remote ssh“. Unter der allgemeineren Suchanfrage finden sich auch Menschen, die andere Formen des Fernzugriffs suchen. Sie belegt deshalb für sich genommen keine Nachfrage nach einem SSH-Produkt. Die Schwierigkeit liegt hier in der Zugriffsverwaltung: Die Übersicht muss die bestehenden Host-Berechtigungen jedes Entwicklers respektieren. Vor dem Bau eines Dashboards stehen Gespräche mit Teams, die überwiegend ortsunabhängig arbeiten.

Häufige Fragen aus der Praxis

Der nächste Schritt für Montag: Eine Aufgabe auf einem entfernten Rechner auswählen, ihren Worktree und ihre benannte Sitzung anlegen und das Abkoppeln sowie erneute Verbinden prüfen, bevor sie unbeaufsichtigt weiterläuft. Eine zweite unabhängige Aufgabe kommt erst hinzu, wenn dieser Ablauf sitzt.

Wenn dieser Ablauf Teil der Entwicklungsumgebung des Teams werden soll: Wir entwickeln KI-Systeme für den Produktiveinsatz.