Notifications Claude Code : reçois un texto quand ton agent s’arrête et réponds depuis ton téléphone

Ton agent de code a terminé il y a quarante minutes. Tu préparais un café, puis tu as répondu à un message Slack, puis tu as regardé ton téléphone pour tout autre chose. Pendant tout ce temps, le terminal est resté là, avec une question polie à l’écran, à attendre un oui.

C’est ça, le vrai goulot d’étranglement du code agentique aujourd’hui. Pas la qualité des modèles. Pas la taille des fenêtres de contexte. L’attention. L’agent est assez rapide pour te distancer, puis il s’arrête net dès qu’il a besoin d’un humain, et rien au monde ne te prévient.

Alors on part à la recherche de notifications pour Claude Code. On branche une notification sur le bureau, on se sent malin pendant un après-midi, et on découvre que cette notification règle environ 20 % du problème. Parce qu’une notification te dit que l’agent s’est arrêté. Elle ne te permet rien d’autre, à moins de retourner devant la machine.

Le Stop hook, c’est la partie à comprendre

Tous les agents de code sérieux exposent désormais la même primitive : un hook de cycle de vie qui se déclenche quand l’agent termine son tour.

Claude Code propose Stop (l’agent principal a fini de répondre) et SubagentStop (un sous-agent a terminé). Les hooks ont un délai d’expiration par défaut de 600 secondes, et un hook Stop peut empêcher Claude de s’arrêter et le pousser à continuer.

Codex a le même événement Stop, configuré dans ~/.codex/hooks.json ou ~/.codex/config.toml. Son contenu Stop inclut stop_hook_active et, bien utile, last_assistant_message : ce que l’agent vient réellement de dire. Renvoie {"decision": "block", "reason": "..."} et Codex construit un prompt de continuation à partir de ta raison au lieu de terminer le tour. Le délai par défaut est là aussi de 600 secondes.

Cursor l’appelle stop, dans ~/.cursor/hooks.json ou dans un .cursor/hooks.json propre au projet. Il reçoit un status valant completed, aborted ou error, ainsi qu’un loop_count. Renvoie un followup_message non vide et Cursor l’envoie comme prochain message utilisateur, avec un plafond par défaut de cinq relances automatiques via loop_limit.

Lis ces trois specs côte à côte et le point intéressant saute aux yeux. Le hook n’est pas qu’un simple notificateur. C’est un endroit où se placer entre le moment où l’agent s’arrête et celui où il s’arrête vraiment. Tu disposes de jusqu’à dix minutes d’attente légitime, et d’un moyen documenté de donner à l’agent sa prochaine instruction.

Presque personne ne s’en sert. La plupart des configurations de notifications Claude Code lancent une notification osascript et se terminent avec le code zéro. Le hook fait la moitié facile et jette la moitié qui a de la valeur.

Ce que tu veux vraiment

Sois honnête sur le workflow que tu cherches à obtenir :

1. Tu lances une longue tâche et tu t’en vas. Sortir le chien, déposer les enfants à l’école, assister à une réunion où tu ne peux pas taper.
2. L’agent arrive au moment où il a besoin d’une décision.
3. Ton téléphone vibre avec ce qu’il a dit : pas « Claude Code a terminé », mais le vrai dernier message.
4. Tu réponds en une ligne, où que tu sois.
5. La même session reprend ta réponse et continue. Même contexte. Même branche. Aucun redémarrage.

L’étape 5, c’est celle que tout le monde saute, et c’est la seule qui change ta journée. Sans elle, on te prévient simplement d’un travail que tu ne peux pas encore faire, ce qui est strictement pire que de ne rien savoir. Une notification sur laquelle tu ne peux pas agir, c’est un changement de contexte sans aucun retour.

Comment on l’a branché : Agent Relay

On l’a d’abord construit pour nous, parce que je perdais sans arrêt des soirées à cause d’agents inactifs depuis le dîner. Ça s’appelle Agent Relay, et ça se compose de deux moitiés.

Côté Notis : deux bases de données (agent_relay_pings pour ce qui a été envoyé, agent_relay_replies pour ce que tu renvoies) et une automatisation par webhook qui transforme un ping en message WhatsApp, Telegram ou e-mail, sur le canal que ton compte utilise déjà.

Sur ta machine : un seul Stop hook installé d’un coup dans Claude Code, Codex et Cursor, plus un minuscule serveur MCP local avec exactement trois opérations : get_status, start_away, stop_away. Pas un shell. Pas une télécommande. Trois verbes.

Quand l’agent s’arrête, le hook envoie le dernier message de l’assistant à Notis, tu reçois un texto, puis le hook patiente : il vérifie toutes les 10 secondes s’il existe une ligne de réponse correspondant exactement à ce workspace et à cette session. Tu réponds au texto et la réponse atterrit dans la session en cours. Les valeurs par défaut sont volontairement banales : un seuil d’inactivité de 300 secondes, jusqu’à 50 allers-retours, une limite d’attente de 10.

Le choix de conception que je défendrais le plus fermement : le statut « absent » n’est pas deviné. Tu appuies sur Start dans l’App Agent Relay quand tu pars et sur Stop quand tu reviens. Le hook installé est inactif par défaut.

Toutes les versions heuristiques qu’on a essayées étaient pires. La détection d’inactivité t’envoie un texto alors que tu fixes ton écran. La présence basée sur l’agenda croit qu’une réunion annulée veut dire que tu es parti. Un assistant qui devine si tu es à ton bureau se trompera précisément aux moments qui comptent, et un ping à tort coûte plus cher qu’un ping manqué, parce qu’il t’apprend à ignorer le canal. Deux boutons valent mieux que de l’astuce.

Ce que ça remplace

La colonne cloud est une vraie option, et parfois la bonne : on a écrit sur comment faire tourner Claude Code dans le cloud et le piloter depuis ton téléphone. Mais passer à un environnement hébergé pour régler un problème de notification, c’est un gros compromis. Tu sacrifies ton état local pour obtenir un texto. Agent Relay laisse l’agent exactement là où il est.

Les limites, en toute honnêteté

Trois choses que je voudrais savoir avant d’installer ça :

Cursor notifie de façon fiable, mais les longues attentes peuvent ne pas fonctionner. L’unité du délai d’expiration des hooks Cursor n’est pas documentée, donc on n’en définit pas. Claude Code et Codex acceptent un délai explicite et patientent pendant toute la durée. Sur Cursor, considère le ping comme fiable et l’aller-retour comme un bonus au mieux.

Codex demande une étape manuelle. Il n’exécutera pas un nouveau hook tant que tu n’as pas ouvert codex une fois dans un terminal et accepté la demande de confiance. Si tu sautes cette étape, il reste muet pour toujours, sans la moindre erreur.

Impossible de l’installer depuis une sandbox. Le hook doit vivre dans ~/.claude/settings.json sur la machine où tes agents tournent réellement. Une installation depuis une sandbox cloud annonce un succès et ne se déclenche jamais, le pire mode de défaillance possible. Si tu mets ça en place, lance-le depuis ton propre terminal.

Et une note de sécurité pas très excitante : l’installeur est propriétaire de ces fichiers de paramètres. Il sauvegarde tout ce qu’il touche et remplace sa propre entrée précédente au lieu d’en ajouter une deuxième. Trois agents, ce sont trois formats de configuration différents, et un fichier de paramètres mal formé empêche carrément l’agent de démarrer. Ne les modifie pas à la main.

Pour qui ça vaut le coup

Mets-le en place si tu lances de longues sessions d’agent et que tu quittes la pièce. Refactorisations, passes de correction de tests, migrations, tout ce où l’agent travaille vingt minutes puis pose une question. C’est tout le cas d’usage.

Passe ton chemin si tu surveilles chaque exécution. Si tu lis la sortie et que tu corriges la trajectoire en permanence (ce qui est réellement le bon mode pour le travail qui repose beaucoup sur les sous-agents), un hook qui t’envoie des textos, c’est du bruit.

Passe plutôt au cloud si tu veux que l’agent tourne pendant que ton portable est fermé. Un Stop hook en attente a besoin d’un processus actif. C’est la limite honnête.

Le fond de l’affaire

La vérité qui dérange sur les agents de code en 2026, c’est que le modèle est rarement ce qui te ralentit. C’est ta disponibilité. Chaque minute qu’un agent passe bloqué à attendre un humain, c’est une minute de capacité que tu as payée et jetée.

Pour régler ça, pas besoin d’un nouveau modèle ni d’un nouvel IDE. Il suffit de remarquer que le Stop hook est une porte, pas une sonnette, puis de laisser ton agent te joindre là où tu es déjà, au lieu d’attendre que tu reviennes vérifier.

Configure-le une fois. Appuie sur Start quand tu pars. Lis tes messages.