Claude Code Hooks

Los Claude Code Hooks, Visualizados.

Los Claude Code hooks te permiten ejecutar comandos shell deterministas en cada evento clave del ciclo de vida de Claude Code: antes de usar una herramienta, después de usar una herramienta, cuando se envía un prompt, cuando un agente se detiene, o cuando se envía una notificación. AgentsRoom es el centro de comando visual que te permite ver cada hook dispararse en tiempo real, a través de decenas de agentes Claude Code, en decenas de proyectos.

Los hooks son la forma oficial de Anthropic de añadir automatización determinista, barreras de protección, pistas de auditoría y efectos secundarios personalizados a Claude Code. AgentsRoom no reemplaza tus hooks. Ejecuta el CLI real de Claude Code, así que cada hook que configures en .claude/settings.json sigue funcionando exactamente como estaba previsto. Lo que AgentsRoom añade es visibilidad: un panel en vivo donde puedes ver cada disparo de hook, por agente, por proyecto, por ejecución.

¿Qué son los Claude Code hooks?

Los Claude Code hooks son comandos shell definidos por el usuario que Claude Code ejecuta automáticamente en puntos específicos durante una sesión de agente. Se configuran en .claude/settings.json (compartido, commiteado en git) o .claude/settings.local.json (personal, ignorado por git), y te dan control determinista sobre el comportamiento de tus agentes Claude Code. Donde un prompt es probabilístico, un hook es 100% determinista: se ejecuta cada vez que el evento correspondiente se dispara, sin excepciones.

Los hooks son la respuesta de Anthropic a la necesidad de barreras de protección, automatización, telemetría, logging de auditoría e integraciones personalizadas. Puedes usar los Claude Code hooks para formatear código automáticamente después de cada edición, bloquear comandos peligrosos antes de que se ejecuten, registrar cada llamada de herramienta en un archivo, enviar una notificación de escritorio cuando el agente esté esperando entrada, disparar un job de CI cuando termine una sesión, o transmitir cada prompt a un backend de observabilidad. Cualquier comando shell que puedas escribir, puedes conectarlo a un Claude Code hook.

Como los hooks viven en el propio proyecto (.claude/settings.json está commiteado en git), viajan con tu codebase. Cada desarrollador del equipo, y cada agente IA generado desde ese proyecto, hereda la misma red de seguridad. AgentsRoom respeta este modelo de principio a fin: la app de escritorio no reescribe tus hooks, ejecuta el CLI real de Claude Code como un proceso hijo, que recoge automáticamente tu configuración de hooks, exactamente como si ejecutaras claude code desde una terminal.

Los 6 Eventos de Claude Code Hooks

Cada sesión de agente Claude Code dispara eventos de hook en puntos bien definidos. Esto es lo que significa cada evento y lo que puedes hacer con él.

PreToolUse

El hook PreToolUse se dispara antes de que Claude Code ejecute cualquier herramienta (Bash, Edit, Write, Read, Grep, etc.). Es el lugar perfecto para barreras de protección: bloquear comandos peligrosos, exigir confirmación para operaciones destructivas, imponer reglas específicas del proyecto o reescribir argumentos de herramienta antes de la ejecución. Devuelve un código de salida distinto de cero desde el hook para bloquear la llamada de herramienta por completo. PreToolUse es el Claude Code hook número 1 para equipos preocupados por la seguridad.

PostToolUse

El hook PostToolUse se dispara inmediatamente después de que cualquier herramienta Claude Code se complete. Aquí es donde conectas el post-procesamiento automático: ejecutar un formateador (Prettier, Black, rustfmt) después de cada Edit, disparar un linter después de cada Write, actualizar un changelog cuando se modifica un archivo, o enviar eventos de telemetría. PostToolUse es el hook imprescindible para convertir Claude Code en un miembro del equipo disciplinado que deja el código más limpio de lo que lo encontró.

UserPromptSubmit

El hook UserPromptSubmit se dispara siempre que se envía un nuevo prompt a un agente Claude Code. Úsalo para registrar cada prompt con fines de auditoría y cumplimiento, reescribir prompts al vuelo (inyectar contexto, redactar secretos), enrutar peticiones a diferentes modelos, o imponer convenciones de nombres. Combinado con el panel multi-agente de AgentsRoom, UserPromptSubmit te da una pista de auditoría completa de cada instrucción enviada a cada agente Claude Code.

Stop

El hook Stop se dispara cuando una sesión de agente Claude Code termina, ya sea porque el trabajo está hecho o porque fue cancelada. Es el lugar adecuado para ejecutar tareas de limpieza, enviar un resumen final a un sistema de seguimiento, commitear artefactos o notificar a un humano que la sesión ha terminado. AgentsRoom complementa el hook Stop con su propio sistema de notificaciones, de modo que recibes notificaciones tanto por tu hook personalizado como por las notificaciones push de escritorio + móvil de AgentsRoom.

Notification

El hook Notification se dispara cuando Claude Code envía una notificación del sistema — típicamente cuando el agente está esperando entrada del usuario o ha terminado una tarea larga. Úsalo para enrutar notificaciones a Slack, Discord, Telegram, email, o cualquier webhook que quieras. AgentsRoom ya expone las notificaciones de Claude Code de forma nativa en su panel multi-agente y como notificaciones push en tu teléfono, así que el hook Notification es el lugar perfecto para añadir integraciones personalizadas por encima.

SubagentStop

El hook SubagentStop se dispara cuando un subagente Claude Code termina su trabajo y devuelve el control al padre. Si usas Claude Code subagents definidos en .claude/agents/*.md para delegar tareas especializadas, SubagentStop te permite registrar lo que hizo cada subagente, agregar sus salidas o disparar un paso de seguimiento. Dentro de AgentsRoom, los eventos SubagentStop aparecen en la línea temporal de agentes en vivo para que puedas ver exactamente qué subagentes se ejecutaron dentro de cada sesión Claude Code.

Por Qué Importan los Claude Code Hooks

Los hooks convierten Claude Code de una IA impresionante en un agente de código de calidad de producción en el que todo tu equipo puede confiar.

Barreras de Seguridad Deterministas

Los prompts son probabilísticos y pueden ser burlados. Los Claude Code hooks son comandos shell deterministas que siempre se ejecutan. Un hook PreToolUse puede bloquear cualquier rm -rf, cualquier push --force, cualquier migración destructiva — sin importar cómo el agente formule su razonamiento. Este es el estándar de oro para despliegues Claude Code críticos en seguridad.

Automatización Sin Esfuerzo

Conecta los Claude Code hooks a tus formateadores, linters, ejecutores de tests, verificadores de tipos y scripts de build. Cada edición que hace el agente dispara las mismas comprobaciones que ejecuta tu pipeline de CI — localmente, instantáneamente, automáticamente. Tus agentes Claude Code se convierten en contribuidores autodisciplinados que nunca olvidan ejecutar el formateador.

Pista de Auditoría Completa

Cada prompt, cada llamada de herramienta, cada inicio y parada de sesión puede ser registrado por los Claude Code hooks. Combina eso con la línea temporal visual de AgentsRoom y obtendrás una pista de auditoría completa de cada acción de agente IA de código — esencial para equipos con fuertes requisitos de cumplimiento, empresas preocupadas por la seguridad, y cualquiera que se tome en serio el desarrollo IA observable.

Convenciones a Nivel de Equipo

Como .claude/settings.json está commiteado en git, un único conjunto de Claude Code hooks impone las mismas convenciones a cada desarrollador del equipo y a cada agente IA generado desde el proyecto. Los nuevos miembros del equipo heredan las barreras de protección en el momento en que clonan el repositorio. Actualiza el comportamiento de todo tu equipo de código IA con una sola pull request.

Observabilidad de Hooks en Vivo

Los Claude Code hooks producen eventos. AgentsRoom convierte esos eventos en un feed visual: cada disparo de hook, cada llamada de herramienta, cada cambio de estado, transmitido en vivo por agente y por proyecto. Ya no tienes que vigilar logs — ves a tu flota Claude Code trabajar en tiempo real.

Pasa de Vigilar a Supervisar

Sin hooks, ejecutar Claude Code significa vigilar cada llamada de herramienta. Con hooks, delegas la vigilancia a código determinista y supervisas a nivel de excepciones. AgentsRoom amplifica esto: ves a todos tus agentes Claude Code protegidos por hooks a la vez, y solo intervienes cuando algo exige tu atención.

Claude Code Hooks + AgentsRoom

AgentsRoom es el centro de comando visual para Claude Code y otros CLIs de código IA. No forkea Claude Code, no reimplementa hooks, no intercepta llamadas de herramienta. Ejecuta el CLI real de Claude Code como un proceso hijo dentro de una terminal xterm.js completa, lo que significa que cada hook que definiste en .claude/settings.json o .claude/settings.local.json se ejecuta exactamente como Anthropic lo diseñó — sin compromisos, sin sorpresas, sin middleware invisible.

Lo que AgentsRoom añade es escala y visibilidad. Puedes ejecutar decenas de agentes Claude Code en paralelo, a través de decenas de proyectos, cada uno con su propia configuración de hooks, y ver cada disparo de hook en un solo panel. Combinados con las notificaciones por agente, la app compañera móvil y el seguimiento de estado en tiempo real de AgentsRoom, los Claude Code hooks se convierten en una capa de observabilidad de primera clase para toda tu operación de código IA.

Ejecuta el CLI Real de Claude Code

AgentsRoom lanza procesos reales de claude CLI dentro de terminales xterm.js completas. Cualquier hook configurado en .claude/settings.json, .claude/settings.local.json o en la configuración a nivel de usuario se dispara automáticamente, exactamente como si ejecutaras Claude Code desde tu terminal. Sin parches, sin reescrituras, sin pérdida de fidelidad.

Eventos de Hook en una Flota Multi-Agente

Ejecuta 10, 20, 50 agentes Claude Code en paralelo con los hooks habilitados. El panel multi-agente de AgentsRoom expone simultáneamente las notificaciones disparadas por hook y los cambios de estado para cada agente. Tus barreras PreToolUse, tus formateadores PostToolUse y tus handlers Stop operan todos a escala de flota.

Visibilidad de Hooks Entre Proyectos

Cada proyecto en AgentsRoom tiene su propio .claude/settings.json y por lo tanto su propia configuración de Claude Code hooks. La barra lateral agrega el estado en vivo entre proyectos para que puedas detectar qué hooks se están disparando dónde, qué agentes están bloqueados esperando entrada del usuario, y qué hooks Stop acaban de completar una ejecución.

Notificaciones de Escritorio + Móvil

AgentsRoom viene con notificaciones nativas de macOS y notificaciones push móviles cifradas de extremo a extremo. El hook Notification, el hook Stop y el hook SubagentStop de Claude Code producen señales que AgentsRoom expone directamente en tu escritorio y tu teléfono. Puedes alejarte del ordenador y aún así saber cuándo un hook te dice que vuelvas.

FAQ Claude Code Hooks

¿Qué son los Claude Code hooks, en una frase?+
Los Claude Code hooks son comandos shell definidos por el usuario que Claude Code ejecuta automáticamente en eventos específicos del ciclo de vida (PreToolUse, PostToolUse, UserPromptSubmit, Stop, Notification, SubagentStop), dándote control determinista sobre el comportamiento de tus agentes IA de código.
¿Dónde se configuran los Claude Code hooks?+
Los Claude Code hooks viven en .claude/settings.json (commiteado en git, compartido con el equipo) o .claude/settings.local.json (ignorado por git, personal). Ambos archivos son recogidos automáticamente por el CLI de Claude Code. AgentsRoom ejecuta el CLI real de Claude Code, así que respeta ambos archivos sin ninguna configuración adicional.
¿AgentsRoom reemplaza los Claude Code hooks?+
No. AgentsRoom no reemplaza, reescribe ni intercepta los Claude Code hooks. Ejecuta el CLI real de Claude Code como un proceso hijo, lo que significa que tus hooks siguen ejecutándose exactamente como Anthropic los diseñó. El rol de AgentsRoom es darte un centro de comando visual y un panel multi-agente encima de las sesiones Claude Code impulsadas por hooks.
¿Puedo monitorizar los eventos de Claude Code hooks en AgentsRoom?+
Sí. AgentsRoom transmite la salida de cada sesión Claude Code en vivo, incluidos los eventos disparados por hooks (salida del formateador, rechazos de barreras, mensajes de notificación, paradas de subagentes). El panel multi-agente agrega el estado de cada agente en ejecución, para que puedas detectar de un vistazo qué hooks se dispararon dónde.
¿Cuál es el Claude Code hook más útil para empezar?+
Para la mayoría de los equipos, PostToolUse es el hook de mayor valor inicial: conéctalo a tu formateador y linter para que cada Edit se limpie al instante. Para proyectos críticos en seguridad, PreToolUse es indispensable: bloquea comandos Bash destructivos antes de que el agente los ejecute. Una vez que esos están en su sitio, añade UserPromptSubmit para el logging de auditoría y Stop para la telemetría de finalización.
¿Es AgentsRoom gratuito para usar con los Claude Code hooks?+
Sí. AgentsRoom es gratuito de descargar y usar con hasta 3 proyectos. Trae tu propia suscripción Anthropic o clave API. Cada hook, cada barrera PreToolUse, cada formateador PostToolUse que hayas configurado en .claude/settings.json funcionará inmediatamente — sin configuración extra, sin comisiones extra.

Mira Tus Claude Code Hooks Dispararse en Vivo

Descarga AgentsRoom, abre un proyecto con hooks en .claude/settings.json, lanza un agente Claude Code, y mira cada evento de hook llegar al panel en tiempo real.

GratisDescargar AgentsRoom

App complementaria: supervisa tus agentes en movimiento

Compatible con Claude, Codex, OpenCode, Gemini CLI y Aider

Multi-proyectos
Multi-proveedor
Multi-agentes
Estado en vivo
Diff y commit
App móvil
Vista previa