Les notifications intégrées de Claude Code : la cloche du terminal et preferredNotifChannel

01La solution rapide

Si tu n'entends rien quand Claude termine, ajoute ceci à ~/.claude/settings.json :

{
  "preferredNotifChannel": "terminal_bell"
}

Ensuite, vérifie que ton terminal réagit à la cloche : jouer un son, faire rebondir l'icône du Dock, faire clignoter l'onglet ou afficher une notification. Ce réglage se trouve dans le terminal, pas dans Claude Code. Sur Mac, Windows et Linux, la plupart des terminaux ont une section « cloche » ou « alerte » dans leurs préférences.

02Toutes les valeurs de preferredNotifChannel

Le réglage peut aller dans n'importe quel fichier de settings : utilisateur (~/.claude/settings.json), projet (.claude/settings.json) ou local (.claude/settings.local.json). Les anciennes versions le stockaient dans ~/.claude.json, et Claude Code lit toujours une valeur restée là.

03Quand la notification intégrée se déclenche

D'après la documentation d'Anthropic, l'alerte intégrée a le même timing que le hook Notification. Dans une session terminal :

• Demande de permission : après environ six secondes d'attente sans frappe au clavier. Chaque touche pressée relance le délai.
• Terminé : environ 60 secondes après l'arrêt de Claude, et seulement si tu n'as rien tapé depuis et qu'aucun agent en arrière-plan ne tourne encore.

L'alerte intégrée « terminé » n'est donc volontairement pas instantanée. Elle est pensée pour te joindre quand tu t'es éloigné, pas pour te notifier pendant que tu regardes. Si tu veux une alerte dès la fin d'un tour, utilise plutôt un hook Stop (voir le guide du Stop hook).

04Terminal par terminal

iTerm2 (macOS)

iTerm2 reçoit une notification de bureau par défaut, mais iTerm2 ne l'affiche qu'une fois que tu l'as autorisée :

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

Vérifie aussi qu'iTerm2 a le droit d'afficher des notifications dans Réglages Système > Notifications.

Apple Terminal (macOS)

Apple Terminal ne reçoit pas de notification de bureau. Avec "auto", Claude Code envoie une cloche silencieuse uniquement s'il détecte que Audible bell est désactivé dans le profil de la fenêtre au premier plan. La cloche apparaît alors comme un flash de la fenêtre, ou un rebond dans le Dock quand Terminal est en arrière-plan, si l'option Visual bell ou le rebond Dock du profil est activé.

Attention à un détail. Si tu as accepté la proposition de configuration du terminal au premier lancement de Claude Code, elle a exécuté /terminal-setup, qui désactive la cloche sonore dans ton profil Apple Terminal. Pour entendre un son, mets "terminal_bell" et réactive Audible bell dans Settings > Profiles > Advanced.

Ghostty et Kitty (macOS et Linux)

Les deux reçoivent une notification de bureau sans aucune configuration, et la transmettent au centre de notifications de ton système.

Tout le reste

Windows Terminal, GNOME Terminal, Konsole, Alacritty, WezTerm, Warp et les terminaux d'IDE n'ont rien par défaut. Choisis "terminal_bell" et active la gestion de la cloche dans le terminal lui-même, ou utilise un hook. Les terminaux d'IDE ont leurs propres particularités, détaillées dans le guide VS Code, Cursor et JetBrains.

05En SSH et dans tmux

La notification de bureau est une séquence d'échappement interprétée par le terminal de ton propre ordinateur : elle te parvient donc même quand Claude Code tourne sur un serveur distant via SSH. Ghostty et Kitty la transmettent sans configuration supplémentaire. iTerm2 a besoin des réglages d'alerte ci-dessus.

Dans tmux, la séquence est avalée sauf si tu autorises le passthrough. Ajoute ceci à ~/.tmux.conf puis lance tmux source-file ~/.tmux.conf :

set -g allow-passthrough on

Les sessions détachées, c'est un autre problème : si aucun terminal n'est attaché, rien ne peut afficher l'alerte. Consulte le guide tmux et les notifications via SSH.

06Combiner l'alerte intégrée et les hooks

Les hooks Notification s'exécutent en plus de l'alerte intégrée, ils ne la remplacent pas. La documentation d'Anthropic précise bien que les hooks se déclenchent même avec "notifications_disabled" : ce réglage change seulement la façon dont Claude Code t'alerte, pas l'exécution de ton hook. Ça permet une séparation nette :

• Garde "auto" ou "terminal_bell" pour l'alerte quand tu es au bureau.
• Ajoute un hook pour tout le reste : un son système, une notification de bureau dans un terminal qui n'en a pas, ou un push sur ton téléphone avec ntfy.
• Si un hook affiche déjà une notification de bureau, choisis "notifications_disabled" pour ne pas en voir deux.

Par exemple, ceci joue un son sur macOS dès que Claude a besoin de toi, dans n'importe quel terminal :

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

Les équivalents Linux et Windows sont dans le guide Linux et le guide Windows.

07Limites des options intégrées

• Ça reste sur l'ordinateur. La cloche ou la notification vient du terminal affiché à l'écran. Pars à la cuisine et tu la rates.
• Ça dépend du terminal. Beaucoup de terminaux populaires n'ont rien tant que tu ne modifies pas un réglage.
• Tu ne peux pas y répondre. Ça te dit que Claude attend ; tu dois quand même revenir au clavier.

Remote Control d'Anthropic, avec l'app mobile Claude, est la solution officielle pour recevoir des push sur ton téléphone. Le guide comparatif la présente à côté des autres options.

08Où se situe Claude Code Notifier

Si tu travailles à ton bureau, l'alerte intégrée plus "terminal_bell" te suffit peut-être. Claude Code Notifier sert quand tu n'es pas devant ton écran. Son outil en ligne de commande, ccn, tourne comme hook Claude Code : il fonctionne donc dans n'importe quel terminal sur Mac, Windows et Linux, avec ou sans réglages de cloche. Seul, il affiche une notification de bureau quand Claude termine, demande une permission ou pose une question. Avec un téléphone associé, tu peux accepter ou refuser les permissions, répondre aux questions de Claude et envoyer l'instruction suivante depuis le téléphone ; et si tu as tapé au clavier dans les 30 dernières secondes, rien n'attend sur le téléphone. Voir la page ccn.

09FAQ