> ## 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 (internal)

> Subprocess mà Claude Code gọi trên mỗi sự kiện công cụ

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

Đây là lệnh được đăng ký trong `settings.json` của Claude Code bởi `failproofai policies --install`. Bình thường bạn không gọi trực tiếp lệnh này.

Đọc một payload JSON từ stdin, đánh giá tất cả các chính sách được bật, và thoát với một mã chỉ định quyết định:

| Mã thoát | Quyết định | Hiệu ứng                                      |
| -------- | ---------- | --------------------------------------------- |
| `0`      | `allow`    | Cho phép hành động                            |
| `1`      | `deny`     | Chặn hành động - Claude sẽ thấy lý do từ chối |
| `2`      | `instruct` | Đưa hướng dẫn vào ngữ cảnh của Claude         |

### Các loại sự kiện được hỗ trợ

| Danh mục                 | Sự kiện                                                                                    |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| **Thực thi công cụ**     | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
| **Vòng đời phiên**       | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`                                        |
| **Tương tác người dùng** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`                     |
| **Subagents & nhiệm vụ** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`            |
| **Cấu hình**             | `InstructionsLoaded`, `ConfigChange`, `CwdChanged`                                         |
| **Hệ thống tệp**         | `FileChanged`, `WorktreeCreate`, `WorktreeRemove`                                          |
| **Ngữ cảnh**             | `PreCompact`, `PostCompact`                                                                |