oliverquaye23/claude-hooks

O que claude-hooks faz?

🛡️ Melhore o Claude Code com ganchos de segurança e utilitários para prevenir injeção de prompt e estender funcionalidades através de scripts personalizados.

Visão Geral

O skill claude-hooks adiciona uma camada de segurança e extensibilidade ao Claude Code. Ele permite que você defina ganchos de pré-execução e pós-execução para interceptar e modificar o comportamento padrão do agente de IA.

Funcionalidades

• Prevenção de Injeção de Prompt: Bloqueie automaticamente comandos maliciosos ou suspeitos antes que sejam executados.
• Scripts Personalizados: Execute scripts shell, Python ou Node.js em pontos específicos do fluxo de trabalho do Claude Code.
• Validações de Segurança: Verifique permissões, caminhos de arquivos e muito mais antes de ações críticas.
• Fácil Configuração: Defina regras em um arquivo de configuração YAML ou JSON.

Instalação

1. Adicione o skill à sua configuração do Claude Code:

   claude add-skill oliverquaye23/claude-hooks
   

2. Crie um arquivo de configuração (opcional):

   touch .claude-hooks.yaml
   

Configuração

Exemplo de .claude-hooks.yaml:

hooks:
  pre_command:
    - name: "block-dangerous-commands"
      script: "block_dangerous.sh"
      condition: "command contains 'rm -rf' || command contains 'sudo'"
  post_command:
    - name: "log-command"
      script: "log_command.sh"

Exemplos de Uso

Bloquear Injeção de Prompt

Configure um gancho para detectar e bloquear comandos que tentam modificar o comportamento do Claude Code:

hooks:
  pre_command:
    - name: "block-prompt-injection"
      script: |
        if echo "$COMMAND" | grep -qiE "ignore (all )?previous instructions|you are now"; then
          echo "Bloqueado: possível injeção de prompt detectada"
          exit 1
        fi

Validar Caminhos de Arquivo

Verifique se os arquivos sendo modificados estão dentro de diretórios permitidos:

hooks:
  pre_file_edit:
    - name: "validate-file-path"
      script: |
        ALLOWED_DIRS=("/home/user/projects")
        for dir in "${ALLOWED_DIRS[@]}"; do
          if [[ "$FILE_PATH" == "$dir"* ]]; then
            exit 0
          fi
        done
        echo "Erro: arquivo fora do diretório permitido"
        exit 1

Compatibilidade

• Plataforma: Claude Code
• Linguagens de Script: Shell (bash), Python, Node.js

Limitações

• Hooks de pré-execução não podem modificar o comando, apenas bloquear ou permitir.
• Scripts personalizados devem ser executáveis e ter permissão de execução.

Contribuição

Contribuições são bem-vindas! Por favor, leia o guia de contribuição antes de enviar PRs.

Licença

MIT