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

# フックハンドラー（内部）

> 各ツールイベントで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`                                                                |