Hooks de agente
Los hooks de agente (ganchos) son comandos o scripts definidos por el usuario que un agente de programación ejecuta automáticamente en puntos fijos de su trabajo, como antes de una llamada a una herramienta o después de editar un archivo, para comprobar, bloquear o ampliar lo que hace.
También llamado: hooks
Por Divya Sharma · Comprobado el 15 nov 2026 · Cómo hacemos las reseñas
Las instrucciones de un prompt o de un archivo de instrucciones son sugerencias que el modelo suele seguir. Los hooks son código que se ejecuta siempre, decida lo que decida el modelo. Por eso son el sitio para las reglas que deben cumplirse y para las tareas rutinarias que no quieres que dependan de que el modelo se acuerde.
Cómo funciona
Registras un hook en la configuración del agente asociado a un evento. En Claude Code, los eventos incluyen el inicio de una sesión, el momento en que el usuario envía un prompt, justo antes de que se ejecute una herramienta (PreToolUse), justo después de que termine (PostToolUse) y cuando el agente se detiene. El agente pasa a tu script los detalles del evento, como el nombre de la herramienta y su entrada. El script puede dejar que la acción siga, bloquearla con un motivo que ve el modelo o añadir contexto.
Usos habituales
Ejecutar un formateador o un linter tras cada edición de archivo. Bloquear comandos de shell que borran archivos o tocan secretos. Rechazar ediciones en rutas protegidas. Enviar una notificación de escritorio cuando el agente necesita una respuesta. Registrar cada llamada a herramienta para auditoría.
Hooks frente a permisos
Los permisos de agente son listas de herramientas permitidas y denegadas. Los hooks son programables, así que pueden inspeccionar argumentos y aplicar reglas que una lista no puede expresar. Ambos forman parte del harness de agente.
Límites
Un hook se ejecuta con todo el acceso de tu usuario, así que un script de hook descuidado o malicioso es en sí mismo un riesgo; revisa los hooks de los repositorios compartidos antes de activarlos. La detección de patrones en comandos se puede eludir, así que trata los hooks como una capa junto a un sandbox de agente, no como la única.
Términos relacionados
- Agente de programación
- Un agente de programación (coding agent) es un agente de IA que trabaja directamente sobre el software: lee un código, edita archivos, ejecuta comandos y pruebas, y repite hasta que un cambio funciona, en lugar de limitarse a sugerir código para que una persona lo pegue.
- Harness de agente
- Un harness de agente (arnés de agente) es el software que rodea a un modelo y lo convierte en un agente funcional: el bucle, las herramientas, el system prompt, los permisos, la gestión del contexto y los archivos que se usan para conservar el progreso entre sesiones.
- Permisos de agente
- Los permisos de agente son las reglas que deciden qué herramientas, archivos, comandos, redes y cuentas puede usar un agente de IA, y qué acciones necesitan antes la aprobación de una persona, para que un agente equivocado o manipulado cause un daño limitado.
- Archivo de instrucciones para agentes (AGENTS.md)
- Un archivo de instrucciones para agentes es un archivo Markdown en un repositorio de código, como AGENTS.md o CLAUDE.md, que un agente de programación lee al inicio de una sesión para conocer los comandos, las convenciones y las reglas del proyecto.
- Sandbox de agente
- Un sandbox de agente (entorno aislado) es un entorno separado, como un contenedor, una máquina virtual o una restricción del sistema operativo, en el que un agente de IA ejecuta código y comandos sin poder llegar a archivos, redes o datos fuera de unos límites fijados.