Los hooks son el pegamento entre Claude Code y tu shell. Se disparan en eventos del ciclo de vida (PreToolUse, PostToolUse, Stop, UserPromptSubmit) y te permiten aplicar políticas en cada acción del agente. Bien usados, transforman Claude Code de asistente útil en miembro disciplinado del equipo.
Actualizado: 24 de abril de 2026
PreToolUse corre antes de una llamada a herramienta y puede cancelarla (útil para bloquear escrituras a .env). PostToolUse corre tras una llamada exitosa, perfecto para correr lint o formatter. Stop corre cuando el agente cree que ha terminado; puedes condicionarlo a tests en verde.
Añade un hook PostToolUse que haga match con Edit|Write y ejecute `npm run lint --silent`. Claude Code lee la salida del hook y, si el lint falla, reintenta la edición automáticamente. Código production-grade sin niñera.
Usa un hook PreToolUse que haga match con Edit|Write y compruebe la ruta contra tu allowlist. Cualquier escritura a /infra, /.env o /.github se rechaza con exit code 2 para que el agente corrija en el mismo turno. Esencial para SaaS empresarial donde ciertos archivos exigen revisión humana.
La plantilla de Alher Tech viene con 12 hooks por defecto: lint, test, type-check, no-secret-in-diff, conventional-commit, no-merge-to-main-sin-PR y unos cuantos más. Cada repo de cliente los hereda para que el agente se comporte igual en todos los proyectos activos.
Los hooks son comandos shell locales: cero tokens. Pueden ahorrar dinero atajando errores temprano y evitando turnos de agente desperdiciados.