> ## 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.

# Handler hook (interno)

> Il sottoprocesso che Claude Code chiama su ogni evento di strumento

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

Questo è il comando registrato nel `settings.json` di Claude Code da `failproofai policies --install`. Normalmente non lo chiami direttamente.

Legge un payload JSON da stdin, valuta tutte le policy abilitate e esce con un codice che indica la decisione:

| Codice di uscita | Decisione  | Effetto                                            |
| ---------------- | ---------- | -------------------------------------------------- |
| `0`              | `allow`    | Consenti l'azione                                  |
| `1`              | `deny`     | Blocca l'azione - Claude vede il motivo del blocco |
| `2`              | `instruct` | Inietta indicazioni nel contesto di Claude         |

### Tipi di evento supportati

| Categoria                        | Eventi                                                                                     |
| -------------------------------- | ------------------------------------------------------------------------------------------ |
| **Esecuzione dello strumento**   | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **Ciclo di vita della sessione** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **Interazione utente**           | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **Subagenti e attività**         | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **Configurazione**               | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **File system**                  | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **Contesto**                     | `PreCompact`, `PostCompact`                                                                |