Claude Code Hooks Mastery

Claude Code Hooks Mastery

Claude Code Hooks - Quickly master how to use Claude Code hooks to add deterministic (or non-deterministic) control over Claude Code's behavior. Plus learn about Claude Code Sub-Agents, the powerful Meta-Agent, and Team-Based Validation with agent orchestration.

Table of Contents

- Prerequisites
- Hook Lifecycle & Payloads
- What This Shows
- UV Single-File Scripts Architecture
- Key Files
- Features Demonstrated
- Hook Error Codes & Flow Control
- UserPromptSubmit Hook Deep Dive
- Claude Code Sub-Agents
- Team-Based Validation System
- Output Styles Collection
- Custom Status Lines

Prerequisites

This requires:
- Astral UV - Fast Python package installer and resolver
- Claude Code - Anthropic's CLI for Claude AI

Optional Setup:

Optional:
- ElevenLabs - Text-to-speech provider (with MCP server integration)
- ElevenLabs MCP Server - MCP server for ElevenLabs
- Firecrawl MCP Server - Web scraping and crawling MCP server (my favorite scraper)
- OpenAI - Language model provider + Text-to-speech provider
- Anthropic - Language model provider
- Ollama - Local language model provider

Hook Lifecycle & Payloads

This demo captures all 13 Claude Code hook lifecycle events with their JSON payloads:

Hook Lifecycle Overview

1. UserPromptSubmit Hook
Fires: Immediately when user submits a prompt (before Claude processes it)
Payload: prompt text, session_id, timestamp
Enhanced: Prompt validation, logging, context injection, security filtering

2. PreToolUse Hook
Fires: Before any tool execution
Payload: tool_name, tool_input parameters
Enhanced: Blocks dangerous commands (rm -rf, .env access)

3. PostToolUse Hook
Fires: After successful tool completion
Payload: tool_name, tool_input, tool_response with results

4. Notification Hook
Fires: When Claude…