Skip to content
Floskool

Chapter 7 · Chapitre 7 · Sécurité, limites et projet final

7.3 Les limites à connaître

Free lesson 5 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Les hooks sont puissants, mais ils ne font pas tout. Mieux vaut connaître leurs limites avant de compter dessus. Voici les principales, d'après la documentation, avec ce qu'elles impliquent.

PostToolUse ne peut pas annuler

Le fichier est déjà écrit. Pour empêcher, utilise PreToolUse. PostToolUse peut seulement réagir : reformater, prévenir Claude.

Les écritures via Bash échappent à Edit|Write

Si Claude modifie un fichier avec une commande shell, ton hook Edit|Write ne voit rien. Ajoute un hook Stop qui contrôle le dossier, ou utilise FileChanged. Et pour les secrets, ajoute des règles deny dans les permissions.

Un délai maximal

10 minutes par défaut pour une commande ; ajustable avec timeout (en secondes). Certains événements ont un délai plus court : la doc cite 30 secondes pour UserPromptSubmit, et un budget partagé très court pour SessionEnd. Un hook de fin de session doit donc être quasi instantané.

Stop tourne à chaque réponse

Garde-le léger, et gère stop_hook_active. Au-delà de huit blocages consécutifs, Claude Code passe outre.

Un hook ne déclenche pas de commande / ni d'outil

Il communique seulement par son code de sortie, stdout et stderr. Il ne peut pas taper /compact à ta place ni demander à Claude d'utiliser un outil. Il peut seulement ajouter du contexte ou bloquer.

Un succès n'affiche rien

Vérifie l'effet (fichier reformaté) ou utilise Ctrl+O.

Des hooks lancés en parallèle

Quand plusieurs hooks correspondent au même événement, la doc indique qu'ils tournent en parallèle. Ne compte pas sur un ordre entre deux hooks du même événement. Si deux étapes doivent se suivre (formater puis vérifier), mets-les dans le même script.

Le filtrage reste « au mieux »

Un if ou une recherche de texte dans une commande ne garantit pas tout. Pour une interdiction stricte, la doc renvoie au système d'autorisations.

Un hook ne remplace pas ta relecture

Un formateur garantit une présentation cohérente, pas un code correct. Un garde-fou bloque les cas que tu as prévus, pas ceux que tu n'as pas imaginés. Les hooks réduisent les oublis ; ils ne suppriment pas le besoin de vérifier.

Le prompt pour auditer tes hooks

Lis mes hooks dans .claude/settings.json et ~/.claude/settings.json.
Pour chacun, dis-moi : ce qu'il ne verra pas (écritures via Bash,
outils non couverts par le matcher), s'il risque d'être lent (événement
fréquent, outil long), et si une règle de permission serait plus adaptée.
Ne modifie rien.

Si ça coince

  • Un fichier sensible a été modifié malgré ton hook. Regarde quel outil a été utilisé (Ctrl+O). Si c'est Bash, ajoute des règles deny et un contrôle sur Stop.
  • Ton hook est coupé avant la fin. Il dépasse son délai : augmente timeout ou allège le travail.
  • Deux hooks se marchent dessus. Ils tournent en parallèle : regroupe les étapes dans un seul script.

À retenir

  • PostToolUse ne défait rien ; les écritures via Bash échappent à Edit|Write.
  • Délai par défaut de 10 minutes pour une commande, plus court sur certains événements.
  • Les hooks d'un même événement tournent en parallèle.
  • Un hook réduit les oublis, il ne remplace pas ta relecture.