Ton propre Claude Code accessible du téléphone — VPS, Coolify, MCP – AutomationBoost
◈ Guide · VPS + Coolify

Ton propre Claude Code, accessible depuis ton téléphone

3 étapes· 3 à 7 h de mise en place· Niveau intermédiaire· Linux en ligne de commande requis

L'application mobile te donne une conversation. Ce qui suit te donne autre chose : un terminal qui tourne en permanence sur ta propre machine, qui voit tes fichiers, tes dépôts et tes automatisations, et que tu peux déclencher depuis ton téléphone — dans la file d'attente, chez le coiffeur, n'importe où.

La différence n'est pas le confort, c'est ce qu'il peut faire. Une conversation te répond. Un terminal agit : il écrit dans tes fichiers, lance tes scripts, commite, déploie. Et comme il tourne chez toi, il n'oublie rien entre deux sessions.

À lire avant de commencer

Ce guide décrit un montage à reproduire chez toi, pas un service à acheter. Tu auras besoin d'un serveur à toi, d'un nom de domaine, et d'être à l'aise avec une ligne de commande Linux. Si ces trois mots te sont étrangers, commence par autre chose — ce n'est pas une question d'intelligence, c'est une question d'heures.

Ce que tu vas monter
  1. Un VPSLa machine qui ne s'éteint jamais
  2. CoolifyCe qui remplace « je bricole en SSH »
  3. Claude Code en conteneurEt pourquoi il tourne sous un utilisateur non-root
  4. Tes MCPLe piège qui fait perdre une soirée
  5. L'appeler depuis le téléphoneDeux chemins, un seul tient la route
  6. Ce qui casse vraimentLes quatre pannes que tu auras

1. Un VPS — la machine qui ne s'éteint jamais

Un VPS est un ordinateur loué, allumé en permanence, chez un hébergeur. C'est la seule pièce que tu ne peux pas remplacer par autre chose : il faut une machine qui reste debout quand ton portable est fermé.

Deux critères, et un seul compte vraiment :

  • La mémoire vive. C'est là que ça se joue. Un agent qui code ouvre des processus, un navigateur sans interface, parfois un encodage vidéo. Quand la RAM sature, les symptômes ne ressemblent pas du tout à un manque de mémoire : un rendu s'arrête au milieu, une commande meurt sans message. Tu chercheras le bug pendant une heure au mauvais endroit.
  • Le disque. Moins critique, mais il se remplit sans prévenir — images Docker, journaux, anciens déploiements. Un disque plein bloque les déploiements avec des messages qui parlent de tout sauf de disque.

Le processeur n'est pas le sujet : le modèle ne tourne pas chez toi, il répond depuis les serveurs d'Anthropic. Ta machine ne fait qu'orchestrer.

Le réflexe qui fait gagner une heure

Avant d'accuser un script, regarde la mémoire disponible et l'espace disque. Sur ce montage, la cause la plus fréquente d'un « ça a planté sans rien dire » est une session abandonnée qui n'a jamais rendu sa mémoire. Vérifie la machine avant de déboguer le code.

2. Coolify — ce qui remplace « je bricole en SSH »

Coolify est une interface que tu installes sur ton VPS pour déployer des applications sans écrire de fichiers de configuration à la main. C'est ce qui transforme un serveur nu en quelque chose que tu peux piloter depuis un navigateur — y compris depuis un téléphone.

Tu t'en serviras pour trois choses : héberger Claude Code, héberger tes autres outils (une instance n8n, tes sites), et surtout redémarrer quelque chose quand tu n'es pas devant ton ordinateur.

Le piège qui coûte le plus de temps perdu

Coolify ne redéploie pas tout seul quand tu pousses sur Git. Tu pousses, tu rafraîchis la page, tu ne vois aucun changement, et tu conclus que ton code est faux. Il ne l'est pas : le déploiement n'a jamais été déclenché. Il faut le lancer — depuis l'interface, ou par un appel à son API. Note-le quelque part maintenant, tu te feras avoir une fois quand même.

3. Claude Code en conteneur

Claude Code s'installe dans un conteneur Docker que Coolify gère comme n'importe quelle autre application. Le conteneur monte le dossier de travail que tu veux lui confier — tes dépôts, tes projets — et c'est tout ce qu'il voit.

L'utilisateur non-root, et pourquoi ça n'est pas un détail

Fais tourner le processus sous un utilisateur normal, pas sous root. La raison est très concrète : si l'agent écrit dans ton dépôt Git en tant que root, une partie des fichiers internes de Git appartiendra à root. Plus tard, tes commits échoueront — pas systématiquement, une fois sur vingt, ce qui est bien pire qu'une panne franche : tu croiras à un problème réseau, à un verrou, à n'importe quoi d'autre.

Concrètement, on appelle le binaire en imposant l'utilisateur :

docker exec -i -u 1000:1000 <nom-du-conteneur> \ claude -p --dangerously-skip-permissions "<ta consigne>"

Deux options méritent une explication :

  • -p exécute une consigne et rend la réponse sur la sortie standard, sans session interactive. C'est ce qui rend l'appel utilisable depuis un script.
  • --dangerously-skip-permissions supprime les demandes de confirmation. Sans elle, l'appel reste bloqué à attendre un « oui » que personne ne tapera. Le nom est volontairement alarmant : ne mets ce conteneur en contact qu'avec des dossiers que tu acceptes de voir modifiés.

Ce que ça coûte, et ce que ça ne coûte pas

Ce montage consomme ton abonnement, pas une facturation à l'usage. C'est exactement l'inverse d'un appel d'API classique, où chaque requête est débitée d'un solde de crédits. La distinction devient très concrète le jour où ton solde d'API tombe à zéro et où la moitié de tes automatisations s'arrête — pendant que ce terminal-là, lui, continue de répondre.

4. Tes MCP — le piège qui fait perdre une soirée

Les MCP sont les connecteurs qui donnent à l'agent l'accès à tes outils. Et il y a ici une limite qu'aucune documentation ne met en avant, parce qu'elle ne se voit pas sur un poste de travail.

Il existe deux façons pour un serveur MCP de communiquer : en lançant un programme local et en lui parlant par son entrée-sortie (stdio), ou par le réseau (HTTP / SSE).

TransportSur ton ordinateurDans le conteneur
stdiofonctionnene se connecte pas
HTTP / SSEfonctionnefonctionne

Un serveur en stdio suppose qu'il peut démarrer un programme sur la même machine que le client. Dans un conteneur qui n'a ni ce programme ni son environnement, la connexion échoue — et l'échec ressemble à une erreur de configuration. Tu relis ton fichier de config dix fois, tu changes les chemins, tu recommences. Le fichier est bon ; c'est le transport qui ne passe pas.

La règle est donc simple, et elle conditionne le choix de tes outils : dans ce montage, ne retiens que les MCP joignables par HTTP ou SSE. Ça écarte certains connecteurs pratiques — mieux vaut le savoir avant de bâtir dessus qu'après.

5. L'appeler depuis ton téléphone

C'est la partie qui donne son intérêt à tout le reste. Deux chemins, et ils ne se valent pas.

Le terminal web

Coolify donne un accès console dans le navigateur. Ça marche, et c'est parfait pour dépanner. Mais taper des commandes sur un clavier de téléphone, dans une file d'attente, n'est agréable à personne. À réserver à l'urgence.

Un déclencheur qui fait le travail — la bonne réponse

Le vrai usage mobile, ce n'est pas de taper des commandes : c'est de déclencher une tâche déjà écrite. Tu montes un webhook dans ton outil d'automatisation, il ouvre une connexion SSH vers le serveur, exécute la commande vue plus haut, et te renvoie la réponse — par message, par email, comme tu veux. Depuis ton téléphone, tu remplis un champ et tu ranges le téléphone.

Trois choses à savoir avant de brancher ça sur quoi que ce soit de sérieux :

  1. La réponse est du texte libre, pas des données structurées. Si la suite de ta chaîne attend un format précis, demande-le explicitement dans la consigne et vérifie le résultat derrière. Sinon tu recevras une phrase là où tu attendais un objet.
  2. Ce n'est pas instantané. L'appel traverse le réseau, le conteneur, puis une génération complète. On compte en dizaines de secondes, pas en millisecondes. Sur un webhook qui doit répondre tout de suite à quelqu'un, passe en asynchrone.
  3. La consigne doit être sans ambiguïté. Le modèle interprète : si ton gabarit dit une chose et ta consigne réelle une autre, il suivra la consigne réelle et te le dira. C'est une qualité chez un humain, un piège dans une chaîne automatique.

Et surtout : protège ce déclencheur. Une URL qui exécute des commandes sur ton serveur ne doit pas être devinable. Mets une authentification dessus, dès le premier jour, pas « plus tard ».

Ce qui casse vraiment

Les quatre pannes que tu auras, dans l'ordre de fréquence. Aucune ne se présente sous son vrai nom — c'est précisément ce qui les rend coûteuses.

Ce que tu voisCe que c'est vraiment
Un traitement s'arrête au milieu, sans erreur La mémoire vive est saturée, souvent par des sessions abandonnées qui ne se sont jamais fermées
Un déploiement échoue avec un message obscur Le disque est plein. Le journal du déploiement le dit, la notification non
Un commit échoue une fois sur vingt Des fichiers internes de Git appartiennent à root — voir l'utilisateur non-root plus haut
Ton code modifié ne change rien en ligne Le déploiement n'a jamais été déclenché ; pousser sur Git ne suffit pas

Une cinquième, plus sournoise : ce qui est mis en cache devant ton site. Si tu passes par un service comme Cloudflare, il garde les réponses — et les en-têtes — plusieurs heures. Tu corriges quelque chose, tu recharges, rien ne bouge, tu recorriges. Pour vérifier une correction, ajoute toujours un paramètre inutile à l'URL (?x=123) : ça force une vraie réponse au lieu d'une copie.

Est-ce que ça vaut le coup ?

Comptez trois à sept heures pour la mise en place, selon votre aisance avec un serveur. C'est un investissement, pas un après-midi.

Ce que ça change : le temps mort redevient du temps de travail. Une idée qui arrive dans une file d'attente devient une tâche lancée, pas une note qu'on relira jamais. Et ce que l'agent produit reste sur ta machine, dans tes dépôts.

Ce que ça ne change pas, et qu'il faut entendre : ça n'écrit pas ta stratégie à ta place. Un terminal qui exécute vite amplifie ce que tu lui demandes — y compris les mauvaises décisions. L'outil sert ceux qui savaient déjà quoi faire et manquaient de temps. Si le problème est ailleurs, ce montage ne le réglera pas.

Tu veux qu'on le monte ensemble ? → voir mon audit

TERMINAL | TONY PAYET / AUTOMATION BOOST | 2026

← Toutes les ressources