לומדים

התשובה הקצרה

רוב המתרגשים חושבים ש"agent" ב‑Claude Code זה "skill עם צעדים נוספים". המודל המנטלי הזה מטעה — ובצורה שתועלתית.

Skill טוענת הוראות לחלון השיחה הנוכחי. לעומת זאת, subagent רץ ב‑חלון הקשר משלו, עם system prompt מותאם, גישה ל־tools מסוימים והרשאות נפרדות, ואחר כך מחזיר תוצאה. ההבדל החשוב הוא איפה העבודה מתבצעת — ואיפה הטוקנים נאכלים.

אבל המילה "agents" ב‑Claude Code מתארת לפחות ארבעה דברים שונים, ולבלבל ביניהן מקשה על ההבנה של הפיצ'ר.

ארבע המשמעויות של "agent"

1. Claude Code עצמו הוא סביבה agentic. ה‑CLI כבר כולל כלים, לולאת ביצוע, ויכולת לתכנן ולפעול במספר שלבים. הוא agentic גם לפני שקונפיגרת דבר.
2. Subagents הם ה‑primitive המובנה המותאם. כשמישהו אומר "בונה agent", הוא ברוב המקרים מתכוון ל‑subagent: עוזר ממוקד שרץ בחלון הקשר משלו עם system prompt מותאם, גישה לכלים ספציפיים והרשאות עצמאיות.
3. Agent teams הם שכבה נפרדת, של multi‑session. subagents עובדים בתוך סשן יחיד; agent teams מתאמים בין סשנים נפרדים. Teams הם מופעים נפרדים של Claude Code שמתקשרים דרך רשימת משימות משותפת והודעות בין עמיתים. הם ניסיוניים, כבויים כברירת מחדל, ודורשים דגל בסביבה.
4. ה‑Claude Agent SDK הוא אותם כלים ולולאת agent שנחשפים כספרייה לתכנות מחוץ ל‑CLI.

הפוסט הזה עוסק בשכבה השנייה — subagents.

למה יש subagents: ניהול הקשר

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

subagent משנה את הצורה של הבעיה הזו. בקשו ממנו לחקור למה מערכת הבדיקות נכשלה: הוא יקרא 20 קבצים, יחפש דפוסי שגיאה, יבדוק קונפיג — הכל בתוך ה‑window שלו. ה‑thread הראשי שלכם מקבל תקציר נקי, לא את חיפוש הקבצים. התיעוד הרשמי אומר את זה במפורש: עבודת subagent לא צורכת את הקונטקסט הראשי שלכם.

שלוש סיבות משניות:

• מומחיות — מבקר ממוקד עם הסטנדרטים של הצוות שלכם בתוך ה‑system prompt שלו אמין יותר מעוזר כללי שמחזיק סטנדרטים לצד כל השאר.
• אכיפת מגבלות — אתם מגדירים במפורש אילו כלים ל‑subagent מותר להשתמש. סוכן מחקר לקריאה בלבד שלא יכול לכתוב קבצים או להריץ shell הוא פרופיל סיכון שונה מהעוזר הראשי.
• בקרת עלות — אפשר להריץ subagents על מודלים שונים. ניתוב משימות קלות ל‑Haiku בעוד הסשן הראשי רץ על Sonnet זה מנגנון שליטה בעלויות.

בנייה של subagent

subagent הוא קובץ Markdown עם frontmatter YAML, בתוך .claude/agents/ (פרויקט) או ~/.claude/agents/ (אישי).

---
name: code-reviewer
description: Reviews code changes for quality, security, and best practices.
 Use proactively after any significant code change.
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, read the changed files and provide
specific, actionable feedback. Focus on what matters. Flag security issues
first, then logic problems, then style.

השדות:

• name — מזהה ייחודי, אותיות קטנות, מקפים בלבד.
• description — השדה החשוב ביותר. Claude קורא אותו כדי להחליט האם להעביר משימה. כתבו אותו בהתנהגות: מה הסוכן עושה ומתי משתמשים בו. "Use proactively" הוא סיגנל מתועד להפעיל בלי בקשה מפורשת.
• tools — מגביל מה הסוכן יכול להגיע אליו. disallowedTools יורש את הסט הכלים של הסשן הראשי ואז מסיר כלים ספציפיים.
• model — ניתוב ל‑sonnet, opus, haiku, או מזהה מודל מלא. השאירו ריק כדי לרשת את המודל של הסשן הראשי.
• Body — הופך ל‑system prompt של הסוכן. הוא מקבל את זה, את תיקיית העבודה, ושום דבר אחר מהסשן הראשי.

המבקר הזה יכול לקרוא ולחפש אבל לא יכול לערוך או להריץ shell — מבקר לקריאה בלבד לא יכול לשנות באופן לא מכוון את מה שהוא בוחן.

Agents מול skills: איפה הגבול

Skills ו‑subagents שניהם חיים בתוך .claude/, שניהם משתמשים ב‑frontmatter, שניהם מערכות הוראות. ההבדל הוא במקום שבו העבודה מתבצעת:

• Skill נטענת לשיחה הנוכחית; ההוראות והקבצים המקוריים שלה נכנסים לקונטקסט הפעיל. Claude פועל על פיהן באותו thread, וכל צעד מצטבר בחלון הראשי.
• Subagent רץ בנפרד בחלון הקשר משלו ומחזיר תוצאה.

משפט שמייצג את זה:

> Skill משנה מה ש‑Claude יודע או איך הוא צריך לגשת לוורקפלואו. > Subagent משנה מי מבצע את העבודה, באיזה קונטקסט, ובאילו כלים.

דוגמה קונקרטית: לאכוף את סטנדרטי הבדיקה של הצוות לאורך כל הסשן — השתמשו ב‑skill. לבדוק 40 קבצים בפעם אחת מבלי למלא את הקונטקסט הראשי — השתמשו ב‑subagent.

שיטות עבודה מומלצות

• ה‑description הוא ממשק הניתוב. Claude קורא תיאורים כדי להחליט מתי לוותר על משימה — הוא לא קורא את ה‑body ראשון. כתבו תנאי הפעלה, לא זהות. "You are an expert reviewer with 20 years of experience" שייך ל‑system prompt, לא ל‑description.
• הגבילו כלים במכוון. סוכן שיורש את כל הכלים הוא כזה שקשה לנבא מה יקרה כשהוא ייקלקל. תנו רק את מה שהמשימה צריכה. הגבלת כלים היא גם אבטחה וגם ניבוי.
• משימה אחת לסוכן. תיאור אחד עבור "בוחן קוד, כותב בדיקות, מעדכן דוקס ומטפל בפריסה" יתנהג באופן לא עקבי. שלוש קבצים צרים מנצחים קובץ רחב אחד. הקונצנזוס בקהילה — אוספים של 100+ subagents צרים — מצביע על אותו כיוון: סוכנים ממוקדים רבים עדיפים על אחד כל‑תכליתי.
• השתמשו ב‑model כידית עלות. haiku על סוכנים שגרתיים מוריד עלות; opus מצדיק את עצמו בהקשרים ארוכים וכבדי הסקה. ברירת המחדל (inherit) מיישמת את המודל הכי חזק על הכל, שלעתים גדולה מדי.

מילה מהירה על agent teams

Agent teams הם סשנים נפרדים של Claude Code המתואמים דרך סשנים נפרדים באמצעות רשימת משימות משותפת והודעות בין עמיתים. הם ניסיוניים, כבויים כברירת מחדל, וצורכים טוקנים במידה משמעותית יותר (לכל עמית יש חלון הקשר שמחויב בנפרד).

האות המעשי: כל עוד ה‑subagents שלכם מדווחים בחזרה אליכם ולא צריכים לדבר אחד עם השני, אתם לא צריכים agent teams. ברגע שאחד צריך להעביר ממצאים לאחר — אז השדרוג מצדיק את העלות.

מתי subagents אינם הכלי המתאים

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

דלגו על subagent אם:

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

מסקנה

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

---

Primary sources: Claude Code docs on subagents and agent teams, and Anthropic's context-engineering guidance. Definitions and experimental status verified against official docs on 2026-08-07.