Claude Code depuis ton téléphone

Ce que c'est et pourquoi ça compte

Tu es dans le train et tu repenses au truc à corriger. Mais le projet est sur l'ordinateur, à la maison. Remote Control est la fonction officielle de Claude Code pour ça : elle relie l'app Claude sur ton téléphone (iOS ou Android), ou claude.ai/code dans un navigateur, à une session de Claude Code qui tourne sur ton ordinateur.

Ce qui compte : Claude travaille sur ton ordinateur, pas dans le cloud. Fichiers, outils, serveurs MCP et réglages du projet restent là. Le téléphone n'est qu'une fenêtre sur cette session, et la conversation est la même partout : tu peux écrire depuis le terminal, le navigateur et le téléphone, en alternant.

Remote Control est sorti de la research preview, la phase d'essai. Pas de bots bricolés et aucun port ouvert sur l'ordinateur. La contrepartie : l'ordinateur reste allumé, avec Claude Code ouvert.

1. Ce qu'il vous faut

• Un abonnement Pro, Max, Team ou Enterprise. Ça ne marche pas avec une clé API.
• Sur Team et Enterprise, un Owner de l'organisation active d'abord l'interrupteur Remote Control dans les réglages d'administration de Claude Code : par défaut, il est désactivé.
• Être connecté avec ton compte claude.ai : dans Claude Code, tape /login.
• Claude Code relié directement à l'API d'Anthropic. Ça ne marche pas avec Amazon Bedrock, Google Cloud ou Microsoft Foundry, ni si ANTHROPIC_BASE_URL pointe vers une autre adresse, comme une passerelle ou un proxy.
• L'app Claude sur ton téléphone, avec le même compte. Si tu ne l'as pas, tape /mobile dans Claude Code : un QR code apparaît et ouvre le bon store.

Si quelque chose ne démarre pas, tape claude doctor dans le terminal : il te dit quelle vérification a échoué.

2. Active-le sur l'ordinateur : trois façons

Mode serveur : claude remote-control

C'est celui que j'utilise pour le téléphone. Dans le dossier du projet, tape :

claude remote-control

Le terminal attend et t'affiche le lien de la session. Appuie sur la barre d'espace et un QR code apparaît : tu le scannes avec ton téléphone et il s'ouvre dans l'app Claude. Dans ce mode, tu n'écris pas dans le terminal : il montre l'état de la connexion et ce que fait Claude. En échange, tu peux ouvrir plusieurs sessions en même temps.

Session normale : claude --remote-control

Ouvre la session habituelle dans le terminal, où tu peux écrire, et elle est aussi joignable depuis le téléphone. La forme courte est claude --rc, et tu peux lui donner un nom : claude --remote-control "Mon projet".

Depuis une session déjà ouverte : /remote-control

Tu es déjà en train de bosser et tu dois partir ? Tape /remote-control (ou /rc) dans la session : tu continues depuis le téléphone avec toute la conversation jusque-là. Ça marche aussi dans l'app de bureau Claude et dans l'extension VS Code.

3. La première fois : les questions à ne pas zapper

La première fois, claude remote-control t'explique ce qu'il fait et demande Enable Remote Control? (y/n). Réponds y. Si tu dis non, il quitte sans démarrer et te le redemande la fois suivante.

Si tu n'as pas encore fait confiance à ce dossier, il te dit ce que la confiance active et demande Trust <dossier>? [y/N]. La réponse est enregistrée, sauf dans ton dossier personnel : là, il te le demande à chaque démarrage. C'est pour ça qu'on le lance dans le dossier du projet.

Il peut aussi te demander comment créer les sessions. Avec same-dir, elles travaillent toutes dans le même dossier, et si deux touchent le même fichier, elles se marchent dessus. Avec worktree, chaque nouvelle session a sa propre copie du projet (un worktree git). Si tu ouvres une session à la fois, same-dir suffit. Pendant qu'il tourne, tu changes avec w.

4. Depuis le téléphone : la carte de ton ordinateur

1. Ouvre l'app Claude et touche Code.
2. En haut, tu trouves ton ordinateur sous forme de carte d'appareil. Elle est là tant que claude remote-control tourne.
3. Touche-la, choisis le dossier du projet, et une session démarre là, sur ton ordinateur.
4. Les sessions déjà ouvertes sont dans la liste en dessous : celles de Remote Control ont une icône d'ordinateur, avec un point vert quand elles sont en ligne.

Maintenant, écris comme tu le ferais à l'ordinateur ; avec @, tu complètes les noms des fichiers du projet. Tu peux joindre une photo ou un fichier, même sans texte : Claude voit les photos directement dans le message, les autres fichiers sont téléchargés par Claude Code sur l'ordinateur et transmis à Claude. Parfait pour un bug que tu vois sur ton téléphone :

Je te joins la capture d'une erreur que je vois sur mon téléphone. Trouve d'où elle vient dans le code, corrige-la et lance les tests. Quand les tests sont finis, envoie-moi une notification avec le résultat.

5. Les notifications sur le téléphone

Claude peut t'envoyer une notification quand un long travail se termine ou quand il a besoin d'une décision de ta part. Tu les actives comme ça :

1. Dans l'app Claude, connecte-toi avec le même compte et la même organisation que dans Claude Code.
2. Accepte l'autorisation des notifications quand le téléphone te la demande.
3. Dans le terminal, tape /config et active Push when Claude decides (les notifications que Claude décide d'envoyer), Push when actions required (autorisations et questions), ou les deux.

Si /config affiche No mobile registered, ouvre l'app Claude sur ton téléphone : elle rafraîchit le lien pour les notifications. Et pendant que tu écris dans le terminal connecté, elles n'arrivent pas, puisque tu y es déjà.

6. Ordinateur allumé, réseau qui saute

• Si le portable se met en veille ou si le réseau saute, Claude Code se reconnecte tout seul quand l'ordinateur revient en ligne. Pendant qu'il dort, par contre, Claude ne travaille pas.
• Si l'ordinateur est allumé mais reste longtemps sans réseau, en mode serveur Claude Code abandonne au bout d'environ 10 minutes et claude remote-control se ferme : il faut le relancer. Une session normale réessaie jusqu'au retour du réseau.
• Si tu fermes le terminal ou arrêtes le serveur avec Ctrl+C, la session passe hors ligne. En relançant claude remote-control dans le même dossier dans les quatre heures environ, tu récupères les sessions d'avant.

Pour garder un Mac éveillé, il y a caffeinate, une commande déjà incluse dans macOS : lancée comme ça, elle empêche la mise en veille pour inactivité tant que le serveur reste ouvert. Mais garde le capot ouvert.

caffeinate -i claude remote-control

Les erreurs les plus courantes

• Avoir ANTHROPIC_API_KEY définie : la session utilise la clé au lieu de l'abonnement et Remote Control ne démarre pas. Enlève-la du terminal ou du bloc env du settings.json.
• Lancer claude remote-control depuis le dossier personnel : la question de confiance revient à chaque démarrage, et la session ne démarre pas dans le projet.
• Fermer le portable et s'attendre à ce que Claude continue. Il ne travaille que tant que l'ordinateur est éveillé et la commande ouverte.
• Attendre des notifications sans les avoir activées dans /config. Sur iPhone, vérifie aussi les modes de concentration et le résumé des notifications, qui peuvent les bloquer ou les retarder.

Check-list

• J'ai un forfait Pro, Max, Team ou Enterprise, et sur Team ou Enterprise l'Owner a activé Remote Control
• J'ai fait /login avec mon compte claude.ai, sans clé API définie
• claude remote-control tourne dans le dossier du projet
• Dans l'app Claude, sous Code, je vois mon ordinateur en haut
• J'ai envoyé une photo depuis mon téléphone et Claude l'a vue
• Les notifications sont activées dans /config
• L'ordinateur reste allumé et ne se met pas en veille

Questions fréquentes