Hook de Bloqueio de Não Verificação

Configuração de hook PreToolUse que intercepta e bloqueia o uso da flag de bypass antes da execução, garantindo que agentes de IA não possam pular hooks de pré-commit, assinatura GPG ou outros mecanismos de segurança do Git.

Visão Geral

Agentes de codificação de IA (Claude Code, Codex, etc.) podem executar comandos shell com flags como --no-verify que pulam hooks de pré-commit. Isso frustra o propósito de linting, formatação, testes e verificações de segurança configurados em hooks de pré-commit. O hook de bloqueio de não verificação adiciona uma proteção PreToolUse que rejeita qualquer chamada de ferramenta contendo flags de bypass antes da execução.

Problema

Quando agentes de IA fazem commit de código, eles podem usar flags de bypass para evitar falhas nos hooks:

# These commands skip pre-commit hooks entirely
git commit --no-verify -m "quick fix"
git push --no-verify
git commit --no-gpg-sign -m "unsigned commit"
git merge --no-verify feature-branch

Isso permite:

• Código não formatado entrar no repositório
• Erros de linting pularem verificações
• Verificações de segurança serem ignoradas
• Commits não assinados pularem políticas de assinatura
• Conjuntos de testes serem contornados

Solução

Adicione um hook PreToolUse em .claude/settings.json que inspeciona cada chamada de ferramenta Bash e bloqueia comandos contendo flags de bypass.

Configuração

Adicione o seguinte ao .claude/settings.json do seu projeto:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "if grep -qE '\"command\"[[:space:]]*:[[:space:]]*\"([^\"\\\\]|\\\\.)*(--no-(ver|g)|commit([^\"\\\\]|\\\\.)*([[:space:]]|\\\\[tn])-[a-zA-Z]*n)'; then echo 'BLOCKED: --no-verify and --no-gpg-sign flags are not allowed. Run the commit without bypass flags so that pre-commit hooks execute properly.' >&2; exit 2; fi"
          }
        ]
      }
    ]
  }
}

Como Funciona

1. Matcher: O hook visa apenas chamadas de ferramenta Bash, portanto, não interfere com outras ferramentas (Read, Edit, Grep, etc.).
2. Inspeção: Claude Code envia a chamada de ferramenta para o hook como JSON via stdin e não define a variável $TOOL_INPUT. O hook procura o valor command nesse JSON com grep -E, portanto, não precisa de jq ou node, e texto em outros campos, como cwd ou a descrição da chamada da ferramenta, não podem ativá-lo. Ele bloqueia --no-verify, --no-gpg-sign e qualquer prefixo mais curto deles que o Git aceita, por exemplo, --no-veri. Ele também bloqueia um grupo de opções curtas com n que segue commit no mesmo comando, por exemplo, -n ou -nm, porque -n é a forma curta de --no-verify. O hook não procura a palavra git, então ele também captura if git ..., sudo git ... e g=git; $g commit --no-verify. Uma correspondência falsa, como uma mensagem de commit que menciona uma flag, bloqueia a chamada, que é a maneira segura de falhar.
3. Bloqueio: Se uma flag de bypass for encontrada em um comando Git, o hook sai com o código 2 e imprime uma mensagem de erro. O código de saída 2 sinaliza Claude Code para rejeitar totalmente a chamada da ferramenta.
4. Passagem: Se nenhuma flag de bypass for encontrada, o hook sai com o código 0 e o comando é executado normalmente.
5. Limites: O hook verifica texto, então ele para um agente que busca uma flag de bypass por hábito. Ele não para um agente que se propõe a evitá-lo, por exemplo, construindo a flag a partir de partes ou executando git -c core.hooksPath=/dev/null commit.

Códigos de Saída

Flags Bloqueadas

Instalação

Configuração por Projeto

Crie ou atualize .claude/settings.json na raiz do seu projeto:

mkdir -p .claude
cat > .claude/settings.json << 'EOF'
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "if grep -qE '\"command\"[[:space:]]*:[[:space:]]*\"([^\"\\\\]|\\\\.)*(--no-(ver|g)|commit([^\"\\\\]|\\\\.)*([[:space:]]|\\\\[tn])-[a-zA-Z]*n)'; then echo 'BLOCKED: --no-verify and --no-gpg-sign flags are not allowed. Run the commit without bypass flags so that pre-commit hooks execute properly.' >&2; exit 2; fi"
          }
        ]
      }
    ]
  }
}
EOF

Configuração Global

…