> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hook handler (interno)

> O subprocesso que Claude Code chama em cada evento de ferramenta

```bash theme={null}
failproofai --hook <EventType>
```

Este é o comando registrado no `settings.json` do Claude Code pelo `failproofai policies --install`. Normalmente você não o chama diretamente.

Lê um payload JSON do stdin, avalia todas as políticas habilitadas e encerra com um código indicando a decisão:

| Código de saída | Decisão    | Efeito                                          |
| --------------- | ---------- | ----------------------------------------------- |
| `0`             | `allow`    | Permite a ação                                  |
| `1`             | `deny`     | Bloqueia a ação — Claude vê o motivo da negação |
| `2`             | `instruct` | Injeta orientações no contexto do Claude        |

### Tipos de evento suportados

| Categoria                   | Eventos                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| **Execução de ferramentas** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **Ciclo de vida da sessão** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **Interação com o usuário** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **Subagentes e tarefas**    | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **Configuração**            | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **Sistema de arquivos**     | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **Contexto**                | `PreCompact`, `PostCompact`                                                                |