Claude Code Hooks

Demo Video + Presentation

 

 

Installation

   

Step 1. Start Claude Code:

claude

Step 2. Send a prompt (e.g., Hi) — you'll hear a sound on session start, tool use, agent response, and more.

Common Errors

If you don't follow the prerequisites, you will see the following error on claude code start

SessionStart:startup hook error

Changelog

new hook addition changelogs only

Date	Hooks	Changes	Claude Code Version	Demo
Mar 31, 2026	27	Added PermissionDenied	v2.1.88
Mar 26, 2026	26	Added TaskCreated	v2.1.84	Demo 4
Mar 25, 2026	25	Added CwdChanged, FileChanged	v2.1.83
Mar 18, 2026	23	Added StopFailure	v2.1.78
Mar 14, 2026	22	Added PostCompact, Elicitation, ElicitationResult	v2.1.76
Mar 5, 2026	19	Added InstructionsLoaded	v2.1.69
Feb 21, 2026	18	Added WorktreeCreate and WorktreeRemove	v2.1.50
Feb 20, 2026	16	Added ConfigChange	v2.1.49
Feb 6, 2026	15	Added TeammateIdle and TaskCompleted	v2.1.33
—	13	Added PostToolUseFailure	—	Demo 3
Jan 17, 2026	12	Added Setup	v2.1.10
Jan 7, 2026	12	Added subagent hooks: PreToolUse, PostToolUse, Stop	v2.1.0
Nov 18, 2025	11	Added PermissionRequest	v2.0.45	Demo 2
Nov 17, 2025	10	Added SubagentStart	v2.0.43
Nov 10, 2025	9	Added Notification	v2.0.37	Demo 1
Jul 28, 2025	8	Added SessionStart	v1.0.62
Jul 16, 2025	7	Added UserPromptSubmit	v1.0.54
Jul 10, 2025	6	Added PreCompact	v1.0.48
Jul 2, 2025	5	Split Stop into Stop and SubagentStop	v1.0.41
Jun 30, 2025	4	Initial release: PreToolUse, PostToolUse, Stop, SessionEnd	v1.0.38

Not in Official Docs

Links

       

Other Repos

codex-cli-hooks · claude-code-best-practice · codex-cli-best-practice

Developed by

Workflow	Description
/workflows:workflow-changelog	Scan for new hooks and drift across all files
/workflows:workflow-add-hook *	Add any recommended hook across all files in one command