Nested Subagents ב-Claude Code: הפיצ'ר שמשנה את כל בניית סוכני ה-AI (ואף אחד לא כתב עליו בדוקומנטציה)

יש שינויים בעולם ה-AI שמקבלים כותרות, ויש שינויים שנכנסים בשקט לתוך גרסה — ומשנים לגמרי את הדרך שבה מערכות עובדות. Nested Subagents ב-Claude Code הוא בדיוק מהסוג השני: תוך ארבעה ימים בלבד אנתרופיק שינתה פעמיים את ההתנהגות של סוכנים שמפעילים סוכנים אחרים, בלי שורה אחת בדוקומנטציה הרשמית.

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

מה זה בכלל Nested Subagents?

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

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

ציר הזמן: ביטול והחזרה תוך 4 ימים

• ▸גרסה 2.1.217 (21 ביולי 2026) — Nested Subagents בוטלו לחלוטין (DISABLED).
• ▸גרסה 2.1.219 (25 ביולי 2026) — היכולת הוחזרה, הפעם עם מגבלת עומק (Depth) שניתנת להגדרה, ברירת מחדל 3.
• ▸באותו עדכון תוקן גם באג משמעותי: הדגל ‎--max-budget-usd לא נאכף על סאב־אייג'נטים שרצו ברקע.

אם הסתמכתם על ‎--max-budget-usd כדי לגדר עלויות — עד הגרסה הזו לא באמת הייתם מוגנים. זה זמן טוב לבדוק את החשבון.

משתני הסביבה שאף אחד לא סיפר לכם עליהם

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

• ▸CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3 — עומק הקינון המרבי של סוכנים.
• ▸CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20 — כמה סוכנים ירוצו במקביל.
• ▸CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200 — כמה סוכנים מותר לייצר בסשן אחד.

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

הנקודה המטרידה: שינוי התנהגות בלי דוקומנטציה

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

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

צ'קליסט מעשי למי שמריץ סוכנים בפרודקשן

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

לאן זה הולך

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

רוצים לבנות מערכות סוכנים כאלה בעצמכם?

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