Claude Code

​

O que o instalador grava

​

Configuração manual do MCP

claude mcp add --scope user zeropath \
  --env ZEROPATH_TOKEN_ID=your_token_id \
  --env ZEROPATH_TOKEN_SECRET=your_token_secret \
  -- uvx --from git+https://github.com/ZeroPathAI/zeropath-mcp-server zeropath-mcp-server

​

Configuração manual do hook

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/home/you/.zeropath/hooks/claude-stop-hook.sh",
            "timeout": 300
          }
        ]
      }
    ]
  }
}

• Modo de monitoramento (padrão): emite uma systemMessage resumindo os achados; o Claude não é interrompido. Relatório completo em ~/.zeropath/logs/.
• Modo de bloqueio (ZEROPATH_BLOCKING_STOP_HOOKS=true em ~/.zeropath/config.env): emite {"decision": "block", "reason": ...} para achados no limiar de severidade ou acima dele. O Claude recebe os achados e as correções sugeridas como sua próxima instrução, remedia, e a nova varredura na próxima parada decide novamente. Os loops são limitados por um orçamento de bloqueios por sessão (padrão: 3).

​

Notas de comportamento

• O hook escaneia git diff HEAD (staged + unstaged). Arquivos novos não rastreados não estão nesse diff; o Claude é orientado (via CLAUDE.md) a escaneá-los por meio da ferramenta MCP asyncCodeScans.submit com input.kind: "files".
• Um turno que não altera código reutiliza o veredito anterior (cache de hash do diff) — turnos conversacionais não pagam a latência da varredura.
• Falhas de varredura seguem a política de fail open com uma systemMessage visível, nunca um bloqueio.

​

Verificar

/mcp                 # expect: zeropath — connected
claude --debug       # shows "Stop hook" execution at end of turn