Hooks: reglas que se cumplen siempre

Qué son

Un hook es una orden que Claude Code ejecuta sola en un momento concreto: antes de usar una herramienta, cuando te necesita, al terminar de responder...

Se escriben en un archivo de ajustes, settings.json: el tuyo (~/.claude/settings.json) para todo, o el de una carpeta (.claude/settings.json). Para ver los que tienes, escribe /hooks: hoy es solo un visor, no un asistente para crearlos.

El más útil: un aviso cuando Claude te necesita

Mientras Claude trabaja puedes hacer otra cosa. Con este hook, cuando se queda esperando tu permiso o tu respuesta, te salta un aviso. Es el ejemplo oficial de la documentación:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Si tu settings.json ya tiene cosas, no lo sustituyas entero: añade la parte de "hooks" junto a lo que haya. Lo más seguro es pedírselo a Claude:

Reglas que no se saltan

Un hook también puede bloquear una acción antes de que ocurra. La documentación trae, por ejemplo, uno que impide borrar carpetas enteras y otro que impide tocar archivos protegidos. Un bloqueo de un hook funciona incluso en el modo que se salta los permisos.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|PowerShell",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(rm *)",
            "command": "powershell.exe",
            "args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"]
          },
          {
            "type": "command",
            "if": "PowerShell(Remove-Item *)",
            "command": "powershell.exe",
            "args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"]
          }
        ]
      }
    ]
  }
}

# .claude/hooks/block-rm.ps1
$callInput = [Console]::In.ReadToEnd() | ConvertFrom-Json
$command = $callInput.tool_input.command

if ($command -match 'rm -rf|Remove-Item.*-Recurse') {
  @{
    hookSpecificOutput = @{
      hookEventName = "PreToolUse"
      permissionDecision = "deny"
      permissionDecisionReason = "Destructive command blocked by hook"
    }
  } | ConvertTo-Json
} else {
  exit 0  # no decision; normal permission flow applies
}

Con cuidado

Si algo falla

Comprueba que lo has pillado

Tres preguntas. Cada acierto suma 10 puntos.