hook（hook 效率）

Hook Management System

Manage Claude Code hooks for the current session.

When to use

• When you need to check the status of Claude Code hooks
• When you want to temporarily disable a noisy or problematic hook
• When debugging hook behavior or performance issues
• When monitoring hook execution metrics

Usage

/hook status                  # Show all hooks and their status
/hook list                    # List available hooks with descriptions
/hook disable [hook-name]     # Temporarily disable a hook
/hook enable [hook-name]      # Re-enable a disabled hook
/hook profile                 # Show hook performance metrics
/hook logs [hook-name]        # View recent logs for a hook

Instructions

When this command is invoked:

/hook status

1. Read ~/.claude/settings.json
2. Parse the hooks configuration
3. Check ~/.claude/hooks/.disabled for disabled hooks
4. Display in a formatted table:

- Hook type (SessionStart, PreToolUse, PostToolUse, and others) - Matcher pattern - Command/Prompt - Status (enabled/disabled)

/hook list

1. Scan ~/.claude/hooks/ directory
2. List each hook file with:

- Filename - Description (from docstring) - Trigger type - Last modified

/hook disable [hook-name]

1. Create/update ~/.claude/hooks/.disabled file
2. Add the hook name to the disabled list
3. Hooks check this file before running
4. Note: Changes persist until re-enabled

/hook enable [hook-name]

1. Read ~/.claude/hooks/.disabled file
2. Remove the hook name from the disabled list
3. Confirm the hook is re-enabled

/hook profile

1. Read ~/.claude/logs/hook_metrics.jsonl
2. Calculate average execution time per hook
3. Show:

- Hook name - Avg execution time (ms) - Total calls - Success rate - Token impact estimate

/hook logs [hook-name]

1. Find log files in ~/.claude/logs/
2. Filter by hook name
3. Show last 20 entries
4. Include timestamp, result, and any errors

Examples

# Check current hook status
/hook status

# Disable noisy notifications temporarily
/hook disable notification

# Re-enable when ready
/hook enable notification

# Check performance impact
/hook profile

# Debug a specific hook
/hook logs post_tool_use

Notes

• Disabled state uses ~/.claude/hooks/.disabled file
• Performance data from ~/.claude/logs/hook_metrics.jsonl
• Hooks check disabled state before executing
• Session-based disabling (resets on restart)