Lo básico

Qué es un hook

Un hook es una acción configurada para ejecutarse automáticamente en un momento concreto del trabajo de un agente de IA.

Por

Director de Ciade · 7 min de lectura ·

Foto: Kasia Derenda / Unsplash · tratamiento Ciade · Licencia de Unsplash
Índice del artículo
  1. En 30 segundos
  2. Ejemplo práctico: una gestoría de Zaragoza
  3. Explicado fácil: un control en el recorrido
  4. No lo confundas con
  5. Por qué te importa: automatizar no elimina el juicio
  6. Cómo preparar una prueba pequeña
  7. El error típico: confundir una pieza con toda la protección
  8. Dudas sobre hooks, respuestas cortas

En 30 segundos

  1. Un hook es una acción configurada para ejecutarse automáticamente en un momento concreto del trabajo de un agente de IA.

  2. El momento determina su utilidad: una comprobación previa puede frenar una operación; una revisión posterior llega con la acción hecha. Un aviso llama tu atención, pero no decide por ti.

Ejemplo práctico: una gestoría de Zaragoza

Imagina una gestoría de Zaragoza que encarga a un agente, un programa que realiza tareas con herramientas, preparar un resumen de expedientes. Es un ejemplo ilustrativo, no un caso de cliente. Trabaja sobre una copia de muestra con documentos ficticios. Una comprobación previa debe rechazar las operaciones configuradas sobre una carpeta reservada. La responsable revisa el contenido, el destinatario y la salida de documentos. El agente no debe leer originales reservados, borrar expedientes ni enviar información real sin autorización.

Explicado fácil: un control en el recorrido

  1. Acción propuesta
  2. Control previo
  3. Pasa o se detiene
  4. Si pasa, se ejecuta
  5. Revisión posterior

Piensa en un puesto de control situado en una puerta concreta. Su alcance depende del paso elegido: no vigila todas las entradas del edificio. En el agente ocurre algo parecido. Elegir el momento y la operación que se examina forma parte de configurar el hook; el nombre por sí solo no dice qué protege.

Los momentos de un hook en Claude Code

Al comenzar la sesión

Qué permite: Aportar información para arrancar el trabajo.

Qué no demuestra: Que el resultado final sea correcto.

Antes de una herramienta

Qué permite: Permitir, preguntar o denegar según la comprobación.

Qué no demuestra: Que cubra operaciones fuera de lo configurado.

Después de una herramienta

Qué permite: Revisar el archivo o el resultado.

Qué no demuestra: Que se haya impedido la acción anterior.

Al acabar una respuesta

Qué permite: Comprobar si quedan pendientes.

Qué no demuestra: Que haya terminado todo el encargo.

Cuando hay un aviso

Qué permite: Llamar la atención de la persona.

Qué no demuestra: Que esa persona haya aprobado algo.

**Los nombres cambian por producto**. Estos momentos corresponden a Claude Code. Al configurar otra herramienta, comprueba qué evento ofrece, es decir, qué suceso activa la acción, y qué decisiones admite en ese punto. No traslades una configuración solo porque en ambos programas aparezca la palabra hook. Fuente: code.claude.com · Consultado el Invalid Date

No lo confundas con

Instrucciones

Aportan el criterio escrito del proyecto. Son contexto persistente que el agente consulta; no configuran por sí mismas un control ejecutable. Qué son las instrucciones del proyecto.

Webhook

Lleva un aviso entre aplicaciones cuando ocurre algo y puede iniciar un proceso. El hook de este artículo interviene en el trabajo del agente. Qué es un webhook.

Por qué te importa: automatizar no elimina el juicio

Un hook puede lanzar un script, un pequeño programa, o pedir una comprobación a otro modelo de IA. Que la comprobación se active sola no garantiza que su decisión sea correcta. Si el control aplica una condición definida, revisa esa condición. Si pide al modelo que valore si un documento está bien, también debes valorar cómo puede equivocarse esa revisión. Para tu negocio son preguntas distintas: si la comprobación se ha ejecutado y si su respuesta merece confianza. Que aparezca una señal favorable solo responde a lo que ese control ha comprobado.

Además, los hooks que ejecutan órdenes en Claude Code trabajan con los permisos de tu usuario y pueden acceder a tus archivos. Revisa su contenido y quién los ha preparado antes de activarlos. Un mecanismo pensado para vigilar al agente también ejecuta trabajo en tu nombre. No lo trates como una barrera completa entre el programa y el ordenador: los permisos y el aislamiento, que limita el espacio al que puede acceder un proceso, cumplen otras funciones. Tienes más contexto en los permisos de un agente.

Cómo preparar una prueba pequeña

  1. Delimita la operación

    Escribe qué debe ocurrir y qué debe evitarse. En la gestoría, concreta la carpeta de muestra y los intentos de borrado que quieres detener. Trabaja con esa copia. Pide a quien configure el hook que explique su alcance en esas mismas palabras. Una petición como «que cuide los archivos» deja abierta la decisión que necesitas tomar antes: qué acciones puede realizar el agente y cuáles deben pasar por un control.

  2. Comprueba los caminos

    Pregunta por las operaciones que detecta el filtro, la condición que selecciona cuándo interviene el hook. Un agente puede cambiar un archivo con una herramienta de edición o mediante una orden en la terminal, la ventana donde se ejecutan comandos. Un filtro preparado solo para las herramientas de edición puede dejar fuera ese segundo camino. Pide que la prueba incluya las formas de trabajar que realmente va a usar el agente, también las que no aparecen en la demostración inicial.

  3. Ensaya el fallo del control

    Decide qué pasa si falla el propio hook. Prueba una operación permitida, otra rechazada y un fallo de la comprobación. En Claude Code, algunos fallos dejan continuar. Existe una opción para detener ante fallos en eventos compatibles, pero no se aplica a los hooks que se ejecutan en segundo plano. Pide que te muestren qué ocurre con la configuración elegida y acuerda quién revisará la incidencia antes de reanudar el trabajo.

  4. Revisa el resultado completo

    Compara lo esperado con lo ocurrido en la copia de prueba. Mira el archivo, el motivo que muestra el control y el punto donde se ha detenido o continuado el agente. Si una comprobación posterior detecta una discrepancia en un informe, corresponde a una persona decidir la corrección y la versión que se enviará. Conserva los casos de prueba para repetirlos cuando cambie la configuración. No pases del ensayo a expedientes reales solo porque el aviso se haya mostrado correctamente.

El error típico: confundir una pieza con toda la protección

La decisión favorable del hook sigue sujeta a las reglas de permisos de Claude Code, incluidas las denegaciones. Revisa el control junto con los accesos del agente y prueba qué ocurre cuando falla la comprobación. En Claude Code a fondo puedes practicar avisos, bloqueos y comprobaciones.

Dudas sobre hooks, respuestas cortas

¿Un hook es una instrucción que el agente recuerda?

No. El hook enlaza una acción con un evento del trabajo del agente. Las instrucciones del proyecto aportan contexto persistente y explican el criterio. Se complementan, pero escribir una norma no configura automáticamente una comprobación ejecutable ni los permisos de las herramientas.

¿Un hook puede impedir que se borre un archivo?

Puede, si interviene antes del borrado y está preparado para denegar esa operación. Hay que probar el evento, el filtro y los caminos de acceso al archivo. Una comprobación posterior puede comunicar el problema, pero llega cuando la acción ya se ha ejecutado y no la revierte.

¿Si aparece un aviso significa que he aprobado la acción?

No. Un aviso no equivale a una aprobación. El aviso llama tu atención; la aprobación requiere la decisión correspondiente. También conviene distinguir el final de una respuesta del final del encargo: en Claude Code, un hook al acabar la respuesta no demuestra que todo el trabajo esté terminado.

¿Todos los hooks son programas de terminal?

No. En Claude Code pueden activar distintas formas de comprobación, como un pequeño programa, una petición a otro servicio o una evaluación con un modelo. Lo que los une es la acción asociada a un evento. Si interviene un modelo, su juicio también puede equivocarse.

Fuentes

Fuentes oficiales, consultadas el 4 de noviembre de 2026

  1. Anthropic · Guía de hooks
  2. Anthropic · Referencia de hooks
  3. Anthropic · Instrucciones, skills y otras extensiones
  4. Anthropic · Configuración de permisos
  5. n8n · Entrada de avisos mediante webhook

Cómo lo comprobamos. Ciade utiliza Claude y Claude Code a diario desde España. El curso incluye prácticas de aviso, bloqueo y comprobación. No se han ejecutado los controles descritos ni medido sus resultados en una empresa. Antes de aplicarlos, comprueba su cobertura y su comportamiento ante fallos en tu configuración.

Qué ha cambiado.

  • 4 de noviembre de 2026: Reescritura v2: gestoría de Zaragoza, momentos de intervención y límites de las comprobaciones previas y posteriores.

Términos relacionados

Aprende a usar la IA en tu trabajo, con criterio.

El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.

El canal de Telegram de Ciade

El lunes, una palabra del glosario. El miércoles, un consejo práctico. El viernes, las noticias de IA de la semana. Y el martes, el boletín.

Unirme al canal

Tú decides qué medimos

Las cookies técnicas hacen que la web funcione. Con tu permiso, además, medimos las visitas con Ahrefs y de qué campaña llegas, y Meta mide nuestros anuncios y puede mostrarte los de Ciade en Facebook e Instagram. Puedes cambiarlo cuando quieras en «Configurar cookies», al pie de la página. Política de cookies