Skip to content

Workflows agentiques — Maîtrise4 / 8

Hooks — Make the Agent Obey Your Rules

A prompt asks the model to remember. A hook makes it happen — deterministically, every time, outside the model's control.

Hooks — Make the Agent Obey Your Rules

Vous pouvez demander à l'agent d'exécuter le formateur après chaque modification. Ou vous pouvez le garantir. Les hooks sont des commandes shell que Claude Code exécute automatiquement à des points définis de sa boucle — transformant « s'il te plaît, souviens-toi » en « toujours ».

Les événements que vous utiliserez réellement

  • PostToolUse — après qu'un outil réussisse. Formatez ou lintez le fichier qui vient d'être modifié.
  • PreToolUse — avant qu'un outil s'exécute. Inspectez et bloquez les appels dangereux.
  • UserPromptSubmit — injectez du contexte avant que le modèle ne voie votre prompt.
  • SessionStart / Stop — chargez le contexte au démarrage, notifiez à la fin.

Connecter un hook

Les hooks vivent sous une clé hooks dans settings.json. Chaque événement mappe à des matchers (une regex sur le nom de l'outil) et des commandes :

{
  "hooks": {
    "PostToolUse": [
      { "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }] }
    ]
  }
}

Les codes de sortie sont le canal de contrôle

  • 0 — succès ; l'agent continue.
  • 2erreur bloquante ; l'action est empêchée et stderr est renvoyé pour que l'agent puisse s'ajuster.
  • autre non-zéro — erreur non-bloquante, enregistrée.

Les recettes qui rentabilisent l'investissement

  • Auto-format à la modificationPostToolUse + Edit|Write.
  • Bloquer rm -rf / force-pushPreToolUse + Bash, sortie 2 en cas de correspondance.
  • Scan de secrets avant écriturePreToolUse + Write, bloquez si des clés sont détectées.
  • Notification du bureau quand une entrée est nécessaireNotification.

Les hooks imposent le comportement. Ensuite, nous empaquettons l'intention — des workflows d'équipe réutilisables — comme des commandes slash personnalisées.

Partager cet article

#Hooks #DevTools #AgenticAI

LinkedInX / TwitterBlueskyThreadsRedditHacker NewsWhatsAppE-mail

Série — Workflows agentiques — Maîtrise

  1. Partie 01L'état d'esprit du flux de travail agentiqueLa plupart des développeurs traitent l'IA comme un autocompléteur plus intelligent. Ceux qui prennent l'avance la traitent comme un coéquipier qui agit. Voici le modèle mental.
  2. Partie 02MCP Servers 101 — Give Your Agent Real ToolsLe Model Context Protocol est la façon dont votre agent arrête de deviner et commence à interroger votre base de données, vos tickets, votre navigateur. Voici le modèle mental et la première connexion.
  3. Partie 03Build Your First Custom MCP ServerLes serveurs prêts à l'emploi couvrent GitHub et Postgres. Le vrai levier, c'est le serveur que seul vous pouvez écrire — le pont vers votre propre système.
  4. Partie 04Hooks — Make the Agent Obey Your Rulesvous êtes iciA prompt asks the model to remember. A hook makes it happen — deterministically, every time, outside the model's control.
  5. Partie 05Commandes slash personnalisées en tant que flux de travail d'équipeUne commande slash personnalisée est un prompt réutilisable que vous engagez dans le dépôt — ainsi toute l'équipe exécute la même instruction de haute qualité au lieu de la retaper.
  6. Partie 06Subagents — Déléguer du travail qui s'adapteUn contexte géant devient lent et vague. Les subagents permettent à l'agent principal de confier du travail ciblé à des spécialistes dotés de leur propre contexte et outils — et de les exécuter en parallèle.
  7. Partie 07The Daily-Driver Setup — Settings, Permissions, Status LineThe difference between fighting the agent and flowing with it is twenty minutes of configuration you do once. Here is the setup.
  8. Partie 08Multi-Tool Pipelines — Ticket to Reviewed BranchThe payoff: chain MCP, hooks, commands and subagents into one flow that takes a ticket to a reviewed branch — with you in the loop only where it counts.

Continuer

PDF — à vie

Hooks

Exécutez vos propres commandes shell à chaque étape de la boucle de l’agent.

Voir le PDF →

Cours

Le cours Claude Mastery

12 modules · 5 langues · certificat · 3 jours d’essai gratuit.

Voir les plans →
LinkedInX / TwitterBlueskyThreads