Claude Code Remote Control : comment l'utiliser ? Contrôle à distance depuis le téléphone, limitations officielles et alternatives (2026)

Comment activer Claude Code Remote Control ? Cet article présente trois utilisations officielles : claude remote-control, claude --remote-control et /remote-control, explique la connexion depuis mobile et navigateur, les exigences de compte, les méthodes de vérification et les erreurs courantes, et compare les solutions PandaNpc pour les modèles personnalisés, Codex et les scénarios multi-machines.

PandaNpcPremière publication le Mis à jour le
Claude Code Remote Control : comment l'utiliser ? Contrôle à distance depuis le téléphone, limitations officielles et alternatives (2026)

La méthode officielle la plus rapide : mettez à jour Claude Code vers la version actuelle, exécutez claude remote-control dans le répertoire du projet, puis ouvrez claude.ai/code depuis l'application Claude sur votre téléphone ou un navigateur pour démarrer et contrôler la session qui continue de s'exécuter sur votre ordinateur. Si la session est déjà ouverte, saisissez directement /remote-control ; si vous souhaitez également continuer à opérer dans le terminal local, utilisez claude --remote-control.

Si vous utilisez uniquement l'abonnement officiel Claude Code et Claude.ai, privilégiez le Remote Control officiel. Si vous utilisez une API Key, Bedrock, Vertex, un ANTHROPIC_BASE_URL personnalisé, ou si vous souhaitez contrôler à distance Codex, PandaCode, DeepSeek harness et plusieurs machines de développement depuis la même interface, envisagez alors PandaNpc. Cet article clarifie les deux approches, sans que vous ayez à deviner laquelle vous convient.

Les informations et commandes sont vérifiées par rapport à la documentation officielle Anthropic Remote Control au 30 août 2026. Claude Code évolue rapidement, les commandes réellement disponibles restent celles indiquées par claude --help et /help sur votre machine.

Les trois façons de lancer Claude Code Remote Control

Ces trois commandes ne sont pas synonymes : la différence réside dans le point de départ.

Votre scénario Commande Ce qui se passe
Vous voulez que le téléphone puisse démarrer une nouvelle session à tout moment claude remote-control Lance le mode serveur ; le téléphone ou le Web peut créer une session sur cette machine
Vous voulez opérer à la fois depuis le terminal local et à distance claude --remote-control Lance une session interactive normale tout en l'ouvrant à l'application Claude et à claude.ai/code
La session actuelle est déjà en cours /remote-control ou /rc Conserve l'historique de la conversation existant et génère une URL distante et un QR code pour le téléphone

L'exécution du Remote Control officiel reste sur votre machine : les fichiers du projet, MCP, outils et configurations ne sont pas déplacés dans un nouveau conteneur cloud ; le téléphone et le navigateur ne sont que des interfaces de contrôle à distance. Cela le distingue de Claude Code on the web, qui s'exécute dans l'environnement cloud géré par Anthropic.

Utiliser le Remote Control officiel : de la vérification à la connexion réussie

Étape 1 : Vérifier la version, la connexion et l'espace de travail

Commencez par exécuter sur la machine de développement :

bash
claude --version

La documentation officielle exige Claude Code v2.1.51 ou une version ultérieure. Ensuite, lancez normalement claude dans le répertoire du projet cible, puis effectuez /login et confirmez la confiance de l'espace de travail. Remote Control utilise l'identité Claude.ai ; la documentation officielle indique explicitement que l'API Key n'est pas prise en charge. Pour les organisations Team ou Enterprise qui ne voient pas l'entrée, un administrateur doit également activer Remote Control dans les paramètres d'administration de Claude Code.

Étape 2 : Choisir un mode de lancement

Pour choisir un répertoire depuis le téléphone et démarrer une nouvelle session, exécutez :

bash
cd /path/to/project
claude remote-control --name "My Project"

Pour continuer à saisir dans le terminal de la machine de développement tout en permettant au téléphone de prendre le relais, exécutez :

bash
cd /path/to/project
claude --remote-control "My Project"

Si une session existe déjà, saisissez directement :

text
/remote-control My Project

Le terminal affiche l'URL de la session ; en mode claude remote-control, appuyer sur la barre d'espace affiche également le QR code.

Étape 3 : Se connecter depuis le téléphone ou le navigateur

Utilisez le même compte Claude :

  • Ouvrez https://claude.ai/code dans le navigateur et sélectionnez la session avec l'icône d'ordinateur dans la liste des sessions ;
  • Sur iOS ou Android, ouvrez l'application Claude et accédez à l'onglet Code ;
  • ou ouvrez directement l'URL fournie par le terminal et scannez le QR code.

Après la première connexion, envoyez d'abord une invite de vérification en lecture seule, sans approuver immédiatement l'écriture de fichiers :

Affichez le répertoire de travail actuel et montrez git status --short. Ne modifiez rien.

La connexion est réellement établie lorsque le chemin est correct, que l'état Git correspond à ce qui est attendu et que la demande d'autorisation apparaît sur le téléphone ou dans le navigateur.

Comment choisir entre le Remote Control officiel, Claude Code Web et PandaNpc

Besoin Remote Control officiel Claude Code on the web PandaNpc
Où l'Agent s'exécute-t-il ? Votre ordinateur Environnement cloud Anthropic Votre ordinateur, serveur ou conteneur de développement
Accès à distance Claude App, claude.ai/code claude.ai/code iOS, navigateur, client de bureau, extension de navigateur
Fichiers locaux et MCP Conservés Utilise un espace de travail cloud Conservés sur l'hôte qui exécute l'Agent
Moteurs pris en charge Claude Code Claude Code Claude Code, Codex, PandaCode, DeepSeek harness, Pi
Limites d'authentification Connexion Claude.ai ; API Key non prise en charge Connexion Claude.ai Utilise le compte existant, l'API ou la configuration de fournisseur personnalisé de chaque moteur sur l'hôte
Gestion unifiée multi-machines Chaque hôte Claude Code fournit des sessions séparément Centré sur les tâches cloud Affiche de manière unifiée les machines de développement, serveurs et connexions de chaque moteur sous le compte
Ports entrants publics Non requis Non applicable Non requis, l'hôte établit activement des connexions sortantes

Le choix est donc simple : si les capacités officielles suffisent, utilisez l'officiel. La valeur de PandaNpc n'est pas de réemballer la même commande officielle, mais de couvrir les scénarios transversaux : multi-moteurs, API/modèles personnalisés, gestion unifiée multi-machines et réseau privé des appareils.

Architecture des connexions sortantes entre l'hôte local, le relais d'authentification et les appareils distants
L'hôte et les appareils distants se connectent activement au relais d'authentification ; aucun port SSH ou Agent entrant public n'est nécessaire ; l'exécution du code et des outils reste sur l'hôte.

Quand la solution officielle ne convient pas : contrôler l'Agent local à distance avec PandaNpc

PandaPaw de PandaNpc s'exécute à côté de la machine de développement et enregistre les moteurs locaux tels que Claude Code et Codex comme connexions distantes. Les appels de modèles suivent toujours le compte et la configuration du fournisseur propres à chaque moteur ; le côté distant se contente d'envoyer des instructions, d'afficher les résultats et de gérer les approbations.

Étape 1 : Installer et se connecter à PandaPaw sur la machine de développement

macOS / Linux :

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows – PowerShell en administrateur :

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

L'installateur ouvre une page d'autorisation dans le navigateur. Après approbation, vérifiez :

bash
pandapaw status

Étape 2 : Choisir l'hôte et le projet depuis la page Agent

Ouvrez PandaNpc Agent dans le navigateur, vérifiez que la machine cible est en ligne (vert), sélectionnez Claude Code et le bon répertoire de projet, puis envoyez l'invite de vérification en lecture seule mentionnée précédemment. Les clients mobiles et de bureau utilisent la même liste de connexions.

Liste des connexions Agent distantes dans la barre latérale de PandaNpc
Vérifiez d'abord l'hôte distant, le moteur Agent et le répertoire du projet, puis entrez dans la session et approuvez les appels d'outils.

Si vous ne vous intéressez qu'aux cartes d'autorisation, aux cartes de questions et aux Live Activities sur iPhone, vous pouvez poursuivre avec le flux de travail iOS pour connecter Claude Code depuis le téléphone.

Plusieurs machines et plusieurs Agents : ne faites pas de redirection de ports machine par machine

Lorsque vous n'avez qu'une seule machine de développement, une session distante suffit. Lorsque Claude Code, Codex et d'autres Agents sont répartis sur des postes de travail, ordinateurs portables, NAS, serveurs cloud ou conteneurs de développement, le vrai problème devient la découverte des hôtes et l'interconnexion sécurisée.

La fonctionnalité Appareils connectés de PandaNpc ajoute les machines du compte à un réseau privé chiffré, attribue à chaque machine une adresse IP privée stable et enregistre automatiquement les Agents qu'elle peut exécuter. Les appareils privilégient les connexions point à point et reviennent au relais lorsque la traversée de NAT échoue ; l'ensemble du processus ne nécessite ni IP publique ni redirection de port sur le routeur. Le téléphone n'a ainsi qu'à choisir « quelle machine, quel Agent, quel projet », sans avoir à conserver un ensemble de ports SSH, de noms de domaine dynamiques et de clés à long terme.

Adresses de réseau privé et état en ligne de plusieurs appareils Windows, macOS et Linux
La page de gestion des appareils affiche de manière unifiée le système hôte, l'état en ligne et l'adresse de réseau privé ; plus besoin de gérer les ports publics appareil par appareil.

Ce type de mise en réseau des appareils répond à la question « les Agents peuvent-ils se joindre en toute sécurité » ; la répartition des tâches, le partage du contexte et l'agrégation des résultats relèvent toujours de la couche d'orchestration multi-Agents. Les deux ne doivent pas être confondus.

Problèmes fréquents et dépannage

`claude remote-control` ou `/remote-control` n'existe pas

Commencez par vérifier claude --version. La commande principale nécessite au moins la v2.1.51 ; la prise en charge VS Code nécessite une version plus récente. Après la mise à jour, rouvrez le terminal et la session. Si la commande est toujours absente, exécutez /help et vérifiez que la stratégie de l'organisation n'a pas désactivé Remote Control.

Impossibilité de trouver l'ordinateur ou la session sur le téléphone

Vérifiez que le téléphone, le navigateur et la CLI sont connectés au même compte et à la même organisation Claude, et que le processus claude remote-control est toujours en cours d'exécution sur la machine de développement. Sur le téléphone, accédez à l'onglet Code, et non à la liste de chat standard.

Impossible d'activer avec API Key, Bedrock, Vertex ou passerelle personnalisée

Le Remote Control officiel exige actuellement une connexion Claude.ai et ne prend pas en charge l'API Key. Vérifiez d'abord s'il s'agit de la méthode d'authentification que vous devez conserver. Si vous pouvez revenir à une connexion par abonnement, utilisez l'officiel ; si vous ne pouvez pas basculer, utilisez une solution capable de se connecter à la CLI locale, comme PandaNpc. Ne modifiez pas silencieusement la passerelle ou la stratégie d'identité de production pour le contrôle à distance.

Peut-on éteindre l'ordinateur ou fermer le capot ?

Non. L'écran peut être éteint, mais l'hôte qui exécute l'Agent doit rester allumé, les processus Claude/PandaPaw doivent rester actifs et connectés au réseau. Le Remote Control officiel se reconnecte automatiquement lorsque l'hôte reprend. En cas de mises en veille fréquentes, de changements de réseau ou d'un état « en ligne mais plus de messages », suivez la liste de vérification de déconnexion distante Claude Code point par point.

Plusieurs sessions distantes peuvent-elles modifier le même fichier ?

Il existe un risque de conflit. Le mode serveur officiel peut créer plusieurs sessions depuis le même répertoire par défaut. Pour des modifications en parallèle, utilisez claude remote-control --spawn worktree afin que chaque session dispose d'un worktree Git indépendant. Dans PandaNpc, choisissez également des espaces de travail ou worktrees différents pour les Agents en parallèle ; ne laissez pas deux sessions en écriture opérer simultanément sur le même checkout.

PandaNpc affiche la machine hors ligne

Sur l'hôte, exécutez pandapaw status et vérifiez successivement l'autorisation du compte, le service en arrière-plan, les connexions sortantes HTTPS/WebSocket et la connexion du moteur correspondant. Ouvrir un port entrant public ne peut pas réparer une connexion sortante bloquée par le proxy de l'entreprise.

Limites de sécurité : le code est local, mais tout ne reste pas sans passer par le réseau

Le Remote Control officiel établit activement des connexions HTTPS sortantes depuis la machine, sans ouvrir de port entrant sur le routeur ; les messages transitent via la connexion TLS de l'API Anthropic entre l'interface distante et la session locale. Les fichiers du projet et l'exécution des outils restent sur l'hôte, mais pour afficher la conversation et traiter les instructions, les données de la session doivent néanmoins passer par les services officiels.

PandaNpc permet également à l'hôte de se connecter activement au relais d'authentification, l'exécution restant sur l'hôte ; les messages, états, diffs et approbations à afficher à distance passent par le relais. Quelle que soit la solution utilisée, vous devez :

  • Vérifier d'abord l'hôte et le répertoire de travail avant d'approuver l'écriture de fichiers ou l'exécution de commandes ;
  • Ne pas partager la connexion distante avec des personnes non fiables ;
  • Pour les projets sensibles, privilégier l'approbation par défaut ou accepter uniquement le mode édition ;
  • Pour les appareils de l'entreprise, respecter les exigences approuvées en matière de VPN, VDI, identité et audit.

FAQ

Qu'est-ce que Claude Code Remote Control ?

Il permet à l'application Claude ou à claude.ai/code de contrôler Claude Code qui continue de s'exécuter sur votre ordinateur. Le téléphone et le navigateur sont des interfaces distantes ; les fichiers locaux, MCP, outils et configurations du projet restent sur la machine de développement.

Comment utiliser Claude Code depuis mon téléphone ?

Sur la machine de développement, exécutez claude remote-control, claude --remote-control, ou saisissez /remote-control dans une session existante ; ouvrez ensuite l'onglet Code de l'application Claude ou claude.ai/code avec le même compte. Si vous devez également contrôler Codex, des modèles personnalisés ou plusieurs hôtes, vous pouvez utiliser la page Agent de PandaNpc.

Claude Code Remote Control prend-il en charge le navigateur ?

Oui. L'entrée officielle est claude.ai/code ; PandaNpc propose également des clients navigateur, iOS et de bureau. Les deux laissent l'Agent s'exécuter sur l'hôte, au lieu de copier tout le projet dans le navigateur actuel.

Claude Code Remote Control prend-il en charge l'API Key ?

La documentation officielle indique clairement que l'API Key n'est pas prise en charge pour le moment ; une connexion Claude.ai est requise. Si votre Claude Code doit utiliser l'API, Bedrock, Vertex ou un ANTHROPIC_BASE_URL personnalisé, conservez l'authentification existante et choisissez une solution distante capable de se connecter à la CLI locale.

Si le téléphone perd la connexion, Claude Code s'arrête-t-il ?

Tant que la machine de développement et le processus Agent restent en ligne, la perte de connexion du téléphone ou la fermeture de la page n'équivaut pas à l'arrêt de la session hôte. Vous pouvez continuer à consulter après reconnexion. En revanche, aucun nouveau travail ne peut être exécuté si la machine de développement est en veille, éteinte ou hors ligne pendant une longue période.

Le Remote Control officiel peut-il contrôler Codex ou plusieurs Agents ?

Non, c'est une fonctionnalité de Claude Code. Pour gérer Claude Code, Codex, PandaCode, DeepSeek harness, Pi et plusieurs hôtes dans la même interface, une couche de connexion multi-moteurs supplémentaire est nécessaire ; PandaPaw et la fonctionnalité Appareils connectés de PandaNpc sont conçus pour ce scénario.

Conclusion

Si vous souhaitez simplement reprendre une session Claude Code officielle depuis le téléphone ou le navigateur : exécutez claude remote-control ; la solution officielle est la plus courte et la plus directe. Si vous avez besoin d'API/modèles personnalisés, d'autres moteurs comme Codex, de plusieurs hôtes ou d'un réseau privé d'appareils : conservez la configuration locale des Agents et centralisez les connexions dans PandaNpc via PandaPaw.

Quelle que soit la voie choisie, le critère de réussite n'est pas « la page affiche en ligne », mais que le côté distant puisse lire le bon répertoire de travail, voir l'état Git réel, recevoir les confirmations d'autorisation et poursuivre la même session locale après une reconnexion.

Connecter Claude Code depuis son téléphone : visualiser les sessions et approuver les outils sur iOS à tout moment

Connecter Claude Code depuis son téléphone : visualiser les sessions et approuver les outils sur iOS à tout moment

Cet article s'adresse aux développeurs et partage les bonnes pratiques pour connecter Claude Code depuis un téléphone. Grâce à l'application iOS PandaNpc, vous pouvez consulter les sessions en temps réel, approuver les appels d'outils et répondre aux questions. À l'aide de pandapaw et d'iOS Live Activity, vous pouvez contrôler à distance efficacement et améliorer la flexibilité du codage.

Lire l'article →
Dépannage des déconnexions distantes de Claude Code : symptômes, critères et solutions pour six types de déconnexion

Dépannage des déconnexions distantes de Claude Code : symptômes, critères et solutions pour six types de déconnexion

La connexion distante de Claude Code a été interrompue. Ne vous précipitez pas pour vous reconnecter — les symptômes varient selon le type de coupure, et les correctifs sont complètement différents. Cet article remonte à partir de « ce que vous observez » pour identifier six causes de coupure (mise en veille de la machine, changement de réseau interrompant les connexions longues, solution de type mise en miroir nécessitant que la machine locale reste allumée, connexion zombie, reconnexion perdant la session, processus récupéré), chacune avec ses critères de confirmation et sa solution correspondante, et se termine par une liste de contrôle de dépannage à suivre.

Lire l'article →
Interconnexion d'appareils : pas besoin d'IP publique, ni de redirection de ports, connectez-vous en toute sécurité à vos appareils à tout moment, n'importe où

Interconnexion d'appareils : pas besoin d'IP publique, ni de redirection de ports, connectez-vous en toute sécurité à vos appareils à tout moment, n'importe où

Vous voulez accéder à Claude Code, SSH, aux services internes sur votre ordinateur à la maison/au bureau depuis votre téléphone ou un autre ordinateur à l'extérieur, mais vous êtes bloqué par l'absence d'IP publique, vous n'osez pas ouvrir la redirection de port, la configuration de frp/花生壳 est trop ennuyeuse ? Activez d'un clic l'interconnexion des appareils dans le client de bureau, ajoutez chacun de vos appareils à votre réseau crypté exclusif, chaque appareil reçoit une IP privée fixe, et vous êtes connecté directement comme si vous étiez sur le même réseau local, où que vous soyez — cryptage de bout en bout, zéro exposition publique, révocation d'un clic à tout moment.

Lire l'article →