> ## 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 핸들러 (내부)

> 각 도구 이벤트마다 Claude Code가 호출하는 서브프로세스

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

이 명령은 `failproofai policies --install`이 Claude Code의 `settings.json`에 등록하는 명령입니다. 일반적으로 직접 호출할 필요가 없습니다.

stdin에서 JSON 페이로드를 읽고 활성화된 모든 정책을 평가한 후, 결정 결과를 나타내는 종료 코드로 종료합니다:

| 종료 코드 | 결정         | 효과                         |
| ----- | ---------- | -------------------------- |
| `0`   | `allow`    | 작업 허용                      |
| `1`   | `deny`     | 작업 차단 - Claude가 거부 이유를 확인함 |
| `2`   | `instruct` | Claude의 컨텍스트에 가이던스 주입      |

### 지원하는 이벤트 유형

| 카테고리             | 이벤트                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------ |
| **도구 실행**        | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **세션 생명주기**      | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **사용자 상호작용**     | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **서브에이전트 및 태스크** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **설정**           | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **파일 시스템**       | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **컨텍스트**         | `PreCompact`, `PostCompact`                                                                |