11. フック
イベントフック、前処理・後処理、自動実行
フックは Claude Code の特定のイベント(ツール実行、通知、セッション終了など)に対して、カスタムのシェルスクリプトを自動実行する仕組みです。settings.json の hooks フィールドで設定し、ファイル保存時の自動フォーマット、危険な操作のブロック、操作ログの記録などを実現できます。
イベント
実用例
フックイベント
- ツール実行失敗時にフックを実行したいPostToolUseFailure
- 権限プロンプトをフックで制御したいPermissionRequest
- サブエージェントの起動・終了をフックしたいSubagentStart / SubagentStop
- コンテキスト圧縮後にフックを実行したいPostCompact
- CLAUDE.md 読み込み時にフックを実行したいInstructionsLoaded
- git worktree の作成・削除をフックしたいWorktreeCreate / WorktreeRemove
- セッション開始・終了時にフックを実行したいSessionStart / SessionEnd
- API エラーで中断した時にフックを実行したいStopFailure
- エージェントチームメンバーのアイドル・タスク完了をフックしたいTeammateIdle / TaskCompleted
- コンテキスト圧縮前にフックを実行したいPreCompact
- MCP サーバーからの入力要求をフックしたいElicitation / ElicitationResult
- 設定変更時にフックを実行したいConfigChange