Führen Sie Claude Code in tmux oder Herdr aus und steuern Sie es über Ihr Smartphone

Eine SSH-Verbindung bricht ab und Claude Code wird damit beendet. Einer Smartphone-Terminaltastatur fehlen Esc- und Ctrl-Tasten. Sie kehren eine Stunde später zurück und Claude Code war die gesamte Zeit untätig, weil es auf die Bestätigung einer Eingabeaufforderung wartet.

Diese Anleitung behebt alle drei Probleme. Führen Sie Claude Code in tmux oder Herdr aus, damit es Verbindungsabbrüche übersteht. Fügen Sie dann Collie hinzu, um wartende Sitzungen auf Ihrem Smartphone zu priorisieren und die fehlenden Tasten bereitzustellen.

Claude Code in tmux weiterlaufen lassen

Starten Sie Claude Code innerhalb einer tmux-Sitzung. Es läuft auf dem Host weiter, wenn Ihre Verbindung abbricht.

tmux new -s claude       # start a session named claude
claude                   # run Claude Code inside it

Trennen Sie die Verbindung mit Ctrl+b, dann d. Melden Sie sich später von einem beliebigen Rechner an und verbinden Sie sich wieder:

tmux attach -t claude

Der tmux-Server verwaltet die Sitzung anstelle Ihrer SSH-Anmeldung, sodass ein Verbindungsabbruch Claude Code nicht stoppt. Führen Sie tmux ls aus, um Sitzungen auf dem Host aufzulisten.

Herdr

Herdr ist ein Terminal-Arbeitsbereichsverwalter, der für Programmieragenten entwickelt wurde. Er funktioniert auf dieselbe Weise.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr                                           # start Herdr, or reattach to it
claude                                          # in the pane Herdr opens

Trennen Sie die Verbindung mit Ctrl+b, dann q, oder schließen Sie das Terminal. Der Herdr-Server lässt Ihre Bereiche und Claude Code weiterlaufen. Führen Sie herdr erneut aus, um sich wieder zu verbinden.

zellij

Führen Sie zellij -s claude aus, starten Sie claude, trennen Sie mit Ctrl o dann d und verbinden Sie sich wieder mit zellij attach claude. Collie spiegelt nur eine zellij-Sitzung. Siehe Hinweise zu zellij.

Mehrere Claude-Code-Sitzungen gleichzeitig ausführen

Geben Sie jeder Sitzung ein eigenes Fenster und einen eigenen Checkout, damit nicht zwei Agenten dieselben Dateien bearbeiten.

# a second checkout, on its own branch
git worktree add ~/src/app-review -b review
tmux new-window -t claude -n review -c ~/src/app-review
claude                                     # in the new window

Drücken Sie in tmux Ctrl+b und dann c, um ein Fenster zu öffnen, und Ctrl+b dann w, um sie aufzulisten. Drücken Sie Ctrl+b dann %, um einen Bereich links und rechts zu teilen, und Ctrl+b dann ", um oben und unten zu teilen.

Geben Sie unter Herdr jedem Agenten einen eigenen Arbeitsbereich, während Herdr läuft:

herdr workspace create --label review --cwd ~/src/app-review

Die Ausführung mehrerer Sitzungen erzeugt mehrere wartende Eingabeaufforderungen. Collie platziert Bereiche, die Eingaben erfordern, ganz oben im Dashboard, während die restlichen Bereiche nach Arbeitsbereich gruppiert sind. Halten Sie eine Zeile gedrückt, um diesen Bereich oben anzuheften. Unter tmux und zellij erfordert diese Sortierung die Beacon-Hooks aus Schritt 3.

Steuern Sie es mit Collie über Ihr Smartphone

Collie läuft auf Ihrem Host und spiegelt Ihre Herdr-, tmux- oder zellij-Bereiche in Ihren Smartphone-Browser. Die gleichen Schritte funktionieren für Codex, OpenCode und jeden anderen Terminal-Agenten. Nur der Befehl im Bereich ändert sich.

Hinweis. Collie bietet konstruktionsbedingt Remote-Shell-Zugriff auf Ihren Rechner. Lesen Sie Sicherheit, bevor Sie es installieren.

• —
  Claude Code läuft auf Ihrem Host in einem Herdr-, tmux- oder zellij-Bereich. Auf dem Smartphone läuft kein Agenten-Code.
• —
  Ihr Smartphone öffnet Collie in einem Browser über Ihr Tailnet. Das Dashboard listet Bereiche auf und platziert wartende Sitzungen an erster Stelle.
• —
  Sie lesen Ausgaben, senden Antworten und übertragen Esc, Tab, Pfeiltasten oder Modifikatortasten über die Tastenleiste. Sie benötigen keinen SSH-Client.
• —
  Optionale Push-Benachrichtigungen informieren Sie, wenn ein Agent eine Eingabe benötigt.

Was Sie benötigen

• —
  Ein Linux- oder macOS-Host mit installiertem Claude Code.
• —
  Ein Terminal-Multiplexer: Herdr, tmux oder zellij. Herdr erkennt Agenten direkt. Unter tmux und zellij verwendet Collie Beacon-Hooks, die Linux erfordern.
• —
  Auf dem Host und Smartphone installiertes Tailscale mit aktiviertem HTTPS in Ihrem Tailnet. Weitere Konfigurationen finden Sie unter Bereitstellung.
• —
  Ein iPhone oder ein Android-Smartphone.

1. Collie installieren

curl -fsSL https://colliepwa.dev/install.sh | sh

Unter Herdr können Sie das Plugin direkt installieren: herdr plugin install AltanS/collie. Installation beschreibt beide Methoden.

2. Starten

collie start

Beim ersten Start wird nach Herdr, tmux und zellij gesucht und Ihre Auswahl in .env gespeichert. Der Befehl startet tailscale serve und gibt eine tailnet-URL aus. Siehe Starten.

3. Claude Code in einem Pane ausführen

Öffnen Sie unter Herdr ein Pane und führen Sie claude aus. Herdr markiert das Pane für Collie als Agent.

Installieren Sie unter tmux oder zellij die Beacon-Hooks einmalig pro Host. Dadurch unterscheidet Collie Agenten von gewöhnlichen Shells. Öffnen Sie danach ein Fenster oder einen Tab in der Sitzung, die Collie spiegelt, und starten Sie Claude Code:

collie hooks install claude    # once per host, Linux only
tmux new-window -n claude      # or: zellij action new-tab --name claude
claude

Collie spiegelt den standardmäßigen tmux-Server, sofern Sie COLLIE_MUX_ENDPOINT_TMUX nicht festlegen. Die Sitzung claude von oben wird automatisch angezeigt.

Laufende Claude-Code-Instanzen laden Einstellungen nicht automatisch neu. Starten Sie Claude Code nach der Installation der Hooks neu. Siehe Collie schreibt Hooks in Claudes eigene Einstellungen.

4. Auf dem Smartphone öffnen

Führen Sie collie qr auf dem Host aus, um den Code zu scannen, oder öffnen Sie den Link aus collie url. Das Smartphone muss sich im selben Tailnet befinden.

1. 01
   Smartphone koppeln. Führen Sie collie pair auf dem Host aus und scannen Sie den QR-Code. Die Kopplung gewährt dem Smartphone Schreibzugriff auf Ihre Panes (Ein Gerät koppeln).
2. 02
   Zum Startbildschirm hinzufügen. Tippen Sie unter Android oben in den Einstellungen auf Installation. Tippen Sie auf einem iPhone im Teilen-Menü von Safari darauf.

5. Claude Code antworten

• —
  Die Übersicht sortiert Panes, die Eingaben erfordern, nach oben. Tippen Sie auf ein Pane, um es zu öffnen.
• —
  Das Eingabefeld ist ein Standard-Textfeld; die Diktierfunktion des Smartphones funktioniert darin.
• —
  Tippen Sie in der Aktionsleiste über der Tastatur auf Tasten. Die Leiste enthält Esc, Pfeiltasten, Eingabetaste, Tabulatortaste, Leertaste, Modifikatortasten, Ziffern sowie F1 bis F12. Tastenkombinationen mit Esc und Strg hängen nicht von der Smartphone-Tastatur ab.
• —
  Schaltflächen für Claude Code befinden sich in derselben Zeile: Model, Effort, Compact und Resume. Siehe Konfiguration.

6. Benachrichtigungen erhalten (optional)

collie push-keys     # writes the VAPID keys to your .env
collie restart

Aktivieren Sie Benachrichtigungen in den Einstellungen von Collie auf dem Smartphone. Eingabe erforderlich ist standardmäßig aktiviert. Installieren Sie Collie auf einem iPhone zuerst auf Ihrem Startbildschirm. Safari beschränkt Web-Push auf Web-Apps auf dem Startbildschirm. Siehe Web Push.

Weitere Möglichkeiten, Claude Code über ein Smartphone zu nutzen

• —
  Claude Code Remote Control verbindet die Claude-App oder claude.ai/code mit einer Claude-Code-Sitzung auf Ihrem Rechner; der Datenverkehr läuft über die Anthropic-API (Anthropic-Dokumentation). Collie spiegelt stattdessen Terminal-Panes, funktioniert daher mit jedem Agenten in Ihrem Multiplexer und verbleibt in Ihrem Tailnet.
• —
  Eine SSH-App wie Termius, Moshi oder Termux stellt das vollständige Terminal bereit. Das funktioniert, aber die Terminalbedienung auf mobilen Tastaturen ist umständlich. Esc, Strg und Pfeiltasten erfordern Ausweichlösungen.