$ man how-to/agent-teams-claude-code

צוותי סוכנים הם סשנים של Claude Code שיכולים לדבר אחד עם השני. הערכים המוקדמים יותר על סוכנים מקבילים במדריך הזה מכסים תת-סוכנים, שהם fire-and-forget. אתה משיק תת-סוכן, הוא מבצע את המשימה שלו, הוא מדווח חזרה להורה. זה הכל. אין תקשורת בין תת-סוכנים. אין מעקב משימות משותף. אין תיאום מעבר למה שההורה מתזמר. צוותי סוכנים מוסיפים שלושה דברים שאין לתת-סוכנים. ראשית, רשימת משימות משותפת שכל חבר צוות יכול לקרוא ולעדכן. שנית, הודעות ישירות בין סוכנים, לא רק הורה-לילד אלא עמית-לעמית. שלישית, ניהול מחזור חיים כדי שמוביל הצוות יכול ליצור, להקצות, לעקוב ולסגור חברי צוות מסשן אחד. ההבדל המעשי: תת-סוכנים טובים למשימות מקבילות עצמאיות שבהן אף סוכן לא צריך לדעת מה סוכן אחר עושה. צוותים טובים למשימות מקבילות מתואמות שבהן סוכנים צריכים להעביר הקשר, לבדוק את העבודה אחד של השני, או להתאים בהתבסס על מה שחבר צוות גילה. אם אי פעם ניהלת צוות קטן של אנשים, המודל המנטלי זהה. אתה מקצה משימות, אנשים עובדים במקביל, הם שולחים לך הודעות עם שאלות, אתה סוקר פלט, ואתה מחליט מתי העבודה גמורה.

CODE

צוותי סוכנים הם ניסיוניים נכון לפברואר 2026. הפעל אותם על ידי הוספת משתנה הסביבה להגדרות Claude Code: ב~/.claude/settings.json: { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } הפעל מחדש את Claude Code אחרי ההוספה. הפיצ'ר לא יופעל עד הסשן הבא. ברגע שמופעל, אפשר לבקש מClaude ליצור צוות בשפה טבעית או שזה קורה דרך כלי TeamCreate. צוות מקבל שם, תיאור, וקובץ הגדרות ב~/.claude/teams/{team-name}/config.json. ההגדרות עוקבות אחרי חברי הצוות עם שמותיהם, מזהי הסוכנים שלהם ותפקידיהם. כל צוות מקבל רשימת משימות תואמת ב~/.claude/tasks/{team-name}/. זה מעקב העבודה המשותף שכל חבר צוות יכול לקרוא ולכתוב. מצבי תצוגה חשובים. ברירת המחדל היא in-process, שבו כל חברי הצוות רצים בטרמינל הראשי ואתה משתמש בShift+Down כדי לעבור ביניהם. אם יש לך tmux או iTerm2, הגדר "teammateMode": "tmux" בsettings.json וכל חבר צוות מקבל חלונית מפוצלת משלו. תצוגת החלוניות מקלה על מעקב אחרי עבודה מקבילית. אפשר גם להעביר --teammate-mode בשורת הפקודה לסשנים חד-פעמיים.

PATTERN

משימות הן עמוד השדרה של התיאום. כל יחידת עבודה מקבלת משימה עם נושא, תיאור, סטטוס (pending, in_progress, completed), ותלויות אופציונליות. תלויות הן הפיצ'ר המפתח. משימה 4 יכולה להיות חסומה על ידי משימות 2 ו3. זה אומר שאף אחד לא מרים משימה 4 עד ששתי המשימות 2 ו3 גמורות. זה אוכף משמעת גלים אוטומטית. אתה לא צריך לפקח על הרצף. רשימת המשימות אוכפת את זה. תהליך העבודה: מוביל הצוות יוצר משימות, מגדיר תלויות, ומקצה בעלים. חברי צוות בודקים את רשימת המשימות אחרי השלמת כל יחידת עבודה כדי למצוא מה זמין הבא. הם תובעים משימות לא חסומות, עובדים עליהן, מסמנים אותן כהושלמו, ובודקים מה הבא. טיפ: העדף הקצאת משימות בסדר מזהה (הנמוך ביותר קודם) כשמספר משימות זמינות. משימות מוקדמות יותר לעתים קרובות מגדירות הקשר שמשימות מאוחרות תלויות בו. זו אותה תבנית גלים מהמדריך על סוכנים מקבילים, רק מפורמלת למערכת משימות במקום תזמור ידני.

PATTERN

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

PRO TIP

הסוכנים הם לא הפריצה. שכבת הניהול היא. בלי אילוצים, סוכנים מקבילים יוצרים כאוס. שני סוכנים עורכים את אותו קובץ והכתיבה האחרונה מנצחת בשקט. סוכן מקבל החלטה ארכיטקטונית שסותרת הנחה של סוכן אחר. פריסה יוצאת לפני שכל הסוכנים מסיימים. שכבת הניהול היא קובץ אילוצים שכל חבר צוות קורא לפני ביצוע כל שינוי. הTEAM-CONSTRAINTS.md שלי אוכף שישה כללים: 1. בעלות על קבצים. כותב אחד לקובץ לגל. אין שני סוכנים נוגעים באותו קובץ בו-זמנית. 2. תיעוד החלטות. כשסוכן מקבל בחירה (מוסכמת שמות, נתיב ייבוא, מבנה נתונים), הוא שולח הודעה למוביל הצוות עם תחילית [DECISION]. ההחלטה הזו הופכת לזמינה לכל חברי הצוות. 3. קרא לפני שאתה כותב. כל סוכן קורא דוגמה קיימת של מה שהוא עומד ליצור. הקוד הקיים הוא מדריך הסגנון. 4. משמעת גלים. משימות תשתית קודם, צרכנים שני, אינטגרציה שלישי, אימות אחרון. אין דילוגים. 5. שער build. אין פריסה עד שהbuild עובר נקי ומוביל הצוות מאשר. 6. הקשר לפני פעולה. כל חבר צוות מקבל את קובץ האילוצים, תיאור משימה ספציפי, הפניות לקבצים, וגבולות בעלות. אם משהו חסר, הסוכן שואל לפני שממשיך. אתה לא צריך בדיוק את קובץ האילוצים שלי. אתה צריך קובץ אילוצים כלשהו. הכללים הספציפיים חשובים פחות מהקיום של כללים בכלל. בלעדיהם, סוכנים סוטים. איתם, סוכנים מתאמים.

FORMULA

השתמש בתת-סוכנים (כלי Task) כשמשימות עצמאיות לחלוטין. אף סוכן לא צריך פלט מסוכן אחר. אף סוכן לא צריך לבדוק עבודה של סוכן אחר. לכל משימה יש קלט ברור ופלט ברור ללא תלויות צולבות. דוגמה: שלושה סוכנים שכל אחד כותב דף ויקי נפרד שלא מפנה לאחרים. השתמש בצוותים כשמשימות מתואמות. סוכנים צריכים להעביר הקשר. הפלט של סוכן אחד מזין את הקלט של סוכן אחר. מישהו צריך לסקור לפני שהשלב הבא מתחיל. דוגמה: חוקר אוסף נתונים, כותב הופך אותם לתוכן, סוקר בודק התאמת קול, וסוכן פריסה דוחף את התוצאה. הפרש העלות חשוב. צוותים משתמשים בערך פי 7 יותר טוקנים מסשן יחיד כי כל חבר צוות מריץ חלון הקשר משלו. שמור צוותים קטנים (2 עד 4 סוכנים), משימות ממוקדות, ונקה כשגמרת. אל תקים צוות למשימה שסוכן ממוקד אחד יכול לטפל בה. מגבלות נוכחיות שכדאי לדעת: צוות אחד לסשן, אין צוותים מקוננים (חברי צוות לא יכולים ליצור צוותים משלהם), תפקיד המוביל קבוע (אי אפשר להעביר מנהיגות באמצע סשן), וחידוש סשן לא עובד עם חברי צוות in-process. אלה אילוצים ניסיוניים שכנראה ישתפרו. מסגרת ההחלטה: אם אתה יכול לתאר את המשימה בפרומפט אחד והסוכן יכול לסיים בלי לשאול אף אחד שאלה, השתמש בתת-סוכן. אם המשימה כוללת העברות, סקירות, או תיאום רב-שלבי, השתמש בצוות.