Claude Code Remote Control : piloter ses sessions à distance

Pour reprendre une session déjà ouverte, utilisez /remote-control. Pour démarrer une nouvelle conversation dans le terminal, lancez claude --remote-control. Choisissez claude remote-control si vous voulez laisser un serveur en attente de tâches à distance. Ces points d’entrée répondent à des usages différents, mais l’exécution reste locale dans tous les cas. Le guide Remote Control d’Anthropic documente les trois modes.

Qui peut utiliser Claude Code Remote Control ?

La condition d’accès est formulée ainsi : « disponible avec les forfaits Pro, Max, Team et Enterprise. Les clés API ne sont pas prises en charge. » Avec Team et Enterprise, « un propriétaire doit d’abord activer le bouton Remote Control » dans les paramètres d’administration de Claude Code. Ce réglage est désactivé par défaut pour l’organisation. Source : prérequis.

Avant de commencer, connectez-vous à votre compte Claude : lancez claude, puis /login. Payer pour l’utilisation de l’API ne suffit pas, et d’autres identifiants configurés peuvent prendre le pas sur une connexion à un abonnement pourtant enregistrée. La section de dépannage revient sur cette distinction.

Remote Control exige aussi une connexion directe à l’API d’Anthropic. Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry ne sont pas pris en charge. Il en va de même pour une variable ANTHROPIC_BASE_URL personnalisée qui pointe ailleurs que vers api.anthropic.com, ainsi que pour une connexion via une passerelle d’entreprise Claude apps. Source : conditions de connexion.

Pour le coût des forfaits, consultez les tarifs de Claude Code. L’accès à distance permet de superviser une tâche depuis un autre appareil ; son exécution reste sur votre machine habituelle.

Quelle commande choisir pour démarrer ?

La configuration la plus rapide dépend de votre situation : commencer une tâche ou reprendre celle qui est en cours.

Les trois premières lignes correspondent aux trois modes de lancement en ligne de commande. VS Code et Desktop disposent de leurs propres points d’entrée. Source : modes de démarrage.

Lancer un serveur dans le répertoire du projet

Depuis le répertoire qui contient le projet concerné, exécutez :

claude remote-control

Acceptez la demande de confirmation initiale de Remote Control lorsqu’elle apparaît. Le processus attend ensuite les connexions et affiche l’URL de la session. Appuyez sur la barre d’espace pour faire apparaître son QR code. Laissez ce terminal ouvert et le processus en marche.

Le mode serveur permet de suivre les connexions et l’activité des outils. Si vous voulez aussi saisir des prompts dans ce terminal, choisissez le mode interactif ci-dessous. Ajoutez --name "My Project" après remote-control pour retrouver facilement la session dans la liste à distance. Source : démarrage du serveur.

Ouvrir une nouvelle session interactive

Utilisez claude --remote-control ou sa forme abrégée, claude --rc. Vous pouvez continuer à saisir des prompts localement tout en accédant à la même session depuis votre téléphone ou un navigateur. Un nom peut suivre l’option, comme dans claude --remote-control "My Project".

C’est un bon point de départ pour un développeur qui commence à son bureau et s’éloigne pendant une tâche. Source : démarrage interactif.

Rendre une conversation existante accessible à distance

Dans la session, saisissez /remote-control ou /rc. S’il s’agit de votre première connexion, acceptez la boîte de dialogue d’activation. Vous conservez l’historique de la conversation. Dans l’interface en ligne de commande, /remote-control My Project permet aussi de nommer la session.

Une fois la connexion établie, le terminal peut afficher l’indicateur /rc active. Relancez /remote-control pour ouvrir le panneau d’état : vous y trouverez l’URL, le QR code et la commande de déconnexion. Se déconnecter depuis ce panneau laisse la conversation locale en cours. L’indicateur peut être masqué si la fenêtre du terminal est trop étroite. Source : état de la connexion.

Démarrer depuis VS Code ou Desktop

Dans l’extension Claude Code pour VS Code, saisissez /remote-control ou /rc dans le champ de prompt. L’indicateur en bas de l’interface ouvre la session connectée ; son URL apparaît également dans la conversation. Dans VS Code, cette commande n’accepte pas de nom de session en argument et n’affiche pas de QR code. Exécutez-la à nouveau pour vous déconnecter.

Dans Claude Desktop, utilisez la même commande dans une session locale de l’onglet Code. Retrouvez la session connectée sur claude.ai/code, puis répétez la commande pour vous déconnecter. Desktop propose aussi un bouton Remote Control propre à chaque session. Sources : accès depuis les applications, commandes de Desktop.

Autoriser l’espace de travail sur l’ordinateur de bureau

Accorder sa confiance à un espace de travail est une décision distincte de la connexion au compte ou de l’activation de Remote Control pour l’organisation. Elle porte sur le répertoire que Claude Code s’apprête à utiliser.

Lorsque le mode serveur rencontre un répertoire qui n’a pas encore été approuvé, il explique ce que cette autorisation permet et demande une confirmation. Votre choix est ensuite enregistré, sauf pour votre répertoire personnel : la confirmation y est demandée à chaque lancement.

Cette demande nécessite un véritable terminal. Si l’entrée ou la sortie standard est redirigée, Claude Code ne peut pas poser la question et s’arrête avec une erreur liée à la confiance accordée à l’espace de travail. La documentation propose deux solutions : lancer d’abord claude dans ce répertoire et l’approuver, ou démarrer claude remote-control directement dans un terminal pour y répondre à la demande. Source : erreur d’autorisation de l’espace de travail.

Utiliser Claude Code sur mobile ou dans un autre navigateur

Ouvrez l’URL de la session pour y accéder directement dans un navigateur. Vous pouvez aussi vous rendre sur claude.ai/code et sélectionner la session par son nom.

Sur téléphone, utilisez l’application officielle Claude pour iOS ou Android, avec votre compte Claude connecté. Appuyez sur Code pour afficher la liste des sessions. Une session Remote Control en ligne se reconnaît à son icône d’ordinateur et à son point vert. Vous pouvez également scanner le QR code de la session pour l’ouvrir dans l’application. Source : connexion des appareils.

Avant de vous éloigner, envoyez un court message de suivi depuis votre téléphone, avec la session de bureau encore sous les yeux. Vous vérifierez ainsi que vous avez bien sélectionné la bonne conversation.

Vous pouvez envoyer des prompts depuis l’une ou l’autre interface. Les appareils connectés affichent aussi les sous-agents en cours, c’est-à-dire les agents auxiliaires qui travaillent au sein de la session, ainsi que les workflows en arrière-plan. Arrêter l’un d’eux à distance arrête la tâche correspondante sur l’ordinateur de bureau. Source : fonctionnement sur les appareils connectés.

Qu’est-ce qui reste en local et qu’est-ce qui transite par Anthropic ?

Votre ordinateur reste l’atelier de travail. Le téléphone et le navigateur vous donnent simplement d’autres commandes pour le piloter.

Le système de fichiers local, les outils, la configuration du projet et les serveurs MCP restent disponibles. Les serveurs MCP sont des connexions qui donnent à Claude accès à des outils ou à des données supplémentaires. Vous n’avez pas à recréer cet environnement local dans un espace cloud distinct pour poursuivre la session à distance. Source : environnement local.

Une exécution locale ne signifie pas que toutes les données de session restent sur votre machine. Anthropic conserve l’historique, qui comprend vos messages, les réponses de Claude et l’activité des outils, afin de synchroniser les appareils et de permettre la reconnexion. La liaison utilise des connexions HTTPS sortantes sur TLS et des identifiants à durée de vie courte ; aucun port entrant n’est ouvert sur votre ordinateur. Source : connexion et sécurité.

Les organisations qui utilisent Zero Data Retention ou la configuration HIPAA ne peuvent pas activer Remote Control. Le paramètre disableRemoteControl peut également bloquer la fonctionnalité. Source : restrictions d’accès.

Espace de travail approuvé et appareils de confiance : deux autorisations distinctes

L’autorisation de l’espace de travail porte sur un répertoire de la machine qui exécute les tâches. Trusted Devices est une condition d’accès facultative, en bêta, qui concerne les appareils depuis lesquels on consulte ou pilote les sessions.

Lorsque cette condition est activée, chaque appareil doit être enregistré et son authentification doit dater de 18 heures au plus. Une confirmation biométrique ou par clé d’accès peut renouveler l’accès. Avec Team et Enterprise, un propriétaire active cette exigence distincte dans Organization settings > Capabilities > Remote sessions. Ce réglage est indépendant du bouton d’activation de Remote Control. Source : Trusted Devices.

Intégrer l’accès à distance et les notifications à vos habitudes

Pour un usage régulier, vous pouvez activer la connexion automatique et éviter de saisir la commande à chaque session :

• Interface en ligne de commande : ouvrez /config et activez Enable Remote Control for all sessions.
• VS Code : retrouvez ce réglage dans la section Settings du menu des commandes.
• Desktop : passez par Settings > Claude Code > Connect new sessions to Remote Control.

Le paramètre sous-jacent remoteControlAtStartup permet d’activer la connexion automatique depuis les paramètres utilisateur ou les paramètres gérés. Les paramètres de projet ou les paramètres locaux d’un dépôt peuvent la désactiver, mais ne peuvent pas l’activer pour toutes les personnes qui ouvrent ce dépôt. La connexion automatique utilise votre propre compte. Sources : paramètre de démarrage, paramètres de VS Code, paramètres de Desktop.

Pour recevoir des notifications sur votre téléphone, installez l’application Claude, utilisez le même compte et la même organisation que dans votre terminal, puis autorisez les notifications dans le système d’exploitation. Dans le /config du terminal, activez Push when Claude decides, Push when actions required, ou les deux. Claude choisit quand envoyer les notifications proactives ; vous pouvez lui demander de vous prévenir à la fin d’une tâche, mais il n’existe pas de configuration par événement. Source : notifications mobiles.

Résoudre l’erreur signalée par Claude Code

Commencez par la cause indiquée dans le message de Claude Code. Une session interactive peut continuer à fonctionner localement même si sa connexion Remote Control échoue : un terminal opérationnel ne suffit donc pas à prouver que l’accès à distance est actif.

La connexion au compte ne convient pas, ou d’autres identifiants sont prioritaires

Exécutez claude auth login et choisissez la connexion via claude.ai. Si l’erreur mentionne ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN, supprimez les identifiants concernés partout où ils sont configurés, notamment dans l’environnement du shell ou dans le bloc env d’un fichier de paramètres. Si elle mentionne apiKeyHelper, supprimez ce paramètre.

Un jeton issu de claude setup-token ou de CLAUDE_CODE_OAUTH_TOKEN ne permet pas non plus d’établir une connexion Remote Control : ces jetons sont limités aux requêtes adressées aux modèles. Utilisez claude auth login pour obtenir les autorisations de connexion requises. Sources : échecs d’authentification, limites des jetons.

Sans connexion à un compte admissible, claude remote-control s’arrête. En revanche, claude --remote-control démarre la session interactive locale, puis affiche une notification d’échec de l’accès à distance. Source : conditions de connexion au compte.

Des variables d’environnement désactivent les vérifications de disponibilité

Les indicateurs de fonctionnalité, ou « feature flags », sont les vérifications qui permettent à Claude Code de déterminer si la fonctionnalité peut être exécutée. La solution dépend de la variable citée dans l’erreur :

La version de la dernière ligne s’applique spécifiquement à ces configurations de variables de télémétrie. Elle ne constitue pas une version minimale générale pour Remote Control. Source : dépannage des indicateurs de fonctionnalité.

La connexion passe par une passerelle ou un autre point d’accès API

La connexion via une passerelle d’entreprise Claude apps n’est pas prise en charge par Remote Control. Les fournisseurs d’API tiers cités plus haut ne le sont pas non plus.

Si l’erreur cite une variable qui détourne d’Anthropic une session claude.ai pourtant admissible, par exemple une variable ANTHROPIC_BASE_URL personnalisée, la solution documentée consiste à supprimer cette variable, à la retirer aussi du bloc env des paramètres si elle y figure, puis à redémarrer la session. Source : exigences et erreurs liées au point d’accès.

Une vérification du compte ou de l’organisation échoue

Si une règle de l’organisation bloque l’accès, vérifiez qu’un propriétaire a activé Remote Control. Une règle appliquée à l’appareil via disableRemoteControl peut constituer une autre cause. Si vous êtes passé à Pro ou Max mais que Claude Code utilise encore une ancienne connexion à une organisation, /status affiche le forfait et l’organisation ; exécuter claude auth logout, puis claude auth login, permet de renouveler votre connexion.

Si les droits d’accès du compte n’ont pas été actualisés après un changement de forfait, la documentation recommande également de se déconnecter puis de se reconnecter, de mettre à jour une ancienne version de Claude Code et d’utiliser claude doctor pour identifier la vérification qui échoue. Si les règles n’ont pas pu être récupérées, rétablissez l’accès au réseau et réessayez ; le résultat de la vérification des règles de l’organisation par cet outil de diagnostic explique les échecs persistants. Source : dépannage du compte et des règles d’accès.

La récupération des identifiants d’accès à distance échoue

Utilisez la commande de diagnostic documentée pour le serveur :

claude remote-control --verbose

Les causes répertoriées sont l’absence d’authentification claude.ai, un réseau ou un proxy qui bloque la requête sortante vers l’API d’Anthropic sur le port 443, ou un échec antérieur de création de session. Dans ce dernier cas, vérifiez que l’abonnement est actif. La commande /remote-control exécutée dans une session n’accepte pas --verbose. Source : dépannage de la récupération des identifiants.

Garder la machine en marche et savoir se reconnecter

Fermer le terminal, quitter Desktop ou VS Code, ou arrêter le processus Claude Code rend la session inaccessible à distance. Après une brève mise en veille ou une courte coupure réseau, la connexion peut se rétablir au retour de la machine. Une panne réseau prolongée produit toutefois un résultat différent selon le mode :

• Mode serveur : après environ 10 minutes sans accès au réseau, le serveur s’arrête. Relancez claude remote-control.
• Mode interactif : le travail local peut continuer pendant que Claude Code tente de rétablir la connexion ; il se reconnecte lorsque le réseau revient.

Certaines commandes, dont /plugin et /resume, nécessitent toujours l’interface locale en ligne de commande. L’accès à distance ne reproduit pas toutes les interactions du terminal. Source : limites.

Si vous avez arrêté un serveur normalement, le redémarrer dans le même répertoire peut restaurer ses sessions pendant une période d’environ quatre heures. Cela suppose qu’aucun autre serveur n’ait été exécuté dans ce répertoire et que vous n’ayez pas utilisé --no-create-session-in-dir. Passé ce délai, démarrez une nouvelle session.

Pour une conversation interactive, utilisez claude --continue ou claude --resume ; si la reconnexion à distance échoue, lancez /remote-control dans la session. Source : reprise des sessions.

Faut-il choisir Remote Control ou une session cloud ?

Choisissez Remote Control lorsque vous voulez conserver l’environnement déjà présent sur votre ordinateur de bureau. Choisissez une session cloud lorsque vous souhaitez exécuter le travail dans une infrastructure cloud.

Les deux types de sessions peuvent apparaître sur claude.ai/code. Cette adresse ne suffit donc pas à savoir où le travail s’exécute. Sources : comparaison documentée, sessions cloud.

Chaque processus interactif Claude Code prend en charge une session à distance. Le mode serveur peut gérer plusieurs sessions locales. Son mode par défaut, same-dir, partage le répertoire de travail, avec un risque de modifications concurrentes ; --spawn worktree attribue aux sessions créées à la demande des worktrees Git distincts, c’est-à-dire des copies de travail séparées au sein d’un dépôt. La session créée au départ utilise toujours le répertoire courant. Source : options du serveur.

Dispatch est une option distincte pour déléguer des tâches depuis un mobile vers Desktop ; ce guide porte sur la poursuite des sessions Claude Code. Pour une comparaison plus large, qui inclut les solutions tierces d’accès à distance, consultez les agents de développement IA avec pilotage à distance depuis un mobile.

Cinq workflows à essayer

Voici des pistes d’utilisation fondées sur les commandes documentées, classées selon leur utilité directe pour poursuivre un travail de développement en cours :

1. Un développeur au milieu d’un correctif : activez /rc, puis répondez à la prochaine question depuis votre téléphone sans recommencer la conversation.
2. Un fondateur qui attend la fin des tests : demandez une notification de fin et utilisez la session mobile pour choisir la tâche suivante après avoir examiné le résultat.
3. Un développeur qui utilise des outils MCP locaux : poursuivez le même projet à distance sans recréer ailleurs les connexions à ses outils.
4. Un développeur qui examine le travail depuis un autre ordinateur : ouvrez l’URL de la session dans le navigateur de cet ordinateur et envoyez vos retours à la session qui tourne au bureau.
5. Un fondateur qui signale un problème visuel : joignez une photo ou un fichier depuis le téléphone pour donner davantage de contexte à la session existante.

L’intérêt est de réduire les interruptions entre une tâche en cours et votre prochaine décision. Inutile d’inventer un nombre d’heures gagnées : le premier critère utile est de réussir un vrai passage de relais sans revenir au bureau. La synchronisation, les pièces jointes et le fonctionnement des outils locaux sont décrits dans la documentation Remote Control.

Lors de votre prochaine journée de travail, connectez un projet existant avec /remote-control, ouvrez-le sur votre téléphone alors que vous êtes encore à votre bureau et envoyez un message de suivi. Une fois ce premier essai réussi, voyez si la connexion automatique et les notifications conviennent à vos habitudes. Si vous mettez encore en place votre workflow local, commencez par le guide pour utiliser Claude Code.

Pour intégrer les agents de développement à un workflow d’équipe fiable, découvrez les systèmes de production IA.