Il existe cinq façons de recevoir les notifications de Claude Code : la notification intégrée du terminal, un hook que tu écris pour afficher une alerte sur le bureau, un hook qui envoie un push via un service comme ntfy, Telegram, Slack ou Discord, le Remote Control d'Anthropic avec l'app mobile Claude, et un outil de notification dédié. Les trois premières sont gratuites et te signalent qu'il s'est passé quelque chose. Remote Control et les outils dédiés te permettent aussi de répondre depuis ton téléphone. Le meilleur choix dépend de ton besoin : juste être prévenu, ou aussi pouvoir agir.
01Les options en un coup d'œil
preferredNotifChannel)Le terminal de ton ordinateurNonAucune, ou un seul paramètreosascript, notify-send, PowerShell)Ton ordinateurNonQuelques lignes dans settings.json02Intégré : le terminal te prévient
Claude Code envoie déjà une notification quand il a terminé ou qu'il attend une réponse à une demande de permission et que tu sembles absent. Par défaut, il envoie une notification de bureau dans iTerm2, Ghostty et Kitty, fait sonner la cloche dans Apple Terminal uniquement dans un cas précis, et ne fait rien dans les autres terminaux. Le paramètre preferredNotifChannel permet de changer ça, par exemple avec "terminal_bell" pour que tous les terminaux reçoivent le caractère de cloche.
Points forts : rien à installer, fonctionne via SSH dans les terminaux qui transmettent la notification. Limites : ça ne touche que l'ordinateur devant toi, beaucoup de terminaux (y compris ceux des IDE) ne reçoivent rien par défaut, et tu ne peux pas répondre. Tous les détails sont dans le guide de la cloche du terminal.
03Tes propres hooks : alertes sur le bureau
Les hooks permettent à Claude Code de lancer une commande à des moments précis. Un hook Notification se déclenche quand Claude a besoin de ton attention (une demande de permission en attente depuis environ six secondes, ou Claude inactif environ 60 secondes après avoir terminé). Un hook Stop se déclenche dès qu'un tour se termine. Branche l'un ou l'autre sur la commande de notification de ton système et tu as des alertes sur Mac, Windows et Linux, dans n'importe quel terminal. Le guide pour être notifié quand Claude a fini explique tout pas à pas.
Points forts : gratuit, privé, entièrement sous ton contrôle, sans réseau. Limites : toujours limité à cet ordinateur, et sur un serveur headless ou via SSH, une commande de bureau n'a aucun bureau où s'afficher (voir les notifications via SSH).
04Tes propres hooks : push sur ton téléphone
Le même hook peut appeler un service de push à la place. Les choix courants :
- ntfy : publie sur un topic avec une seule ligne
curl, et reçois le message dans l'app ntfy sur iPhone ou Android. Gratuit sur ntfy.sh, et tu peux héberger ton propre serveur. Voir le guide ntfy. - Pushover : une API avec un quota mensuel de messages gratuits et ses propres apps. Les messages sont limités à 1 024 caractères.
- Telegram, Slack ou Discord : un bot ou un webhook entrant poste un message dans un chat que tu surveilles déjà. Voir le guide Telegram, Slack et Discord.
Points forts : ça atteint ton téléphone où que tu sois, pour pas cher voire gratuitement, et tu vois exactement ce qui est envoyé. Limites : à sens unique. Le téléphone peut te dire que Claude attend, mais la session attend quand même que tu reviennes au clavier. Tu dois aussi gérer des secrets (noms de topics, tokens, URLs de webhook) et décider quand ne pas envoyer, car un hook se déclenche que tu sois au bureau ou non.
05Remote Control d'Anthropic et l'app Claude
Remote Control connecte l'app Claude sur iPhone et Android, ou claude.ai/code dans un navigateur, à une session Claude Code qui tourne sur ton ordinateur. Tu vois toute la conversation et tu peux y écrire, et les demandes de permission et les questions AskUserQuestion sont transmises au téléphone. Avec Push when actions required et Push when Claude decides activés dans /config, l'app envoie des notifications push. Elle s'en abstient quand tu écris dans le terminal connecté ou qu'il a le focus.
Points forts : fait par Anthropic, toute la session sur ton téléphone, aucun tiers impliqué. Limites (d'après la documentation d'Anthropic) : il faut un plan Pro, Max, Ultra, Team ou Enterprise connecté via claude.ai, les clés API ne sont pas supportées, et ce n'est pas disponible avec Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry ou un ANTHROPIC_BASE_URL personnalisé. Sur Team et Enterprise, un Owner doit l'activer. La session doit être lancée avec Remote Control (ou configurée pour se connecter au démarrage), et c'est Claude qui décide quand envoyer les push « decides » ; il n'y a aucune configuration par événement au-delà des deux options.
06Outils de notification dédiés
Plusieurs outils s'appuient sur les hooks ci-dessus et ajoutent un moyen de répondre.
- claude-remote-approver est un package npm open source (MIT) qui utilise le hook
PermissionRequestet ntfy. Chaque demande de permission devient une notification avec des boutons Approve et Deny, et les options d'AskUserQuestiondeviennent aussi des boutons. Sans réponse avant son timeout (120 secondes par défaut), Claude Code revient au prompt du terminal. - Pushary est un service hébergé qui s'installe avec
npx pushary@latest setup. Il installe des hooks Claude Code, envoie un push quand Claude a fini, et te permet d'approuver ou de répondre depuis le téléphone. - Claude Code Notifier (le nôtre), c'est
ccn, un outil en ligne de commande gratuit pour Mac, Windows et Linux, plus des apps pour iPhone et Android. Il est indépendant et n'est pas fait par Anthropic.
D'autres projets open source envoient des alertes vers ntfy, Discord ou le bureau avec un script tout prêt. Ils valent le coup d'œil si tu veux du DIY sans écrire le script.
07Où se situe Claude Code Notifier
Si des alertes à sens unique te suffisent, un hook de dix lignes avec ntfy ou ton notificateur de bureau fait parfaitement l'affaire, et ça ne coûte rien.
Claude Code Notifier sert pour ce qui se passe après l'alerte. Installé seul, ccn affiche une notification de bureau sur Mac, Windows ou Linux quand Claude a fini, a besoin d'une permission ou pose une question. Avec un téléphone appairé, tu peux :
- autoriser une fois, autoriser pour la session, ou refuser une demande de permission depuis le téléphone
- choisir une réponse quand Claude te demande de choisir
- envoyer l'instruction suivante dès que Claude a fini
Il gère aussi ta présence. Si tu as tapé quelque chose dans les 30 dernières secondes, rien n'attend : le terminal demande comme d'habitude et le téléphone reçoit au plus une note. Si tu es absent, le terminal attend la réponse du téléphone jusqu'à une limite que tu choisis, et arrête d'attendre dès que tu touches le clavier. Comme c'est un hook, ça marche dans n'importe quel terminal, y compris ceux des IDE, sans avoir besoin d'activer Remote Control dans la session. Les apps mobiles nécessitent un abonnement ou un achat à vie ; voir les tarifs. Installe-le depuis la page ccn.
08Comment choisir
- Tu es devant l'ordinateur et tu veux juste un rappel : la notification intégrée ou un hook de bureau.
- Tu veux que ton téléphone vibre, et tu reviendras répondre : ntfy ou un webhook de chat.
- Tu veux toute la conversation sur ton téléphone et tu te connectes avec un plan claude.ai : Remote Control.
- Tu veux approuver, répondre et continuer depuis le téléphone, avec des alertes qui restent silencieuses quand tu es au clavier : un outil dédié comme Claude Code Notifier.
09FAQ
Claude Code a-t-il des notifications intégrées ?
Oui. Il envoie une notification de bureau dans iTerm2, Ghostty et Kitty, et tu peux régler preferredNotifChannel sur "terminal_bell" pour avoir la cloche dans n'importe quel terminal. Ça ne touche que l'ordinateur qui fait tourner le terminal. Pour les push sur téléphone, Anthropic propose Remote Control avec l'app Claude.
Quelle est la solution gratuite pour recevoir les notifications Claude Code sur mon téléphone ?
Un hook Notification ou Stop qui lance curl vers un topic ntfy gratuit, puis l'app ntfy sur ton téléphone. Le guide ntfy propose une config à copier-coller. Ça te dit que Claude attend, mais ne peut pas répondre à ta place.
Puis-je approuver les demandes de permission de Claude Code depuis mon téléphone ?
Oui, avec Remote Control ou avec un outil basé sur le hook PermissionRequest, comme claude-remote-approver ou Claude Code Notifier. Voir approuver les permissions depuis ton téléphone.
Puis-je en utiliser plusieurs en même temps ?
Oui, les hooks de différentes sources s'exécutent tous. Évite d'avoir deux outils qui répondent tous les deux aux demandes de permission, et attends-toi à des alertes en double si deux outils notifient sur le même événement.