מה זה Hooks ב-Claude Code?

Hooks ב-Claude Code הם פקודות מערכת (shell) שרצות אוטומטית באירועים מוגדרים במחזור-החיים — למשל לפני או אחרי שימוש בכלי, בתחילת סשן או כשקלוד מסיים לענות. בניגוד להוראה ב-CLAUDE.md, Hook רץ ללא תלות בהחלטת המודל, ולכן הוא מנגנון אכיפה דטרמיניסטי.

עודכן ב-28 ביוני 2026

הבעיה ש-Hooks פותר

הוראות ב-CLAUDE.md הן בקשה מנומסת — קלוד מנסה לכבד אותן, אבל אין ערובה שזה יקרה בכל פעם. כשצריך ודאות — שכל קובץ ייעבר בפורמט אחרי עריכה, שאף פקודת מחיקה מסוכנת לא תרוץ, שבדיקות יורצו לפני כל commit — בקשה לא מספיקה. Hook הופך את ה"בבקשה" ל"תמיד": פקודה אמיתית שרצה מעצמה ברגע הנכון.

אירועי ה-Hooks הנפוצים

כל Hook נקשר לאירוע. אלה הנפוצים ביותר:

זו רשימה חלקית של הנפוצים — בגרסאות העדכניות קיים סט אירועים רחב הרבה יותר (כ-30, כולל אירועי הרשאות, תת-סוכנים, worktree ועוד). את הסט המלא והמדויק כדאי לאמת תמיד מול התיעוד הרשמי.

איפה מגדירים Hooks

Hooks מוגדרים בקובצי ה-settings תחת המפתח hooks, עם matcher (לאיזה כלי) ורשימת פקודות:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "/path/to/block-rm.sh" }
        ]
      }
    ]
  }
}

אפשר להגדיר אותם ברמת הפרויקט (.claude/settings.json), ברמת הפרויקט-המקומית (.claude/settings.local.json), ברמת המשתמש (~/.claude/settings.json), במדיניות מנוהלת, וגם בתוך תוספים (Plugins) או ב-frontmatter של Skill/Agent.

איך Hook חוסם פעולה

Hook מסוג PreToolUse יכול לעצור קריאה לכלי לפני שהיא רצה, בשלוש דרכים:

• יציאה עם קוד 2: ה-Hook יוצא עם exit 2, וה-stderr שלו מועבר לקלוד כשגיאה.
• JSON עם permissionDecision: יציאה תקינה עם פלט JSON שבו "permissionDecision": "deny" וסיבה.
• JSON עם decision: פלט עם "decision": "block" לחסימה פשוטה.

#!/bin/bash
command=$(jq -r '.tool_input.command')
if echo "$command" | grep -q 'rm -rf'; then
  echo "Destructive rm -rf blocked" >&2
  exit 2   # blocks the tool call
fi
exit 0

שאלות נפוצות