Where are hook configurations stored?

Configurations follow a precedence hierarchy including managed-settings.json, local .claude settings, project-level settings, and user-level settings.

How do I block a tool execution using a hook?

By using the PreToolUse event and returning an exit code of 2, you can block a tool call and feed an error message back to Claude.

Can I use hooks for specific tools only?

Yes, matchers allow you to target specific tools like 'Bash', 'Write', or 'Edit', and support regex patterns for more complex filtering.

What are Claude Code hooks?

Hooks are specialized commands or prompts that execute automatically in response to Claude Code events, such as starting a session or using a tool.

What environment variables are available to hooks?

Hooks have access to standard system variables plus specific variables like $CLAUDE_PROJECT_DIR and $CLAUDE_PLUGIN_ROOT.

Claude Hooks Reference 2026

Name: Claude Hooks Reference 2026
Author: Jamie-BitFlight

byJamie-BitFlight

•

Herramientas para Desarrolladores

Provides a comprehensive technical reference for the Claude Code hooks system to automate and validate AI workflows.

This skill serves as the authoritative guide for the Claude Code hooks system as of January 2026, offering detailed specifications for developers looking to extend and secure their AI-driven development environment. It provides essential documentation on hook events, configuration precedence, and matchers, allowing users to implement custom logic for tool validation, automated formatting, and session lifecycle management. Whether you are building complex plugins or simple project-specific scripts, this reference ensures you have the correct syntax for JSON inputs, exit codes, and environment variables.

Características Principales

01Guidance on plugin-specific environment variables and lifecycle scoping

02Detailed technical schema for JSON input/output and exit code behaviors

03Comprehensive guide to hook configuration precedence and directory structures

0414 GitHub stars

05Support for tool-specific matchers, regex patterns, and MCP server integrations

06Full documentation of all 10+ hook events including PreToolUse and SessionStart

Casos de Uso

01Creating custom session initialization scripts for environment setup and cleanup

02Implementing security gatekeepers to block or validate dangerous shell commands

03Automating code linting and style formatting immediately after file modifications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills claude-hooks-reference-2026

For use in Claude.ai and ChatGPT

Download Skill