- סוכן-משנה (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
יוצרים את הסוכן
צרו את הקובץ .claude/agents/reviewer.md עם התוכן מהדוגמה למעלה. אם Claude Code לא מוצא את הסוכן, הפעילו אותו מחדש.
- 2
קוראים לו
כתבו: Use the reviewer subagent to review my latest changes against SPEC.md. בשורת הפלט תראו קריאה בשם reviewer.
- 3
יוצרים את הסקריפט
שמרו את block-danger.sh ב-.claude/hooks/. ב-macOS וב-Linux הריצו chmod +x. ודאו ש-jq מותקן.
- 4
מחברים ל-settings
הוסיפו את בלוק ה-PreToolUse ל-.claude/settings.json, והקלידו /hooks כדי לראות שהוא נרשם.
- 5
בודקים חסימה
בקשו מ-Claude להריץ git push --force בפרויקט הניסיוני. אמורה להגיע הודעת Blocked, ו-Claude יציע דרך אחרת.
שאלו את עצמכם: איזו משימה אצלכם חוזרת על עצמה ומחזירה פלט ארוך? שם סוכן-משנה ירוויח את מקומו.
טעויות נפוצות
- תיאור עמום בשדה description. Claude מאציל לפיו, אז כתבו מתי להשתמש בסוכן.
- כתיבת שם שדה לא נכון. לפי התיעוד, Claude Code מתעלם משדה שלא מתאים בדיוק, למשל
maxTurnsולאmax_turns. - hook שמדפיס טקסט לפני ה-JSON. פלט מפרופיל המעטפת יכול להפר את ההחלטה. בדקו עם
claude --debugובתיעוד ה-troubleshooting. - שכחת
exit 2. יציאה בקוד אחר, חוץ מ-0 ו-2, בדרך כלל לא חוסמת. - hook על כל אירוע. הוא רץ שוב ושוב ומאט את העבודה.
השיעור הבא: פרויקט מסכם, מחיר ושימוש ב-Claude Code (קלוד קוד) →
למאמר מעמיק על תוספים וסוכנים: תוספים לקלוד קוד. לתמונה הכללית: מדריך קלוד קוד המלא. לסיכום הקורס: /courses/claude-code/.