> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hook-Handler (intern)

> Der Subprozess, den Claude Code bei jedem Tool-Ereignis aufruft

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

Dies ist der Befehl, der in Claude Codes `settings.json` durch `failproofai policies --install` registriert wird. Normalerweise rufen Sie diesen nicht direkt auf.

Liest eine JSON-Nutzlast von stdin, wertet alle aktivierten Richtlinien aus und beendet sich mit einem Code, der die Entscheidung anzeigt:

| Exit-Code | Entscheidung | Auswirkung                                           |
| --------- | ------------ | ---------------------------------------------------- |
| `0`       | `allow`      | Aktion erlauben                                      |
| `1`       | `deny`       | Aktion blockieren – Claude sieht den Ablehnungsgrund |
| `2`       | `instruct`   | Hinweise in Claudes Kontext einschleusen             |

### Unterstützte Ereignistypen

| Kategorie                 | Ereignisse                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------ |
| **Tool-Ausführung**       | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **Sitzungslebenszyklus**  | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **Benutzerinteraktion**   | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **Subagenten & Aufgaben** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **Konfiguration**         | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **Dateisystem**           | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **Kontext**               | `PreCompact`, `PostCompact`                                                                |