Skip to main content
ClaudeWave

Claude Hooks

Comandos shell que Claude Code ejecuta automáticamente en eventos del ciclo de vida (antes/después de una tool, al arrancar la sesión, al parar) para aplicar políticas o automatizar.

Los hooks se configuran en ~/.claude/settings.json (global) o .claude/settings.json (proyecto) bajo la clave hooks. Cada entrada tiene un matcher (nombre del evento + patrón de tool) y un comando. El runtime ejecuta el comando de forma síncrona y espera a que termine antes de continuar.

Patrones comunes: auto-formatear en PostToolUse Edit (correr biome/prettier tras cada edición de fichero), bloquear comandos destructivos en PreToolUse Bash (exit 1 si ves rm -rf), inyectar contexto en SessionStart (cat docs/CONTEXT.md), notificar a Slack en Stop (curl al webhook). Un hook PreToolUse que termine con exit 1 bloquea la llamada a la tool, y el mensaje de error se le pasa a Claude para que ajuste su plan.

Los hooks corren con los permisos de tu usuario, pueden leer, escribir y ejecutar cualquier cosa que tú puedas. Mantenlos rápidos (unos segundos máximo), porque un hook colgado cuelga a Claude.