Pour connecter ton téléphone à Claude Code, installe l'app Claude Code Notifier sur ton iPhone ou ton téléphone Android, et l'outil en ligne de commande gratuit ccn sur ton ordinateur, puis associe-les. Lance ccn pair et scanne le QR code affiché, ou ouvre l'app dans Ordinateurs > Ajouter un ordinateur et lance ccn pair avec le code à 6 chiffres affiché. Ça fonctionne pareil sur Mac, Windows et Linux, et ça prend environ une minute.
01Ce que l'association t'apporte
Une fois ton téléphone associé, Claude Code peut te joindre quand il a besoin de toi :
- Un push « Claude a terminé » dès qu'un tour se termine.
- Des demandes de permission que tu peux autoriser une fois, autoriser pour la session, ou refuser.
- Des questions auxquelles tu réponds en choisissant une option.
- Une instruction de relance à envoyer juste après que Claude a terminé.
Avant l'association, ccn affiche déjà des notifications de bureau sur l'ordinateur pour ces mêmes moments. L'association ajoute le téléphone.
Claude Code Notifier est un outil indépendant développé par TouchTap Ltd. Il n'est ni développé par Anthropic, ni affilié à elle. Il passe par les hooks de Claude Code, donc il couvre chaque session claude dans n'importe quel terminal, y compris les terminaux intégrés aux IDE VS Code, Cursor et JetBrains.
02Avant de commencer
Il te faut :
- Claude Code installé et fonctionnel sur l'ordinateur.
- L'app Claude Code Notifier sur ton téléphone, depuis l'App Store ou Google Play. Si tu scannes d'abord le QR code sans avoir l'app, ton téléphone te propose le store.
- Une connexion réseau sur les deux appareils.
L'app est gratuite à télécharger et nécessite un abonnement ou un achat à vie, avec un essai gratuit sur la formule annuelle. Voir les tarifs.
03Deux façons d'associer
Il y a deux méthodes. Elles mènent au même résultat, choisis la plus pratique.
Les liens QR et les codes à 6 chiffres sont valables 24 heures.
04Méthode 1 : scanner un QR code
Sur Mac ou Linux
- Ouvre un terminal et installe
ccn:
curl -fsSL https://claudecodenotifier.com/install.sh | shOu avec Homebrew :
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn- Lance
ccn(ouccn pair). Il installe les hooks si besoin et affiche un QR code et un lien. - Pointe l'appareil photo de ton téléphone vers le QR code et ouvre le lien. Si l'app est installée, elle s'ouvre et lance l'appairage. Sinon, le téléphone te propose d'abord l'App Store ou Google Play ; installe l'app et l'appairage continue.
- Le terminal confirme que le téléphone est appairé.
Sur Windows
- Ouvre PowerShell et installe
ccn(le support de Windows est en bêta) :
irm https://claudecodenotifier.com/install.ps1 | iex- Lance
ccn pair. PowerShell affiche un QR code et un lien. - Scanne-le avec l'appareil photo de ton téléphone, comme ci-dessus.
- PowerShell confirme que le téléphone est appairé.
Avec Node.js ou en plugin, sur n'importe quel OS
Si tu as Node.js, cette commande installe et lance l'appairage d'un coup :
npx @touchtap/ccnOu, depuis Claude Code, installe-le en plugin et lance sa commande de configuration :
/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup05Méthode 2 : saisir un code à 6 chiffres
Cette méthode démarre sur le téléphone, pratique quand tu vois mal l'écran de l'ordinateur ou quand Claude Code tourne sur un serveur auquel tu accèdes en SSH.
- Ouvre l'app Claude Code Notifier et va dans Computers > Add a computer.
- L'app affiche un code à 6 chiffres et la ligne exacte à lancer pour ton système.
- Lance cette ligne sur l'ordinateur. Si
ccnest déjà installé, c'est simplement :
ccn pair 482913Remplace 482913 par ton propre code.
Installer et appairer en une ligne
Chaque ligne d'installation accepte le code, donc une seule commande suffit sur un nouvel ordinateur.
Sur Mac ou Linux :
curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913Sur Windows, dans PowerShell :
irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913En plugin Claude Code, passe le code à la commande de configuration : /ccn:setup 482913.
06Vérifier que ça marche
Deux commandes confirment que tout est en place :
ccn doctor # checks hooks, credentials, server connection and presence detection
ccn test # sends a test notification to your phoneEnsuite, teste en conditions réelles. Lance claude, donne-lui une petite tâche et éloigne-toi du clavier. Quand il a fini, ton téléphone reçoit un push.
À noter : ccn détecte quand tu es devant l'ordinateur. Si tu as tapé quelque chose dans les 30 dernières secondes, les demandes de permission et les questions s'affichent dans le terminal comme d'habitude et le téléphone reçoit au plus une simple note. Éloigne-toi pour voir le téléphone prendre le relais.
07Appairer plusieurs appareils
- Plusieurs ordinateurs, un téléphone. Répète les étapes sur chaque ordinateur. Ton Mac du boulot, ta machine Linux à la maison et ton portable Windows peuvent tous joindre le même téléphone. Lancer plusieurs sessions Claude Code explique comment les distinguer.
- Plusieurs téléphones, un ordinateur. Appaire chaque téléphone avec le même ordinateur.
- Voir ou retirer des téléphones.
ccn devicesliste les téléphones appairés, etccn devices revoke <name>en retire un.
08Scripts et machines distantes
ccn pair --no-wait affiche le QR code et rend la main tout de suite, idéal pour les scripts et le provisioning. Sur un serveur en SSH, la méthode du code à 6 chiffres est généralement la plus simple, puisque tu tapes le code dans la même session SSH que celle où tu utilises Claude Code. Notifications de Claude Code sur un serveur distant en SSH couvre le reste de la configuration.
09Si l'appairage ne fonctionne pas
- Le code a été refusé. Les codes sont valables 24 heures. Génères-en un nouveau dans l'app, ou utilise la méthode du QR code.
- Le QR code ne se scanne pas. Agrandis la fenêtre du terminal, ou ouvre plutôt le lien affiché sur ton téléphone.
ccnest introuvable après l'installation. Ouvre un nouveau terminal pour que tonPATHsoit mis à jour.- Appairé, mais aucun push n'arrive. Lance
ccn doctor, puisccn test, et vérifie que les notifications sont autorisées pour l'app dans les réglages de ton téléphone.
La liste complète se trouve dans Les notifications Claude Code ne fonctionnent pas ? Une checklist.
10Pas encore prêt à appairer ?
Pas de souci. Les notifications desktop fonctionnent dès que ccn est installé. Tant qu'aucun téléphone n'est appairé, ccn te suggère de temps en temps ccn pair. Pour désactiver ces suggestions :
ccn config set pair_nudges off11FAQ
Faut-il un compte pour appairer ?
Non. Claude Code Notifier n'a pas de comptes. L'appairage relie l'ordinateur et le téléphone sans aucune inscription. Les notifications passent par un relais chiffré et sont supprimées sous 48 heures. Consulte la Politique de confidentialité.
Combien de temps un code d'appairage reste-t-il valide ?
Le code à 6 chiffres de l'app comme le lien QR de ccn pair sont valables 24 heures. Passé ce délai, génères-en un nouveau.
Puis-je appairer un ordinateur sans écran ?
Oui. Utilise la méthode à 6 chiffres : ouvre Ordinateurs > Ajouter un ordinateur dans l'app, puis lance ccn pair avec le code sur cette machine, par exemple via SSH.
L'appairage modifie-t-il mes réglages Claude Code ?
L'installation de ccn ajoute sept entrées de hook dans ~/.claude/settings.json, ne touche à rien d'autre et garde une sauvegarde unique juste à côté. L'appairage lui-même se contente de relier le téléphone. ccn uninstall supprime les hooks, les appairages et l'état local.
Comment désappairer un téléphone ?
Lance ccn devices pour voir les téléphones appairés, puis ccn devices revoke <name>. ccn forget efface aussi l'ordinateur du serveur.