Guía
Los hooks de Claude Code, explicados: qué son y qué puedes construir con ellos
Respuesta corta: Los hooks permiten que Claude Code ejecute tu comando cuando arranca una herramienta, pide permiso o termina un turno. Cómo funcionan y cómo los usa Herdbell.
Un hook es un pequeño comando que un agente ejecuta en un momento determinado. Claude Code, Codex y Cursor los admiten de alguna forma, y son la manera limpia de que otro programa siga lo que hace un agente sin iniciar sesión en nada ni leer la pantalla.
La idea en un párrafo
Le dices al agente: cuando pase esto, ejecuta este comando. El agente lo ejecuta y le entrega una breve descripción del evento. El comando puede limitarse a registrarlo (para enviar una notificación, por ejemplo) o, en algunos eventos, devolver una respuesta que el agente usa.
Momentos en los que puedes engancharte
Los nombres exactos de eventos y los ajustes varían entre agentes y versiones, así que consulta la documentación de cada agente antes de escribir el tuyo.
- Una sesión empieza o termina, o envías un prompt.
- Una herramienta está a punto de ejecutarse o acaba de hacerlo.
- El agente pide permiso para hacer algo.
- El agente termina su turno (un evento Stop).
Dónde viven
En un archivo de ajustes: para Claude Code es ~/.claude/settings.json, para Codex ~/.codex/hooks.json y para Cursor ~/.cursor/hooks.json. Editar estos archivos a mano está bien, y también es como se conecta una herramienta como Herdbell.
Cómo los usa Herdbell
- Al conectar, Herdbell hace una copia del archivo y luego añade su propio comando pequeño para los eventos que necesita.
- En la mayoría de los eventos solo escucha, para poder mostrar lo que hace el agente.
- En una solicitud de permiso espera tu respuesta y la devuelve, así que Allow y Deny surten efecto. Al final de un turno puede mantener abierto al agente para que tu respuesta vuelva al mismo chat.
- Si no respondes a tiempo, se aparta y el agente vuelve a su propio aviso. Desconectar solo elimina los hooks de Herdbell.
Preguntas frecuentes
¿Los hooks necesitan una clave de API o iniciar sesión?
No. Un hook es un comando local en tu Mac. Herdbell los usa para no tener que iniciar sesión en un agente ni llamar a un modelo de IA.
¿Puede un hook estropear mi agente?
Uno mal escrito puede ralentizarlo o confundirlo, por eso Herdbell primero hace una copia de tus ajustes, mantiene sus hooks pequeños y se aparta cuando no respondes. Puedes desconectarlo en cualquier momento.