Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Remote Control est en aperçu de recherche et disponible sur tous les plans. Sur Team et Enterprise, il est désactivé par défaut jusqu’à ce qu’un administrateur active le bouton Remote Control dans les paramètres d’administration Claude Code.
Remote Control connecte claude.ai/code ou l’application Claude pour iOS et Android à une session Claude Code s’exécutant sur votre machine. Commencez une tâche à votre bureau, puis reprenez-la depuis votre téléphone sur le canapé ou un navigateur sur un autre ordinateur. Lorsque vous démarrez une session Remote Control sur votre machine, Claude continue à s’exécuter localement à tout moment, donc rien ne se déplace vers le cloud. Avec Remote Control, vous pouvez :
  • Utiliser votre environnement local complet à distance : votre système de fichiers, serveurs MCP, outils et configuration de projet restent tous disponibles, et taper @ complète automatiquement les chemins de fichiers de votre projet local
  • Travailler depuis les deux surfaces à la fois : la conversation reste synchronisée sur tous les appareils connectés, vous pouvez donc envoyer des messages depuis votre terminal, navigateur et téléphone de manière interchangeable
  • Survivre aux interruptions : si votre ordinateur portable s’endort ou votre réseau tombe en panne, la session se reconnecte automatiquement lorsque votre machine revient en ligne
Contrairement à Claude Code sur le web, qui s’exécute sur l’infrastructure cloud, les sessions Remote Control s’exécutent directement sur votre machine et interagissent avec votre système de fichiers local. Les interfaces web et mobile ne sont qu’une fenêtre dans cette session locale.
Remote Control nécessite Claude Code v2.1.51 ou version ultérieure. Vérifiez votre version avec claude --version.
Cette page couvre la configuration, comment démarrer et se connecter aux sessions, et comment Remote Control se compare à Claude Code sur le web.

​
Conditions requises

Avant d’utiliser Remote Control, confirmez que votre environnement répond à ces conditions :
  • Abonnement : disponible sur les plans Pro, Max, Team et Enterprise. Les clés API ne sont pas prises en charge. Sur Team et Enterprise, un administrateur doit d’abord activer le bouton Remote Control dans les paramètres d’administration Claude Code.
  • Authentification : exécutez claude et utilisez /login pour vous connecter via claude.ai si vous ne l’avez pas déjà fait.
  • Confiance de l’espace de travail : exécutez claude dans votre répertoire de projet au moins une fois pour accepter la boîte de dialogue de confiance de l’espace de travail.

​
Démarrer une session Remote Control

Vous pouvez démarrer une session Remote Control à partir de la CLI ou de l’extension VS Code. La CLI offre trois modes d’invocation ; VS Code utilise la commande /remote-control.
Accédez à votre répertoire de projet et exécutez :
claude remote-control
Le processus reste en cours d’exécution dans votre terminal en mode serveur, en attente de connexions distantes. Il affiche une URL de session que vous pouvez utiliser pour vous connecter depuis un autre appareil, et vous pouvez appuyer sur la barre d’espace pour afficher un code QR pour un accès rapide depuis votre téléphone. Pendant qu’une session distante est active, le terminal affiche l’état de la connexion et l’activité des outils.Drapeaux disponibles :
DrapeauDescription
--name "My Project"Définissez un titre de session personnalisé visible dans la liste des sessions sur claude.ai/code.
--remote-control-session-name-prefix <prefix>Préfixe pour les noms de session générés automatiquement lorsqu’aucun nom explicite n’est défini. Par défaut, le nom d’hôte de votre machine, produisant des noms comme myhost-graceful-unicorn. Définissez CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX pour le même effet.
--spawn <mode>Comment le serveur crée les sessions.
• same-dir (par défaut) : toutes les sessions partagent le répertoire de travail actuel, elles peuvent donc entrer en conflit si elles modifient les mêmes fichiers.
• worktree : chaque session à la demande obtient sa propre git worktree. Nécessite un référentiel git.
• session : mode session unique. Sert exactement une session et rejette les connexions supplémentaires. Défini au démarrage uniquement.
Appuyez sur w à l’exécution pour basculer entre same-dir et worktree.
--capacity <N>Nombre maximum de sessions concurrentes. La valeur par défaut est 32. Ne peut pas être utilisé avec --spawn=session.
--verboseAfficher les journaux de connexion et de session détaillés.
--sandbox / --no-sandboxActiver ou désactiver le sandboxing pour l’isolation du système de fichiers et du réseau. Désactivé par défaut.

​
Se connecter depuis un autre appareil

Une fois qu’une session Remote Control est active, vous avez plusieurs façons de vous connecter depuis un autre appareil :
  • Ouvrez l’URL de la session dans n’importe quel navigateur pour accéder directement à la session sur claude.ai/code.
  • Scannez le code QR affiché à côté de l’URL de la session pour l’ouvrir directement dans l’application Claude. Avec claude remote-control, appuyez sur la barre d’espace pour basculer l’affichage du code QR.
  • Ouvrez claude.ai/code ou l’application Claude et trouvez la session par nom dans la liste des sessions. Dans l’application mobile Claude, appuyez sur Code dans la navigation pour accéder à la liste des sessions. Les sessions Remote Control affichent une icône d’ordinateur avec un point d’état vert lorsqu’elles sont en ligne.
Le titre de la session distante est choisi dans cet ordre :
  1. Le nom que vous avez passé à --name, --remote-control, ou /remote-control
  2. Le titre que vous avez défini avec /rename
  3. Le dernier message significatif dans l’historique de conversation existant
  4. Un nom généré automatiquement comme myhost-graceful-unicorn, où myhost est le nom d’hôte de votre machine ou le préfixe que vous avez défini avec --remote-control-session-name-prefix
Si vous n’avez pas défini de nom explicite, le titre se met à jour pour refléter votre message une fois que vous en envoyez un. Renommer une session depuis claude.ai ou l’application Claude met également à jour le titre local affiché dans claude --resume. Si l’environnement a déjà une session active, vous serez invité à choisir si vous souhaitez la continuer ou en démarrer une nouvelle. Si vous n’avez pas encore l’application Claude, utilisez la commande /mobile dans Claude Code pour afficher un code QR de téléchargement pour iOS ou Android.

​
Activer Remote Control pour toutes les sessions

Par défaut, Remote Control ne s’active que lorsque vous exécutez explicitement claude remote-control, claude --remote-control, ou /remote-control. Pour l’activer automatiquement pour chaque session interactive, exécutez /config dans Claude Code et définissez Enable Remote Control for all sessions sur true. Définissez-le sur false pour le désactiver. Dans l’application Desktop, vous pouvez également basculer ceci depuis Settings → Claude Code → Enable remote control by default. Avec ce paramètre activé, chaque processus Claude Code interactif enregistre une session distante. Si vous exécutez plusieurs instances, chacune obtient son propre environnement et sa propre session. Pour exécuter plusieurs sessions concurrentes à partir d’un seul processus, utilisez plutôt le mode serveur.

​
Connexion et sécurité

Votre session Claude Code locale effectue uniquement des requêtes HTTPS sortantes et n’ouvre jamais de ports entrants sur votre machine. Lorsque vous démarrez Remote Control, il s’enregistre auprès de l’API Anthropic et interroge le travail. Lorsque vous vous connectez depuis un autre appareil, le serveur achemine les messages entre le client web ou mobile et votre session locale sur une connexion en continu. Tout le trafic passe par l’API Anthropic sur TLS, le même transport de sécurité que n’importe quelle session Claude Code. La connexion utilise plusieurs identifiants de courte durée, chacun limité à un seul objectif et expirant indépendamment.

​
Remote Control vs Claude Code sur le web

Remote Control et Claude Code sur le web utilisent tous deux l’interface claude.ai/code. La différence clé est l’endroit où la session s’exécute : Remote Control s’exécute sur votre machine, donc vos serveurs MCP locaux, outils et configuration de projet restent disponibles. Claude Code sur le web s’exécute dans l’infrastructure cloud gérée par Anthropic. Utilisez Remote Control lorsque vous êtes au milieu d’un travail local et que vous souhaitez continuer depuis un autre appareil. Utilisez Claude Code sur le web lorsque vous souhaitez lancer une tâche sans aucune configuration locale, travailler sur un référentiel que vous n’avez pas cloné, ou exécuter plusieurs tâches en parallèle.

​
Notifications push mobiles

Lorsque Remote Control est actif, Claude peut envoyer des notifications push à votre téléphone. Claude décide quand envoyer une notification. Il en envoie généralement une lorsqu’une tâche longue se termine ou lorsqu’il a besoin d’une décision de votre part pour continuer. Vous pouvez également demander une notification dans votre message, par exemple notify me when the tests finish. Au-delà du bouton marche/arrêt ci-dessous, il n’y a pas de configuration par événement.
Les notifications push mobiles nécessitent Claude Code v2.1.110 ou version ultérieure.
Pour configurer les notifications push mobiles :
1

Installer l'application Claude mobile

Téléchargez l’application Claude pour iOS ou Android.
2

Connectez-vous avec votre compte Claude Code

Utilisez le même compte et la même organisation que vous utilisez pour Claude Code dans le terminal.
3

Autoriser les notifications

Acceptez l’invite de permission de notification du système d’exploitation.
4

Activer les notifications dans Claude Code

Dans votre terminal, exécutez /config et activez Push when Claude decides.
Si les notifications n’arrivent pas :
  • Si /config affiche No mobile registered, ouvrez l’application Claude sur votre téléphone pour qu’elle puisse actualiser son jeton push. L’avertissement disparaît la prochaine fois que Remote Control se connecte.
  • Sur iOS, les modes Focus et les résumés de notifications peuvent supprimer ou retarder les notifications. Vérifiez Paramètres → Notifications → Claude.
  • Sur Android, l’optimisation agressive de la batterie peut retarder la livraison. Exemptez l’application Claude de l’optimisation de la batterie dans les paramètres système.

​
Limitations

  • Une session distante par processus interactif : en dehors du mode serveur, chaque instance Claude Code prend en charge une session distante à la fois. Utilisez le mode serveur pour exécuter plusieurs sessions concurrentes à partir d’un seul processus.
  • Le processus local doit continuer à s’exécuter : Remote Control s’exécute en tant que processus local. Si vous fermez le terminal, quittez VS Code, ou arrêtez autrement le processus claude, la session se termine.
  • Panne réseau prolongée : si votre machine est allumée mais incapable d’atteindre le réseau pendant plus de dix minutes environ, la session expire et le processus se termine. Exécutez claude remote-control à nouveau pour démarrer une nouvelle session.
  • Ultraplan déconnecte Remote Control : le démarrage d’une session ultraplan déconnecte toute session Remote Control active car les deux fonctionnalités occupent l’interface claude.ai/code et une seule peut être connectée à la fois.
  • Certaines commandes sont locales uniquement : les commandes qui ouvrent un sélecteur interactif dans le terminal, telles que /mcp, /plugin, ou /resume, fonctionnent uniquement à partir de la CLI locale. Les commandes qui produisent une sortie textuelle, y compris /compact, /clear, /context, /usage, /exit, /usage-credits, /recap, et /reload-plugins, fonctionnent à partir du mobile et du web.

​
Dépannage

​
« Remote Control requires a claude.ai subscription »

Vous n’êtes pas authentifié avec un compte claude.ai. Exécutez claude auth login et choisissez l’option claude.ai. Si ANTHROPIC_API_KEY est défini dans votre environnement, désactivez-le d’abord.

​
« Remote Control requires a full-scope login token »

Vous êtes authentifié avec un jeton de longue durée de claude setup-token ou la variable d’environnement CLAUDE_CODE_OAUTH_TOKEN. Ces jetons sont limités à l’inférence uniquement et ne peuvent pas établir de sessions Remote Control. Exécutez claude auth login pour vous authentifier avec un jeton de session à portée complète à la place.

​
« Unable to determine your organization for Remote Control eligibility »

Vos informations de compte en cache sont obsolètes ou incomplètes. Exécutez claude auth login pour les actualiser.

​
« Remote Control is not yet enabled for your account »

La vérification d’admissibilité peut échouer avec certaines variables d’environnement présentes :
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_TELEMETRY : désactivez-les et réessayez.
  • CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, ou CLAUDE_CODE_USE_FOUNDRY : Remote Control nécessite l’authentification claude.ai et ne fonctionne pas avec les fournisseurs tiers.
Si aucun de ceux-ci n’est défini, exécutez /logout puis /login pour actualiser.

​
« Remote Control is disabled by your organization’s policy »

Cette erreur a quatre causes distinctes. Exécutez d’abord /status pour voir quelle méthode de connexion et quel abonnement vous utilisez.
  • Vous êtes authentifié avec une clé API ou un compte Console : Remote Control nécessite OAuth claude.ai. Exécutez /login et choisissez l’option claude.ai. Si ANTHROPIC_API_KEY est défini dans votre environnement, désactivez-le.
  • Votre administrateur Team ou Enterprise ne l’a pas activé : Remote Control est désactivé par défaut sur ces plans. Un administrateur peut l’activer sur claude.ai/admin-settings/claude-code en activant le bouton Remote Control. Ce bouton est un paramètre d’organisation côté serveur.
  • Le bouton d’administration est grisé : votre organisation a une configuration de rétention des données ou de conformité incompatible avec Remote Control. Cela ne peut pas être modifié à partir du panneau d’administration. Contactez le support Anthropic pour discuter des options.
  • L’erreur mentionne disableRemoteControl : votre administrateur informatique a désactivé Remote Control sur cet appareil via les paramètres gérés, indépendamment du bouton à l’échelle de l’organisation.

​
« Remote credentials fetch failed »

Claude Code n’a pas pu obtenir une accréditation de courte durée auprès de l’API Anthropic pour établir la connexion. Réexécutez avec --verbose pour voir l’erreur complète : 
claude remote-control --verbose
Causes courantes :
  • Non connecté : exécutez claude et utilisez /login pour vous authentifier avec votre compte claude.ai. L’authentification par clé API n’est pas prise en charge pour Remote Control.
  • Problème de réseau ou de proxy : un pare-feu ou un proxy peut bloquer la requête HTTPS sortante. Remote Control nécessite l’accès à l’API Anthropic sur le port 443.
  • Échec de la création de session : si vous voyez également Session creation failed — see debug log, l’échec s’est produit plus tôt dans la configuration. Vérifiez que votre abonnement est actif.

​
Choisir la bonne approche

Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.
TriggerClaude runs onSetupBest for
DispatchMessage a task from the Claude mobile appYour machine (Desktop)Pair the mobile app with DesktopDelegating work while you’re away, minimal setup
Remote ControlDrive a running session from claude.ai/code or the Claude mobile appYour machine (CLI or VS Code)Run claude remote-controlSteering in-progress work from another device
ChannelsPush events from a chat app like Telegram or Discord, or your own serverYour machine (CLI)Install a channel plugin or build your ownReacting to external events like CI failures or chat messages
SlackMention @Claude in a team channelAnthropic cloudInstall the Slack app with Claude Code on the web enabledPRs and reviews from team chat
Scheduled tasksSet a scheduleCLI, Desktop, or cloudPick a frequencyRecurring automation like daily reviews

​
Ressources connexes

  • Claude Code sur le web : exécutez des sessions dans des environnements cloud gérés par Anthropic au lieu de sur votre machine
  • Ultraplan : lancez une session de planification cloud depuis votre terminal et examinez le plan dans votre navigateur
  • Canaux : transférez Telegram, Discord ou iMessage dans une session afin que Claude réagisse aux messages pendant que vous êtes absent
  • Dispatch : envoyez un message avec une tâche depuis votre téléphone et il peut générer une session Desktop pour la gérer
  • Authentification : configurez /login et gérez les identifiants pour claude.ai
  • Référence CLI : liste complète des drapeaux et commandes incluant claude remote-control
  • Sécurité : comment les sessions Remote Control s’intègrent dans le modèle de sécurité Claude Code
  • Utilisation des données : quelles données circulent via l’API Anthropic lors des sessions locales et distantes