Hooks en Claude Code: automatiza tus flujos de desarrollo

Qué son los hooks en Claude Code

Los hooks son comandos shell que se ejecutan automáticamente en respuesta a eventos de Claude Code. Piensa en ellos como git hooks pero para tu agente de IA: antes de un commit, después de editar un archivo, al crear un PR.

Tipos de hooks

PreToolCall: se ejecuta antes de que Claude use una herramienta. Útil para validar acciones.

PostToolCall: se ejecuta después. Útil para linting, formatting, notificaciones.

Notification: se ejecuta cuando Claude quiere mostrar algo al usuario.

Configuración en settings.json

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Write|Edit",
        "command": "npx eslint --fix {{filePath}}"
      }
    ],
    "PreToolCall": [
      {
        "matcher": "Bash",
        "command": "echo 'Executing: {{command}}'"
      }
    ]
  }
}

Ejemplos prácticos

Auto-lint después de editar: ESLint/Prettier se ejecuta automáticamente cada vez que Claude edita un archivo.

Tests después de cambios: ejecutar tests unitarios después de cada modificación de código.

Notificación Telegram: enviar alerta cuando Claude completa una tarea larga.

Prevenir operaciones peligrosas: bloquear git push --force o rm -rf.

Hooks avanzados

Los hooks pueden leer el contexto del tool call (archivo, comando, resultado) y tomar decisiones. Combinados con CLAUDE.md, crean un flujo de desarrollo completamente automatizado.