Mejor Claude Hooks
Claude Code hooks for automation, safety, and custom behavior.
¿Qué son los Hooks de Claude Code?
Los hooks de Claude Code son comandos shell que el runtime ejecuta en eventos del ciclo de vida, antes de que una tool corra (PreToolUse), después (PostToolUse), cuando Claude se detiene (Stop), cuando arranca la sesión (SessionStart), etc. Permiten automatizar guardrails, validaciones, formateadores y notificaciones sin tocar Claude en sí.
Patrones comunes: auto-formatear código tras cada Edit (PostToolUse → biome/prettier), bloquear comandos peligrosos antes de ejecutarlos (PreToolUse → fail si rm -rf), notificar a Slack cuando Claude termina una tarea larga (Stop → curl webhook), inyectar contexto al arrancar la sesión (SessionStart → cat fichero). Los hooks se configuran en ~/.claude/settings.json o en el .claude/settings.json del proyecto.
El directorio inferior cataloga más de 25 colecciones open-source de hooks, guardrails, formateadores, observabilidad, dispatch, ordenadas por estrellas y Trust Score.
Preguntas sobre Hooks
¿Dónde configuro los hooks de Claude Code?+
Dos sitios: ~/.claude/settings.json (global) y .claude/settings.json (proyecto). Cada hook lleva un matcher (nombre del evento + patrón de tool) y un comando. Ejecuta claude config para ver la config resuelta actual.
¿Un hook puede bloquear a Claude de ejecutar una tool?+
Sí. Un hook PreToolUse que termine con exit 1 bloquea la llamada. El mensaje de error se le pasa a Claude para que ajuste su plan. Así se implementan guardrails tipo 'nada de rm -rf en producción' o 'nunca edites configs de prod'.
¿Los hooks corren de forma síncrona?+
Sí. Claude Code espera a que cada hook termine antes de continuar. Mantenlos rápidos (menos de unos segundos) o envuelve el trabajo lento en un proceso en background. Un hook colgado cuelga a Claude.
¿Puedo compartir hooks entre miembros del equipo?+
Sí, commitea el .claude/settings.json del proyecto. Quien clone el repo recibe los mismos hooks. Para los scripts referenciados por los hooks, commitealos también bajo .claude/scripts/ o similar para que las referencias se resuelvan.
¿Cuál es el hook más útil para empezar?+
Auto-formatear en PostToolUse Edit. Es pequeño (3-5 líneas de JSON), arregla una molestia recurrente (los espacios de Claude) y no cuesta CPU. Después, añade un hook PreToolUse Bash para bloquear comandos destructivos. Esos dos cubren el 80% del valor de los hooks.