Faire tourner Claude Code sur un VPS

Faire tourner Claude Code sur un serveur plutôt que sur votre portable vous apporte trois choses. Il continue de travailler quand votre portable est fermé. Il survit à une connexion perdue. Et il place l'agent sur une machine que vous pouvez jeter, pas sur celle qui contient vos clés SSH et votre profil de navigateur. Ce guide décrit une installation d'environ quinze minutes sur une machine Debian ou Ubuntu neuve. Les mêmes étapes fonctionnent sur Alpine et Fedora avec de petites adaptations.

Il vous faut un forfait Claude qui inclut Claude Code : Pro, Max, Team ou Enterprise, ou un compte Console. L'offre gratuite de claude.ai ne l'inclut pas. Connectez-vous avec votre abonnement : aucune clé API à gérer, aucun usage facturé en plus.

1. Choisir une machine

La configuration requise d'Anthropic indique 4 Go de RAM ou plus et un processeur x64 ou ARM64. Les systèmes Linux pris en charge sont Ubuntu 20.04+, Debian 10+ et Alpine 3.19+. En pratique, la chaîne d'outils de votre projet pèse plus lourd que la CLI :

• 4 Go : le minimum documenté, suffisant pour une session sur un projet modeste.
• 8 Go : si vous compilez quoi que ce soit de conséquent (un bundler, une suite de tests, un conteneur ou deux) ou faites tourner plusieurs sessions à la fois.
• 16 Go : si vous faites tourner plusieurs agents en parallèle, ou une base de données à côté.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr et d'autres conviennent tous, tout comme une vieille machine sous votre bureau. Choisissez une région proche de vous si vous comptez taper dans un terminal dessus. Les instances ARM sont généralement les moins chères au gigaoctet, et Claude Code y tourne nativement. Notre guide du meilleur VPS pour les agents de code compare les hébergeurs et les tailles.

2. Créer un utilisateur non root

Beaucoup d'images VPS vous connectent en root. Ne faites pas tourner l'agent en root : la moindre erreur devient une erreur à l'échelle du système. Claude Code refuse aussi de démarrer en mode bypass-permissions en root, donc il vous faudra de toute façon un utilisateur normal tôt ou tard. Sur Debian ou Ubuntu :

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

Sur Fedora, le groupe d'administration est wheel au lieu de sudo. Sur Alpine, installez d'abord sudo ou doas. La dernière ligne copie la clé avec laquelle vous êtes déjà connecté, pour pouvoir vous reconnecter en tant que dev avant de verrouiller quoi que ce soit. Testez depuis un second terminal avant de fermer le premier. S'enfermer dehors d'un VPS tout neuf est un rite de passage dont on se passe volontiers.

3. Clés SSH et durcissement

Si vous vous connectez encore par mot de passe, passez d'abord à une clé. Générez-en une sur votre ordinateur avec ssh-keygen -t ed25519, puis copiez-la avec ssh-copy-id dev@your-server. Une fois la connexion par clé fonctionnelle, modifiez /etc/ssh/sshd_config :

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Redémarrez ensuite SSH : sudo systemctl restart ssh sur Debian et Ubuntu. Sur Fedora, le service s'appelle sshd : lancez donc sudo systemctl restart sshd. Pour aller plus loin, ajoutez fail2ban et un pare-feu qui n'autorise que SSH. Si la machine n'a pas du tout besoin d'être sur l'Internet public, placez-la sur un réseau Tailscale. Votre téléphone rejoint le même réseau et la joint directement.

Depuis un téléphone : les apps SSH peuvent générer une clé sur l'appareil et vous montrer la partie publique à coller dans ~/.ssh/authorized_keys. Maude le fait pour vous : son bouton « Configurer la connexion par clé » crée une clé via la connexion avec laquelle vous êtes déjà connecté. Il installe la partie publique, teste la nouvelle clé et ne garde la partie privée que dans le trousseau du téléphone.

4. Installer Claude Code

Anthropic recommande désormais l'installeur natif, qui n'a pas besoin de Node.js. Lancez-le avec votre utilisateur normal, pas avec sudo :

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Il place le lanceur dans ~/.local/bin/claude et se met à jour tout seul en arrière-plan. claude doctor vérifie l'installation et vos paramètres sans démarrer de session. Quelques alternatives, toutes tirées de la documentation d'installation :

• Des dépôts apt, dnf et apk signés si vous préférez que le gestionnaire de paquets du système s'en charge. Ils ne se mettent pas à jour automatiquement ; vous mettez à jour avec le reste du système.
• npm fonctionne toujours (npm install -g @anthropic-ai/claude-code, Node.js 22 ou plus récent). Il installe le même binaire natif. Anthropic déconseille sudo npm install -g.
• Alpine a besoin de bash, curl, libgcc, libstdc++ et ripgrep, plus USE_BUILTIN_RIPGREP=0 dans vos paramètres.

Si un ancien guide vous disait d'installer Node d'abord, vous pouvez désormais sauter cette étape.

5. Se connecter sans navigateur

Lancez claude (ou claude auth login) et suivez les instructions. Un VPS n'a pas de navigateur, donc vous ouvrirez l'URL de connexion sur un autre appareil. Claude Code vous permet d'appuyer sur c pour la copier. Connectez-vous là-bas. Quand le navigateur ne peut pas joindre le callback local de Claude Code, ce qui est normal via SSH, il affiche un code à la place. Collez-le à la ligne Paste code here if prompted et la connexion se termine sur le serveur.

L'identifiant est enregistré dans ~/.claude/.credentials.json avec le mode 0600. Traitez la machine en conséquence : quiconque a un shell avec cet utilisateur peut utiliser votre abonnement Claude. Pour les scripts et la CI, il existe aussi claude setup-token, qui affiche un jeton valable un an que vous définissez comme CLAUDE_CODE_OAUTH_TOKEN. D'après la documentation d'authentification, ce jeton ne peut faire que des requêtes au modèle et ne peut pas lancer de sessions Remote Control.

6. Le garder en vie

Tout ce que vous lancez au premier plan d'une session SSH meurt avec cette connexion. La solution habituelle est tmux :

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Vous pouvez vous détacher, perdre le réseau, vous reconnecter des heures plus tard et vous rattacher : la session est intacte. tmux ne survit pas à un redémarrage, en revanche. Après un redémarrage, claude --continue reprend la conversation la plus récente de ce dossier. Notre guide pour garder Claude Code actif après avoir fermé votre portable couvre les autres options, dont systemd et les daemons de sessions.

7. Même machine, plus d'agents

Un serveur qui fait tourner Claude Code peut faire tourner les autres agents de code à côté. Chacun s'installe dans votre répertoire personnel et garde sa propre connexion, donc ils ne se gênent pas. Prévoyez de la RAM pour chacun de ceux qui tournent en même temps.

Sources : authentification Codex, documentation OpenCode, documentation Grok Build, installation d'Antigravity CLI, vérifiées en octobre 2026. Codex et Antigravity ont leurs propres pas-à-pas : Codex CLI sur un VPS et Antigravity CLI sur un serveur. Gemini CLI n'est plus une option pour les comptes Google personnels, et Antigravity CLI est son remplaçant chez Google.

8. Le joindre depuis votre téléphone

Il y a trois façons de faire, de la plus manuelle à la moins manuelle :

Une app SSH et tmux. Termius, Blink ou n'importe quel autre client, rattaché à votre session tmux. C'est gratuit et complet, et vous pilotez un terminal plein écran avec un clavier virtuel. Voici comment cela se compare.

Remote Control. Lancez claude remote-control dans tmux et ouvrez la session depuis l'onglet Code de l'app Claude. C'est inclus dans Pro, Max, Team et Enterprise. La documentation d'Anthropic suggère tmux ou screen précisément pour ce cas. Cela ne fonctionne que pour Claude, et les demandes d'autorisation de la session arrivent sur le téléphone, où vous y répondez. L'app ne peut pas passer la session en Auto ni en Bypass permissions.

Maude. Maude se charge des étapes 4 et 6, et l'étape 5 se fait depuis votre téléphone. Vous ajoutez le serveur par son adresse, en collant une commande ssh … ou en scannant un QR code issu de curl -fsSL https://maude.pilotdev.fr/setup | sh. Si vous êtes connecté en root, un bouton crée pour vous l'utilisateur non root de l'étape 2. Maude déploie ensuite son propre daemon via SSH et installe chaque agent dans une version que nous avons testée et figée. Vous vous connectez à Claude, Codex ou n'importe quel autre depuis le téléphone. Les sessions continuent sur le serveur quand l'app est fermée, et le serveur se connecte lui-même au relais de Maude, donc cela fonctionne derrière un NAT sans port ouvert.

9. Décider des autorisations

Vient maintenant la question intéressante : jusqu'où le laissez-vous agir sans surveillance ? Un serveur que vous pouvez reconstruire est le bon endroit pour assouplir les autorisations, à condition de l'avoir réellement traité comme jetable. Le mode auto de Claude Code, où un classifieur approuve les actions sûres, comble une bonne partie de l'écart. Le bypass complet a ses propres règles, dont la restriction en root de l'étape 2. Elles ont leur propre page : faire tourner Claude Code avec toutes les autorisations, en sécurité.

Le piloter depuis votre téléphone

Une fois le serveur en place, Claude Code sur votre téléphone explique comment Maude le pilote. Si Claude n'est pas votre seul agent, commencez par la vue d'ensemble des agents.

Questions fréquentes

Ce qui a changé

• 1 octobre 2026 — Installation basculée sur l'installeur natif d'Anthropic (Node.js n'est plus nécessaire) ; recommandations de RAM alignées sur le minimum documenté de 4 Go ; ajout du parcours de connexion headless par code collé et de setup-token ; nouvelle section sur Codex, OpenCode, Grok Build et Antigravity sur la même machine.
• 25 juillet 2026 — Première publication.