Módulo 05 — Hooks & automatización

5.1 — Estocástico vs Determinista: por qué existen los hooks

Desde el comienzo de esta formación, configuras Claude Code con archivos CLAUDE.md, instrucciones de proyecto y convenciones de equipo. Todo eso funciona, la mayoría de las veces. El problema fundamental: CLAUDE.md es consultivo. Claude lo lee, lo interpreta y hace lo mejor que puede. Pero "lo mejor que puede" no es una garantía. Un LLM puede olvidar una instrucción, malinterpretarla o juzgar que no se aplica en un contexto dado.

Los hooks resuelven este problema. Son comandos shell o prompts LLM que se ejecutan automáticamente en puntos precisos del lifecycle de Claude Code. No están "sugeridos", están ejecutados. Cuando configuras un hook que bloquea las eliminaciones de archivos, ese hook se ejecutará en cada intento, sin excepción.

Piensa en la diferencia entre una señal de "velocidad limitada a 50 km/h" (CLAUDE.md) y un radar automático que dispara el flash sistemáticamente (hooks). La primera informa, el segundo lo impone.

Los hooks se configuran en JSON en tus archivos de settings (.claude/settings.json para el proyecto, ~/.claude/settings.json para el global) y se disparan en eventos precisos del lifecycle: arranque de sesión, uso de herramienta, parada, compactación de contexto, notificación. Cada evento es un punto de intercepción donde puedes conectar uno o varios hooks.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '{\"decision\": \"deny\", \"reason\": \"Comando bloqueado por hook\"}'",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

Hay dos tipos de hooks disponibles: command (script shell determinista) y prompt (evaluación LLM contextual). El primero es rápido y predecible, el segundo es capaz de juicio semántico. La elección entre ambos depende de la naturaleza de la verificación.