Hook Configuration in AI

From the Claude Code cheat sheet · Hooks System · verified Jul 2026

Hook Configuration

Setting up hooks in settings.json

json

# ~/.claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"Running: \" + .tool_input.command' >> ~/.claude/log.txt"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/validate_prompt.py"
          }
        ]
      }
    ]
  }
}

json

// EXAMPLE: Log all bash commands
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "date >> ~/.claude/bash.log && echo '{{tool_input.command}}' >> ~/.claude/bash.log"
      }]
    }]
  }
}

📌 Matcher filters by tool name

🔍 Can run commands or scripts

📌 Access tool data via placeholders

hooksconfig

More AI tasks

Back to the full Claude Code cheat sheet