Where are hook configurations stored?

Hooks can be stored in several locations with a specific precedence order: Managed settings (highest), Local settings, Project settings, User settings, Plugin settings, and Capability frontmatter (lowest).

How do I match specific tools with hooks?

You can use the 'matcher' field in your configuration to target specific tools like 'Write' or 'Edit', use regex patterns like 'Edit|Write', or use the '*' wildcard to match all tools.

Are there security risks with using hooks?

Yes, hooks execute arbitrary shell commands on your system. You should only use trusted hooks and understand that they have the same permissions as your user account.

Can I persist environment variables across sessions?

Yes, by using the SessionStart or Setup hooks and appending export commands to the file path provided in the $CLAUDE_ENV_FILE environment variable.

What are Claude Code hooks?

Hooks are specialized configurations that allow Claude Code to execute custom shell commands or LLM prompts in response to specific lifecycle events, such as before a tool is used or when a session starts.

Claude Code Hooks Core Reference

Name: Claude Code Hooks Core Reference
Author: Jamie-BitFlight

byJamie-BitFlight

•

学习与文档

Provides a comprehensive technical guide for implementing, configuring, and troubleshooting the Claude Code hook system.

This skill serves as the definitive reference for the Claude Code hooks system, enabling developers to automate workflows through custom commands and prompts. It details the complete lifecycle of events—from session startup to tool execution—and provides precise documentation on configuration hierarchy, regex matchers, and environment variable persistence. Whether you are setting up project-specific linting, automating environment variables with CLAUDE_ENV_FILE, or managing MCP tool interactions, this reference ensures you have the technical specifications needed to build robust and secure automation within the Claude Code environment.

主要功能

01Configuration precedence guide covering managed, local, project, and user settings

02Comprehensive event lifecycle documentation for all 13+ hook triggers

0326 GitHub stars

04Advanced matcher specifications for tool names, regex, and MCP servers

05Detailed execution behavior notes on timeouts, parallelization, and output handling

06Environment variable persistence patterns using CLAUDE_ENV_FILE and SessionStart

使用场景

01Implementing custom validation, formatting, or linting before and after tool usage

02Automating repository environment setup and dependency checks on session start

03Configuring complex automated responses to tool failures and subagent lifecycles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills hooks-core-reference

For use in Claude.ai and ChatGPT

Download Skill