CLAUDE CODE原文:EN

Claude Code Hooks完全解説:27イベント・3ハンドラタイプでワークフロー自動化を完全制御

Claude Code Hooks Complete Reference: 27 Events, 3 Handler Types (May 2026)

via The Prompt Shelf· 収集日:2026年5月26日

日本語要約

2026年5月時点でClaude Code Hooksは27の固有ライフサイクルイベントをサポートするまでに拡張された。SessionStart・Setup・SessionEnd・UserPromptSubmit・UserPromptExpansion・Stop・StopFailure・PreToolUse/PostToolUse・PostToolBatch・PermissionRequest・SubagentStart/Stop・TaskCreated/Completed・InstructionsLoaded・ConfigChange・CwdChanged・FileChanged・WorktreeCreate/Remove・PreCompact/PostCompact・Notification・Elicitationなど包括的なイベントが利用可能だ。ハンドラタイプはCommand(シェルスクリプト)・Prompt(単一ターンLLM評価)・Agent(ツールアクセス付きサブエージェント)の3種類。設定はグローバル・プロジェクト共有・プロジェクトローカルの3レベルで管理できる。

編集コメント

HooksはClaude Codeの動作に対して確定的な制御を加える仕組みであり、LLMの判断に依存せず特定の処理を必ず実行させられる点が実用性の核心だ。PreCompact/PostCompactフックはコンテキスト圧縮前後の状態管理に活用でき、長時間エージェントセッションの信頼性向上に直結する。CI/CDパイプラインへの組み込みや、チームルールの自動強制にも有用であり、本番運用を見据えたClaude Code活用の必修知識となっている。

参考:The Prompt Shelfの記事をもとに要約