Notifications Claude Code sur Mac : sois averti quand Claude termine ou a besoin de toi.

L’alerte intégrée de Claude Code se déclenche quand Claude termine une tâche ou s’interrompt pour demander une autorisation, et que tu sembles t’être éloigné du terminal. L’affichage de cette alerte sous forme de bannière dépend de l’app de terminal.

Claude Code dispose d’un réglage pour cela : preferredNotifChannel. Dans Claude Code, saisis /config et ouvre Local notifications. La valeur par défaut est auto. Les autres choix sont terminal_bell, iterm2, iterm2_with_bell, kitty, ghostty et notifications_disabled.

La sonnerie du terminal est le bref son ou clignotement qu’un terminal émet lorsqu’un programme demande ton attention. Pour l’utiliser dans Terminal.app, Warp ou VS Code, tu peux aussi ajouter cette ligne dans un fichier de réglages de Claude Code, comme ~/.claude/settings.json, à l’intérieur des accolades qui entourent son contenu :

"preferredNotifChannel": "terminal_bell"

• iTerm2 : ouvre Settings > Profiles > Terminal, coche Notification Center Alerts, clique sur Filter Alerts et active Send escape sequence-generated alerts.
• Terminal.app : pour mieux remarquer la sonnerie, ouvre Settings > Profiles > Advanced et, sous Bell, choisis d’ajouter une pastille à l’icône du Dock ou de la faire rebondir quand Terminal est en arrière-plan. Si tu as accepté la configuration du terminal proposée par Claude Code au premier lancement, elle a désactivé la sonnerie audible de Terminal ; coche Audible bell à cet endroit si tu veux l’entendre.
• Quel que soit le terminal : l’app de terminal elle-même doit avoir l’autorisation d’envoyer des notifications dans Réglages Système > Notifications.

D’anciens articles conseillent d’exécuter claude config set. Cette commande n’existe plus : utilise /config ou modifie le fichier de réglages.

Un hook est une commande shell que Claude Code exécute à un moment défini. Tu déclares les hooks dans un fichier de réglages. Ils fonctionnent dans tous les terminaux, car le terminal n’intervient pas dans leur exécution.

La méthode proposée par Anthropic pour recevoir des notifications utilise l’événement Notification. Cet événement ne t’avertit que Claude a terminé que par l’intermédiaire de idle_prompt, environ 60 secondes plus tard, et seulement si tu n’as rien saisi depuis. Pour recevoir une alerte dès que Claude s’arrête, utilise Stop.

Un tour qui se termine par une erreur d’API, comme une limite de fréquence des requêtes, déclenche StopFailure au lieu de Stop. Les hooks de notification ne peuvent rien bloquer : ils exécutent simplement ta commande.

Chaque extrait ci-dessous se place dans ~/.claude/settings.json, qui s’applique à tous tes projets. La validité du JSON et de la syntaxe shell de chaque extrait a été vérifiée. Aucun logiciel supplémentaire n’est nécessaire.

Une bannière sur Mac quand Claude termine.

Dans ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code\" sound name \"Glass\"' -e 'end run' \"Finished in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Une bannière sur Mac quand Claude attend ton accord.

Dans ~/.claude/settings.json

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code needs you\" sound name \"Ping\"' -e 'end run' \"Waiting for your OK in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Les deux bannières indiquent le nom du dossier dans lequel la session s’exécute.

Autorise Éditeur de scripts à afficher les bannières.

Sur Mac, les bannières de osascript proviennent de l’app intégrée Éditeur de scripts. Tant qu’Éditeur de scripts n’est pas autorisé à envoyer des notifications, la commande échoue sans message d’erreur, et macOS ne te demande pas d’autorisation.

1. Dans Terminal, exécute ceci une fois :

osascript -e 'display notification "test"'

2. Ouvre Réglages Système > Notifications, trouve Éditeur de scripts et active Autoriser les notifications.

Un son à la place d’une bannière.

Dans ~/.claude/settings.json

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

Une alerte vocale.

Dans ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "say \"Claude has finished\"", "async": true } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "say \"Claude needs your permission\"", "async": true } ] }
    ]
  }
}

"async": true permet à Claude Code de continuer pendant que le Mac parle.

Pour afficher une bannière pour un événement et jouer un son pour l’autre, utilise deux fois le générateur de hooks de notification : choisis à chaque fois un événement et son type d’alerte, puis utilise sa zone de fusion pour ajouter les deux résultats à ton fichier. Il t’indique dans quel fichier placer chaque extrait, et tout s’exécute dans ton navigateur.

• Accorde ta confiance au dossier. Claude Code retient tous les hooks, même ceux de ~/.claude/settings.json, tant que tu n’as pas accepté la boîte de dialogue de confiance de l’espace de travail pour ce dossier.
• Vérifie ce qui est chargé. Saisis /hooks dans Claude Code. Cette commande liste tes hooks et le fichier dont chacun provient, mais elle ne permet pas d’en ajouter. Claude Code prend normalement tes modifications en compte tout seul ; sinon, redémarre la session.
• Mac d’entreprise. Une organisation peut n’autoriser que les hooks qu’elle gère. Dans ce cas, /hooks affiche « Only hooks from managed settings run here », et les hooks personnels ne s’exécutent pas.
• Deux alertes à la fois. Les hooks de tous les niveaux de réglages se cumulent. Un hook d’alerte dans un fichier de projet et un autre hook d’alerte dans ton fichier utilisateur se déclenchent donc tous les deux. Un hook strictement identique présent dans plusieurs fichiers ne s’exécute qu’une fois. Les hooks s’exécutent aussi en parallèle de la notification intégrée. Si tu reçois les deux alertes, règle Local notifications sur notifications_disabled et conserve le hook.
• Trop d’alertes. Stop se déclenche après chaque tour, pas seulement lorsqu’une tâche entière est terminée.
• Si tu utilises aussi Cowork Island. Garde chacun de tes hooks dans sa propre entrée, comme dans les extraits ci-dessus, et en dehors de ~/.perch/. L’app considère comme siennes uniquement les commandes contenant /.perch/, et elle remplace les entrées entières. Une commande placée dans une de ses entrées serait donc supprimée avec elle.

• Documentation de Claude Code : configuration du terminal
• Documentation de Claude Code : référence des hooks
• Documentation de Claude Code : guide des hooks
• Documentation de Claude Code : référence des réglages
• Documentation de Claude Code : réglages
• Historique des modifications de Claude Code
• Guide d’utilisation de Terminal : réglages avancés
• Guide de création de scripts d’automatisation sur Mac : affichage des notifications
• FAQ de Cowork Island et guide d’installation

Sources vérifiées le 18 octobre 2026. Ce guide est rédigé par le créateur de Cowork Island. Pour signaler une correction, écris à support@coworkisland.com ou ouvre un ticket sur GitHub.