$ man how-to/subagents-vs-agent-teams

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

PATTERN

Subagents מופעלים באמצעות כלי Agent בתוך סשן Claude Code. אתה מציין את המשימה, סוג הסוכן (Explore, Plan, כללי), ואופציונלית מצב בידוד (worktree לענפי git נפרדים). כל subagent מקבל חלון הקשר משלו. הוא יכול לקרוא קבצים, להריץ פקודות, לחפש קוד, ולהחזיר תוצאות. כשהוא מסיים, התוצאה חוזרת לסשן ההורה. מאפיינים מרכזיים: תקשורת חד-כיוונית. ההורה שולח משימה, ה-subagent מחזיר תוצאה. ללא משא ומתן הלוך ושוב. מערכת קבצים משותפת. Subagents רואים את אותו repo (אלא אם משתמשים בבידוד worktree). שינויים מ-subagent אחד גלויים לאחרים. תזמור הורה. הסשן הראשי מחליט מה להאציל, מתי להפעיל, ואיך לשלב תוצאות. עלות: כל subagent צורך tokens ביחס למשימתו. חיפוש קובץ מהיר עשוי לצרוך 5K tokens. חקירה עמוקה עשויה לצרוך 50K. הסשן ההורה נושא בעלות. הכי טוב ל: מחקר מקבילי, חיפושי קבצים עצמאיים, יצירת תוכן במקביל, כל משימה שבה צריך מהירות דרך מקביליות אבל המשימות עצמאיות.

PATTERN

צוותי סוכנים הם תכונה ניסיונית (הפעלה דרך CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1). סשן אחד משמש כראש צוות. הוא יוצר משימות ברשימת משימות משותפת. חברי צוות תובעים משימות, עובדים עליהן, ומתקשרים תוצאות אחד לשני. מאפיינים מרכזיים: תקשורת עמית-לעמית. חברי צוות שולחים הודעות ישירות אחד לשני. ראש הצוות לא צריך להעביר כל פיסת מידע. מערכת משימות משותפת. משימות מפורסמות ברשימה משותפת. חברי צוות תובעים משימות לפי זמינות ויכולת. לא נדרשת הקצאה מרכזית. חלונות הקשר עצמאיים. לכל חבר צוות יש הקשר מלא משלו. הם יכולים להחזיק מודלים מנטליים שונים של ה-codebase ולשתף תגליות דרך הודעות. אוטונומיה גבוהה יותר. חברי צוות יכולים לגלות בעיות, ליצור משימות חדשות, ולתאם פתרונות בלי שראש הצוות מכוון כל צעד. עלות: כל חבר צוות הוא מופע Claude מלא. צוות של 3 משתמש בערך פי 3 tokens. צוות של 5 משתמש פי 5. זה מצטבר מהר. הכי טוב ל: פיצ'רים מורכבים רב-מודוליים, סקירות קוד מקבילות עם תחומי מיקוד שונים, דיבאג עם השערות מתחרות, וכל משימה שבה סוכנים צריכים להגיב לתגליות אחד של השני.

FORMULA

השתמש ב-subagents כש: - המשימות עצמאיות (שום משימה לא תלויה בפלט של משימה אחרת) - התקשורת חד-כיוונית (שלח משימה, קבל תוצאה) - אתה רוצה שהסשן ההורה ישמור על שליטה מלאה - התקציב חשוב (subagents זולים יותר) - המשימות מוגדרות היטב עם קריטריוני השלמה ברורים השתמש בצוותי סוכנים כש: - משימות מתקשרות (שינויי frontend משפיעים על backend, ממשקים משותפים) - סוכנים צריכים להגיב לתגליות אחד של השני - מרחב הבעיה עמום ודורש חקירה - אתה רוצה שסוכנים יאתגרו את הגישות אחד של השני - העבודה תיקח לסשן בודד יותר מדי זמן ונהנית ממקביליות אמיתית השתמש בסשן בודד כש: - המשימה רציפה (כל שלב תלוי בקודם) - ה-codebase קטן מספיק לחלון הקשר אחד - אתה צריך שליטה הדוקה על כל החלטה - עלות חשובה יותר ממהירות דוגמה אמיתית מתהליך העבודה שלי: אני משתמש ב-subagents יומיומית למחקר מקבילי - "חקור את מודול ה-auth," "מצא את כל נקודות ה-API," "בדוק כיסוי בדיקות." אלה שאילתות עצמאיות. אני משתמש בצוותי סוכנים לפיצ'רים רב-יומיים - "בנה את הדשבורד החדש" שבו סוכן אחד מטפל בשכבת ה-API, אחר מטפל ברכיבי ה-UI, ושלישי כותב בדיקות. הם צריכים לתאם על חוזה הממשק בין השכבות.

PRO TIP

Subagents זולים. subagent חקירה טיפוסי משתמש ב-10-50K tokens. בתמחור הנוכחי, זה אגורות. אתה יכול להפעיל 5-10 subagents במקביל בלי לחשוב על עלות. צוותי סוכנים יקרים. כל חבר צוות מתחזק חלון הקשר מלא שגדל עם כל הודעה וקריאת קובץ. צוות של 3 שעובד שעה יכול לצרוך 500K-1M tokens. בתמחור API, זה דולרים. במנוי Max, זה נספר מול מגבלות השימוש שלך. הכלל: התחל עם subagents. שדרג לצוותי סוכנים רק כשאתה נתקל בבעיית תיאום אמיתית ש-subagents לא יכולים לפתור. רוב המשימות לא צריכות צוותי סוכנים. תבנית סשן-בודד-עם-subagents מטפלת ב-90% מהעבודה המקבילית. אפשרות נוספת: כמה טאבים בטרמינל, כל אחד מריץ סשן Claude Code עצמאי על חלקים שונים של ה-codebase. זה נותן לך מקביליות בלי העומס של צוותי סוכנים. הפשרה היא שסשנים לא יכולים לתקשר - אתה המתזמר.