Notre avis

Guide pour développer des hooks Claude Code, des scripts shell automatisés qui s'exécutent en réponse à des événements (appels d'outils, notifications, début/fin de session).

Points forts

Permet d'automatiser des workflows comme le linting, le formatage ou les validations personnalisées.
Prend en charge une large gamme d'événements (PreToolUse, PostToolUse, SessionStart, etc.).
Offre des variables d'environnement pour une intégration flexible avec le projet.
Recommandation d'utilisation de hooks basés sur des prompts pour des décisions contextuelles.

Limites

Nécessite une bonne compréhension des événements et de l'ordre d'exécution.
Les hooks bash sont limités à des vérifications déterministes simples.
La gestion des timeouts et des erreurs doit être faite manuellement.

Quand l'utiliser

Lorsque vous souhaitez ajouter des validations automatiques, du contexte ou des intégrations externes aux flux de travail de Claude Code.

Quand l'éviter

Pour des modifications simples et ponctuelles du comportement de l'agent, préférez des instructions directes dans le prompt.

Exemples

Create a PreToolUse linting hook

Create a hook that runs eslint on any JavaScript file before it is used by Claude. Use PreToolUse event and only trigger when the tool is reading or writing a .js file.

Set up a session start context loader

I want a hook that loads a summary of the current project from a README file every time a new session starts. Use the SessionStart event and store context in an environment variable.

Debug an existing hook

My PostToolUse hook that logs tool calls isn't firing. Check my hook configuration and help me debug the event listener setup.

name: hook-development description: "[Utility] Guide for developing Claude Code hooks - shell commands that execute automatically in response to tool calls and notifications. Use this when users want to create, debug, or optimize hooks for automating workflows like linting, formatting, notifications, or custom validations. Supports PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification events."

Hook Development for Claude Code Plugins

Overview

Hooks are event-driven automation scripts that execute in response to Claude Code events. Use hooks to validate operations, enforce policies, add context, and integrate external tools into workflows.

Hook Types

Prompt-Based Hooks (Recommended)

Use LLM-driven decision making for context-aware validation.

Command Hooks

Execute bash commands for deterministic checks.

Hook Events

| Event | When | Use For | |-------|------|---------| | PreToolUse | Before tool | Validation, modification | | PostToolUse | After tool | Feedback, logging | | UserPromptSubmit | User input | Context, validation | | Stop | Agent stopping | Completeness check | | SubagentStop | Subagent done | Task validation | | SessionStart | Session begins | Context loading | | SessionEnd | Session ends | Cleanup, logging | | PreCompact | Before compact | Preserve context | | Notification | User notified | Logging, reactions |

Environment Variables

$CLAUDE_PROJECT_DIR - Project root path
$CLAUDE_PLUGIN_ROOT - Plugin directory
$CLAUDE_ENV_FILE - SessionStart only: persist env vars here

Best Practices

Use prompt-based hooks for complex logic
Use ${CLAUDE_PLUGIN_ROOT} for portability
Validate all inputs in command hooks
Set appropriate timeouts

Développement de hooks Claude Code

Recommandé pour