Être averti quand Claude Code attend une validation ou se termine

Claude Code envoie une notification lorsqu'il termine une tâche ou s'interrompt sur une demande d'autorisation pendant que vous semblez absent. Vous pouvez l'afficher sous forme de notification de bureau, de signal sonore dans le terminal ou via toute action qu'un hook Notification peut exécuter. Le choix de la méthode dépend de votre terminal et du nombre de sessions que vous utilisez.

1. Les notifications de bureau

Dans Ghostty, Kitty et iTerm2, les notifications de Claude Code s'affichent sous forme de notifications de bureau sans aucune configuration nécessaire.

Dans iTerm2, si elles n'apparaissent pas, ouvrez Settings > Profiles > Terminal, activez Notification Center Alerts, puis dans Filter Alerts, autorisez les alertes générées par séquences d'échappement. Vérifiez également que l'application de terminal dispose bien de l'autorisation d'envoyer des notifications dans les paramètres de votre système.

Ces notifications vous parviennent également depuis une session distante via SSH.

Dans l'application de bureau Claude, l'onglet Code envoie sa propre notification de bureau lorsqu'une session termine une tâche pendant que vous ne la regardez pas. Une session lancée depuis Dispatch sur votre téléphone y envoie une notification push lorsqu'elle se termine ou nécessite votre approbation.

Si votre terminal implémente le protocole de statut de programme OSC 7501, Claude Code 2.1.295 ou ultérieur indique également si chaque session interactive travaille, attend votre réponse ou a terminé, sans rien avoir à activer. La documentation de votre terminal précise s'il prend en charge ce protocole et à quel endroit il affiche l'état.

2. Le signal sonore du terminal

D'autres terminaux, comme Apple Terminal, Warp ou le terminal intégré de VS Code, ne reçoivent pas la notification de bureau. Vous pouvez demander un signal sonore à la place. Ajoutez ceci à ~/.claude/settings.json :

{
  "preferredNotifChannel": "terminal_bell"
}

Si vous utilisez tmux, ajoutez set -g allow-passthrough on dans ~/.tmux.conf pour que la notification soit transmise au terminal externe.

Si vos sessions s'exécutent dans Windows Subsystem for Linux, consultez Claude Code WSL notifications: get alerts on Windows pour connaître la configuration du signal sonore dans Windows Terminal et les hooks PowerShell.

3. Un hook Notification

Un hook exécute votre propre commande lorsque Claude a besoin de vous : un son, une bannière sur votre bureau, un message sur votre téléphone. Il s'exécute en parallèle de la notification intégrée. Sur Mac, ceci joue un son :

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

L'événement Notification comporte des types sur lesquels vous pouvez filtrer, notamment permission_prompt et idle_prompt, ce qui vous permet de traiter différemment « demande d'approbation » et « en attente de votre prochain message ». Un hook Stop distinct se déclenche lorsque Claude a fini de répondre. Aucun de ces types ne couvre les questions à choix multiples de Claude. Consultez Know when Claude Code asks you a question or wants a plan approved pour découvrir le hook approprié.

Si vous exécutez des sessions en arrière-plan, la vue agent (claude agents, en préversion de recherche) vous alerte également pendant qu'elle est ouverte lorsque l'une d'elles a besoin d'une réponse, se termine ou échoue. Elle déclenche le hook Notification avec le type agent_needs_input ou agent_completed, ce qui permet à un script de hook de réagir à ces événements également. Consultez Vue agent Claude Code : lancer et suivre des sessions en arrière-plan pour apprendre à démarrer des sessions en arrière-plan et y répondre.

Pour comprendre comment Notification s'articule avec PreToolUse, PostToolUse, Stop et les autres événements de hooks, lisez Claude Code hooks: events, matchers, settings and handlers.

Laquelle choisir

Quand les notifications ne suffisent plus

Une notification indique qu'une session a besoin de vous. Avec quatre sessions ouvertes, il faut encore déterminer laquelle, et une fois la bannière ignorée, elle disparaît.

Pour une comparaison plus large de tmux, des hooks, de la vue agents, des panneaux d'IDE et des pavés de statut, consultez How to monitor multiple Claude Code sessions.

Orbtile affiche chaque session sous forme de tuile dédiée sur un iPhone, un téléphone Android ou sur le Logitech MX Creative Keypad. Une session en attente s'illumine dans la couleur d'alerte de son agent et passe au premier plan, la tuile indique ce qu'elle demande, et vous pouvez répondre aux requêtes compatibles directement depuis le pavé : appuyez sur Refuser, ou maintenez Autoriser pendant 0,6 seconde. Il utilise les hooks de Claude Code via son propre plugin, de sorte que vos notifications continuent de fonctionner comme auparavant.

Si vous utilisez également Kimi Code, consultez Kimi Code notifications: hooks, NotifyUser and TUI settings pour découvrir le fonctionnement de ses hooks et le suivi de progression.