סוכני משנה בקלוד קוד: מתי, ואיך מגדירים

מה זה סוכן משנה, ומתי צריך אחד?

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

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

היתרון השני הוא מקביליות: אפשר לשגר כמה סוכני משנה בבת אחת — אחד סורק קוד, שני בודק תיעוד, שלישי מריץ בדיקות — וכולם עובדים במקביל. ההיררכיה גם כבר אינה שטוחה: מגרסה 2.1.219 סוכן משנה יכול לפתוח סוכני משנה משלו, עד עומק 3 כברירת מחדל. מי שמעדיף את ההתנהגות הישנה מכבה את הקינון במשתנה הסביבה CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH.

כאן כדאי לדעת איפה נגמר הגבול. בשיחה רגילה קלוד הוא המתזמר: הוא מחליט תור אחר תור את מי לשגר, וכל תוצאה חוזרת אל חלון ההקשר שלו — ולכן יש תקרה, וברירת המחדל היא עד 20 סוכני משנה שרצים במקביל. למשימות בסדר גודל אחר, כמו הגירה של מאות קבצים, קלוד קוד כותב workflow: סקריפט שמחזיק את התזמור בעצמו, מריץ עד 16 סוכנים במקביל, ומחזיר לשיחה רק את התשובה הסופית. ההסבר המלא — מתי זה מתאים, איך מפעילים וכמה זה עולה — נמצא בworkflows בקלוד קוד, והדרך המהירה לראות את זה עובד היא הפקודה ‎/deep-research‎: צוות מחקר בפקודה אחת.

איך מגדירים סוכן משנה?

סוכן משנה הוא קובץ Markdown בתיקיית ‎.claude/agents‎ של הפרויקט (או ב-‎~/.claude/agents‎ כדי שיהיה זמין בכל הפרויקטים). מבנה הקובץ פשוט: כותרת עם ההגדרות, וגוף שהוא הוראות התפקיד. הנה סוקר קוד אמיתי:

---
name: code-reviewer
description: בודק שינויי קוד לפני commit. הפעל אחרי כתיבת פיצ'ר או תיקון.
tools: Read, Grep, Glob
model: haiku
---

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

שלוש שורות שמעצבות את ההתנהגות:

• ‎description‎: זה מה שהסוכן הראשי קורא כדי להחליט מתי להאציל לסוכן הזה. תיאור ברור (“בודק שינויי קוד לפני commit”) שווה יותר משם מתוחכם
• ‎tools‎: מגבילים את הסוכן רק לכלים שהוא באמת צריך. סוקר קוד צריך לקרוא ולחפש — לא לכתוב. הגבלה כזאת היא גם אבטחה
• ‎model‎: על איזה מודל הסוכן ירוץ (תכף נראה למה זה משנה)

מודל שונה לכל סוכן: איך זה חוסך

ברירת המחדל היא שסוכן משנה רץ על אותו מודל כמו השיחה הראשית. אבל לא כל משימת עזר דורשת את המודל הכבד: סריקת קבצים, סינון תוצאות והרצת בדיקות הן עבודה מכנית שמודל מהיר וזול עושה מצוין. מנתבים אותה למודל כמו Haiku, ושומרים את המודל היקר למקום שבו הוא באמת נדרש — השיחה עצמה.

Haiku 4.5 מהיר וזול

Sonnet 5 מאוזן

Opus 4.8 דור קודם

Opus 5 מתקדם

Fable 5 מודל הדגל

מהיר וחסכוני יכולת מרבית

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

איך מפעילים סוכן משנה?

יש שלוש דרכים, מהאוטומטית לידנית:

• האצלה אוטומטית: קלוד קורא את ה-‎description‎ של הסוכנים הזמינים ומחליט בעצמו מתי משימה מתאימה לאחד מהם. תיאור טוב הוא כל מה שצריך
• קריאה מפורשת: מבקשים במפורש — “תריץ את code-reviewer על השינויים” — וקלוד משגר אותו
• סשן שלם על סוכן: אפשר לפתוח את קלוד קוד ישירות בזהות של סוכן מסוים עם ‎claude —agent code-reviewer‎, למשל בהרצה מתוזמנת שכל תפקידה סקירה

מתי דווקא לא?

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

שורה תחתונה

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

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

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