lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio claude-codehookspluginspython

Hookify: define reglas para las herramientas de Claude Code

Convierte una regla de trabajo en avisos o bloqueos que se aplican cuando Claude Code usa herramientas.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: instala el plugin desde su catálogo

Comprueba con python3 --version que tienes Python ≥3.7. En /plugin de Claude Code, confirma que el catálogo oficial está registrado; si falta, regístralo desde la pestaña Marketplaces de /plugin con anthropics/claude-plugins-official. Después localiza Hookify e instálalo.

Paso 2: crea una regla de prueba

El ejemplo oficial evita mensajes de depuración:

/hookify No uses console.log en archivos TypeScript
/hookify:list

Inspecciona el archivo creado en .claude/: evento, patrón, estado y acción. Para cambiar su activación usa /hookify:configure.

Comprobación

En un archivo de prueba provoca una coincidencia con console.log y confirma el aviso. Para comprobar también el bloqueo prometido, crea .claude/hookify.prueba.local.md con esta adaptación de la regla Bash del README; utiliza un marcador inocuo en lugar del patrón de borrado:

---
name: prueba-bloqueo
enabled: true
event: bash
pattern: HOOKIFY_R2_BLOCK_TEST
action: block
---

Este comando está bloqueado por la regla de prueba.

Pide al agente que intente ejecutar echo HOOKIFY_R2_BLOCK_TEST mediante su herramienta Bash. Debe aparecer la denegación y el comando no debe ejecutarse. Un echo con otro texto debe seguir funcionando. Desactiva después esta regla de prueba con /hookify:configure. La acción predeterminada warn solo avisa: no basta para dar el bloqueo por comprobado.

Si algo falla

Si no se dispara, revisa ubicación del archivo, enabled, evento y patrón. Si faltan importaciones, verifica Python y la instalación del plugin. La guía indica que las reglas se aplican sin reinicio.

ver en .md ¿Prefieres el recurso entero?

Qué es

Hookify es un plugin de Claude Code que ayuda a crear reglas de hooks a partir de instrucciones y correcciones. Sus reglas son archivos Markdown con una cabecera de configuración y un mensaje para el agente.

Para qué te sirve

  • Cuando quieres avisar de instrucciones de depuración que no deberían quedar en el código.
  • Cuando necesitas bloquear un patrón concreto de comando antes de ejecutarlo.
  • Cuando quieres activar o desactivar una regla sin reconstruir una configuración compleja.

Cómo funciona

Los archivos de reglas viven en .claude/ y seleccionan un evento, condiciones y una acción. warn muestra un aviso y deja continuar; block impide la operación en el evento compatible. Las condiciones pueden usar expresiones regulares de Python y combinaciones de campos.

La carpeta plugins/hookify es la herramienta documentada aquí. Comparte repositorio con otros plugins independientes, por eso su URL apunta a la carpeta y no al catálogo completo.

Antes de empezar

Necesitas Claude Code y Python 3.7 o posterior; el README de Hookify no declara dependencias Python externas. La ficha conserva el SPDX del repositorio detectado por GitHub, Apache-2.0, aunque la carpeta del plugin declara MIT en su propia documentación.

Límites y alternativas

Una expresión regular solo cubre los patrones que expresa. Una regla de aviso no es un bloqueo y los bloqueos no equivalen a aislamiento del sistema. Valida coincidencias y falsos positivos sobre archivos de prueba antes de convertir la regla en una política habitual.

Recursos