herdr sur un VPS : vos agents Claude Code à distance
Installez herdr v0.9.5 sur un VPS proche de la France, joignez-le par Tailscale SSH et voyez quel agent Claude Code ou Codex attend votre réponse. Et ce qui survit à un redémarrage.
herdr sur un VPS : ce que vous gagnez par rapport à tmux
herdr est un multiplexeur de terminal conçu pour les agents de code. Sur un VPS (serveur privé virtuel), il garde vos sessions Claude Code ou Codex actives quand vous fermez votre portable. Comme tmux, il laisse les processus tourner dans un serveur en arrière-plan. Sa différence : chaque panneau affiche l'état de l'agent qui y tourne, par exemple working, blocked ou idle. Vous voyez donc d'un coup d'œil quel agent attend votre réponse.
Ce guide installe herdr v0.9.5, la version marquée « Latest » sur GitHub au 10 novembre 2026, publiée le 14 octobre 2026. Il couvre l'accès au serveur par Tailscale SSH, l'installation, la connexion depuis votre poste avec herdr machine add, et surtout ce qui survit à un redémarrage. Réponse courte : les agents en cours ne survivent pas à un redémarrage de la machine.
Si vous utilisez déjà tmux pour cela, le guide Claude Code sur un VPS avec tmux reste valable. tmux a une limite simple : il ne sait pas ce qu'un agent fait. Avec quatre agents dans quatre fenêtres, vous passez de l'une à l'autre pour trouver celui qui attend une validation. herdr fait ce tri à votre place.
Ce que herdr sait vraiment de vos agents
herdr est écrit en Rust et publié sous licence Apache 2.0. Il lance Claude Code, Codex, Cursor, OpenCode, Grok et d'autres agents sans les modifier : il ne les enveloppe pas et ne les remplace pas. La documentation des concepts définit cinq états :
blocked: l'agent attend une saisie, une validation ou une décision.working: l'agent travaille.done: l'agent a fini et vous n'avez pas encore regardé le résultat.idle: l'agent a fini ou attend, et vous l'avez déjà vu.unknown: herdr ne sait pas classer l'état avec certitude.
Un point compte pour la suite. herdr reconnaît Claude Code et Codex, et il lit leur état dans ce qu'ils affichent à l'écran. L'état blocked est strict : herdr le pose seulement quand l'écran correspond à une invite de validation, une question ou une demande de permission qu'il connaît. Sinon, il retombe sur idle. Une invite qu'il ne reconnaît pas peut donc apparaître comme idle alors que l'agent attend. Quand une intégration remonte l'état elle-même, herdr utilise cette information à la place de la lecture d'écran.
Choisir le VPS : près de vous, car chaque touche fait l'aller-retour
herdr est une TUI (interface texte dans le terminal) que vous pilotez à travers SSH (Secure Shell). Chaque touche part vers le serveur, puis l'écran mis à jour revient. La distance réseau entre vous et le VPS s'ajoute donc à chaque frappe. Pour un développeur en France, choisissez un centre de données en France ou dans un pays voisin. Répondre à Claude Code sur un serveur à l'autre bout du monde reste possible, mais le décalage se sent vite dans une interface interactive.
Mesurez au lieu de deviner. Un ping depuis votre poste vers l'adresse publique du VPS donne le temps d'aller-retour. Comparez deux régions avant de vous engager. Pour la taille de la machine, ce sont surtout vos tests, vos builds et vos serveurs de développement qui consomment du processeur et de la mémoire, pas l'affichage de herdr.
Partez d'un serveur propre : les dix premières minutes sur un nouveau VPS couvrent l'utilisateur non root et les mises à jour.
Joindre le serveur par Tailscale SSH, sans port 22 ouvert sur internet
Tailscale crée un réseau privé entre vos machines, le tailnet. Tailscale SSH ajoute une chose : le démon tailscaled intercepte le trafic du tailnet qui arrive sur le port 22 de l'adresse Tailscale du serveur, et il gère l'authentification à la place de vos clés SSH. Sur le serveur :
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale set --ssh
tailscale ip -4tailscale up affiche une URL. Ouvrez-la pour rattacher le serveur à votre tailnet. La dernière commande affiche l'adresse Tailscale du serveur : notez-la. Selon la documentation Tailscale SSH, la partie serveur demande Tailscale v1.24 ou plus récent.
L'accès dépend de la politique d'accès de votre tailnet. Elle doit autoriser à la fois l'accès réseau et l'accès SSH depuis votre poste. La politique par défaut, non modifiée, laisse un utilisateur joindre ses propres machines en mode check. Lisez ce que ce mode exige dans la documentation Tailscale avant de compter sur des connexions en arrière-plan.
Sur votre poste, donnez un nom court au serveur dans ~/.ssh/config :
Host workbox
HostName ADRESSE_TAILSCALE
User devRemplacez ADRESSE_TAILSCALE par l'adresse affichée par tailscale ip -4, et dev par votre utilisateur sur le serveur. Testez ensuite :
ssh workbox true && echo okLa commande doit afficher ok. Tant qu'elle échoue, rien de ce qui suit ne marchera, car herdr passe par OpenSSH et ne contourne pas cette étape. La documentation de herdr ne parle pas de Tailscale SSH. Ce montage fonctionne parce que herdr utilise votre configuration OpenSSH, où workbox est un hôte comme un autre.
Une fois ssh workbox validé par Tailscale, fermez le port 22 côté internet. Tailscale ne le fait pas pour vous : c'est votre travail, dans le pare-feu réseau de votre fournisseur. Gardez une session ouverte pendant le changement, et vérifiez qu'une nouvelle connexion passe encore. Le guide sécuriser SSH sur un VPS détaille les réglages côté sshd.
Installer herdr v0.9.5 depuis la release GitHub
Le script https://herdr.dev/install.sh télécharge le binaire de la release pour votre plateforme. La page d'installation ne décrit aucune option de version pour ce script. Elle permet de fixer un tag de release seulement avec Nix (nix run github:herdrdev/herdr/v0.x.y), et herdr channel set preview ou herdr channel set stable choisit une ligne de versions, pas une version précise. Pour savoir exactement ce qui tourne sur votre serveur, téléchargez vous-même le binaire de la release v0.9.5. Elle fournit deux binaires Linux, herdr-linux-x86_64 et herdr-linux-aarch64. Ce sont des exécutables nus, sans archive. Vérifiez d'abord l'architecture du serveur :
uname -mx86_64 désigne un processeur Intel ou AMD. aarch64 désigne un processeur ARM. Sur un serveur x86_64 :
curl -fLo herdr https://github.com/herdrdev/herdr/releases/download/v0.9.5/herdr-linux-x86_64
chmod +x herdr
sudo install -m 755 herdr /usr/local/bin/herdr
rm herdr
herdr --versionSur ARM, remplacez le dernier élément de l'URL par herdr-linux-aarch64. L'option -L suit la redirection de GitHub vers son stockage de fichiers. L'option -f fait échouer curl sur une erreur HTTP, au lieu d'enregistrer une page d'erreur sous le nom herdr. herdr --version doit afficher 0.9.5. La page de la release GitHub ne propose pas de fichier de sommes de contrôle, mais herdr publie une empreinte SHA-256 de chaque binaire de la v0.9.5 dans son manifeste latest.json, champ sha256. Comparez-la avec le résultat de sha256sum /usr/local/bin/herdr : 14d9e8bc8b4a9e0118d77c32266f76d461f09b40342eb23752960bd89f59929d pour linux-x86_64, 17d7536f2da50859523680ef279dffcac8e4a235f4e46fe8da6c2ec44141897c pour linux-aarch64.
Installez aussi herdr sur votre poste, avec le binaire qui lui correspond : herdr-macos-aarch64 ou herdr-macos-x86_64 sur Mac, herdr-windows-x86_64.zip sur Windows, ou un binaire Linux. C'est ce client local qui se connectera au serveur plus loin.
La documentation réserve herdr update aux installations faites par l'installeur de herdr. Avec un binaire posé à la main, la mise à jour se fait donc à la main : lisez les notes de la release suivante, puis relancez les mêmes commandes avec le nouveau tag. herdr vérifie lui-même la sortie de nouvelles versions et vous prévient dans l'interface, ce qui vous évite de surveiller GitHub.
La v0.9.5 corrige la v0.9.4. Deux corrections vous concernent. Les questions de Claude Code s'affichent désormais comme blocked dans les sessions nommées. herdr n'installe plus de hooks de tour pour Codex : l'état de Codex vient maintenant de la lecture de l'écran, et herdr integration install codex met à jour une intégration existante.
Premier lancement sur le serveur
ssh workbox
cd ~/mon-projet
herdrherdr lance votre session par défaut en arrière-plan, ou la rejoint si elle existe. Quand une session n'a aucun espace de travail, il en ouvre un. Les raccourcis passent par un préfixe : ctrl+b, puis une touche d'action.
ctrl+bpuisv: coupe le panneau vers la droite.ctrl+bpuis-: coupe le panneau vers le bas.ctrl+bpuisc: ouvre un nouvel onglet.ctrl+bpuisnoup: passe à l'onglet suivant ou précédent.ctrl+bpuisw: navigue entre les espaces de travail.ctrl+bpuisq: détache le client.
C'est le même préfixe que tmux. Si vous lancez herdr à l'intérieur de tmux, le premier des deux qui lit ctrl+b le garde pour lui. Changez le préfixe dans la configuration au lieu d'empiler les deux.
Lancez claude dans un panneau et codex dans un autre. La connexion de ces agents sur un serveur sans écran (abonnement ou clé API) et le réglage de leurs permissions sont traités dans faire tourner Claude Code en sécurité sur un VPS. Installez ensuite les intégrations :
herdr integration install claude
herdr integration install codexElles permettent à l'agent de revenir dans la même session après un redémarrage du serveur herdr. Testez la persistance : ctrl+b puis q, fermez la connexion SSH, reconnectez-vous avec ssh workbox, puis lancez herdr. Vos agents ont continué à travailler pendant votre absence.
Piloter le serveur depuis votre poste avec herdr machine add
Au lieu d'ouvrir SSH puis de lancer herdr sur le serveur, vous pouvez enregistrer le serveur dans le herdr de votre poste. Le travail local et les machines SSH enregistrées partagent alors une seule fenêtre, avec une liste d'agents commune. Chaque machine se reconnecte de son côté. Lancez la commande dans un terminal interactif :
herdr machine add workboxLe terminal interactif compte, car herdr peut poser une question avant d'installer ou de remplacer quelque chose sur le serveur. L'installation ou la mise à jour du paquet distant complet n'a lieu qu'après votre confirmation. Les connexions en arrière-plan, elles, ne répondent jamais à une question. Elles n'installent, ne mettent à jour, ne redémarrent ni ne transfèrent jamais un serveur. Lisez donc chaque question avant de répondre.
Pour viser directement une session précise sans passer par la découverte, ajoutez son nom :
herdr machine add workbox --remote-session agentsPour une connexion ponctuelle sans enregistrer la machine, herdr --remote workbox suffit. Dans un script, listez les agents d'une machine enregistrée :
herdr --machine workbox agent listLe client et le serveur négocient leur compatibilité : ils n'ont pas besoin de la même version exacte. Mettre à jour le client sur votre portable ne remplace pas le serveur distant en cours d'exécution et n'arrête pas ses agents. Si herdr propose de remplacer ce serveur, la réponse par défaut est Non. Appuyer sur Entrée garde donc vos agents en vie.
Après une coupure, par exemple quand votre portable sort de veille, relancez l'authentification SSH dans un terminal :
herdr machine reconnect workboxCette commande n'installe rien et ne met rien à jour. Elle reprend seulement la connexion.
Sous le capot, l'attachement distant gère sa connexion SSH avec des keepalives temporaires et, quand c'est possible, la réutilisation de connexion. Sur Linux et macOS, le client crée un socket de contrôle OpenSSH privé pour chaque attachement. Le réglage manage_ssh_config = false de la configuration fait passer l'attachement par un ssh simple. Essayez-le si votre hôte se comporte bizarrement avec ces options, car ni herdr ni Tailscale ne documente leur interaction avec Tailscale SSH.
Clés SSH, ssh-add et ForwardAgent
Le catalogue local des machines ne stocke ni mot de passe, ni clé privée, ni ticket d'agent, ni socket de contrôle SSH. L'authentification reste entièrement le travail d'OpenSSH. La conséquence est directe : une connexion en arrière-plan ne peut pas taper la phrase de passe de votre clé. Si vous joignez un serveur avec une clé protégée, chargez-la dans l'agent SSH avant de lancer herdr :
ssh-add ~/.ssh/id_ed25519
ssh-add -lssh-add -l liste les clés chargées. La réponse The agent has no identities. signifie qu'aucune clé n'est chargée, et vos connexions en arrière-plan échoueront. Avec Tailscale SSH sur workbox, c'est Tailscale qui authentifie, mais la règle vaut pour tous vos autres serveurs.
Le transfert d'agent (ForwardAgent) vaut no par défaut dans OpenSSH. La documentation de herdr vous demande de l'activer vous-même, seulement pour un hôte de confiance, dans votre configuration SSH. Le manuel de ssh_config explique le risque. Un utilisateur capable de contourner les permissions de fichiers sur le serveur peut utiliser votre agent transféré. Il ne récupère pas la clé, mais il peut s'authentifier avec elle. Réservez ForwardAgent yes aux serveurs dont vous contrôlez tous les comptes root. Pour qu'un agent pousse sur Git depuis le VPS, une clé dédiée au serveur est souvent plus saine, comme l'explique la gestion des clés SSH.
Ce qui survit, et ce qui ne survit pas à un redémarrage
La persistance de herdr a deux niveaux, et la page sur l'état des sessions les distingue clairement.
Premier niveau : vous détachez le client avec ctrl+b puis q, vous fermez le terminal, ou la connexion SSH tombe. Le serveur herdr continue, et chaque agent aussi. C'est la persistance la plus solide, car les processus d'origine ne s'arrêtent jamais.
Second niveau : le serveur herdr s'arrête puis redémarre, ou la machine redémarre. Les processus d'origine sont alors perdus. herdr restaure la forme de la session : espaces de travail, onglets, panneaux, répertoire courant, disposition et focus. La restauration native des sessions d'agent est activée par défaut. Elle relance les agents pris en charge à partir de la référence de session fournie par leur intégration. Une référence absente, invalide, dupliquée ou périmée donne un shell normal à la place. Les shells en cours, les serveurs de développement, les tests et les autres processus ne sont pas conservés.
Concrètement, un redémarrage après une mise à jour du noyau arrête vos agents au milieu de leur tâche. herdr rouvre les panneaux et peut relancer la session d'un agent pris en charge, mais le travail en cours a été interrompu. Vérifiez si votre serveur redémarre seul après les mises à jour automatiques :
grep Automatic-Reboot /etc/apt/apt.conf.d/50unattended-upgradesUne ligne Unattended-Upgrade::Automatic-Reboot "true"; sans // devant signifie que la machine redémarre seule quand une mise à jour l'exige. Avant un redémarrage que vous lancez vous-même, regardez d'abord herdr --machine workbox agent list depuis votre poste, et attendez qu'aucun agent ne soit en working.
Sur un Linux avec systemd-logind, herdr écoute l'avertissement d'arrêt de la machine et demande un court délai pour sauvegarder et s'arrêter proprement. Cette protection n'existe pas sans logind. Elle ne couvre pas un arrêt forcé, une coupure de courant, ni des processus tués avant l'arrivée de l'avertissement. herdr garde jusqu'à 48 instantanés de disposition dans session-snapshots/, à côté de session.json. L'historique d'écran des panneaux est désactivé par défaut.
Questions ouvertes : ports réseau et télémétrie
Deux questions comptent pour un serveur exposé, et la documentation n'y répond qu'en partie.
herdr ouvre-t-il un port ? La documentation de l'API décrit seulement un socket local : du JSON ligne par ligne sur un socket de domaine Unix. Par défaut, c'est ~/.config/herdr/herdr.sock, et ~/.config/herdr/sessions/<nom>/herdr.sock pour une session nommée. Elle ne parle ni de TCP ni d'un port en écoute, et le travail à distance passe par SSH. Je n'ai pas de relevé à vous montrer, donc vérifiez sur votre serveur, avec herdr lancé :
sudo ss -tulnp
sudo ss -xlp | grep herdrLa première commande liste les ports TCP et UDP en écoute, avec le processus qui les tient. Cherchez herdr dans la colonne des processus. D'après la documentation, vous ne devriez pas l'y trouver. La seconde commande doit montrer le socket Unix. Si herdr apparaît dans la première liste, la documentation est incomplète : signalez-le au projet avant d'ouvrir quoi que ce soit.
herdr envoie-t-il de la télémétrie ? Les pages de la documentation TUI que j'ai lues (installation, démarrage rapide, concepts, agents, état des sessions, API, configuration, connexion des machines) ne parlent ni de télémétrie ni d'option pour la couper. Elles parlent en revanche de la vérification des nouvelles versions, qui implique une requête réseau. L'application de bureau Herdr, elle, envoie un rapport d'usage quotidien activé par défaut, avec ses propres options de désactivation. Ce document concerne l'application, pas le binaire herdr de ce guide, donc n'en tirez aucune conclusion pour la TUI. Si la question compte pour vous, lisez le code source, ou observez les connexions sortantes avec sudo ss -tnp | grep herdr pendant que herdr tourne.
Git worktrees : un agent par copie de travail
Deux agents dans le même répertoire modifient les mêmes fichiers et se gênent. Git sait créer une seconde copie de travail liée au même dépôt : git worktree add ../mon-projet-auth -b auth crée le dossier ../mon-projet-auth sur une nouvelle branche auth. Ouvrez un panneau herdr dans ce dossier et lancez-y le second agent. Après la fusion, git worktree remove ../mon-projet-auth supprime la copie. C'est du Git pur : la documentation de herdr ne mentionne pas les worktrees, et herdr n'a rien de spécial à faire ici.
herdr-core et l'application Herdr : à ne pas confondre
Hors du périmètre de ce guide. Le nom Herdr couvre trois programmes. Le binaire herdr utilisé ici est la TUI, que le site décrit comme « the original Herdr: a terminal app with its own server ». herdr-core est un projet séparé : son outil hc lance des programmes et des agents dans des terminaux qui restent vivants après votre départ. Il s'installe avec le script https://releases.herdr.dev/core/install.sh. L'application de bureau Herdr a son propre script, https://releases.herdr.dev/app/install.sh, qui installe aussi herdr-core s'il n'est pas encore présent. L'application pour téléphone n'a pas de script : elle s'installe depuis l'App Store ou Google Play. Selon le site, la TUI et l'application ne partagent pas leurs agents. L'application mobile se connecte à herdr-core en SSH ou par Tailscale, sans compte, et pas à la TUI. Ne mélangez donc jamais les commandes hc et herdr : hc machine add et herdr machine add appartiennent à deux programmes différents. Pour répondre à vos agents depuis un téléphone sans quitter la TUI, voyez plutôt piloter Claude Code depuis un téléphone.
Pannes courantes et leurs causes
herdr machine add workbox échoue tout de suite. Testez ssh workbox true && echo ok. Si SSH répond Permission denied (publickey), le problème vient de SSH et pas de herdr : suivez corriger l'erreur Permission denied (publickey).
La connexion marche dans un terminal, mais plus en arrière-plan. Votre clé a une phrase de passe et l'agent SSH ne la contient pas. Le catalogue de herdr ne stocke aucune clé, donc rien d'autre ne peut la fournir. Lancez ssh-add, puis herdr machine reconnect workbox.
Un agent attend votre réponse, mais le panneau affiche idle. L'état blocked dépend d'invites connues. Une invite que herdr ne reconnaît pas retombe sur idle. Vérifiez que vous êtes en v0.9.5, qui corrige les questions de Claude Code dans les sessions nommées, et que l'intégration de l'agent est installée.
Après un redémarrage, un panneau n'est plus qu'un shell. La référence de session de cet agent était absente ou périmée, ou l'agent n'est pas pris en charge. Relancez-le à la main dans ce panneau.
FAQ
herdr remplace-t-il tmux pour faire tourner Claude Code sur un VPS ?
Pour des agents de code, oui, c'est son rôle. Les deux gardent les processus en vie dans un serveur en arrière-plan quand vous vous déconnectez. herdr ajoute un état par panneau (working, blocked, idle, plus done et unknown), qui montre quel agent attend une réponse. L'état blocked dépend toutefois d'invites que herdr reconnaît, et une invite inconnue s'affiche comme idle.
Mes agents herdr survivent-ils au redémarrage du VPS ?
Non, pas les processus. Une déconnexion SSH ou un client fermé ne les touche pas. Un redémarrage de la machine ou du serveur herdr les arrête. herdr restaure ensuite les espaces de travail, les onglets, les panneaux et la disposition. Il relance aussi les agents pris en charge dont l'intégration a enregistré une session. Les tests, les serveurs de développement et les autres processus en cours sont perdus.
Faut-il installer herdr sur le serveur avant herdr machine add ?
Ce n'est pas obligatoire. Lancé dans un terminal interactif, herdr machine add workbox peut installer ou mettre à jour le paquet distant, mais seulement après votre confirmation. Les connexions en arrière-plan n'installent jamais rien. Installer vous-même le binaire de la release v0.9.5 vous permet de savoir exactement quelle version tourne sur le serveur.
herdr ouvre-t-il un port réseau ou envoie-t-il de la télémétrie ?
La documentation de la TUI décrit seulement un socket Unix local, et le travail à distance passe par SSH. Elle ne documente aucune télémétrie ni option pour la couper, mais elle mentionne une vérification des nouvelles versions. Vérifiez vous-même avec sudo ss -tulnp pour les ports en écoute et sudo ss -tnp | grep herdr pour les connexions sortantes.