En el desarrollo asistido por inteligencia artificial hay una frustración que se repite con demasiada frecuencia: el modelo entiende lo que se le pide, pero no siempre actúa igual de bien cuando llega el momento de ejecutar tareas concretas. Puede respetar el estilo del proyecto durante un rato, olvidarse después de pasar el formateador, tocar un archivo delicado por error o dar por buena una tarea con tests rotos. Esa irregularidad ha hecho que muchos equipos descubran un límite práctico de los archivos de instrucciones como CLAUDE.md: ayudan a orientar el comportamiento, pero no garantizan cumplimiento estricto. La propia documentación de Claude Code lo deja claro al explicar que el contenido de CLAUDE.md se inyecta como un mensaje de usuario después del prompt del sistema, por lo que Claude intenta seguirlo, pero no existe garantía absoluta, sobre todo si las instrucciones son ambiguas o entran en conflicto.
Ahí es donde entran los hooks, una de las funciones más interesantes y también más infravaloradas de Claude Code. Anthropic los define como acciones automáticas que se ejecutan en puntos concretos del ciclo de vida de la herramienta. En otras palabras, ya no se trata de “pedirle” a la IA que haga algo, sino de fijar reglas ejecutables que corren siempre cuando se dispara un evento determinado. La idea ha ganado tracción en las últimas semanas entre usuarios avanzados de Claude Code porque resuelve un problema muy real: pasar de instrucciones deseables a automatismos verificables.
La simplificación más habitual consiste en hablar de dos grandes momentos. Por un lado, PreToolUse, que se ejecuta antes de que Claude lance una herramienta y puede bloquear una acción. Por otro, PostToolUse, que se activa después de una ejecución correcta y sirve para tareas como formatear, lanzar comprobaciones o dejar trazabilidad. Esa lectura es útil para entender el concepto, aunque la documentación oficial va bastante más allá y recoge una lista amplia de eventos, entre ellos SessionStart, UserPromptSubmit, PermissionRequest, InstructionsLoaded, Stop, TaskCompleted, FileChanged o WorktreeCreate. Es decir, el sistema de hooks no está pensado solo para limpiar código, sino para modelar el comportamiento operativo de Claude Code de una forma bastante más profunda.
De las sugerencias a las reglas que sí se ejecutan
La diferencia técnica importa más de lo que parece. Un archivo CLAUDE.md puede decir “usa Prettier siempre”, “no toques .env” o “ejecuta tests antes de terminar”, pero todo eso sigue dependiendo de que el modelo recuerde la instrucción, la interprete bien y decida obedecerla en cada contexto. Con hooks, en cambio, la lógica se ejecuta fuera del razonamiento probabilístico del modelo. Si un evento coincide con el matcher definido en la configuración, el hook corre. Y si devuelve un bloqueo, la acción no sigue adelante. Anthropic explica además que los hooks pueden ser comandos de shell, endpoints HTTP, prompts o incluso agentes, lo que amplía bastante el margen de automatización para equipos que quieren reforzar políticas internas o procesos de calidad.
Este es el motivo por el que se está hablando tanto de configuraciones que encadenan autoformato, lint, tests, protección de archivos y auditoría. No es magia ni “vibe coding” sin control. Es una capa de automatización que intenta domesticar el comportamiento de un agente con acceso a terminal, lectura y edición de archivos, git y herramientas externas. En la práctica, es también una respuesta al temor que generan los agentes demasiado autónomos cuando se les deja operar sobre repositorios reales. Claude Code, según su propia documentación, puede leer el proyecto, ejecutar comandos y trabajar sobre el estado de git. Precisamente por eso, la posibilidad de imponer límites automáticos se vuelve especialmente relevante.
Los ocho hooks que mejor explican la tendencia
La lista que más se está compartiendo entre desarrolladores resume bastante bien el tipo de automatización que hoy se considera útil en Claude Code. El primer grupo busca higiene básica del repositorio: ejecutar Prettier después de cada edición y lanzar ESLint automáticamente para que los cambios queden formateados y limpios antes incluso de pasar por revisión. La propia guía oficial de Anthropic usa el autoformato tras ediciones como uno de los ejemplos más claros de uso.
El segundo grupo está centrado en seguridad y control. Aquí entran los hooks que bloquean comandos destructivos antes de ejecutarse, los que impiden modificar ficheros sensibles como .env, claves o secretos, y los que registran cada comando con marca temporal para crear un historial de auditoría. En un entorno donde el agente puede usar Bash, esta categoría no es un capricho: es una red de seguridad. La documentación oficial señala que PreToolUse puede bloquear llamadas a herramientas, mientras que InstructionsLoaded y otros eventos también pueden aprovecharse con fines de observabilidad y trazabilidad.
El tercer bloque apunta a calidad de entrega. Aquí aparecen los hooks que ejecutan tests de forma automática tras cambios relevantes, los que impiden crear una pull request si la suite falla y los que usan el evento Stop para evitar que Claude cierre una tarea sin pasar antes por ciertas comprobaciones. Este punto merece un matiz interesante: en Claude Code, Stop no es simplemente una señal de salida pasiva. La referencia oficial explica que ese evento puede bloquear la parada del agente y obligarle a continuar si el hook así lo decide. Dicho de otra forma, un equipo puede convertir el final de una tarea en una especie de “puerta de control” donde se verifica si realmente se ha terminado bien.
El último gancho de la lista es el auto-commit al terminar cada tarea. Es, probablemente, el más discutible desde el punto de vista operativo. Puede resultar útil para mantener cambios atómicos y evitar que varias tareas queden mezcladas en un único commit, pero también introduce riesgos si se usa sin criterio, por ejemplo en ramas compartidas o sin una convención clara de mensajes y validaciones previas. Anthropic no lo presenta como una práctica recomendada universal, aunque sí documenta el evento Stop y otros mecanismos que permiten construir este tipo de flujos. Como ocurre con muchas automatizaciones, el valor no está tanto en copiar una receta como en adaptar la lógica al nivel de madurez del equipo.
Una función pequeña que apunta a un cambio mayor
Lo realmente interesante de esta tendencia es que refleja un cambio de mentalidad en el uso de agentes para programar. Durante meses, la conversación giró alrededor de prompts mejores, archivos de contexto más largos o trucos para que el modelo “se portara bien”. Los hooks desplazan el debate hacia otro lugar: qué partes del proceso conviene sacar del terreno probabilístico para convertirlas en reglas duras, repetibles y auditables. La propia documentación de mejores prácticas de Claude Code lo resume con una frase bastante directa: los hooks son para acciones que deben ocurrir siempre, sin excepciones.
Eso no convierte a Claude Code en un sistema infalible ni elimina la necesidad de revisión humana. Pero sí marca un paso importante hacia flujos de trabajo más profesionales. En vez de confiar ciegamente en que el agente recuerde todas las normas del proyecto, los equipos pueden decidir qué comportamientos se negocian con el modelo y cuáles se fuerzan con código. En un momento en que los asistentes de programación avanzan hacia modos cada vez más autónomos, esa distinción empieza a ser decisiva. Porque el verdadero salto no está solo en que la IA escriba código, sino en que pueda hacerlo dentro de límites claros, trazables y razonablemente seguros.
Preguntas frecuentes
¿Qué diferencia hay entre CLAUDE.md y los hooks en Claude Code?CLAUDE.md sirve para dar instrucciones persistentes y contexto al modelo, pero no garantiza cumplimiento estricto. Los hooks, en cambio, ejecutan acciones automáticas en eventos concretos y permiten bloquear, validar o registrar comportamientos.
¿Qué hooks son los más útiles para empezar en Claude Code?
Los más habituales para empezar son el autoformato tras editar archivos, el bloqueo de comandos peligrosos en Bash y la protección de archivos sensibles. Son los que más reducen errores básicos con una configuración relativamente simple.
¿Se pueden bloquear acciones de Claude Code antes de que ocurran?
Sí. El evento PreToolUse está diseñado precisamente para actuar antes de que una herramienta se ejecute, y puede impedir la acción según la lógica del hook. También pueden bloquearse otros eventos como ciertas solicitudes de permisos o incluso la finalización de una tarea.
¿Dónde se configuran los hooks de Claude Code para compartirlos con un equipo?
Anthropic indica que la ubicación habitual para compartir configuración a nivel de proyecto es .claude/settings.json. También existen ~/.claude/settings.json para ajustes personales y .claude/settings.local.json para configuración local no compartida.
