Chapitre 3 · Chapitre 3 · Écrire sa première configuration
3.3 Premier hook : être prévenu quand Claude attend
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementCommençons par un hook sans risque et immédiatement utile : une alerte quand Claude Code a besoin de toi. Tu lances une tâche, tu passes sur une autre fenêtre, et tu es prévenu dès que Claude attend ton accord.
Sur Windows
La documentation propose cette configuration, à mettre dans ~/.claude/settings.json :
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
}
]
}
]
}
}
La doc prévient : cette commande ouvre une boîte de dialogue, pas une notification dans le coin de l'écran, et elle peut apparaître derrière ta fenêtre de terminal. Teste d'abord la commande directement dans PowerShell. Si tu utilises Claude Code dans WSL (Linux sous Windows), powershell.exe doit être accessible depuis WSL.
Sur macOS
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
La doc signale un piège : osascript passe par l'application Éditeur de script. Si elle n'a pas l'autorisation d'afficher des notifications, la commande échoue sans rien dire, et macOS ne te le demande pas. Teste d'abord osascript -e 'display notification "test"' dans le Terminal.
Sur Linux
La doc propose notify-send 'Claude Code' 'Claude Code needs your attention'. Elle précise que cette commande a besoin d'un service de notifications de bureau, absent sur un serveur ou en SSH.
Ne viser que certaines notifications
Un matcher vide réagit à toutes les notifications. Pour n'être prévenu que lorsqu'une autorisation attend, mets "matcher": "permission_prompt". La doc indique que celle-ci se déclenche quand la demande attend depuis environ six secondes. Il existe d'autres types, comme idle_prompt : la liste complète est dans la doc.
Pourquoi c'est sans risque
Ce hook n'a pas besoin de lire le JSON reçu, il n'écrit aucun fichier et ne peut rien bloquer : la doc précise que les hooks Notification ne peuvent ni bloquer ni modifier les notifications. Au pire, la fenêtre ne s'affiche pas. C'est le hook idéal pour te familiariser avec la configuration.
Tester
- Enregistre
~/.claude/settings.jsonet vérifie qu'il est un JSON valide. - Tape
/hooksdans Claude Code : ton hook doit apparaître sous Notification. Ce menu sert à consulter, pas à modifier : pour changer un hook, on édite le fichier. - Demande à Claude une action qui nécessite ton accord, par exemple : « Lance la commande npm --version ».
- Passe sur une autre fenêtre et attends quelques secondes.
Si ça coince
- Rien ne s'affiche sous Windows. Regarde derrière ta fenêtre de terminal : la boîte de dialogue s'y cache souvent. Puis teste la commande seule dans PowerShell.
- Rien sous macOS. Vérifie l'autorisation de notifications de l'Éditeur de script dans les réglages du système.
- Le hook n'est pas dans
/hooks. Vérifie l'emplacement (~/.claude/settings.json) et le JSON. Les changements sont normalement pris en compte tout seuls ; sinon, redémarre la session. - Tu es prévenu trop souvent. Remplace le matcher vide par
permission_prompt.
À retenir
- La notification est le meilleur premier hook : utile, sans risque.
- Sa place :
~/.claude/settings.json, pour l'avoir dans tous tes projets. "matcher": "permission_prompt"limite l'alerte aux demandes d'autorisation./hookspermet de vérifier, pas de modifier.