lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración principiante claude-codeagentesautomatizacion

Hooks de Claude Code: automatiza acciones ante eventos

Ejecuta comprobaciones y avisos en puntos concretos de la sesión sin depender de que el modelo recuerde solicitarlos.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

  1. Lee el ejemplo de Notification de la guía oficial para tu sistema.
  2. Incorpora su bloque hooks al archivo de configuración indicado sin sobrescribir otros eventos.
  3. Comprueba la configuración desde Claude Code con el comando documentado:
/hooks

Comprobación

Genera el evento de prueba indicado por la guía y confirma el aviso. Revisa el comando por separado si no aparece.

Si algo falla

Comprueba evento, matcher y permisos de notificación del sistema; consulta los apartados de diagnóstico de la guía.

ver en .md ¿Prefieres el recurso entero?

Qué es

Los hooks son extensiones de la configuración de Claude Code que reaccionan a eventos de su ciclo de trabajo. La guía oficial incluye comandos, evaluaciones con modelos y hooks HTTP.

Para qué te sirve

  • Cuando quieres un aviso al necesitarse tu intervención.
  • Cuando una edición debe activar una comprobación del proyecto.

Cómo funciona

La configuración relaciona eventos con acciones y filtros. Los hooks de comandos ejecutan procesos; reciben datos del evento y devuelven resultados con un contrato documentado. El evento elegido determina cuándo pueden intervenir.

Antes de empezar

Necesitas Claude Code y los programas que invoque el hook. El ejemplo de notificaciones de macOS usa osascript; Linux y Windows tienen ejemplos distintos. Conserva la configuración existente al incorporar una nueva regla.

Límites y alternativas

Un hook se ejecuta con acceso al entorno de la sesión. Revisa su código, sus entradas y su alcance. Una notificación no bloquea una acción, y un hook mal configurado puede frenar el trabajo. Hookify es un plugin distinto para gestionar reglas mediante archivos.

Recursos