חיצים לניווט · Enter לפתיחה · Esc לסגירה

קורס Claude Code בעברית, בחינם · שיעור 7 מתוך 8 · 20 דק׳

🪝 שיעור 7: סוכנים ו-⁠Hooks ב-⁠Claude Code (קלוד קוד)

Claude Code hooks ו-⁠subagents בקלוד קוד: מה זה סוכן-משנה, איפה מגדירים אותו, אילו אירועי hook קיימים, דוגמאות עם קוד מהתיעוד ואבטחה. ברמה בינונית.

🎯 בסוף השיעור תדעו להגדיר סוכן-משנה לקריאה בלבד, לחבר hook שחוסם פקודה מסוכנת, ולהחליט מתי כל אחד מהם שווה את המאמץ.

→ השיעור הקודם: חיבור מערכות עם MCP
בקצרה
  • סוכן-משנה (subagent) ב-⁠Claude Code הוא קובץ Markdown עם הגדרות, שאליו Claude מאציל משימה סגורה. הוא עובד בהקשר נפרד ומחזיר סיכום.
  • Hook הוא פקודה שאתם מגדירים, ו-⁠Claude Code מריץ אותה בנקודה קבועה, למשל לפני הרצת כלי. הוא פועל תמיד, גם כשהמודל לא חשב עליו.
  • שניהם חזקים ושניהם דורשים זהירות: hook רץ עם ההרשאות המלאות שלכם.

בשיעורים הקודמים בניתם הוראות (CLAUDE.md), נהלים (סקילים) וחיבורים (MCP). עכשיו שני כלים אחרונים: מי עושה עבודה בצד, ומה קורה אוטומטית. מדריך כללי על סוכני בינה מלאכותית יש במה זה סוכן AI. כאן נתמקד ב-⁠Claude Code (קלוד קוד) עצמו.

מה זה סוכן-משנה (subagent) ב-⁠Claude Code?

סוכן-משנה הוא עוזר עם הוראות משלו, כלים משלו וחלון הקשר משלו. Claude שולח אליו משימה, הוא מבצע אותה בנפרד, וחוזר רק עם סיכום. הפלט הארוך נשאר אצלו ולא מנפח את השיחה שלכם.

לפי התיעוד, ל-⁠Claude Code יש כמה סוכני-משנה מובנים, כמו Explore (חיפוש וקריאה בלבד בקוד) ו-⁠Plan (איסוף מידע לתכנון). אתם יכולים להוסיף משלכם.

איפה מגדירים סוכן-משנה ואיך נראה הקובץ?

סוכן-משנה הוא קובץ Markdown. בראשו frontmatter של YAML, ואחריו ההוראות שלו. לפי התיעוד, רק name ו-⁠description חובה. השדה description הוא מה ש-⁠Claude קורא כדי להחליט מתי להאציל.

---
name: reviewer
description: Reviews changed files against the spec they were built from. Use after implementing a feature, before opening the PR.
tools: Read, Grep, Glob
---
You're reviewing code you didn't write. Compare the changed files against the spec you're given,
check that every requirement is implemented and the listed edge cases have tests,
and report only the gaps that affect correctness. Skip style.

הדוגמה הזאת לקוחה ממדריך ה-⁠best practices הרשמי. השורה tools: Read, Grep, Glob הופכת אותו למבקר שלא יכול לערוך כלום, וההגבלה נאכפת על ידי Claude Code ולא רק מתבקשת בפרומפט.

מיקוםהיקףעדיפות
--agents (דגל בהפעלה)הסשן הנוכחי2
.claude/agents/הפרויקט הנוכחי3
~/.claude/agents/כל הפרויקטים שלכם4
תיקיית agents/ של פלאגיןאיפה שהפלאגין מופעל5, הנמוכה ביותר

כששני סוכנים באותו שם, נבחר זה שבמיקום בעדיפות גבוהה יותר. את תיקיית הפרויקט כדאי לשמור ב-⁠git, כדי שהצוות ישתמש באותם סוכנים.

איך קוראים לסוכן?

יש שלוש דרכים, לפי התיעוד. כתיבה בשפה רגילה: Use the reviewer subagent on my recent changes. אזכור עם @, שמבטיח שדווקא הסוכן הזה ירוץ. והפעלת סשן שלם כסוכן עם claude --agent reviewer.

מתי להאציל משימה לסוכן-משנה ומתי לא?

התיעוד נותן כלל פשוט. נשארים בשיחה הראשית כשצריך הלוך-חזור, כשכמה שלבים חולקים הקשר, ובשינוי קטן וממוקד. מאצילים כשהמשימה סגורה ומחזירה סיכום.

המצבאיפה עובדים
תיקון קטן, שיפור הדרגתישיחה ראשית
הרצת כל הבדיקות עם פלט ארוךסוכן-משנה
סקירה של קוד שנכתב זה עתה, בעיניים רעננותסוכן-משנה (reviewer)
רוצים להגביל כלים, למשל קריאה בלבדסוכן-משנה עם tools
נוהל שחוזר על עצמו בשיחה הראשיתסקיל, לא סוכן
סוכן-משנה לא חינם

כל סוכן שולח בקשות משלו, והן נספרות באותו שימוש. סוכן חדש גם צריך לאסוף הקשר מאפס, אז לפעמים הוא איטי יותר. לפי התיעוד, לעבודה פשוטה אפשר להגדיר model: haiku ולחסוך.

מה זה hook ואילו אירועים קיימים ב-⁠Claude Code?

Hook הוא פקודה שאתם מגדירים, ו-⁠Claude Code מריץ אותה בנקודה קבועה במחזור החיים שלו. לפי התיעוד, זה נותן שליטה דטרמיניסטית: הפעולה קורה תמיד, ולא תלויה בהחלטה של המודל. שורה ב-⁠CLAUDE.md היא בקשה. hook הוא אכיפה.

אלה האירועים העיקריים מתוך הטבלה הרשמית. הרשימה המלאה ארוכה יותר, ואותה בודקים בתיעוד ה-⁠hooks.

אירועמתי הוא נורה
SessionStartכשסשן מתחיל או חוזר
UserPromptSubmitכששולחים פרומפט, לפני ש-⁠Claude מעבד אותו
PreToolUseלפני הרצת כלי. אפשר לחסום
PostToolUseאחרי שכלי הצליח
Notificationכש-⁠Claude Code שולח התראה
SubagentStart / SubagentStopכשסוכן-משנה נוצר או מסיים
Stopכש-⁠Claude מסיים להגיב
PreCompactלפני דחיסת ההקשר
SessionEndכשהסשן נגמר

ה-⁠hook מקבל נתונים כ-⁠JSON ב-⁠stdin, למשל tool_name ו-⁠tool_input. הוא מחזיר תשובה בקוד יציאה: 0 אומר שאין התנגדות, ו-⁠2 חוסם. מה שנכתב ל-⁠stderr חוזר ל-⁠Claude כסיבה.

מגדירים hooks בתוך settings.json. בקובץ ~/.claude/settings.json הם חלים על כל הפרויקטים. בקובץ .claude/settings.json הם חלים על הפרויקט, ואפשר לשמור אותם ב-⁠git. הפקודה /hooks מציגה את כל מה שהוגדר.

אילו דוגמאות שימושיות אפשר להתחיל מהן?

התראה כש-⁠Claude מחכה לכם

אירוע Notification עם matcher ריק מופעל בכל התראה. זו הדוגמה הרשמית ל-⁠Windows, והיא פותחת חלון:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

ב-⁠macOS וב-⁠Linux יש בתיעוד פקודות מתאימות. החלון עלול להיפתח מאחורי הטרמינל, אז בדקו את הפקודה קודם ב-⁠PowerShell.

חסימת פקודה מסוכנת

הסקריפט הבא מתבסס על הדוגמה הרשמית, שחוסמת drop table. שמרו אותו ב-⁠.claude/hooks/block-danger.sh. הוא קורא את ה-⁠JSON, מוציא את הפקודה עם jq, ואם יש התאמה, יוצא עם 2.

#!/bin/bash
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command')

if echo "$COMMAND" | grep -q -i -E "drop table|git push --force"; then
  echo "Blocked: dangerous command" >&2
  exit 2
fi

exit 0

ומחברים אותו ב-⁠.claude/settings.json, על כלי Bash בלבד:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-danger.sh"
          }
        ]
      }
    ]
  }
}

ב-⁠macOS וב-⁠Linux צריך גם chmod +x על הסקריפט. הדוגמאות בבאש דורשות jq.

רשת ביטחון, לא חומה

התיעוד עצמו מזהיר: סינון לפי תבנית הוא best-effort, ולאכיפה קשיחה של הרשאה או חסימה עדיף להשתמש במערכת ההרשאות (permissions). hook כזה תופס טעויות, לא מתקפות.

בדיקת פורמט לפני קומיט

כאן מחברים שלושה רכיבים מתועדים: שדה if שמסנן לפקודות git commit, הדפוס 1>&2 || exit 2 מדוגמת ה-⁠Stop hook הרשמית, והדגל --check של Prettier, שמחזיר קוד 1 כשקבצים לא מעוצבים.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git commit *)",
            "command": "npx prettier . --check 1>&2 || exit 2"
          }
        ]
      }
    ]
  }
}

הדוגמה הזאת שלנו ולא מהתיעוד כמות שהיא. נסו אותה קודם בענף ניסיוני.

האם hooks בטוחים? מה לבדוק לפני שמוסיפים?

לפי התיעוד, hook מסוג command מריץ פקודות מעטפת עם ההרשאות המלאות של חשבון המשתמש. הוא יכול לשנות, למחוק או לקרוא כל קובץ שאתם יכולים. התיעוד מורה לסקור ולבדוק כל פקודה לפני שמוסיפים אותה.

שלושה כללים מעשיים:

  • קראו כל hook שהגיע מפלאגין או ממאגר של מישהו אחר. פלאגין יכול לצרף hooks.
  • התחילו בפעולות קטנות והפכו אותן לחמורות רק אחרי בדיקה.
  • בסשן אינטראקטיבי Claude Code מחזיק hooks עד שתאשרו את דיאלוג האמון של התיקייה. ב-⁠claude -p אין דיאלוג, והתיקייה נחשבת מהימנה. לכן לא מריצים claude -p על מאגר זר בלי לבדוק את .claude/.

מתי לא להשתמש בסוכנים וב-⁠hooks?

  • במשימה קטנה. תיקון של שורה לא צריך סוכן. הוא ייקח יותר זמן ויעלה יותר.
  • בהעדפה שהיא לא חובה. אם רוצים שהסגנון “בדרך כלל” יהיה כך, שורה ב-⁠CLAUDE.md מספיקה. לפי המדריך הרשמי, hook שמגן רק על העדפה כדאי למחוק.
  • ב-⁠hook איטי. הוא רץ בכל ירי של האירוע. סינון עם matcher ו-⁠if מקטין את מספר ההרצות.
  • כשהכלל חייב להיות הרשאה. את החסימות הקשיחות מגדירים ב-⁠permissions.

תרגיל מעשי

המטרה: סוכן סקירה לקריאה בלבד, ו-⁠hook שחוסם פקודה מסוכנת. בפרויקט ניסיוני, לא בפרויקט חי.

  1. 1

    יוצרים את הסוכן

    צרו את הקובץ .claude/agents/reviewer.md עם התוכן מהדוגמה למעלה. אם Claude Code לא מוצא את הסוכן, הפעילו אותו מחדש.

  2. 2

    קוראים לו

    כתבו: Use the reviewer subagent to review my latest changes against SPEC.md. בשורת הפלט תראו קריאה בשם reviewer.

  3. 3

    יוצרים את הסקריפט

    שמרו את block-danger.sh ב-.claude/hooks/. ב-⁠macOS וב-⁠Linux הריצו chmod +x. ודאו ש-⁠jq מותקן.

  4. 4

    מחברים ל-⁠settings

    הוסיפו את בלוק ה-⁠PreToolUse ל-.claude/settings.json, והקלידו /hooks כדי לראות שהוא נרשם.

  5. 5

    בודקים חסימה

    בקשו מ-⁠Claude להריץ git push --force בפרויקט הניסיוני. אמורה להגיע הודעת Blocked, ו-⁠Claude יציע דרך אחרת.

שאלו את עצמכם: איזו משימה אצלכם חוזרת על עצמה ומחזירה פלט ארוך? שם סוכן-משנה ירוויח את מקומו.

טעויות נפוצות

  • תיאור עמום בשדה description. Claude מאציל לפיו, אז כתבו מתי להשתמש בסוכן.
  • כתיבת שם שדה לא נכון. לפי התיעוד, Claude Code מתעלם משדה שלא מתאים בדיוק, למשל maxTurns ולא max_turns.
  • hook שמדפיס טקסט לפני ה-⁠JSON. פלט מפרופיל המעטפת יכול להפר את ההחלטה. בדקו עם claude --debug ובתיעוד ה-⁠troubleshooting.
  • שכחת exit 2. יציאה בקוד אחר, חוץ מ-0 ו-2, בדרך כלל לא חוסמת.
  • hook על כל אירוע. הוא רץ שוב ושוב ומאט את העבודה.
סיימתי את השיעור אם...0%

השיעור הבא: פרויקט מסכם, מחיר ושימוש ב-⁠Claude Code (קלוד קוד) →

למאמר מעמיק על תוספים וסוכנים: תוספים לקלוד קוד. לתמונה הכללית: מדריך קלוד קוד המלא. לסיכום הקורס: /courses/claude-code/.

20 דק׳ קריאה

חשבון גיקזילה