Claude Code Remote Control : connexion au téléphone par QR code

Vous trouverez d’autres instructions dans la documentation Ailoot.

Comment Claude Code Remote Control relie-t-il ordinateur et téléphone ?#

Anthropic a lancé Remote Control le 24 février 2026. Anthropic le décrit comme un moyen de poursuivre des sessions locales depuis n’importe quel appareil.

En clair : vous démarrez une session dans le terminal comme d’habitude. Activez Remote Control. Ouvrez l’application Claude sur votre téléphone → l’onglet Code → votre session apparaît avec un point vert. Touchez-la, lisez et répondez. Vous pouvez écrire depuis votre ordinateur portable, votre téléphone et votre navigateur, dans n’importe quelle combinaison : tout est synchronisé.

La documentation officielle de Remote Control distingue l’exécution locale du trafic réseau : les commandes et les opérations sur les fichiers s’exécutent sur votre machine, tandis que la conversation est synchronisée via Anthropic.

C’est la différence essentielle avec Claude Code sur le Web, où la session s’exécute dans une machine virtuelle cloud d’Anthropic. Ici, Claude continue de tourner sur votre matériel, avec tous vos dépôts Git, variables d’environnement et clés de base de données. Votre téléphone n’est qu’un écran qui vous permet de lui parler.

Pourquoi un vibe coder pourrait en avoir besoin

Trois scénarios pratiques que l’auteur utilisait chaque semaine :

1. Un long refactoring pendant la nuit. Demandez à Claude de mettre à jour 40 fichiers pour une nouvelle API. Éloignez-vous de votre ordinateur portable. Le matin, installez-vous sur le canapé avec votre téléphone, examinez le diff et dites : « Accepte les 12 premiers ; montre-moi le reste séparément. » Pas besoin d’ouvrir l’ordinateur.
2. Approuver une étape en allant au travail. Vous êtes dans le métro quand Claude envoie une notification push : « J’ai besoin d’une décision sur la migration du schéma. » Ouvrez-la, lisez les deux options et écrivez : « Prends la première option ; ne touche pas aux tests. » La session continue pendant votre trajet.
3. Pendant une diffusion en direct ou une réunion. Pendant une réunion Zoom, vous pouvez vérifier sur votre téléphone si une deuxième session Claude a créé une version de test. Inutile de quitter l’appel vidéo pour changer de fenêtre.

Ce qu’il vous faut pour utiliser Remote Control#

Tableau complet des exigences :

Vérifiez votre version avec :

claude --version

Si elle est antérieure à 2.1.51, mettez-la à jour :

npm install -g @anthropic-ai/claude-code@latest

Si ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN ou apiKeyHelper est défini dans votre environnement, Remote Control ne démarrera pas. Depuis la v2.1.139 (11.05.2026), Anthropic bloque explicitement la fonctionnalité lorsque ces variables sont présentes. Exécutez unset ANTHROPIC_API_KEY, puis reconnectez-vous avec /login.

Démarrer Remote Control : 3 méthodes en 2 minutes#

Méthode 1. Mode serveur : un serveur dédié aux sessions à distance

1. Ouvrez un terminal dans le dossier du projet

   Exécutez cd une fois pour accéder au répertoire où vous allez travailler. S’il s’agit d’un nouveau dossier, exécutez claude comme d’habitude pour terminer la boîte de dialogue Workspace Trust.

2. Démarrez le serveur

   claude remote-control
   

   Le terminal reste ouvert. Une URL de session et l’invite « Press space to show QR » apparaissent en bas. Le serveur attend des connexions.

3. Connectez-vous depuis votre téléphone

   Appuyez sur la barre d’espace : le code QR apparaît. Scannez-le avec l’application Claude ou l’appareil photo de votre iPhone pour ouvrir la session.

Facultatif : définissez le nom de la session et ses paramètres :

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name — le nom affiché pour la session dans la liste sur votre téléphone.
• --spawn worktree — chaque nouvelle session s’ouvre dans son propre worktree Git afin que les sessions parallèles ne se gênent pas.
• --capacity 4 — un maximum de 4 sessions à distance simultanées sur le serveur. La valeur par défaut est 32.

Méthode 2. Mode interactif : ma session avec Remote Control en plus

claude --remote-control
# ou en plus court :
claude --rc

Vous obtenez une session interactive normale dans votre terminal, avec Remote Control activé. Vous pouvez écrire à Claude depuis votre ordinateur portable et votre téléphone : la conversation est synchronisée.

Contrairement au mode serveur, il s’agit d’une seule session. C’est pratique si vous prévoyez de travailler principalement sur votre ordinateur et souhaitez utiliser votre téléphone comme solution de secours lorsque vous devez vous éloigner.

Méthode 3. Depuis une session active avec /rc

Vous travaillez déjà dans Claude Code ? Ne fermez pas la session. Saisissez simplement :

/remote-control

ou, en plus court :

/rc

La session devient une session à distance. Vous ne perdez pas son contexte. C’est utile lorsque vous vous rendez compte au milieu d’une tâche que vous devez vous éloigner.

Code QR : connectez votre téléphone en 10 secondes#

1. Installez l’application Claude

   Si vous ne l’avez pas encore, saisissez /mobile dans Claude Code. Un code QR apparaît pour télécharger l’application depuis l’App Store ou Google Play. C’est plus rapide qu’une recherche manuelle.

2. Affichez le code QR de la session dans le terminal

   Après claude --rc ou claude remote-control, appuyez sur la barre d’espace. Le code QR apparaît directement dans le terminal.

3. Scannez-le avec votre téléphone

   Ouvrez l’appareil photo dans l’application Claude, ou utilisez l’appareil photo standard de l’iPhone (les appareils photo Android peuvent aussi le scanner). Si cela ne fonctionne pas, agrandissez la fenêtre du terminal, passez à iTerm2 ou Windows Terminal, ou copiez l’URL au-dessus du code QR et collez-la manuellement dans votre navigateur.

4. Activez les notifications push

   Saisissez /config dans la session et activez « Push when Claude decides ». Claude Code doit être en version 2.1.110 ou ultérieure.

Ce que vous verrez sur votre téléphone

L’onglet Code s’ouvre dans l’application Claude. Votre session apparaît dans la liste avec une icône d’ordinateur et un point vert (en ligne). Touchez-la pour y accéder.

Ensuite, cela fonctionne comme claude.ai/code : vous pouvez voir les messages de Claude et les diffs de fichiers, les accepter ou les rejeter, ou demander des modifications. Vous pouvez écrire une nouvelle demande. Elle est envoyée à votre machine, où Claude, en local, la traite et renvoie une réponse.

Ce que Claude peut faire avec les notifications push

Claude envoie des notifications push lorsqu’il estime qu’elles sont nécessaires. Par défaut, cela se produit dans deux cas : une longue tâche se termine ou Claude a besoin de votre décision. Vous pouvez aussi le demander explicitement : « Préviens-moi quand les tests réussissent », et il en enverra une.

Si vous ne recevez pas les notifications push :

• Sur iOS, vérifiez Réglages → Notifications → Claude. Les modes Concentration peuvent les réduire au silence.
• Sur Android, désactivez l’optimisation de la batterie pour l’application Claude.
• Si /config indique « No mobile registered », ouvrez l’application Claude au moins une fois afin qu’elle puisse mettre à jour son jeton push.

Travailler depuis le canapé : 5 scénarios utiles#

Scénario 1. Revue depuis le canapé : examiner un travail effectué pendant la nuit

Avant d’aller vous coucher, confiez à Claude une tâche comme : « Fais passer tout le dépôt dans les nouvelles règles de lint et corrige tout ce qui n’est pas critique ; marque le reste TODO. » Exécutez claude --rc et laissez le terminal ouvert.

Le matin, installez-vous sur le canapé avec votre téléphone. Ouvrez l’application Claude → repérez la session avec un point vert → trouvez-y 87 commits présentés sous forme de diffs. Faites-les défiler ; pour les passages douteux, écrivez « annule ceci ; je le corrigerai manuellement », et pour ceux qui sont corrects, « accepte tout ». Pas besoin « d’aller jusqu’à l’ordinateur » à 7 h du matin.

Scénario 2. Approuver en déplacement : valider une étape dans le métro

Lancez une longue migration de schéma de base de données le matin. À 9 h 30, une notification push arrive dans le métro : « J’ai trouvé deux solutions de migration ; j’ai besoin d’une décision. » Touchez-la, lisez les options, choisissez-en une et ajoutez : « Ne supprime pas l’ancienne table tant que toute la série de tests n’est pas terminée. » Claude continue.

Sans Remote Control, Claude s’arrêterait à ce stade et attendrait en silence. Vous arrivez et ouvrez votre ordinateur portable : 40 minutes perdues.

Scénario 3. S’éloigner : suivre une longue tâche pendant le déjeuner

Avant le déjeuner, lancez Claude sur la tâche « Mets à jour la documentation de tous les points de terminaison ». Allez dans un café. Au bout de 25 minutes, une notification push arrive : « Terminé, regarde. » Touchez une fois « accepter », puis retournez à votre soupe. Sans Remote Control, soit vous restez 25 minutes devant votre ordinateur comme un gardien, soit vous revenez et découvrez que Claude n’a rien fait de tout ce temps, parce qu’il a rencontré un point de décision.

C’est un point important. Remote Control ne rend pas Claude plus autonome : cela vous donne simplement accès à lui de n’importe où. Moins Claude rencontre de points de décision, moins vous recevez de notifications push. Soyez donc plus précis dans vos consignes : « Fais-le de cette manière ; dans ces cas, fais ceci ; si ce n’est vraiment pas clair, arrête-toi et envoie une notification push. »

Scénario 4. Prendre une décision d’architecture depuis un café

Au milieu d’un refactoring, Claude trouve deux méthodes de migration et vous demande de choisir. Si vous êtes loin de votre ordinateur, ouvrez les diffs proposés sur votre téléphone, choisissez une option et ajoutez le commentaire : « Mais ne touche pas à la table user_settings : je la supprimerai la semaine prochaine. » La session continue.

Cela fonctionne particulièrement bien en mode worktree (--spawn worktree) : chaque tâche parallèle est dans sa propre branche et elles n’interfèrent pas entre elles. Sur votre téléphone, vous passez de l’une à l’autre comme dans des conversations.

Scénario 5. Plusieurs sessions worktree en même temps

Une approche puissante consiste à combiner le mode serveur et plusieurs worktrees. Lancez ceci sur votre ordinateur portable :

claude remote-control --spawn worktree --capacity 4

Démarrez des sessions dans différentes branches depuis votre téléphone : l’une construit une fonctionnalité, une autre corrige des bugs tirés d’une liste et une troisième exécute des tests de régression. Elles tournent toutes en parallèle sur votre ordinateur portable ; aucune ne bloque les autres.

Sécurité : ce qui reste sur votre ordinateur et ce qui est envoyé#

Avant de connecter un projet sensible, décidez quel contenu peut apparaître dans les prompts et les sorties d’outils. Gardez les secrets de production hors de l’environnement accessible à l’agent ; le tableau des transferts ne prouve pas qu’une session donnée ne peut pas les divulguer.

Concrètement : votre ordinateur portable demande à Anthropic « Avez-vous des messages pour moi ? », reçoit une réponse et la traite localement. Personne, à l’extérieur, n’ouvre de port entrant vers votre machine. Un pare-feu d’entreprise autorisera cela sans configuration particulière.

Quelles données sont effectivement envoyées à Anthropic

Remote Control ajoute une interface synchronisée, pas un mode d’inférence hors ligne. Anthropic conserve la transcription de la session connectée, avec les messages, réponses et activités d’outils, selon sa politique d’utilisation des données. Vérifiez les données envoyées au modèle et les accès depuis les appareils connectés.

Une remarque sur les identifiants

Autrement dit, plusieurs jetons de courte durée circulent entre votre ordinateur portable, Anthropic et votre téléphone au lieu d’un seul jeton de longue durée. La compromission de l’un ne donne pas accès à tous les autres.

Autre limite importante : --dangerously-skip-permissions ne fonctionne pas dans Remote Control. Chaque appel d’outil (Bash, Write, Edit) attend toujours votre approbation. C’est volontaire : la fonctionnalité sur téléphone ne doit pas transformer l’appareil en « ordinateur portable en pilote automatique sans supervision ».

Vous avez démarré Remote Control ? Configurez-le maintenant pour que Claude ne vous interrompe pas toutes les 10 minutes#

/rc est un moyen pratique d’avoir votre session sur votre téléphone. Mais si Claude écrit « Je ne comprends pas quoi faire » toutes les 10 minutes, le problème ne vient pas du téléphone : il vient de l’ingénierie du contexte, c’est-à-dire de la clarté des règles que vous définissez au départ.

Six problèmes au premier démarrage et comment les résoudre#

Problème 1. « Remote Control environments are not available for your account »

La plainte la plus fréquente dans le dépôt anthropics/claude-code (issue #29449 et plus d’une douzaine de doublons). Vous avez répondu y à « enable Remote Control? » : la CLI a renvoyé une erreur et ne propose plus de nouvel essai.

La cause est presque toujours la même : ANTHROPIC_API_KEY ou CLAUDE_CODE_OAUTH_TOKEN est défini dans l’environnement. Remote Control fonctionne uniquement avec OAuth complet via /login, et non avec une clé.

Solution :

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# vérifiez que l’environnement est propre :
env | grep -i anthropic
env | grep -i claude

# reconnectez-vous :
claude
/logout
/login

Après vous être connecté via le navigateur avec /login, Remote Control devrait démarrer.

Problème 2. Le code QR ne se scanne pas avec votre téléphone

Vous pointez l’appareil photo de votre téléphone vers le code, mais il ne réagit pas ou indique : « Impossible de lire ceci. »

Cause : votre terminal affiche le code QR en trop petit ou avec un contraste insuffisant.

Solution :

1. Agrandissez la fenêtre du terminal en plein écran.
2. Si vous utilisez Apple Terminal, passez à iTerm2 (ou Warp). Sous Windows, utilisez Windows Terminal plutôt que CMD.
3. Réduisez la taille de police du terminal de 1–2 points pour que le code QR paraisse plus grand.
4. Si cela ne suffit pas, copiez l’URL au-dessus du code QR et ouvrez-la dans le navigateur de votre téléphone.

Problème 3. Le pare-feu bloque le port 443

Cela arrive généralement sur les ordinateurs d’entreprise avec un proxy d’interception (Zscaler ou un VPN d’entreprise avec MITM).

Solution : commencez par activer les journaux détaillés et relever l’erreur précise :

claude remote-control --verbose

Si vous voyez « certificate verification failed », il y a une interception MITM : contactez votre administrateur réseau. Si vous voyez « connection refused » / « timeout », demandez à l’administrateur d’autoriser l’accès sortant à *.anthropic.com:443.

Problème 4. Claude Code est trop ancien

Vérifiez :

claude --version

Si la version est antérieure à 2.1.51, mettez-la à jour :

npm install -g @anthropic-ai/claude-code@latest

L’extension VS Code nécessite au moins la v2.1.79. Les notifications push nécessitent la v2.1.110.

Problème 5. Les notifications push n’arrivent pas

Scénario : Remote Control fonctionne, mais votre téléphone reste silencieux lorsque Claude termine une longue tâche.

Liste de vérification :

1. Exécutez /config dans la session. Si le message « No mobile registered » apparaît, ouvrez l’application Claude sur votre téléphone au moins une fois pour qu’elle puisse mettre à jour son jeton push.
2. iOS : Réglages → Notifications → Claude → vérifiez que les notifications sont activées et qu’elles ne sont pas réduites au silence par le mode Concentration.
3. Android : ouvrez les réglages de la batterie et excluez Claude de l’optimisation de la batterie.
4. Si le résumé des notifications iOS est activé, la notification push peut arriver, mais n’apparaître que dans le résumé horaire. Désactivez le résumé pour Claude.

Problème 6. Claude Desktop perturbe /remote-control

Si vous exécutez /remote-control dans l’application Claude Desktop, vous obtenez l’erreur « Remote Control requires a full-scope login token » (issue GitHub #48378).

Cause : Claude Desktop injecte un jeton OAuth aux permissions limitées (inférence uniquement).

Solution : exécutez Claude Code dans un terminal système classique, et non dans le terminal intégré à Claude Desktop. C’est une limitation connue ; Anthropic travaille à la corriger.

Bonus. La reconnexion automatique cesse discrètement de fonctionner pendant les longues sessions

Symptôme : une session Remote Control tourne pendant 30–60 minutes, puis le téléphone se déconnecte silencieusement sans indicateur (issue #34255). Corrigez le problème manuellement : /remote-control → Disconnect → redémarrez la connexion. Ce n’est pas idéal, mais la fonctionnalité est encore en aperçu de recherche.

Rien qu’en mai 2026, Anthropic a publié huit correctifs spécialement pour Remote Control : la fonctionnalité est activement améliorée. Vous pouvez vous en plaindre, mais il est raisonnable de s’attendre à ce que la plupart de ces problèmes disparaissent en quelques mois.

Remote Control comparé aux bots Telegram et à SSH+tmux#

Tableau comparatif

Quand choisir chaque option

• Remote Control — la solution par défaut pour « quitter son ordinateur portable tout en continuant à diriger le travail ». Interface complète, synchronisation entre appareils et aucun service tiers.
• Channels (bot Telegram) — lorsque vous voulez qu’un échec CI, une nouvelle réclamation client ou un message de chat déclenche automatiquement une enquête de Claude. C’est « événement → Claude réagit » plutôt que « je dirige Claude depuis mon téléphone ». Pour en savoir plus, consultez le guide sur Telegram et Claude Code.
• SSH + tmux — lorsque vous avez besoin d’un shell arbitraire sur votre téléphone pour vos propres commandes (déployer une version, consulter un journal, redémarrer un service). Un shell universel en dehors de Claude Code. Pour les tâches ponctuelles, cela fonctionne avec Termux/Blink.
• Autres agents de code — Anthropic Remote Control est réservé à Claude Code. Pour comparer Claude et les alternatives, consultez Cursor vs Claude Code.

La documentation d’Anthropic distingue donc ces deux fonctionnalités selon leur cas d’usage : Remote Control sert à diriger ; Channels sert à réagir.

Nouveautés de Remote Control de mai 2026 à juin 2026#

Chronologie complète des correctifs :

Huit correctifs spécifiques à Remote Control en un mois, c’est normal pour une fonctionnalité en aperçu de recherche. Anthropic répond clairement aux retours et corrige les cas limites.

Si la fonctionnalité se comporte bizarrement chez vous, commencez par vérifier la version et la mettre à jour. Il est fort possible que le bug ait déjà été corrigé.

Liste de contrôle : configurer et faire fonctionner Remote Control en 5 minutes#

1. Vérifiez votre version de Claude Code

   claude --version — elle doit être en version 2.1.51 ou ultérieure. Sinon, exécutez npm install -g @anthropic-ai/claude-code@latest.

2. Supprimez les clés API de l’environnement

   Exécutez unset ANTHROPIC_API_KEY et unset CLAUDE_CODE_OAUTH_TOKEN. Puis exécutez /logout → /login via le navigateur.

3. Installez l’application Claude sur votre téléphone

   Exécutez /mobile dans une session Claude Code pour afficher un code QR permettant d’accéder à l’App Store / Google Play.

4. Démarrez Remote Control

   Exécutez claude --rc ou saisissez /rc dans une session. Une URL et l’invite « Press space to show QR » apparaîtront.

5. Scannez le code QR avec votre téléphone

   Appuyez sur la barre d’espace dans le terminal → utilisez l’appareil photo ou l’application Claude. Agrandissez la fenêtre du terminal si le code ne se scanne pas.

6. Activez les notifications push

   /config → « Push when Claude decides ». Si le message « No mobile registered » apparaît, ouvrez l’application Claude au moins une fois.

7. Lancez une longue tâche et éloignez-vous

   Rédigez un prompt précis : « Fais-le de cette façon ; dans ces cas, fais ceci ; dans les cas douteux, envoie une notification push. » Puis travaillez depuis votre téléphone grâce aux notifications push.

Dans un exemple pratique, il a fallu 3–5 minutes pour passer de zéro à la première conversation depuis le canapé.

Quand vous serez prêt, découvrez Ailoot.