Claude Code Remote Control ne fonctionne pas ? Toutes les erreurs et solutions (2026)
Quand Claude Code Remote Control ne fonctionne pas, la cause est presque toujours l'une de ces trois. La connexion n'est pas la bonne. Un réglage envoie Claude ailleurs que chez Anthropic. Ou la session sur votre Mac s'est arrêtée.
Cherchez ci-dessous le message que vous voyez. Chaque erreur a une solution courte tirée de la documentation officielle d'Anthropic.
| Erreur ou symptôme | Cause | Solution |
|---|---|---|
| "Remote Control requires a claude.ai subscription" | Pas connecté avec claude.ai | claude auth login |
| "Remote Control requires claude.ai subscription auth" | Une clé API ou un jeton est défini | Supprimer la variable |
| "Remote Control requires a full-scope login token" | Jeton issu de claude setup-token | claude auth login |
| "Remote Control isn't enabled for this account" | Anciennes infos d'abonnement en cache | Se déconnecter puis se reconnecter |
| "Couldn't verify Remote Control eligibility" | Hors ligne ou bloqué par un proxy | Réessayer, puis claude doctor |
| "Remote Control is only available when using Claude via api.anthropic.com" | Bedrock, Google Cloud, Foundry ou ANTHROPIC_BASE_URL | Supprimer la variable |
| "Remote Control is disabled by your organization's policy" | Option désactivée sur Team ou Enterprise | Vérifier /status, demander à un Owner |
| "could not reach the Remote Control server for about 30 minutes" | Contact perdu pendant longtemps | Lancer /remote-control |
| Session absente de l'app | Remote Control n'a jamais été lancé | Lancer /rc |
| Session hors ligne | Le processus claude s'est arrêté | claude remote-control --continue |
| Session de l'app Desktop absente du téléphone | Bug connu, issue #92306 | La lancer dans le Terminal |
| Session forkée absente | Bug connu, issue #94396 | Lancer /remote-control dedans |
/remote-control n'affiche rien | Signalé dans l'issue #96591 | Utiliser claude remote-control |
| Session disparue après des heures sans message | Signalé dans l'issue #98879 | Envoyer un message ou /remote-control |
| "Couldn't reconnect to your Remote Control session" | App quittée, relancée ou mise à jour | Réessayer, puis nouvelle session |
“Remote Control requires a claude.ai subscription”
Ce message apparaît quand Claude Code n'est pas connecté avec un compte claude.ai. Avec claude remote-control, il devient "You must be logged in to use Remote Control."
Remote Control fonctionne avec les offres Pro, Max, Team et Enterprise. Les clés API ne marchent pas. Connectez-vous avec votre compte claude.ai :
claude auth login“Remote Control requires claude.ai subscription auth”
Vous êtes connecté, mais une clé API ou un jeton passe en priorité. Le message le nomme, par exemple "ANTHROPIC_API_KEY is set, so this session is using API-key auth".
Supprimez cette variable de votre profil shell et du bloc env de vos réglages Claude. Relancez ensuite Claude :
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN
claude --remote-controlSi le message cite apiKeyHelper, supprimez ce réglage.
“Remote Control requires a full-scope login token”
Vous utilisez un jeton longue durée issu de claude setup-token ou de CLAUDE_CODE_OAUTH_TOKEN. Ces jetons servent seulement aux requêtes au modèle. Connectez-vous de façon normale :
claude auth login“Remote Control isn't enabled for this account”
Claude Code a vérifié votre compte et la réponse est négative. Cela arrive souvent après un changement d'offre, quand d'anciennes infos sont encore en cache. Les anciennes versions affichaient "Remote Control is not yet enabled for your account".
Déconnectez-vous, reconnectez-vous et mettez Claude Code à jour. claude doctor indique quelle vérification a échoué :
claude auth logout
claude auth login
claude doctor“Couldn't verify Remote Control eligibility”
Claude Code n'a pas pu joindre le service qui vérifie votre compte. Vous êtes hors ligne ou un proxy bloque la requête. Réessayez avec une connexion normale ou lancez claude doctor pour en savoir plus.
“Remote Control is only available when using Claude via api.anthropic.com”
C'est l'une des erreurs les plus fréquentes. Remote Control a besoin que Claude Code parle directement à l'API d'Anthropic. Il ne marche pas sur Amazon Bedrock, Google Cloud ou Microsoft Foundry. Il échoue aussi quand ANTHROPIC_BASE_URL pointe vers un proxy ou une passerelle LLM, même avec une connexion claude.ai.
Le message nomme la cause, comme CLAUDE_CODE_USE_BEDROCK ou une ANTHROPIC_BASE_URL personnalisée. Supprimez-la du shell et du bloc env de vos réglages. Relancez ensuite la session :
env | grep -i -e ANTHROPIC -e CLAUDE_CODE_USE
unset ANTHROPIC_BASE_URL
claude --remote-control“Remote Control is disabled by your organization's policy”
Sur les offres Team et Enterprise, Remote Control est désactivé au départ. Un Owner l'active dans les réglages admin de Claude Code. Si vous payez Pro ou Max, Claude Code est peut-être encore connecté à une ancienne organisation Team.
Lancez /status pour voir votre offre et votre organisation. Si ce n'est pas la bonne, lancez claude auth logout puis claude auth login. Si le message cite disableRemoteControl, votre service informatique l'a coupé sur cet appareil.
“could not reach the Remote Control server for about 30 minutes”
Votre session a perdu le contact avec les serveurs d'Anthropic pendant longtemps. Lancez ceci dans la session pour vous reconnecter :
/remote-controlLa session n'apparaît pas dans l'app Claude
Remote Control démarre seulement quand vous le demandez. Lancez /rc dans votre session ou démarrez Claude avec claude --remote-control. Dans l'app Claude, touchez Code pour voir vos sessions. Les deux appareils doivent utiliser le même compte.
Pour connecter chaque session automatiquement, ouvrez /config et activez Enable Remote Control for all sessions. Dans l'app Desktop, allez dans Réglages > Claude Code > Connect new sessions to Remote Control.
La session est passée hors ligne
Remote Control tourne dans le processus claude de votre Mac. Si vous fermez le terminal ou quittez l'app, la session passe hors ligne.
En mode serveur, vous pouvez la reprendre dans les quatre heures environ :
claude remote-control --continuePour une session lancée avec --remote-control ou /rc, lancez claude --continue puis /rc. Lancez les longues tâches dans tmux pour qu'une fenêtre fermée ne les arrête pas.
Tout s'arrête quand mon Mac se met en veille
Le travail est en pause pendant la veille. Claude Code se reconnecte tout seul quand le Mac se réveille.
Pour garder le Mac éveillé pendant une tâche, lancez Claude avec caffeinate :
caffeinate -i claude --remote-controlLa plupart des MacBook se mettent quand même en veille quand on ferme l'écran, sauf avec un écran externe et le chargeur branchés.
La session n'apparaît pas sur votre téléphone ou disparaît
Ce sont des bugs connus, signalés sur GitHub. En octobre 2026, la plupart sont encore ouverts. Voici ce qui se passe dans chaque cas et ce que vous pouvez faire.
Les sessions de l'app Claude Desktop n'apparaissent jamais
Sur macOS, les sessions Code interactives de l'app Desktop peuvent ne pas s'inscrire à Remote Control, même avec la connexion automatique activée. Les tâches planifiées de la même app apparaissent bien sur le téléphone. C'est signalé dans l'issue #92306, toujours ouverte.
Il n'y a pas encore de correctif officiel. Selon le signalement, la CLI installée à part n'est pas touchée. Lancer la session dans le Terminal avec claude --remote-control peut vous permettre de contourner le problème.
Une session forkée n'apparaît jamais
Une session forkée depuis une autre n'est jamais marquée pour Remote Control. Elle reste absente de l'onglet Code sur votre téléphone. Voir l'issue #94396, toujours ouverte.
Le contournement donné par l'auteur : activez-le à la main avec /remote-control dans cette session. Envoyez d'abord un message. Sinon vous obtenez "Remote Control requires an active session. Send a message first."
/remote-control n'affiche rien et la session n'apparaît jamais
Certaines personnes lancent /remote-control et n'obtiennent ni lien ni confirmation. En le relançant, on voit "Remote Control disconnected." Signalé dans l'issue #96591, fermée comme non prévue.
Lancez claude doctor pour vérifier votre connexion et votre réseau. Essayez ensuite le mode serveur avec claude remote-control. Il affiche une URL de session et un QR code pour ouvrir la session directement.
La session disparaît après des heures sans message
Un signalement sur Android décrit une session disparue de la liste Code après environ 8 heures sans message. L'ordinateur était toujours allumé. Elle est revenue après une utilisation de l'app Desktop. Voir l'issue #98879, toujours ouverte.
Il n'y a pas encore de correctif. Envoyez un message depuis votre Mac pour la faire revenir, ou reconnectez-vous avec /remote-control.
"Couldn't reconnect to your Remote Control session"
Quand l'app Desktop se ferme, redémarre ou se met à jour, ses sessions s'arrêtent et Remote Control ne se réactive pas. Le réactiver peut échouer avec "Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume." Voir l'issue #98504, toujours ouverte.
Suivez le message. Réessayez une fois, puis démarrez une nouvelle session. Une session arrêtée doit d'abord exécuter un échange sur votre Mac avant de pouvoir réactiver Remote Control.
Un contournement de la communauté dans ce fil : lancez claude dans tmux, en dehors de l'app Desktop. Un redémarrage de l'app ne l'arrête alors plus.
Quand vous avez besoin de plus que la session Claude
Remote Control est très pratique pour discuter avec Claude Code. Parfois, il vous faut aussi le reste de votre Mac. Macky ouvre le terminal et l'écran de votre Mac sur votre iPhone.
- Il marche avec une clé API, Bedrock ou un proxy. C'est votre propre shell, donc votre configuration reste la même.
- Des modes dédiés pour Claude Code et Codex, plus un terminal normal pour git, Docker et le reste.
- Une barre de touches avec Esc, Tab et Ctrl. Validez avec y et Entrée.
- Vos clés SSH restent sur votre Mac. Tapez
ssh my-vpset vous êtes connecté. - Avec Pro, utilisez votre MacBook écran fermé et gardez les sessions connectées en arrière-plan.
Installez Macky sur votre Mac et votre iPhone, connectez-vous sur les deux, puis lancez la connexion. C'est gratuit avec des sessions de 5 minutes. Pro coûte 29 $ une seule fois. Télécharger sur l'App Store.
Vous découvrez Remote Control ? Lisez le guide de Claude Code Remote Control. Pour comparer les deux, voyez Macky vs Claude Code Remote Control.
FAQ
Pourquoi Claude Code Remote Control ne fonctionne pas ?
Le plus souvent, c'est la connexion, une clé API ou ANTHROPIC_BASE_URL, ou le processus claude arrêté sur le Mac. Le message d'erreur indique lequel.
Comment corriger "Remote Control is only available when using Claude via api.anthropic.com" ?
Supprimez ANTHROPIC_BASE_URL ou la variable Bedrock, Google Cloud ou Foundry citée dans le message. Relancez ensuite Claude Code connecté avec claude.ai.
Remote Control marche-t-il avec une clé API ?
Non. Il faut une connexion claude.ai avec une offre Pro, Max, Team ou Enterprise.
Pourquoi ma session n'apparaît pas dans l'app Claude ?
Remote Control démarre seulement avec /rc ou claude --remote-control, sauf si vous activez la connexion automatique dans /config. Les deux appareils doivent utiliser le même compte.
Que se passe-t-il si mon Mac se met en veille ?
La session est en pause. Claude Code se reconnecte quand le Mac se réveille.
Puis-je piloter Claude Code depuis mon téléphone sans Remote Control ?
Oui. Macky ouvre le terminal de votre Mac sur votre iPhone, donc Claude Code marche avec n'importe quelle connexion, clé API comprise.
Guides et comparatifs associés
Claude Code Remote Control : configuration, limites et solutions (2026)
Codex sur mobile : utiliser OpenAI Codex depuis l'iPhone (2026)
OpenAI Codex Remote Control : Résoudre le blocage "Awaiting Approval" et les bugs de jumelage
Essayer Macky
Connectez-vous au terminal de votre Mac depuis votre iPhone.