Repolode
Enviar
karanb192

karanb192/claude-code-hooks

Colección de hooks instalables para Claude Code que aplican protecciones de seguridad, automatización, seguimiento de costos y notificaciones en las llamadas a herramientas del agente.

Ver en GitHubSitio web
Estrellas
576
Forks
49
Issues abiertos
6
Último commit
hace 4 días

¿Qué es?

claude-code-hooks es un conjunto de hooks listos para usar en Claude Code, empaquetados como un marketplace de plugins con 22 plugins instalables. Los hooks se ejecutan en momentos como PreToolUse y PostToolUse, donde pueden permitir, denegar o modificar una llamada a una herramienta, y el motivo se devuelve al agente. Como se ejecutan en procesos separados, fuera del modelo, se aplican independientemente de lo que diga el prompt.

Los plugins de seguridad bloquean la lectura y exfiltración de archivos .env y otros archivos secretos, las instalaciones mediante pipe a la shell, rm -rf en directorios de inicio, los force push a main y las modificaciones de la propia configuración de hooks y settings. Otros plugins ofrecen registro de sesiones en markdown, generación de informes diarios, protección contra la manipulación de pruebas, preparación automática de cambios con git, formato de código con ruff y prettier, seguimiento del costo de contexto y notificaciones de Slack cuando Claude necesita que el usuario intervenga. La mayoría de las protecciones admiten un nivel de seguridad configurable y un modo ask que pregunta en lugar de bloquear.

Cada plugin se instala con un único comando slash, y cada script también puede ejecutarse de forma independiente al registrarlo en settings.json. El proyecto incluye un conjunto de pruebas que se ejecuta con Node 18, 20 y 22, y una correspondencia con OWASP LLM Top 10 2026.

Funciones clave

  • 01Bloquea comandos de shell peligrosos, como rm -rf en directorios de inicio, las fork bombs y curl | sh.
  • 02Impide leer o exfiltrar archivos .env, claves SSH y credenciales de servicios en la nube.
  • 03Protege la propia configuración de seguridad del agente para que no se modifique durante una sesión.
  • 04Envía alertas a Slack cuando Claude Code necesita que el usuario intervenga.
  • 05Registra cada sesión en markdown y genera informes diarios a partir de la actividad del agente.
  • 06Se instala como plugins individuales desde el marketplace de Claude Code o como scripts independientes.

Casos de uso

  • Añadir protecciones para impedir que un agente de programación autónomo elimine archivos o haga force push a main.
  • Mantener los secretos fuera del alcance del agente en repositorios que contienen archivos .env.
  • Hacer seguimiento de la actividad de las sesiones y del costo en tokens de un equipo que usa Claude Code a diario.
  • Recibir notificaciones en Slack cuando una sesión prolongada del agente está esperando aprobación.

Inicio rápido

  1. 1

    Añade el marketplace a Claude Code (solo una vez)

    /plugin marketplace add karanb192/claude-code-hooks
  2. 2

    Instala el hook que quieras (por ejemplo, context-hogs; sustituye el nombre por el que prefieras)

    /plugin install context-hogs@claude-code-hooks
  3. 3

    Reinicia Claude Code para activar el hook

Antes de usarlo

  • Con su nivel alto predeterminado, Config-guard también bloquea claude plugin install, uninstall y disable. Por eso, instala primero los demás plugins o establece CONFIG_GUARD_ALLOW=true para esa llamada.
  • El esquema del payload de Config-Change no está documentado, así que config-watch lo analiza de forma defensiva.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open source

Temas

#claude-code#ai-agents#safety#hooks#developer-tools#automation#notifications#ai-tools#anthropic#claude

Preguntas frecuentes

¿Qué es claude-code-hooks?
Colección de hooks instalables para Claude Code que aplican protecciones de seguridad, automatización, seguimiento de costos y notificaciones en las llamadas a herramientas del agente. claude-code-hooks es un conjunto de hooks listos para usar en Claude Code, empaquetados como un marketplace de plugins con 22 plugins instalables. Los hooks se ejecutan en momentos como PreToolUse y PostToolUse, donde pueden permitir, denegar o modificar una llamada a una herramienta, y el motivo se devuelve al agente. Como se ejecutan en procesos separados, fuera del modelo, se aplican independientemente de lo que diga el prompt.
¿claude-code-hooks es gratuito? ¿Qué licencia tiene?
claude-code-hooks es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿claude-code-hooks sigue mantenido?
Mantenimiento activo. El último commit de claude-code-hooks fue el 2 nov 2026.
¿Para qué puedo usar claude-code-hooks?
Añadir protecciones para impedir que un agente de programación autónomo elimine archivos o haga force push a main. Mantener los secretos fuera del alcance del agente en repositorios que contienen archivos .env. Hacer seguimiento de la actividad de las sesiones y del costo en tokens de un equipo que usa Claude Code a diario. Recibir notificaciones en Slack cuando una sesión prolongada del agente está esperando aprobación.
¿Cómo se instala claude-code-hooks?
Añade el marketplace a Claude Code (solo una vez): /plugin marketplace add karanb192/claude-code-hooks Instala el hook que quieras (por ejemplo, context-hogs; sustituye el nombre por el que prefieras): /plugin install context-hogs@claude-code-hooks Reinicia Claude Code para activar el hook
¿Dónde consigo claude-code-hooks?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/karanb192/claude-code-hooks

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados