Les hooks de Claude Code expliqués

Les hooks font partie des fonctionnalités les plus utiles de Claude Code, et pourtant les moins exploitées. Cet article explique à quoi ils servent et comment les mettre au service de vos workflows.

Qu'est-ce qu'un hook

Un hook est une commande déclenchée automatiquement par Claude Code à un moment précis de son cycle de travail. Plutôt que d'agir manuellement, vous définissez une règle : « quand tel événement se produit, exécute telle commande ».

L'idée est simple mais puissante : elle transforme Claude Code d'un assistant réactif en un assistant qui respecte automatiquement vos règles de projet.

Le principe du déclencheur

Chaque hook associe un événement à une action. L'événement peut être, par exemple, le moment où Claude s'apprête à utiliser un outil, ou celui où il vient de modifier un fichier. L'action est une commande shell de votre choix.

À quoi servent les hooks

Les hooks répondent à plusieurs besoins concrets.

Faire respecter des standards de code

Le cas le plus courant : déclencher un formateur ou un linter après chaque modification de fichier. Ainsi, le code produit reste conforme aux conventions du projet, sans que vous ayez à le demander à chaque fois.

# Exemple de principe : formater un fichier après son écriture
npx prettier --write "$FICHIER_MODIFIE"

Protéger des fichiers sensibles

Un hook peut bloquer une action avant qu'elle se produise. Vous pouvez par exemple empêcher toute modification d'un fichier de configuration critique ou d'un répertoire de production.

Automatiser des tâches répétitives

Lancer la suite de tests, mettre à jour un index, notifier une équipe : tout ce que vous feriez manuellement après une action de Claude peut devenir un hook.

Quand utiliser un hook

Un hook n'est pas toujours la bonne réponse. Voici comment décider.

Privilégiez le hook pour les règles non négociables

Si une action doit toujours se produire (formater, vérifier, journaliser), un hook garantit qu'elle ne sera jamais oubliée. C'est plus fiable qu'une instruction dans le fichier CLAUDE.md, qui reste une recommandation.

Préférez les instructions pour le contexte

Pour transmettre des préférences ou du contexte de projet, un fichier CLAUDE.md reste l'outil adapté. Consultez notre guide sur la rédaction du fichier CLAUDE.md pour distinguer les deux approches.

Réservez les sous-agents aux tâches autonomes

Si le besoin est de déléguer une tâche complexe et isolée, ce n'est pas un hook qu'il vous faut, mais un sous-agent. Notre article sur les sous-agents de Claude Code détaille ce choix.

Bonnes pratiques

Quelques principes évitent que les hooks deviennent contre-productifs.

Gardez les hooks rapides

Un hook s'exécute pendant votre session de travail. Une commande lente ralentit chaque interaction. Visez des hooks qui s'exécutent en quelques secondes au maximum.

Rendez les échecs lisibles

Quand un hook bloque une action, il doit indiquer clairement pourquoi. Un message d'erreur explicite évite la confusion et fait gagner du temps.

Versionnez vos hooks

Stockez la configuration de vos hooks dans le dépôt du projet. Toute l'équipe bénéficie ainsi des mêmes garde-fous, et la configuration est tracée.

Testez avant de généraliser

Validez un hook sur un cas isolé avant de l'appliquer à tout le projet. Un hook mal calibré peut bloquer des actions légitimes et freiner votre travail.

Hooks et certification

La maîtrise des hooks fait partie des compétences attendues d'un architecte Claude. Les questions de la CCA-F portent notamment sur la distinction entre hooks, instructions et sous-agents. Si vous préparez l'examen, entraînez-vous avec les questions d'entraînement sur ce sujet.

En résumé

Les hooks transforment Claude Code en un assistant qui applique vos règles automatiquement : formatage, contrôles, protections, automatisations. La clé est de les réserver aux règles non négociables, de les garder rapides et de les versionner. Pour passer à la pratique, enchaînez avec la leçon Les hooks et le cours complet Claude Code en action.