Hooks en Claude Code: Guía Completa para Automatizar tu Flujo de Trabajo

Los Hooks en Claude Code son puntos de enganche que te permiten ejecutar scripts automatizados en momentos específicos de tu flujo de trabajo. Imagina poder ejecutar validaciones, notificaciones, o limpiezas automáticas sin intervención manual. Eso es exactamente lo que hacen los Hooks. En esta guía completa, aprenderemos los 25+ Hooks disponibles y cómo usarlos para transformar tu productividad.

¿Qué son los Hooks?

Los Hooks son eventos que Claude Code dispara automáticamente en respuesta a ciertas acciones. Cuando ocurre un evento (como antes de ejecutar una herramienta o al finalizar una sesión), Claude Code busca si has configurado un Hook para ese evento y lo ejecuta. Esto permite automatizar tareas repetitivas sin escribir código personalizado cada vez.

Los Hooks se configuran en tu archivo settings.json en la carpeta .claude. Cada Hook puede ejecutar un script bash, validaciones, o acciones personalizadas.

Tipos de Hooks Principales

Existen cuatro categorías principales de Hooks que cubrirán la mayoría de tus casos de uso:

1. PreToolUse y PostToolUse

Estos Hooks se ejecutan antes y después de que Claude Code ejecute cualquier herramienta (como correr tests, hacer commits, ejecutar comandos bash). Son perfectos para validaciones previas y análisis posteriores.

2. SessionStart y SessionStop

Se ejecutan al iniciar y terminar una sesión de trabajo. Usa SessionStart para configurar tu entorno y SessionStop para limpiar recursos.

3. ToolError

Se ejecuta cuando una herramienta falla. Perfecto para notificaciones, logs, o intentos de recuperación automática.

4. Custom Hooks

Puedes definir eventos personalizados para casos específicos de tu flujo de trabajo.

Configurando Hooks en tu Proyecto

Aquí está un ejemplo real de cómo configurar Hooks en tu archivo settings.json:

{
  "hooks": {
    "PreToolUse": {
      "description": "Validar antes de ejecutar herramientas",
      "script": ".claude/hooks/pre-tool-check.sh"
    },
    "PostToolUse": {
      "description": "Documentar ejecución de herramientas",
      "script": ".claude/hooks/post-tool-log.sh"
    },
    "SessionStart": {
      "description": "Preparar ambiente al inicio",
      "script": ".claude/hooks/session-start.sh"
    },
    "SessionStop": {
      "description": "Limpiar al terminar",
      "script": ".claude/hooks/session-cleanup.sh"
    },
    "ToolError": {
      "description": "Notificar errores",
      "script": ".claude/hooks/error-handler.sh"
    }
  }
}

Ahora, aquí está un ejemplo de un script bash que se ejecutaría en el Hook PreToolUse:

#!/bin/bash
# .claude/hooks/pre-tool-check.sh

# Verificar que el proyecto esté en estado válido
if [ ! -f "package.json" ]; then
  echo "❌ Error: package.json no encontrado"
  exit 1
fi

# Asegurarse de que el repo está limpio
if ! git diff-index --quiet HEAD --; then
  echo "⚠️  Aviso: Hay cambios sin hacer commit"
fi

# Validar que las dependencias están instaladas
if [ ! -d "node_modules" ]; then
  echo "📦 Instalando dependencias..."
  npm install
fi

echo "✅ Verificaciones previas completadas"
exit 0

Casos de Uso Reales

Los Hooks brillan en escenarios reales. Algunos ejemplos que nuestros usuarios implementan:

• •Validación automática: Ejecutar linters y tests antes de permitir commits
• •Notificaciones: Alertar por Slack o email cuando falla un deploy
• •Backup automático: Guardar snapshots de tu contexto al finalizar sesiones
• •Logging y auditoría: Registrar todas las acciones de Claude Code
• •Integración CI/CD: Disparar pipelines en Jenkins o GitHub Actions

En el módulo de Automatización Avanzada del curso, profundizamos en 25+ Hooks diferentes y creamos flujos complejos que automatizan completamente tu pipeline de desarrollo. Aprenderás a orquestar múltiples Hooks, manejar errores, y crear soluciones empresariales.

Los Hooks son la piedra angular de la automatización en Claude Code. Una vez que domines este concepto, transformarás tu flujo de trabajo y ganarás horas de productividad cada semana.