Hooks d'agent
Les hooks d'agent (points d'accroche) sont des commandes ou scripts définis par l'utilisateur qu'un agent de code exécute automatiquement à des moments précis de son travail, par exemple avant un appel d'outil ou après la modification d'un fichier, pour vérifier, bloquer ou étendre ce qu'il fait.
Aussi appelé : hooks
Par Divya Sharma · Vérifié le 15 nov. 2026 · Notre méthode
Les instructions d'un prompt ou d'un fichier d'instructions sont des suggestions que le modèle suit en général. Les hooks sont du code qui s'exécute à chaque fois, quoi que décide le modèle. C'est donc là qu'il faut placer les règles qui doivent toujours s'appliquer, et les corvées dont vous ne voulez pas qu'elles dépendent de la mémoire du modèle.
Comment ça marche
Vous enregistrez un hook dans les paramètres de l'agent, associé à un événement. Dans Claude Code, les événements incluent le début d'une session, le moment où l'utilisateur envoie un prompt, juste avant l'exécution d'un outil (PreToolUse), juste après (PostToolUse) et l'arrêt de l'agent. L'agent transmet à votre script les détails de l'événement, comme le nom de l'outil et ses paramètres. Le script peut laisser l'action se poursuivre, la bloquer avec une raison que le modèle voit, ou ajouter du contexte.
Usages courants
Lancer un formateur ou un linter après chaque modification de fichier. Bloquer les commandes shell qui suppriment des fichiers ou touchent à des secrets. Refuser les modifications de chemins protégés. Envoyer une notification de bureau quand l'agent attend une réponse. Journaliser chaque appel d'outil pour l'audit.
Hooks ou permissions
Les permissions d'agent sont des listes d'autorisation et d'interdiction pour les outils. Les hooks sont programmables : ils peuvent donc inspecter les arguments et appliquer des règles qu'une liste ne peut pas exprimer. Les deux font partie du harnais d'agent.
Limites
Un hook s'exécute avec tous les droits de votre utilisateur, si bien qu'un script de hook négligent ou malveillant constitue lui-même un risque ; examinez les hooks des dépôts partagés avant de les activer. La reconnaissance de motifs sur les commandes peut être contournée : traitez donc les hooks comme une couche parmi d'autres, aux côtés d'un bac à sable pour agent, et non comme la seule.
Termes liés
- Agent de code
- Un agent de code (coding agent) est un agent IA qui travaille directement sur un logiciel : il lit une base de code, modifie des fichiers, lance des commandes et des tests, et recommence jusqu'à ce qu'un changement fonctionne, au lieu de seulement suggérer du code qu'une personne collera.
- Harnais d'agent
- Un harnais d'agent (agent harness) est le logiciel qui entoure un modèle et en fait un agent opérationnel : la boucle, les outils, le prompt système, les permissions, la gestion du contexte et les fichiers éventuels qui servent à transmettre l'avancement d'une session à l'autre.
- Permissions d'agent
- Les permissions d'agent sont les règles qui déterminent quels outils, fichiers, commandes, réseaux et comptes un agent IA peut utiliser, et quelles actions exigent d'abord l'approbation d'un humain, afin qu'un agent qui se trompe ou qui est manipulé ne puisse causer que des dégâts limités.
- Fichier d'instructions pour agent (AGENTS.md)
- Un fichier d'instructions pour agent est un fichier Markdown placé dans un dépôt de code, comme AGENTS.md ou CLAUDE.md, qu'un agent de code lit au début d'une session pour apprendre les commandes, les conventions et les règles du projet.
- Bac à sable pour agent
- Un bac à sable pour agent (agent sandbox) est un environnement isolé, comme un conteneur, une machine virtuelle ou une restriction du système d'exploitation, dans lequel un agent IA exécute du code et des commandes sans pouvoir atteindre les fichiers, réseaux ou données au-delà de limites fixées.