Claude Code sur un VPS : le faire tourner sur un serveur Linux et le piloter depuis votre téléphone

Ce qu’il vous faut

• Un serveur Linux accessible en SSH, chez un fournisseur comme DigitalOcean ou OVHcloud. N’importe quelle distribution convient pour la CLI Claude Code ; Claude Desktop nécessite Ubuntu 22.04 ou version ultérieure, ou Debian 12 ou version ultérieure.
• Un forfait Claude Pro, Max, Ultra, Team ou Enterprise. Remote Control ne fonctionne pas avec les clés API, et sur Team ou Enterprise, un Owner doit d’abord l’activer.
• L’application Claude sur votre téléphone (iOS ou Android), ou claude.ai/code dans un navigateur.
• En option, un environnement de bureau et un bureau à distance sur le serveur, pour les fois où Claude a besoin d’un site web sur lequel vous devez vous connecter.

Comment configurer Claude Code sur un VPS Linux

1. Louez un serveur et connectez-vous-y

   Créez un serveur Linux chez un fournisseur comme DigitalOcean ou OVHcloud et connectez-vous-y en SSH. Choisir Ubuntu 22.04+ ou Debian 12+ vous laisse Claude Desktop comme option ; sur toute autre distribution, vous utilisez la CLI.

2. Installez Claude Code et connectez-vous

   Installez la CLI Claude Code avec le script d’installation d’Anthropic. Elle tourne dans un terminal (Anthropic cite Ubuntu 20.04+ et Debian 10+ parmi les systèmes pris en charge) : elle convient donc à un serveur headless que vous n’atteignez qu’en SSH. Sur Ubuntu 22.04+ ou Debian 12+, vous pouvez installer Claude Desktop à la place, avec apt ; il est en bêta sous Linux (voir Claude Desktop sous Linux). Lancez ensuite claude et connectez-vous avec votre compte Claude, pas avec une clé API.

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

3. Lancez Remote Control en mode serveur

   Depuis le dossier de votre projet, lancez claude remote-control. Cela démarre un serveur qui peut héberger plusieurs sessions Claude Code à la fois, et vous pouvez ouvrir chacune d’elles depuis votre téléphone. Ajoutez --chrome pour activer l’intégration Chrome dans ces sessions. Pour que ce soit plutôt chaque session interactive qui se connecte, mettez remoteControlAtStartup à true dans ~/.claude/settings.json.

   # Start a tmux session, so the server keeps running after you close SSH
   tmux new -s claude
   
   # Inside tmux, from your project folder: run the Remote Control server and
   # restart it whenever it exits (it gives up after ~10 minutes offline)
   cd ~/my-project
   while true; do claude remote-control; sleep 10; done
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t claude

4. Gardez-le actif après votre déconnexion

   Remote Control ne fonctionne que tant que le processus claude tourne : fermez le terminal et ses sessions passent hors ligne. Lancez-le dans tmux ou screen pour qu’il survive à la fermeture de la connexion SSH, ou comme service. Le mode serveur s’arrête aussi après environ 10 minutes sans réseau : relancez-le automatiquement, comme le fait la boucle ci-dessus. Pour les modes de permission et les limites d’usage sur les longues exécutions, voir comment faire tourner Claude Code 24 h/24, 7 j/7.

5. Ouvrez-le depuis votre téléphone

   Ouvrez l’application Claude sur iOS ou Android, ou claude.ai/code, et choisissez une session. Claude tourne sur le serveur ; le téléphone affiche la conversation et envoie vos messages. Les détails de configuration et les solutions aux problèmes se trouvent dans le guide Remote Control. Pour écrire plutôt à Claude Code depuis Telegram, voir les channels de Claude Code.

Source : documentation Remote Control d’Anthropic

Ajouter un bureau pour vous connecter aux sites web

Un serveur que vous atteignez en SSH n’a pas d’écran, ce qui ne pose aucun problème jusqu’à ce que Claude ait besoin d’un site sur lequel vous devez vous connecter. Ajoutez un bureau à distance et vous pourrez vous connecter vous-même, puis laisser Claude utiliser le navigateur.

• Installez un environnement de bureau et un serveur de bureau à distance sur le VPS, et ouvrez-le depuis votre portable quand vous devez vous connecter quelque part.
• Installez Google Chrome ou Microsoft Edge avec l’extension Claude in Chrome, et connectez-vous aux sites que Claude doit utiliser. Claude in Chrome fonctionne sous Linux ; il n’est pas pris en charge dans WSL.
• Démarrez le serveur avec claude remote-control --chrome pour que ses sessions puissent utiliser ce navigateur.
• Accédez au bureau à distance via Tailscale, qui place vos appareils sur un réseau privé, un tailnet, où eux seuls peuvent se joindre entre eux. Voir ce qu’est Tailscale.
• Avec un bureau sur Ubuntu ou Debian, Claude Desktop est aussi une option, en plus de la CLI.

Ce qu’un serveur Linux ne sait pas faire

Si l’un de ces points compte pour vous, utilisez plutôt un Mac mini à la maison, la configuration que l’on utilise chez Crewmark.

• Pas de Computer Use. Claude ne peut pas utiliser les applications et l’écran sous Linux : dans la CLI, Computer Use est réservé à macOS, et dans Claude Desktop, c’est une préversion de recherche sur macOS et Windows.
• Pas de développement iOS. Xcode et l’iOS Simulator ne tournent que sur macOS : un serveur Linux ne peut donc ni compiler ni exécuter une application iPhone.
• Une application de bureau plus limitée. Claude Desktop sous Linux est une bêta pour Ubuntu et Debian, sans Computer Use, Cowork ni dictée.
• Un processus qui doit rester actif. Comme pour toute configuration Remote Control, les sessions ne sont joignables que tant que claude tourne sur le serveur.

Mac mini ou VPS Linux pour Claude Code

Donnez un poste permanent au serveur

Un serveur qui ne se met jamais en veille répond chaque fois que vous lui écrivez, et attend quand vous ne le faites pas. Crewmark transforme une conversation Claude Code sur ce serveur en employé IA doté d’un rôle, d’objectifs, d’horaires de travail et d’une pulsation : pendant les horaires de travail, la CLI crewmark, qui tourne sous Linux comme sous macOS et Windows, réveille l’employé pour qu’il traite ses tickets sur un tableau partagé. L’ordinateur sur lequel il tourne doit rester allumé, et c’est le cas d’un VPS.

1. Recrutez un employé

   Choisissez un rôle parmi les rôles d’employés IA, comme ingénieur logiciel ou spécialiste SEO, et rédigez ses objectifs et ses KPI.

2. Connectez Claude Code sur le serveur

   Collez le lien de configuration dans une conversation Claude Code sur le VPS. Il installe la CLI crewmark et relie cette conversation à l’employé. Codex fonctionne aussi.

3. Fixez les horaires de travail et une pulsation

   En semaine seulement ou tous les jours, des horaires qui peuvent dépasser minuit, et un réveil toutes les 15, 30, 60, 120 ou 240 minutes.

4. Assignez des tickets depuis votre téléphone

   Créez et assignez des tickets sur le tableau de crewmark.ai depuis n’importe quel navigateur ; en assigner un réveille l’employé immédiatement. Quand il a besoin d’une revue ou d’une décision, il passe le ticket en Needs action et vous pose la question sur le ticket. Des missions à lui confier se trouvent dans les cas d’usage de Claude Code.

FAQ