Revisada el 2026-10-10
En una frase: un hook es un programa tuyo que salta en un momento fijo.
Funciona en Claude Code, una IA de Anthropic. Trabaja con los archivos de un proyecto.
Una instrucción escrita es una petición que la IA puede olvidar. Un hook salta en su momento, sin depender de que la IA se acuerde. Eso sí, tiene que estar activo, encajar con su filtro y terminar sin fallos.
Tema avanzado
Para usar hooks hay que programar un poco. Aquí tienes la idea; el detalle está en la versión adulta, enlazada al final.
Cómo se ve
Qué necesitas
- Claude Code instalado.
- Un programa corto, llamado script, que sepa leer los datos que le llegan.
- Cuidado: el hook funciona con todos tus permisos. Puede leer, cambiar o borrar lo mismo que tú. Revísalo y pruébalo antes de activarlo.
Qué pasa, paso a paso
- Eliges el momento en que salta. Abajo tienes los más útiles.
- Eliges dónde guardarlo: para todos tus proyectos o solo para uno. Los hooks de todos los sitios se suman.
- En un archivo de ajustes escribes qué momento lo dispara y qué programa corre.
- Cuando salta, el programa recibe datos: la carpeta, el momento y, a veces, la herramienta.
- El programa responde: todo bien, bloquear la acción o dejar un mensaje.
- Lo compruebas con una orden que lista los hooks. Y lo pruebas a mano, con datos de ejemplo.
Es como el timbre del instituto. Suena a su hora, aunque nadie mire el reloj.
Los momentos más útiles
- Al empezar o reanudar la sesión, o al vaciar o resumir la conversación. Sirve para cargar información que cambia.
- Al enviar un mensaje, antes de que Claude lo lea. Puede añadir contexto o bloquearlo.
- Antes de usar una herramienta. Puede impedir que se use.
- Después de usar una herramienta con éxito. Por ejemplo, para dar formato al código.
- Cuando Claude termina de responder. Puede pedirle que siga.
- Cuando Claude Code te avisa, por ejemplo porque espera tu permiso.
Cómo responde el programa
El programa contesta con un número o con un mensaje. Un número dice si todo va bien o si hay que frenar. Qué pasa al frenar depende del momento:
- Antes de una herramienta, la bloquea. Le puede explicar el motivo a Claude.
- Al enviar un mensaje, lo rechaza.
- Después de una herramienta, ya no puede deshacer lo hecho.
- Al empezar la sesión o al avisarte, no bloquea nada.
Si el programa falla de otra forma, lo normal es que la acción siga. Hay ajustes para bloquear también ante un fallo; están en la versión adulta.
Al empezar o al enviar un mensaje, lo que escribe le llega a Claude. También puede dejar dos mensajes: uno para ti y otro para Claude. El de Claude solo funciona en los momentos que lo admiten.
Un ejemplo oficial: un hook que, en un Mac, te avisa cuando Claude te necesita. Si ya tienes otros hooks, añade el nuevo a su lado sin borrar los demás. El código está en la versión adulta.
Un ejemplo de la vida real
Imagina a alguien que programa con Claude Code y usa tres hooks:
- Uno salta después de que Claude cambie un archivo. Le da formato al código.
- Otro salta antes de usar una herramienta. Si va a tocar una carpeta protegida, la bloquea.
- Otro salta cuando Claude espera tu permiso. Te avisa con una notificación.
Si el hook de formato falla, lo normal es que el trabajo siga. Por eso conviene probar cada hook a mano.
Errores que se repiten
- Un texto que se cuela antes de la respuesta del programa. Entonces Claude Code no la entiende.
- Poner el mensaje para Claude en el sitio equivocado. Se ignora sin avisar.
- Hooks lentos al enviar mensajes: frenan cada mensaje. Si tardan demasiado, lo que devuelven se descarta.
- En un modo automático, Claude Code no pregunta si te fías de la carpeta. Con un proyecto ajeno, sus hooks se ejecutan sin preguntar.
- Datos variables sin comillas o rutas incompletas. Mejor con comillas y rutas completas.
Pruébalo tú
- Quieres impedir que Claude use cierta herramienta. ¿En qué momento pondrías el hook?
- ¿Por qué hay que revisar un hook antes de activarlo?
Respuestas
- Antes de usar la herramienta. En ese momento, el hook puede bloquearla.
- Porque funciona con todos tus permisos. Puede leer, cambiar o borrar lo mismo que tú.
Palabras clave
- Hook: programa que salta ante un evento de la sesión.
- Script: programa corto que hace una tarea concreta.
- Evento: momento de la sesión que dispara un hook, como enviar un mensaje.
- Archivo de ajustes: archivo donde se apunta qué hook salta y cuándo.
- Ruta: la dirección de un archivo dentro del ordenador.