Ce que vous allez apprendre

Ce guide vous présente toutes les méthodes pour utiliser Claude Code à distance — de la fonctionnalité officielle Remote Control d'Anthropic aux configurations DIY SSH avec tmux, mosh, et Tailscale. À la fin, vous disposerez d'une configuration de codage mobile fonctionnelle où vous pourrez lancer des tâches sur votre ordinateur de bureau, quitter votre bureau et garder le contrôle total depuis votre téléphone.

Claude Code Remote Control : Le guide complet 2026

Le February 25, 2026, Anthropic a lancé Remote Control — la possibilité de lancer une tâche de codage dans votre terminal, de mettre votre ordinateur portable dans votre sac et de garder le contrôle total depuis votre téléphone. Aucun VPN, aucun port forwarding, aucun outil tiers n'est requis. Source

Mais la fonctionnalité officielle n'est qu'une partie de l'histoire. La communauté des développeurs a construit un écosystème entier de configurations de codage mobile autour de Claude Code, allant des simples tunnels SSH aux workflows multi-outils sophistiqués avec notifications push et entrée vocale. Ce guide les couvre tous.

Partie 1 : Remote Control officiel

De quoi s'agit-il

Remote Control est la fonctionnalité intégrée d'Anthropic pour continuer les sessions Claude Code sur plusieurs appareils. Elle fonctionne en demandant à votre instance locale de Claude Code de s'enregistrer auprès de l'API Anthropic en tant que serveur, puis en permettant aux clients autorisés (votre téléphone) de se connecter et de contrôler la session à distance. Source

Comment cela fonctionne sous le capot

Le modèle de sécurité est simple et conservateur :

Votre bureau (Claude Code)          API Anthropic           Votre téléphone (Claude App)
        │                                │                          │
        ├──── Enregistrer la session ────►│                          │
        │                                │                          │
        │◄─── Attribuer l'URL de session ─┤                          │
        │                                │                          │
        │     Afficher le QR code        │                          │
        │                                │◄──── Scanner le QR / Auth ┤
        │                                │                          │
        │◄─── Router les messages ───────┤──── Router les messages ─►│
        │                                │                          │
        │     (Tout le trafic via TLS)   │                          │

Propriétés de sécurité clés :

• Aucun inbound ports — votre machine locale effectue uniquement des requêtes HTTPS sortantes
• Pas de connexion directe — votre téléphone ne se connecte jamais directement à votre ordinateur de bureau
• Chiffrement TLS — tout le trafic passe par l'API Anthropic via TLS
• Session-scoped — chaque session Remote Control possède une URL unique qui expire

Source

Étapes de configuration

Étape 1 : Mettre à jour Claude Code

Remote Control nécessite Claude Code v2.1.51 ou ultérieure :

# Vérifiez votre version
claude --version

# Mettez à jour si nécessaire
npm update -g @anthropic-ai/claude-code

Étape 2 : Démarrer une session

Commencez à travailler sur votre projet normalement :

cd ~/projects/my-app
claude

Étape 3 : Activer Remote Control

Depuis votre session Claude Code, exécutez :

/rc
# ou
/remote-control

Cela démarre le serveur Remote Control. Votre terminal affichera :

Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control

Étape 4 : Se connecter depuis votre téléphone

Deux options :

1. QR Code : Appuyez sur la barre d'espace dans votre terminal pour afficher un QR code. Ouvrez l'application Claude sur votre téléphone et scannez-le.
2. URL : Copiez l'URL de la session et ouvrez-la dans l'application Claude sur votre téléphone.

Votre téléphone a maintenant le contrôle total de la session Claude Code. Vous pouvez envoyer des messages, approuver les modifications de fichiers et examiner les résultats — la conversation reste synchronisée sur tous les appareils connectés. Source

Activer Remote Control par défaut

Si vous utilisez fréquemment Remote Control, activez-le pour toutes les sessions :

/mobile

Cela affiche un QR code pour installer l'application Claude si vous ne l'avez pas déjà fait, et bascule le paramètre "Enable Remote Control for all sessions" sur true. Une fois activée, chaque session Claude Code démarre automatiquement en mode Remote Control. Source

Exigences du forfait

Source

Limites de Remote Control

• Nécessite l'application Claude — vous ne pouvez pas utiliser un navigateur générique ; l'application mobile Claude est requise
• Dépendance envers Anthropic — tout le trafic passe par les serveurs d'Anthropic ; si leur API est en panne, Remote Control l'est aussi
• Pas de support hors ligne — les deux appareils doivent avoir une connectivité internet
• Expiration de session — les sessions inactives finissent par expirer
• Fournisseur unique — fonctionne uniquement avec les modèles Claude, pas si vous utilisez OpenCode ou d'autres outils multi-fournisseurs

Partie 2 : SSH + tmux + mosh (L'approche DIY)

Pour les développeurs qui souhaitent un contrôle total du terminal, un support multi-fournisseur ou qui travaillent sur des réseaux peu fiables, l'approche basée sur SSH est plus robuste. Comme l'a écrit le développeur Harper Reed : "En cherchant comment utiliser Claude Code sur un téléphone, la réponse évidente était de se connecter en ssh à un ordinateur depuis un téléphone et de lancer claude." Source

Pourquoi trois outils ?

Vous avez besoin de deux types de résilience différents :

• mosh gère la connexion mobile instable — transitions WiFi vers cellulaire, zones mortes, mise en veille du téléphone
• tmux gère la persistance de la session — maintient la session Claude Code active même lorsque votre téléphone se déconnecte complètement

Ensemble, ils rendent le développement mobile réellement viable. Source

Configuration de la stack

Étape 1 : Installer Tailscale (Réseau privé)

Tailscale crée un mesh WireGuard privé entre vos appareils. Pas de port forwarding, pas de configuration de routeur, pas de règles de pare-feu.

Sur votre ordinateur de bureau :

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Start Tailscale
sudo tailscale up

Sur votre téléphone :

• Installez l'application Tailscale depuis votre app store
• Connectez-vous avec le même compte
• Les deux appareils sont maintenant sur le même réseau privé

Votre ordinateur obtient une IP Tailscale (quelque chose comme 100.64.x.x) que votre téléphone peut atteindre directement, quel que soit le réseau WiFi ou cellulaire utilisé. Source

Étape 2 : Installer tmux (Persistance de la session)

tmux maintient vos sessions de terminal actives indépendamment de votre connexion SSH. Lorsque votre téléphone se déconnecte (verrouillage de l'écran, changement de réseau, batterie vide), la session tmux continue de s'exécuter.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

Créez une configuration tmux optimisée pour l'usage mobile :

# ~/.tmux.conf

# Increase scrollback buffer
set -g history-limit 50000

# Enable mouse support (useful on mobile)
set -g mouse on

# Reduce escape-time for responsive mobile input
set -sg escape-time 10

# Status bar with useful info
set -g status-right '#H | %H:%M'

# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'

Étape 3 : Installer mosh (Résilience de la connexion)

mosh (Mobile Shell) utilise UDP au lieu de TCP, ce qui gère les transitions réseau avec fluidité. Lorsque votre téléphone passe du WiFi au cellulaire ou traverse un tunnel, mosh se reconnecte automatiquement.

Sur votre ordinateur de bureau :

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

Sur votre téléphone :

• iOS : Installez Blink Shell ou Termius — les deux supportent mosh nativement
• Android : Installez JuiceSSH ou Termux avec le paquet mosh

Étape 4 : Se connecter et lancer Claude Code

Depuis le client SSH de votre téléphone :

# Connect via mosh through Tailscale
mosh user@100.64.x.x

# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude

# Launch Claude Code
cd ~/projects/my-app
claude

Vous avez maintenant une session Claude Code qui :

• Survit aux changements de réseau (mosh)
• Survit aux déconnexions du téléphone (tmux)
• Est accessible depuis n'importe quel appareil sur votre réseau Tailscale
• Fonctionne avec n'importe quel fournisseur d'IA, pas seulement Claude

Se reconnecter après une déconnexion

Lorsque vous reprenez votre téléphone plus tard :

# mosh se reconnectera automatiquement si la session est toujours active
# Si la session mosh est interrompue, lancez-en une nouvelle :
mosh user@100.64.x.x

# Re-attachez-vous à votre session tmux
tmux attach -t claude

Votre session Claude Code est exactement là où vous l'avez laissée — même conversation, même répertoire de travail, mêmes modifications en attente.

Partie 3 : Notifications push avec ntfy

Le problème avec Remote Control et les configurations SSH : vous devez continuer à vérifier votre téléphone pour voir si Claude Code a terminé sa tâche. La solution est les notifications push.

Qu'est-ce que ntfy ?

ntfy est un service de notification push simple et open-source. Vous pouvez l'auto-héberger pour plus de confidentialité ou utiliser l'instance publique sur ntfy.sh. Source

ntfy auto-hébergé avec Tailscale

Pour une confidentialité maximale, lancez ntfy sur votre ordinateur de bureau et accédez-y via Tailscale :

# Install ntfy
brew install ntfy  # macOS
# or
sudo apt install ntfy  # Linux

# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090

Puisque votre téléphone et votre ordinateur sont sur le même réseau Tailscale, votre téléphone peut atteindre ntfy à l'adresse http://100.64.x.x:8090. Aucune donnée ne quitte votre réseau privé.

Configuration des hooks Claude Code

Les hooks Claude Code vous permettent de déclencher des commandes personnalisées lorsque certains événements surviennent. Configurez un hook pour envoyer une notification quand Claude Code a besoin d'une entrée :

// ~/.claude/settings.json
{
  "hooks": {
    "notification": {
      "command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
      "event": "stop"
    }
  }
}

Source

Configuration de l'application mobile ntfy

1. Installez l'application ntfy sur votre téléphone (iOS ou Android)
2. Ajoutez un abonnement au sujet claude-code sur votre serveur auto-hébergé (http://100.64.x.x:8090/claude-code)
3. Activez les notifications push pour ce sujet

Désormais, dès que Claude Code s'arrête et a besoin d'une entrée — qu'il ait terminé une tâche, rencontré une erreur ou ait besoin d'une approbation — vous recevez une notification push sur votre téléphone. Plus besoin de garder le terminal ouvert ou de vérifier constamment.

Configuration avancée des notifications

Pour des notifications plus riches en contexte, vous pouvez inclure le dernier message de Claude Code :

#!/bin/bash
# ~/.claude/hooks/notify.sh

# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")

# Send notification with context
curl -s \
  -H "Title: Claude Code" \
  -H "Priority: high" \
  -H "Tags: robot" \
  -d "$LAST_OUTPUT" \
  http://100.64.x.x:8090/claude-code

Source

Partie 4 : Happy Coder (Alternative open-source gratuite)

Happy Coder est un outil gratuit et open-source qui fournit une interface web pour contrôler Claude Code à distance, avec des notifications push intégrées et une entrée vocale. Source

Fonctionnalités clés

• Gratuit et open source — aucun abonnement requis au-delà de votre forfait Claude Code
• Notifications push — système de notification intégré, aucune configuration ntfy nécessaire
• Entrée vocale — dictez des commandes au lieu de taper sur un petit écran
• Support multi-agents — fonctionne avec Codex aux côtés de Claude Code
• Basé sur le web — fonctionne dans n'importe quel navigateur mobile, aucune installation d'application requise

Configuration

# Install Happy Coder
npm install -g happy-coder

# Start the server
happy-coder start --port 3000

# Access from your phone via Tailscale
# http://100.64.x.x:3000

Happy Coder fournit une interface web optimisée pour mobile qui affiche votre conversation Claude Code, vous permet d'envoyer des messages et montre les modifications de fichiers — le tout via votre navigateur.

Partie 5 : Comparaison complète des configurations

Matrice de comparaison des méthodes

Configuration recommandée par cas d'utilisation

Utilisateur occasionnel (vérifier les tâches de temps en temps) : → Remote Control. Une commande, un scan QR, terminé.

Codeur mobile quotidien (code fréquemment depuis son téléphone) : → SSH + tmux + mosh + ntfy. Résilience et contrôle maximaux.

Chef d'équipe (surveiller plusieurs sessions) : → Happy Coder. Basé sur le web, supporte plusieurs agents, notifications intégrées.

Développeur multi-fournisseur (utilise Claude, Codex et des modèles locaux) : → SSH + tmux + mosh. Fonctionne avec n'importe quel outil s'exécutant dans un terminal.

Partie 6 : Configurations avancées

Exécuter plusieurs sessions Claude Code

Avec tmux, vous pouvez exécuter plusieurs sessions Claude Code en parallèle et basculer entre elles :

# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests

# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m

# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend

Configuration de VM Linux headless

Pour les équipes qui souhaitent un environnement de codage à distance dédié, Claude Code Remote Control fonctionne sur des VM Linux headless via SSH + tmux. Source

# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Start in a tmux session
tmux new-session -s remote-claude

# Launch Claude Code
claude

# Start Remote Control
/rc

Scannez ensuite le QR code depuis votre téléphone. Cela vous donne un environnement de développement puissant dans le cloud, contrôlé entièrement depuis votre mobile.

Combiner Remote Control avec SSH

Vous pouvez utiliser les deux méthodes ensemble pour une flexibilité maximale :

1. SSH + tmux pour la persistance de la session et l'accès complet au terminal
2. Remote Control au sein de la session tmux pour l'interface de chat conviviale sur mobile

# SSH into your machine
mosh user@100.64.x.x

# Attach to tmux
tmux attach -t claude

# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc

Vous avez maintenant :

• tmux qui maintient la session active
• mosh qui stabilise la connexion SSH
• Remote Control qui fournit une interface mobile soignée
• Un accès complet au terminal quand vous en avez besoin

Partie 7 : Créer des applications en déplacement

Le workflow de développement mobile

La combinaison de Claude Code + accès à distance change fondamentalement quand et où vous pouvez être productif. Un workflow pratique :

1. Trajet du matin : Examinez les résultats de la CI de la nuit sur votre téléphone, lancez des tâches de correction via Remote Control.
2. Pause déjeuner : Vérifiez les progrès via les notifications ntfy, approuvez ou redirigez les modifications.
3. Soirée : Reprenez votre ordinateur portable et la session tmux est exactement là où vous l'aviez laissée.

Quand le codage mobile est-il pertinent ?

Le codage mobile via Claude Code est le mieux adapté pour :

• L'initiation de tâches — décrivez ce que vous voulez construire et laissez Claude Code travailler pendant que vous n'êtes pas là.
• La revue de code — lisez les diffs et approuvez les modifications depuis votre téléphone.
• Le triage de bugs — enquêtez sur les problèmes et orientez Claude Code vers les corrections.
• Le suivi de progression — vérifiez l'état des tâches de longue durée.

Il est moins adapté pour :

• Le débogage complexe — les petits écrans rendent la lecture des stack traces pénible.
• Le travail visuel — les ajustements CSS et de mise en page nécessitent un écran complet.
• Le refactoring à grande échelle — vous voudrez examiner des modifications étendues sur un moniteur approprié.

Créer avec ZBuild de n'importe où

Pour les développeurs qui souhaitent créer et itérer sur des applications en déplacement, des plateformes comme ZBuild complètent le workflow distant de Claude Code. ZBuild fournit un constructeur d'applications visuel qui fonctionne bien sur tablettes et peut être associé à Claude Code pour une logique backend plus complexe — vous offrant une capacité de développement full-stack qui ne nécessite pas de poste de travail fixe.

Partie 8 : Dépannage

Problèmes courants et solutions

Problème : "Remote Control not available on your plan" Solution : Vérifiez que vous êtes sur un forfait Pro, Max, Team ou Enterprise. Le niveau Free ne supporte pas Remote Control.

Problème : Le QR code ne se scanne pas Solution : Assurez-vous que votre application Claude est mise à jour. Essayez l'URL de session directement au lieu de scanner.

Problème : La connexion mosh tombe et ne se reconnecte pas Solution : Vérifiez que mosh-server s'exécute sur votre bureau (which mosh-server). Vérifiez que Tailscale est connecté sur les deux appareils. Assurez-vous que les ports UDP 60000-61000 sont ouverts si vous n'utilisez pas Tailscale.

Problème : La session tmux affiche un écran vide après reconnexion Solution : Exécutez tmux attach -t claude au lieu de créer une nouvelle session. Si la session est interrompue, vérifiez si Claude Code a planté en consultant ~/.claude/logs/.

Problème : Les notifications ntfy n'arrivent pas Solution : Vérifiez que le serveur ntfy s'exécute (curl http://100.64.x.x:8090/health). Vérifiez que l'URL d'abonnement de l'application ntfy correspond à l'adresse de votre serveur. Assurez-vous que la connexion Tailscale de votre téléphone est active.

Problème : La session Claude Code a expiré pendant que le téléphone était déconnecté Solution : Cela arrive avec Remote Control après une inactivité prolongée. Utilisez une configuration basée sur tmux pour les sessions qui doivent persister pendant des heures. Les sessions tmux survivent indéfiniment, indépendamment des connexions client.

Problème : La frappe est lente sur mobile Solution : Utilisez l'entrée vocale (Happy Coder) ou rédigez des messages courts et orientés vers la tâche. Alternativement, préparez vos prompts dans une application de notes et collez-les dans le terminal.

Partie 9 : Considérations de sécurité

Sécurité de Remote Control

• Tout le trafic est chiffré via TLS via l'API d'Anthropic.
• Les URL de session sont uniques et expirent après usage.
• Aucun inbound ports n'est ouvert sur votre machine.
• Vos identifiants et vos fichiers ne quittent jamais votre machine (seule la sortie texte de Claude Code est transmise).

Bonnes pratiques de sécurité SSH

Lorsque vous exposez SSH pour un accès mobile :

# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes

# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x

# Use a non-standard port
Port 2222

Sécurité de Tailscale

Le réseau mesh de Tailscale basé sur WireGuard fournit :

• Un chiffrement de bout en bout entre les appareils.
• Aucun routage de données via les serveurs de Tailscale (connexions directes).
• MagicDNS pour une résolution facile des noms d'hôte.
• Des listes de contrôle d'accès (ACLs) pour les configurations d'équipe.

Conclusion

Utiliser Claude Code à distance en 2026 va du plus simple (une commande /rc) au entièrement personnalisé (SSH + tmux + mosh + ntfy + Tailscale). La bonne configuration dépend de votre workflow :

• Remote Control pour des vérifications mobiles rapides sans configuration.
• SSH stack pour les développeurs qui vivent dans le terminal et ont besoin d'une résilience maximale.
• Happy Coder pour un juste milieu gratuit et riche en fonctionnalités.

L'impact pratique est significatif. Le développement n'est plus lié au fait d'être assis à un bureau avec un ordinateur portable ouvert. Vous pouvez lancer une tâche, partir, et garder le contrôle. Que vous construisiez un projet personnel, gériez le codebase d'une équipe ou prototypiez une application avec ZBuild, l'accès mobile à Claude Code signifie que votre workflow de développement vous suit, et non l'inverse.

Sources

• Documentation Claude Code Remote Control — Anthropic
• Remote Claude Code : Programmer comme au début des années 2000s — Harper Reed
• Claude Code depuis la plage : mosh, tmux, et ntfy — Rogs
• Claude Code Remote Control : Coder depuis votre téléphone — Medium
• Claude Code sur votre téléphone portable — Builder.io
• Notifications Claude Code parfaites avec Tailscale et ntfy — Felipe Elias
• 3 façons de lancer Claude Code depuis votre téléphone — Zilliz
• Lancer Claude Code depuis votre iPhone — Pete Sena / Medium
• Analyse du lancement de Claude Code Remote Control — Blockchain News
• Remote Control sur VM Linux headless — GitHub Issue #29479
• Configuration mobile Claude Code avec tmux et Bitvise — GitHub Gist
• Comment utiliser Claude Code sur votre téléphone — FelloAI
• Configuration mobile Claude Code — Blog Sealos