# Hooks de Claude Code: Automatiza lint, tests y git | Alher Tech

> Automatiza lint, tests, git y políticas con los hooks de Claude Code. Ejemplos de PreToolUse, PostToolUse y Stop para entregas SaaS B2B de calidad empresarial.

- Canonical page: https://alhertech.com/es/claude-code/hooks/
- Site: Alher Tech (custom software, AI agents and SEO engineering, https://alhertech.com/)
- Contact: https://alhertech.com/es/contacto/

---

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

## Cuándo se disparan los hooks

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.

## Ejemplo: correr eslint tras cada edit

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.

## Ejemplo: bloquea escrituras fuera de rutas permitidas

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.

## Hooks y entregas B2B

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.

## Preguntas frecuentes

### ¿Los hooks cuestan dinero?

Los hooks son comandos shell locales: cero tokens. Pueden ahorrar dinero atajando errores temprano y evitando turnos de agente desperdiciados.
