Repolode
Enviar
karanb192

karanb192/claude-code-hooks

Coleção de hooks instaláveis para o Claude Code que impõem proteções de segurança, automação, acompanhamento de custos e notificações em chamadas de ferramentas do agente.

Ver no GitHubSite
Estrelas
576
Forks
49
Issues abertas
6
Último commit
há 5 dias

O que é?

claude-code-hooks é um conjunto de hooks prontos para usar no Claude Code, distribuídos como um marketplace de plugins com 22 plugins instaláveis. Os hooks são executados em etapas como PreToolUse e PostToolUse, nas quais podem permitir, negar ou modificar uma chamada de ferramenta; o motivo é retornado ao agente. Como são executados em processos separados, fora do modelo, eles se aplicam independentemente do que o prompt diz.

Os plugins de segurança bloqueiam a leitura e a exfiltração de arquivos .env e outros arquivos secretos, instalações com pipe para shell, comandos rm -rf em diretórios home, force pushes para main e alterações na própria configuração de hooks e settings. Outros plugins incluem registro de sessões em markdown, geração de resumos diários, proteção contra adulteração de testes, staging automático no git, formatação de código com ruff e prettier, acompanhamento do custo de contexto e notificações no Slack quando Claude precisa de informações. A maioria das proteções aceita um nível de segurança configurável e um modo ask, que pergunta em vez de bloquear.

Cada plugin é instalado com um único comando slash, e cada script também pode ser executado de forma independente quando registrado em settings.json. O projeto inclui uma suíte de testes executada no Node 18, 20 e 22, além de um mapeamento para o OWASP LLM Top 10 2026.

Recursos principais

  • 01Bloqueia comandos de shell perigosos, como rm -rf em diretórios home, fork bombs e curl | sh.
  • 02Impede a leitura ou exfiltração de arquivos .env, chaves SSH e credenciais de serviços de nuvem.
  • 03Protege a configuração de segurança do próprio agente contra alterações durante uma sessão.
  • 04Envia alertas no Slack quando o Claude Code precisa de informações do usuário.
  • 05Registra cada sessão em markdown e gera resumos diários com base na atividade do agente.
  • 06Instala como plugins individuais pelo marketplace do Claude Code ou como scripts independentes.

Casos de uso

  • Adicionar proteções para impedir que um agente de programação autônomo apague arquivos ou faça force push para main.
  • Manter segredos fora do alcance do agente em repositórios que contêm arquivos .env.
  • Acompanhar a atividade das sessões e o custo de tokens de uma equipe que usa o Claude Code diariamente.
  • Receber notificações no Slack quando uma sessão longa do agente estiver aguardando aprovação.

Início rápido

  1. 1

    Adicione o marketplace ao Claude Code (uma única vez)

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

    Instale o hook que quiser (por exemplo, context-hogs; substitua o nome pelo de sua preferência)

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

    Reinicie o Claude Code para ativar o hook

Antes de usar

  • No nível alto padrão, o Config-guard também bloqueia claude plugin install, uninstall e disable. Portanto, instale os outros plugins primeiro ou defina CONFIG_GUARD_ALLOW=true para essa chamada.
  • O esquema do payload de Config-Change não está documentado, então o config-watch faz a análise de forma defensiva.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open source

Tópicos

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

Perguntas frequentes

O que é claude-code-hooks?
Coleção de hooks instaláveis para o Claude Code que impõem proteções de segurança, automação, acompanhamento de custos e notificações em chamadas de ferramentas do agente. claude-code-hooks é um conjunto de hooks prontos para usar no Claude Code, distribuídos como um marketplace de plugins com 22 plugins instaláveis. Os hooks são executados em etapas como PreToolUse e PostToolUse, nas quais podem permitir, negar ou modificar uma chamada de ferramenta; o motivo é retornado ao agente. Como são executados em processos separados, fora do modelo, eles se aplicam independentemente do que o prompt diz.
claude-code-hooks é gratuito? Qual é a licença?
claude-code-hooks é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-code-hooks ainda é mantido?
Manutenção ativa. O último commit de claude-code-hooks foi em 2 de nov. de 2026.
Para que posso usar claude-code-hooks?
Adicionar proteções para impedir que um agente de programação autônomo apague arquivos ou faça force push para main. Manter segredos fora do alcance do agente em repositórios que contêm arquivos .env. Acompanhar a atividade das sessões e o custo de tokens de uma equipe que usa o Claude Code diariamente. Receber notificações no Slack quando uma sessão longa do agente estiver aguardando aprovação.
Como instalar claude-code-hooks?
Adicione o marketplace ao Claude Code (uma única vez): /plugin marketplace add karanb192/claude-code-hooks Instale o hook que quiser (por exemplo, context-hogs; substitua o nome pelo de sua preferência): /plugin install context-hogs@claude-code-hooks Reinicie o Claude Code para ativar o hook
Onde consigo claude-code-hooks?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/karanb192/claude-code-hooks

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados