Comment être prévenu quand Claude Code ou Codex a fini

Comment un agent te dit qu’il a fini

Les deux outils peuvent lancer une commande à toi au bon moment. Une notification, ce n’est que ça : Claude Code appelle ça un hook, Codex l’appelle notify. Quoi que fasse la commande (jouer un son, afficher une bannière, faire briller l’écran), ça se passe quand l’agent s’arrête ou te demande quelque chose.

Claude Code : la notification intégrée

Quand Claude Code a fini, ou attend une demande d’autorisation, il peut envoyer tout seul une notification sur le bureau. La documentation d’Anthropic indique que ça marche directement dans Ghostty et Kitty. Dans iTerm2, active-le une fois :

1. iTerm2 → Settings → Profiles → Terminal.
2. Coche Notification Center Alerts.
3. Clique sur Filter Alerts et active Send escape sequence-generated alerts.

Tu lances Claude Code dans tmux ? Ajoute set -g allow-passthrough on à ~/.tmux.conf, sinon la notification n’arrive jamais jusqu’à ton terminal. Tu peux aussi choisir comment Claude Code te prévient (par exemple une sonnerie du terminal) dans ses réglages /config.

Source : documentation Claude Code : configuration du terminal

Claude Code : un hook qui joue un son

Dans le Terminal d’Apple, VS Code ou n’importe quel autre terminal, un hook fait l’affaire. Les hooks se trouvent dans ~/.claude/settings.json (pour tous les projets) ou .claude/settings.json (un seul projet). Deux événements comptent :

• Stop : Claude a fini sa réponse.
• Notification : Claude a besoin de toi (une demande d’autorisation, ou il attend ta réponse depuis un moment).

Ceci joue un son macOS pour les deux. Fusionne-le dans ton fichier de réglages (garde ce qui s’y trouve déjà) :

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

Tu préfères une bannière ? Utilise plutôt cette commande (la même que l’exemple d’Anthropic) :

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

Tape /hooks dans Claude Code pour voir ce qui est configuré. Les nouveaux hooks s’appliquent aux sessions lancées après l’enregistrement. Les sons de /System/Library/Sounds/ sont libres d’utilisation : Glass, Ping, Pop, Purr, Submarine et d’autres.

Sources : référence des hooks · guide des hooks

Codex : le réglage notify

Codex CLI lance un programme à toi après chaque tour, défini avec notify dans ~/.codex/config.toml. Codex ajoute une description JSON du tour en dernier argument (son type est agent-turn-complete), qu’une simple commande de son peut ignorer :

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify est une clé de premier niveau : place-la au-dessus de toute [section] du fichier. Codex a aussi des notifications intégrées dans son interface de terminal (notifications sous [tui]), qui passent par la notification ou la sonnerie du terminal ; voir une bannière ou non dépend de ton terminal.

Le notify de Codex se déclenche à la fin d’un tour. Il n’a pas d’événement séparé « attend ton accord » comme le hook Notification de Claude Code.

Source : documentation Codex : configuration avancée

Agent Alerts de Clacky : pareil, sans la config

Si tu préfères ne pas toucher au JSON ni au TOML, Clacky (une app pour la barre des menus du Mac) propose Agent Alerts (alertes d’agent). Il utilise les mêmes hooks que ci-dessus, donc rien ne surveille ton écran ni ne lit ton terminal :

1. Ouvre le tableau de bord de Clacky → Agent Alerts.
2. À côté de Claude Code ou de Codex, clique sur Set Up…. Clacky te montre exactement les lignes qu’il va ajouter ; clique sur Add Hooks. Il garde une copie de sauvegarde de ton fichier juste à côté (settings.json.clacky-backup).
3. Clique sur Send a Test Alert pour entendre les deux sons.

Ce que tu obtiens :

• Un son différent pour terminé (un accord qui monte) et besoin de toi (deux petits coups et une question), avec cinq voix au choix par agent.
• En option, une douce lueur sur le bord de l’écran pendant environ une seconde. Elle laisse passer les clics et n’apparaît jamais dans les enregistrements.
• Quiet when it’s in front (silencieux quand le terminal de l’agent est l’app active) et Quiet during calls (silencieux quand le micro est utilisé), tous deux activés par défaut.
• Un point par session dans la barre des menus : au travail, en attente ou terminé. Clique dessus pour ramener son terminal au premier plan.
• Keep Awake → Until My Agent Is Done, pour qu’une longue tâche ne s’arrête pas parce que ton Mac s’est mis en veille.

Claude Code fonctionne dans n’importe quel terminal et dans l’onglet Code de l’app Claude. Codex fonctionne avec la CLI et a droit au son terminé (Codex n’envoie pas d’événement « besoin de toi »). Si ta config Codex a déjà une ligne notify, Clacky n’y touche pas et te le signale, au lieu de la remplacer. Remove… ne retire que les lignes de Clacky.

Si rien ne se passe

• Relance la session. Les hooks sont lus au démarrage d’une session, donc une session déjà en cours ne te préviendra pas.
• Vérifie que le fichier est valide. Une virgule manquante dans settings.json bloque tous les hooks. Colle-le dans n’importe quel validateur JSON.
• Teste la commande seule. Lance afplay /System/Library/Sounds/Glass.aiff dans le Terminal. Pas de son ? Vérifie ta sortie audio et le volume.
• Les bannières ne s’affichent pas ? Vérifie Réglages Système → Notifications pour ton terminal (ou Éditeur de script, pour osascript), ainsi que les modes de concentration.
• Deux sons à la fois ? Tu as deux configurations (par exemple ton propre hook et celui de Clacky). Garde-en une.