Automatiser un geste simple avec un hook, en toute prudence

1. À la fin de cette leçon, tu sauras

Expliquer ce qu’est un hook et à quels moments il peut se déclencher.
Consulter les hooks en place avec /hooks.
Mettre en place, avec l’agent, un hook simple et sans risque.
Appliquer les règles de prudence : comprendre chaque commande, commencer petit, savoir retirer.

2. Pourquoi ça t’intéresse

Anne confie à l’agent des tâches qui durent quelques minutes : trier ses factures de l’année, mettre en forme un long document pour son association. Pendant ce temps, elle fait autre chose et oublie de revenir voir. L’agent l’attend parfois depuis vingt minutes avec une question. Un hook peut la prévenir automatiquement, par un son ou un message, dès que l’agent a fini ou attend une réponse. Un petit geste automatique, qui ne touche à aucun fichier.

3. Avant de commencer


Il te faut	Claude Code, ton dossier de travail, les leçons sur les permissions (module 5) et les plugins
Coût	Ton abonnement à l’agent (vérifie le prix du jour sur claude.com/pricing)
Durée	45 min à 1 h

4. Comprendre en 3 minutes

Un hook est une règle du type « quand ceci se produit, fais cela automatiquement ».

Image mentale : la sonnerie du four. Tu ne surveilles pas le gâteau en permanence ; au bon moment, la sonnerie retentit. Le four ne te demande pas ton avis pour sonner.

Les moments auxquels on peut accrocher un hook sont prévus par Claude Code. En voici des exemples, en langage courant :

Moment	Exemple d’action
L’agent a fini de répondre	Jouer un son, afficher un message
L’agent attend ta réponse	Te prévenir
Avant que l’agent utilise un outil	Vérifier qu’il ne touche pas à un dossier interdit
Après qu’il a modifié un fichier	Noter le nom du fichier dans un journal

La liste exacte des moments et la façon de les configurer sont dans la documentation officielle (code.claude.com/docs). La commande /hooks affiche les hooks en place et permet de les gérer.

La règle d’or : un hook exécute une commande sur ton ordinateur sans te demander la permission. Toute la sécurité que tu as apprise au module 5 (lire, puis accepter) ne s’applique pas au moment où il se déclenche. D’où trois règles :

Comprendre chaque commande avant de l’activer. Si tu ne sais pas l’expliquer, tu ne l’actives pas.
Commencer par des actions qui ne modifient rien : prévenir, afficher, vérifier.
Savoir retirer le hook, et noter qu’il existe.

Les plugins peuvent aussi installer des hooks : c’est une raison de plus pour lire leur contenu.

5. Faire ensemble

Étape 1 · Regarder l’existant

Lance claude dans ton dossier de travail.
Tape /hooks et observe. Il n’y a peut-être rien : c’est normal. S’il y a des hooks que tu n’as pas mis toi-même (par exemple via un plugin), note-les.

Étape 2 · Faire proposer un hook sans risque

Je veux un hook qui me prévienne (un son ou une notification
système) quand tu as fini de répondre. Mon ordinateur est sous
[Windows / macOS / Linux]. Propose-moi la configuration, explique
chaque partie de la commande en langage simple, et dis-moi ce
qu'elle peut et ne peut pas faire. Ne l'active pas encore.

Étape 3 · Relire et questionner

Lis l’explication. Pose au moins une question :

Cette commande peut-elle lire, modifier ou supprimer un de mes
fichiers ? Peut-elle envoyer quoi que ce soit sur internet ?

Si la réponse n’est pas un « non » clair pour une simple notification, demande une version plus simple.

Étape 4 · Activer et tester

Active le hook via /hooks ou en laissant l’agent écrire la configuration, après avoir relu ce qu’il écrit. Puis teste :

Réponds simplement « test » et termine.

Tu dois être prévenu. Si rien ne se passe, demande à l’agent de diagnostiquer, sans ajouter de commande que tu ne comprends pas.

Étape 5 · Noter et savoir retirer

Ajoute dans decisions.md : le hook ajouté, ce qu'il fait,
où il est configuré, et comment le retirer.

6. Faire toi-même

Choisis un petit automatisme utile dans ta façon de travailler : être prévenu quand l’agent a fini, ou quand il attend ta réponse, ou garder une trace des fichiers modifiés dans un journal.

Consigne : fais proposer le hook par l’agent, fais-toi expliquer chaque commande, vérifie qu’il ne peut rien abîmer, active-le, teste-le, puis note dans decisions.md comment le retirer. Ensuite, retire-le une fois et remets-le, pour être sûr de savoir le faire.

Résultat attendu : un hook actif que tu sais expliquer en une phrase, et une note qui permettrait à quelqu’un d’autre de le désactiver.

7. Vérifier

Tu as ouvert /hooks et noté ce qui existait avant toi.
Tu sais expliquer avec tes mots ce que fait la commande de ton hook.
Le hook ne modifie, ne supprime et n’envoie rien.
Le test a déclenché l’action attendue.
Tu as su retirer puis remettre le hook.
decisions.md indique ce que fait le hook et comment le retirer.

8. Ce que tu gardes

Dans ton carnet de bord, note la règle d’or : « Un hook agit sans demander. Je ne lance que ce que je sais expliquer. » Avec les skills, les connecteurs, les plugins et les sous-agents, tu as maintenant la carte complète des façons d’étendre ton agent.

9. Pour aller plus loin

Un hook de vérification peut empêcher l’agent de toucher à un dossier sensible : la documentation sur code.claude.com/docs montre comment, à n’essayer qu’une fois à l’aise.
Le module 9 prolonge cette idée : automatiser sans perdre le contrôle.