Comment utiliser Claude Code depuis ton téléphone
Tu lances un gros refactor, tu pars te faire un café, et Claude Code s’arrête pour demander s’il peut exécuter les migrations. Tu n’es pas à ton bureau, donc l’agent attend. Ce guide explique comment laisser l’ordinateur travailler et garder un œil dessus depuis ton téléphone : ce qu’il faut mettre en place, et dans quel ordre.
Pourquoi faire ça
Un agent de code ne travaille pas toujours par rafales de deux minutes. Une longue tâche peut durer une demi-heure ou plus, et en chemin Claude Code demande la permission d’exécuter des commandes, de modifier des fichiers ou de toucher à quelque chose en dehors du projet. Si personne ne répond, il attend.
Avec ton téléphone en poche, tu vois où il en est, tu lis ce qu’il demande et tu décides. Pas besoin de rester collé au bureau, ni de tout approuver d’avance au cas où.
Ce qu’il te faut
Trois choses sur l’ordinateur où tourne Claude Code, plus une app sur ton téléphone.
Un serveur SSH. Ton téléphone se connecte à ton ordinateur en SSH, exactement comme le ferait un autre portable.
- Sous macOS : Réglages Système › Général › Partage › Session à distance.
- Sous Linux (Debian ou Ubuntu) :
sudo apt install openssh-server
sudo systemctl enable --now ssh
Un moyen de l’atteindre depuis l’extérieur de ton réseau local. Sur le même Wi-Fi, l’IP locale suffit. Hors de chez toi, un VPN comme Tailscale est la voie raisonnable : le téléphone et l’ordinateur se voient comme s’ils étaient sur un même réseau, et tu n’as pas à exposer le port 22 sur internet. Ne fais pas cela, surtout avec une connexion par mot de passe.
Un multiplexeur de terminal, comme tmux. Sans lui, si le téléphone perd sa connexion ou si tu fermes l’app, la session de terminal meurt avec elle. Avec tmux, Claude Code continue de tourner sur l’ordinateur et tu te rattaches simplement à la même session.
brew install tmux # macOS
sudo apt install tmux # Debian/Ubuntu
Pas à pas
- Active SSH sur l’ordinateur et vérifie que ça marche depuis une autre machine :
ssh your-user@computer-ip. - Installe le VPN des deux côtés si tu veux te connecter hors de chez toi, et note le nom ou l’IP de l’ordinateur sur ce réseau.
- Lance Claude Code dans tmux :
tmux new-session -A -s claude
claude
L’option -A signifie que si une session nommée claude existe déjà, tu t’y rattaches au lieu d’en créer une seconde.
- Connecte-toi depuis le téléphone en SSH et rattache-toi à cette session tmux. De là, tu peux écrire à Claude, lire ce qu’il fait et répondre.
Ça marche. Ce qui manque, c’est le confort : tu dois ouvrir l’app toutes les quelques minutes pour voir si Claude t’attend encore. C’est à ça que sert la dernière pièce.
Où Wendo s’insère
Wendo est un client SSH pour iOS et Android, fait par Lirafy, conçu pour garder un œil sur les agents de code. Il n’est pas encore dans les stores ; il arrive bientôt sur l’App Store et Google Play.
Ce qu’il ajoute au SSH simple, ce sont les alertes et les approbations. Sur l’ordinateur, tu lances une commande :
curl -fsSL https://wendo.lirafy.dev/install.sh | sh
Le script télécharge le hook et le script d’appairage dans ~/.wendo, installe jq et qrencode s’ils manquent, enregistre le hook dans ~/.claude/settings.json (en sauvegardant d’abord une copie sous settings.json.bak-wendo), te prévient si rien n’écoute SSH sur le port 22 et affiche un QR code. Tu peux le relancer sans que rien ne soit dupliqué.
Sur le téléphone, va dans Machines › Ajouter et choisis de scanner le QR code. Wendo épingle l’empreinte de la clé d’hôte du serveur dès ce premier moment, donc tu n’acceptes pas une clé à l’aveugle. L’app te montre ensuite une commande à exécuter sur l’ordinateur, qui installe la clé du téléphone dans authorized_keys.
À partir de là, tout ce dont Claude Code a besoin de toi arrive dans la boîte de réception : demandes de permission, questions et tâches terminées, de toutes tes machines au même endroit. Chaque demande de permission peut être approuvée ou refusée depuis sa ligne. Si tu ne réponds pas, rien d’étrange ne se passe : le hook attend 90 secondes, puis Claude Code te le demande dans le terminal comme d’habitude. Les détails sont dans la page alertes et approbations.
Si tu lances Claude dans tmux, toucher une alerte t’amène au pane exact où il tourne. La configuration est sur la page tmux, et ce qui se passe quand le réseau tombe est expliqué dans des sessions qui survivent aux coupures.
Deux autres choses aident sur un petit écran : le visualiseur de diff pour relire ce que Claude a modifié, et le collage d’images dans la conversation. Si tu construis quelque chose pour le web, il y a aussi un aperçu dans le navigateur.
Le plan gratuit inclut 5 approbations d’essai depuis la boîte de réception ; avec Pro, il n’y a pas de limite.
App fermée
La boîte de réception s’actualise toute seule tant que Wendo est ouvert. Avec l’app fermée, les alertes arrivent via ntfy, un service de notifications push que tu peux héberger toi-même. Comment le configurer, et pourquoi le topic est en pratique un mot de passe, est expliqué dans l’article sur les notifications de Claude Code sur ton téléphone.
Et si je préfère un autre client
N’importe quel client SSH couvre l’essentiel : se connecter, se rattacher à tmux, parler à Claude Code. Ce que tu perds, c’est tout le reste. Sans le hook, il n’y a ni boîte de réception, ni approbation depuis une ligne, ni alerte quand la session a besoin de toi : il faut penser à vérifier. Si cela te suffit, les étapes ci-dessus sont tout ce qu’il te faut.
Limites à connaître
- Sous Windows, il faut WSL2 : l’app envoie des commandes de shell POSIX en SSH, et tmux n’existe pas sous Windows. Lance Claude Code dans WSL pour que les hooks s’y exécutent.
- Pour l’instant, le hook n’est enregistré que pour Claude Code.
- Les questions et approbations de plan de Claude ne bloquent pas : tu y réponds depuis la vue chat, pas depuis une ligne de la boîte de réception.
- L’intégration de tmux, zellij et herdr fait partie de Wendo Pro.