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

# Manejador de hooks (interno)

> El subproceso que Claude Code invoca en cada evento de herramienta

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

Este es el comando registrado en el archivo `settings.json` de Claude Code por `failproofai policies --install`. Normalmente no se llama directamente.

Lee un payload JSON desde stdin, evalúa todas las políticas habilitadas y termina con un código que indica la decisión:

| Código de salida | Decisión   | Efecto                                                  |
| ---------------- | ---------- | ------------------------------------------------------- |
| `0`              | `allow`    | Permite la acción                                       |
| `1`              | `deny`     | Bloquea la acción — Claude recibe el motivo del rechazo |
| `2`              | `instruct` | Inyecta orientación en el contexto de Claude            |

### Tipos de eventos soportados

| Categoría                      | Eventos                                                                                    |
| ------------------------------ | ------------------------------------------------------------------------------------------ |
| **Ejecución de herramientas**  | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **Ciclo de vida de sesión**    | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **Interacción con el usuario** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **Subagentes y tareas**        | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **Configuración**              | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **Sistema de archivos**        | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **Contexto**                   | `PreCompact`, `PostCompact`                                                                |