Recevoir une notification quand un agent de code termine ou attend ton accord

Pour être prévenu quand un agent de code termine ou attend ton accord, active ses alertes intégrées ou ajoute un hook qui se déclenche sur ces événements. Si tu t’éloignes de l’ordinateur, envoie l’alerte sur ton téléphone. Teste-la avant de partir : un agent qui attend une autorisation ne fait rien tant que tu n’as pas répondu.

Les exemples de ce guide utilisent Claude Code. Garder l’ordinateur éveillé fait l’objet d’un guide à part. Mono by Reunified envoie ces alertes pour les agents que tu lances avec lui, mais la méthode marche avec n’importe quelle configuration.

1. Choisis les événements de l’agent qui méritent une alerte

Trois événements comptent :

Si tu ne configures qu’une seule alerte, choisis celle des demandes d’autorisation.

2. Active les alertes dans Claude Code

Claude Code envoie une notification quand il termine ou s’arrête pour demander une autorisation alors que tu sembles absent. Par défaut, il n’affiche des notifications de bureau que dans Ghostty, Kitty et iTerm2 (configuration du terminal). Ailleurs, règle preferredNotifChannel sur "terminal_bell" dans ~/.claude/settings.json pour déclencher le signal sonore du terminal. Dans tmux, ajoute set -g allow-passthrough on à ~/.tmux.conf et recharge ce fichier.

Pour jouer ton propre son ou lancer ta propre commande, ajoute des hooks dans le même fichier. L’événement Notification accepte des filtres (matchers) comme permission_prompt (une demande d’autorisation attend depuis environ six secondes) et idle_prompt (Claude a terminé il y a environ une minute et tu n’as rien tapé depuis). Sur un Mac, cette configuration joue un son différent pour chacun :

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff" }]
      }
    ]
  }
}

Le guide des hooks donne aussi des commandes de notification de bureau pour macOS, Linux et Windows. Les autres agents fonctionnent autrement : consulte leur documentation.

3. Envoie l’alerte sur ton téléphone

Trois moyens permettent d’atteindre un téléphone :

• L’application de l’agent lui-même. Quand le Remote Control de Claude Code est actif, lance /config et active les notifications push quand Claude le décide (« Push when Claude decides »), quand une action est requise (« Push when actions required »), ou les deux. Il te faut un forfait éligible et l’application Claude connectée au même compte, avec les notifications autorisées.
• Un hook qui envoie une notification push, par exemple avec curl vers un service de push dont l’application est installée sur ton téléphone.
• Une application compagnon qui relaie les événements de session depuis l’ordinateur.

Dans tous les cas, l’ordinateur doit être allumé, éveillé et en ligne, et l’agent doit toujours tourner. Garde le token d’un hook dans ~/.claude/settings.json, pas dans le .claude/settings.json du projet, qui peut se retrouver dans un commit du dépôt.

4. Garde le texte des alertes discret sur l’écran verrouillé

N’importe qui près d’un téléphone verrouillé peut lire ses aperçus. Ne mets ni secrets, ni contenu de fichiers, ni lignes de journal dans les messages de tes hooks. Envoie seulement l’événement et le nom du projet : pour un projet fictif appelé « invoice-export », « invoice-export : autorisation requise » suffit. Sur iPhone, ouvre Réglages > Notifications et règle Afficher les aperçus sur Si déverrouillé. Android peut aussi masquer le contenu sensible sur l’écran de verrouillage, mais le nom de l’option varie selon le téléphone.

Dans Mono, une alerte de fin affiche le dernier message de l’agent, raccourci s’il est long. Une alerte d’autorisation montre la demande telle que l’agent la décrit, souvent la commande.

5. Fais un essai avec une tâche sans risque avant de partir

Sur ton ordinateur à la maison, démarre une session nommée « contrôle invoice-export » et demande à l’agent de lancer les tests et de signaler les échecs sans modifier de fichiers. L’agent doit obtenir ton accord avant d’exécuter une commande : il sollicite donc l’autorisation de lancer npm test. Sur l’ordinateur, ouvre un autre écran ou une autre application, puis verrouille ton téléphone et va dans une autre pièce.

Dans Mono, tu devrais voir :

1. Une alerte « Demande d’autorisation de l’agent » qui indique la commande de test.
2. Appuyer sur l’alerte ouvre cette session, où tu choisis Autoriser. Chaque nouvelle demande envoie sa propre alerte.
3. « L’agent a terminé dans “contrôle invoice-export” », avec le dernier message de l’agent, par exemple « Un test de dates.test.ts échoue à cause des fuseaux horaires. Je n’ai modifié aucun fichier. »

Lance ensuite une deuxième tâche avec la session ouverte sur ton téléphone : aucune alerte n’arrive pendant que tu regardes. Avant de sortir, vérifie qu’aucun appareil n’affiche la session à l’écran.

6. Répare les alertes qui n’arrivent pas

Dans Mono, ouvre Réglages > Notifications et vérifie « Toutes les notifications », « Code » (sessions terminées et arrêtées), « Demandes d’autorisation » et « Envoyer à tes autres appareils ». Ils sont tous activés par défaut. Les alertes partent de l’ordinateur qui exécute l’agent : laisse donc Mono ouvert sur cet ordinateur.

Avant d’approuver depuis ton téléphone, lis ce qu’il faut vérifier dans une demande d’autorisation. Le guide pour travailler avec des agents de code depuis ton téléphone couvre le reste de la configuration. Mono n’est pas encore disponible, mais tu peux rejoindre la liste d’attente.