Hooks en Claude Code: lo que no puede fallar
Los hooks de Claude Code se ejecutan siempre, en un momento fijo, sin depender de que Claude se acuerde. Lo que no puede fallar va en un hook.
Escribes en tu CLAUDE.md "no toques la carpeta Contratos firmados" y casi siempre funciona. Casi. Para lo que no puede fallar ni una vez, Claude Code tiene otra herramienta: los hooks.
Es el día 26 de #30DaysOfClaude; el resto de tips está en el índice de la serie.
Hooks en Claude Code: una regla, no un consejo
La guía de buenas prácticas de Claude Code lo explica en una frase: las instrucciones del CLAUDE.md orientan, y los hooks son deterministas y garantizan que la acción ocurre. La página de memoria va más allá: Claude trata el CLAUDE.md como contexto, no como configuración obligatoria, y para bloquear una acción decida lo que decida Claude, recomienda un hook.
Un hook se ejecuta solo, en un momento fijo del trabajo de Claude: antes de usar una herramienta (editar un archivo, enviar un correo), después de usarla, cuando espera tu respuesta o al terminar.
Cómo crear un hook sin programar
No hace falta escribir nada técnico. La propia documentación propone pedírselo a Claude. Tres para empezar:
Crea un hook que impida editar nada en la carpeta Contratos firmados.
Crea un hook que me pida confirmación antes de enviar cualquier correo.
Crea un hook que apunte en un registro cada archivo que modifiques.
Cuando un hook bloquea algo, Claude recibe el motivo y busca otra forma de hacerlo. Y cuando pide confirmación, te pregunta a ti antes de seguir, incluso si tienes Claude en modo automático. Para ver los que tienes, escribe /hooks.
Tu paso para hoy: busca en tu CLAUDE.md la regla que más te dolería que Claude se saltara. Pídele que la convierta en un hook.
Cuándo no usar un hook
- Si la regla necesita criterio. "Usa un tono cercano con clientes nuevos" no se comprueba con un sí o un no: eso va en el CLAUDE.md, mejor con su porqué, como contamos en cuántos NUNCA hay en tu CLAUDE.md.
- Si no estás en Claude Code. Los hooks son de Claude Code; en el chat de Claude no existen.
- Si bloquea de más. Un hook demasiado amplio frena trabajo legítimo. Empieza por uno concreto y amplía.
Para el resto de lo que va en el CLAUDE.md, el día 25 iba de eso: CLAUDE.md o skill, ¿Claude lo necesita siempre?. Y la comparación completa está en Skills vs. CLAUDE.md.
¿Qué regla de tu CLAUDE.md convertirías hoy en un hook?
Preguntas frecuentes
¿Qué es un hook en Claude Code?
Una acción que Claude Code ejecuta siempre en un momento fijo: antes de cada cambio en un archivo, cuando Claude espera tu respuesta, al terminar. No depende de que Claude decida hacerlo, así que se cumple cada vez.
¿Por qué Claude no cumple siempre mi CLAUDE.md?
Porque el CLAUDE.md es contexto, no una configuración que se imponga. Claude lo lee y lo intenta seguir, pero la documentación de Claude Code aclara que no hay garantía de cumplimiento estricto, sobre todo con instrucciones vagas o que se contradicen.
¿Necesito saber programar para crear un hook?
No. Puedes pedírselo a Claude con una frase, por ejemplo "crea un hook que impida editar nada en la carpeta Contratos firmados", y él lo escribe y lo configura. Con /hooks ves los que tienes.