Can I run multiple hooks for the same event?

Yes, Claude Code executes all matching hooks for an event in parallel. They are designed to be independent and do not see each other's output.

What are prompt-based hooks in Claude Code?

Prompt-based hooks use natural language instructions to let the LLM make context-aware decisions, such as evaluating if a specific tool use is safe or appropriate based on the current transcript.

What is the difference between the hooks.json and settings.json format?

Plugin hooks in hooks/hooks.json require a 'hooks' wrapper object and can include an optional description, while user settings in .claude/settings.json use a direct top-level format for events.

How do I ensure my plugin hooks are portable?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable in your hooks configuration to reference scripts within your plugin directory, avoiding hardcoded absolute paths.

How do I block a tool execution using a hook?

In a PreToolUse hook, you can return a JSON object with 'permissionDecision': 'deny' or, in a command hook, exit with code 2 to feed an error back to Claude and stop execution.

Claude Code Hook Development

Name: Claude Code Hook Development
Author: michelabboud

bymichelabboud

•

개발자 도구

Streamlines the creation of event-driven automation hooks to validate tool calls, enforce security policies, and customize Claude Code workflows.

소개

This skill provides comprehensive guidance for implementing event-driven hooks within Claude Code plugins. It enables developers to integrate both prompt-based reasoning and deterministic bash commands into the agent's lifecycle, covering critical events like PreToolUse, PostToolUse, and SessionStart. By leveraging these patterns, users can enforce safety protocols, automate project context loading, and ensure rigorous task completion standards through a structured, portable approach using environment variables and JSON configurations.

주요 기능

Command hooks for high-performance deterministic bash script execution
Prompt-based validation for context-aware reasoning and natural language logic
Environment variable persistence via $CLAUDE_ENV_FILE for session management
Support for the full hook lifecycle including PreToolUse, Stop, and SessionStart
1 GitHub stars
Portable path handling using the ${CLAUDE_PLUGIN_ROOT} variable

사용 사례

Automating project-specific context loading and environment setup at session start
Implementing security guardrails to block dangerous bash commands or unauthorized file access
Enforcing code quality standards by validating tool outputs before final submission

소개

주요 기능

Command hooks for high-performance deterministic bash script execution
Prompt-based validation for context-aware reasoning and natural language logic
Environment variable persistence via $CLAUDE_ENV_FILE for session management
Support for the full hook lifecycle including PreToolUse, Stop, and SessionStart
1 GitHub stars
Portable path handling using the ${CLAUDE_PLUGIN_ROOT} variable

사용 사례

Automating project-specific context loading and environment setup at session start
Implementing security guardrails to block dangerous bash commands or unauthorized file access
Enforcing code quality standards by validating tool outputs before final submission