Exécutez Claude Code dans tmux ou Herdr, et contrôlez-le depuis votre téléphone

Une connexion SSH se coupe, et Claude Code s'arrête net. Le clavier de terminal sur mobile n'a pas de touches Échap et Ctrl. Vous revenez une heure plus tard : Claude Code est resté inactif tout ce temps, bloqué sur une invite en attente de validation.

Ce guide règle ces trois problèmes. Exécutez Claude Code dans tmux ou Herdr pour qu'il survive aux pertes de connexion. Ajoutez ensuite Collie pour faire remonter les sessions en attente sur votre téléphone et disposer des touches manquantes.

Laisser tourner Claude Code dans tmux

Lancez Claude Code dans une session tmux. L'exécution continue sur l'hôte en cas de coupure de connexion.

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

Détachez la session avec Ctrl+b, puis d. Reconnectez-vous plus tard depuis n'importe quelle machine et rattachez-la :

tmux attach -t claude

Le serveur tmux détient la session et non votre session SSH : une déconnexion n'interrompt donc pas Claude Code. Exécutez tmux ls pour lister les sessions sur l'hôte.

Herdr

Herdr est un gestionnaire d'espaces de travail de terminal conçu pour les agents de code. Son fonctionnement est identique.

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

Détachez avec Ctrl+b, puis q, ou fermez le terminal. Le serveur Herdr maintient vos panneaux et Claude Code en cours d'exécution. Exécutez à nouveau herdr pour vous rattacher.

zellij

Exécutez zellij -s claude, démarrez claude, détachez avec Ctrl o puis d, et rattachez avec zellij attach claude. Collie ne réplique qu'une seule session zellij. Voir notes sur zellij.

Exécuter plusieurs sessions de Claude Code en parallèle

Attribuez à chaque session sa propre fenêtre et son propre checkout pour éviter que deux agents ne modifient les mêmes fichiers.

# 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

Dans tmux, appuyez sur Ctrl+b puis c pour ouvrir une fenêtre, et sur Ctrl+b puis w pour les lister. Appuyez sur Ctrl+b puis % pour diviser un panneau verticalement, et sur Ctrl+b puis " pour le diviser horizontalement.

Dans Herdr, attribuez à chaque agent son propre espace de travail pendant l'exécution de Herdr :

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

L'exécution de sessions multiples génère plusieurs invites en attente. Collie place les panneaux nécessitant une saisie en haut du tableau de bord, le reste étant regroupé par espace de travail. Maintenez une ligne appuyée pour épingler ce panneau en haut. Sur tmux et zellij, ce tri nécessite les hooks de beacon décrits dans étape 3.

Pilotez-le depuis votre téléphone avec Collie

Collie s'exécute sur votre hôte et réplique vos panneaux Herdr, tmux ou zellij dans le navigateur de votre téléphone. Les mêmes étapes s'appliquent à Codex, OpenCode et tout autre agent en terminal. Seule la commande lancée dans le panneau change.

Remarque. Collie fournit par conception un accès shell distant à votre machine. Lisez Sécurité avant de l'installer.

• —
  Claude Code tourne sur votre hôte dans un panneau Herdr, tmux ou zellij. Aucun code d'agent ne tourne sur le téléphone.
• —
  Votre téléphone ouvre Collie dans un navigateur via votre tailnet. Le tableau de bord liste les panneaux et place les sessions en attente en tête.
• —
  Vous lisez la sortie, envoyez des réponses et transmettez Échap, Tab, les flèches ou les touches modificatrices depuis le tiroir Keys. Aucun client SSH n'est nécessaire.
• —
  Des notifications push facultatives vous alertent lorsqu'un agent requiert une action.

Prérequis

• —
  Un hôte Linux ou macOS avec Claude Code installé.
• —
  Un multiplexeur de terminal : Herdr, tmux ou zellij. Herdr détecte directement les agents. Sur tmux et zellij, Collie utilise des hooks de beacon, qui nécessitent Linux.
• —
  Tailscale installé sur l'hôte et le téléphone, avec HTTPS activé sur votre tailnet. Pour d'autres configurations, voir Déploiement.
• —
  Un téléphone iPhone ou Android.

1. Installez Collie

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

Sur Herdr, vous pouvez installer le plugin directement : herdr plugin install AltanS/collie. Installer détaille les deux méthodes.

2. Démarrez-le

collie start

Le premier lancement vérifie la présence de Herdr, tmux et zellij, puis enregistre votre choix dans .env. Il lance tailscale serve et affiche une URL tailnet. Consultez Démarrez-le.

3. Lancez Claude Code dans un volet

Sur Herdr, ouvrez un volet et exécutez claude. Herdr signale le volet à Collie comme étant un agent.

Sur tmux ou zellij, installez les hooks beacon une seule fois par hôte. Cela permet à Collie de distinguer les agents des simples shells. Ensuite, ouvrez une fenêtre ou un onglet dans la session que Collie réplique, puis lancez 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 réplique le serveur tmux par défaut, sauf si vous définissez COLLIE_MUX_ENDPOINT_TMUX. La session claude mentionnée ci-dessus apparaît automatiquement.

Les instances actives de Claude Code ne rechargent pas automatiquement les paramètres. Redémarrez Claude Code après avoir installé les hooks. Consultez Collie écrit les hooks dans les paramètres de Claude.

4. Ouvrez-le sur votre téléphone

Exécutez collie qr sur l'hôte pour scanner le code, ou ouvrez le lien depuis collie url. Gardez le téléphone sur le même tailnet.

1. 01
   Associez le téléphone. Exécutez collie pair sur l'hôte et scannez le code QR. L'association accorde au téléphone l'accès en écriture à vos volets (Associer un appareil).
2. 02
   Ajoutez-le à votre écran d'accueil. Sur Android, appuyez sur Installer en haut des paramètres. Sur un iPhone, utilisez la feuille de partage de Safari.

5. Répondez à Claude Code

• —
  Le tableau de bord place en haut les volets en attente de saisie. Appuyez sur l'un d'eux pour l'ouvrir.
• —
  La zone de saisie utilise un champ texte standard, la dictée vocale du téléphone y fonctionne donc.
• —
  Appuyez sur Touches dans la barre d'actions au-dessus du clavier. La barre contient Échap, les touches fléchées, Entrée, Tab, Espace, les modificateurs, les chiffres et les touches F1 à F12. Les combinaisons avec Échap et Ctrl ne dépendent pas du clavier du téléphone.
• —
  Les boutons de Claude Code se trouvent sur la même rangée : Model, Effort, Compact et Resume. Consultez Configurer.

6. Recevez des notifications (facultatif)

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

Activez les notifications dans les paramètres de Collie sur le téléphone. Action requise est activé par défaut. Sur un iPhone, installez d'abord Collie sur votre écran d'accueil. Safari limite Web Push aux applications web ajoutées à l'écran d'accueil. Consultez Web Push.

Autres moyens d'accéder à Claude Code depuis un téléphone

• —
  Contrôle à distance de Claude Code connecte l'application Claude ou claude.ai/code à une session Claude Code sur votre machine, et son trafic transite par l'API Anthropic (Documentation d'Anthropic). Collie réplique plutôt les volets du terminal : il fonctionne ainsi avec n'importe quel agent de votre multiplexeur et reste sur votre tailnet.
• —
  Une application SSH comme Termius, Moshi ou Termux donne accès à l'intégralité du terminal. Cela fonctionne, mais les touches de contrôle de terminal sur clavier mobile sont peu pratiques. Échap, Ctrl et les flèches nécessitent des manipulations de contournement.