برنامج Claude Code Agent Teams التعليمي: 15 خطوة من الإعداد حتى الحل
منح Agent Teams كل زميل جلسة Claude Code خاصة به، وقائمة مهام مشتركة، ومحادثة مباشرة فيما بينهم. يغطي هذا الدليل المصوَّر مفتاح settings.json، وأول فريق تنشئه، وقيادة الفريق، وحلّه — والقيود التي لا يخبرك بها أحد.
النسخة المختصرة
- ميزة Agent Teams تجريبية ومعطَّلة افتراضيًا: أضف "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" إلى كتلة env في settings.json، ثم شغّل Claude Code الإصدار 2.1.32 أو أحدث.
- عليك أن تطلبها بالكلمات — اطلب من Claude "create an agent team" وسمِّ الزملاء أو النموذج، وإلا فسيُنشئ بصمت وكلاء فرعيين عاديين.
- الزملاء لا يرثون سجل محادثتك أبدًا — سلِّمهم ملف سياق، وأبقِ كل مهمة صغيرة بما يكفي لإنتاج مخرَج واحد واضح.
- كل زميل هو نسخة مستقلة من Claude Code بنافذة سياق خاصة، فتتضاعف الرموز — خفِّض الزملاء إلى Sonnet أو Haiku عندما تسمح المهمة، وافحص /cost بعد كل تشغيل.
Claude Code Agent Teams (Full Tutorial): The BEST FEATURE of Claude Code is HERE!
الفيديو:AICodeKing13:58
Agent teams — Orchestrate teams of Claude Code sessions
الوثائق الرسمية:code.claude.comDocs
ميزة Agent Teams تجريبية: توقَّع خشونة في استئناف الجلسات وحالة المهام وتوقيت الحل. كل أمر ومفتاح إعداد واختصار في هذه الصفحة جرى التحقق منه مقابل الوثائق الرسمية قبل النشر.
اللقطات مأخوذة من تسجيل شاشة AICodeKing؛ وقد قدّم شرحا Bart Slodyczka وSimon Scrapes حقائق عملية إضافية. جميع المصادر منسوبة ومُوثَّقة بروابط، وكل خطوة تربطك بلحظتها الدقيقة في الفيديو.
من طرفية فارغة إلى فريق محلول
1. فعِّل Agent Teams وتحقق من بيئتك
- 1
اعثر على وثائق agent teams واقرأ تحذير الميزة التجريبية
تقع Agent Teams في قسم Build with Claude Code من الوثائق الرسمية. تفتح الصفحة بلافتة برتقالية: الميزة تجريبية، ومعطَّلة افتراضيًا، ولها قيود معروفة في استئناف الجلسات وتنسيق المهام والحل. اقرأ تلك اللافتة قبل تحويل أي مفتاح.
صفحة agent teams الرسمية ولافتة الميزة التجريبية.شاهد عند 0:20 - 2
قرر بين الوكلاء الفرعيين وagent teams
تتضمن الوثائق جدول مقارنة. الوكلاء الفرعيون يعملون داخل جلسة واحدة، ويعيدون النتائج إلى المستدعي، وتكلفتهم من الرموز أقل. الزملاء نسخ مستقلة من Claude Code تراسل بعضها مباشرة وتتشارك قائمة مهام — التعاون الحقيقي يكلّف رموزًا أكثر. استخدم الوكلاء الفرعيين حين يهم النتيجة فقط؛ وفريقًا حين يحتاج العاملون إلى تحيّر بعضهم بعضًا.
الوكلاء الفرعيون مقابل agent teams، من الجدول الرسمي مباشرة.شاهد عند 1:00 - 3
فعِّل المفتاح في settings.json
افتح (أو أنشئ) ~/.claude/settings.json وأضف كتلة env فيها "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1". وملفات الإعدادات على مستوى المشروع والمحلية يمكنها تفعيله أيضًا، والتصدير من الصدفة يعمل — لكن "0" في إعدادات المستخدم تتفوق على تصدير الصدفة. يسري التغيير على الجلسة الجارية دون إعادة تشغيل.
كتلة env التي تشغّل agent teams.شاهد عند 2:00 - 4
حدِّث Claude Code وشغّله واطلب الفريق بكلمات صريحة
شغّل claude update أولًا — تحتاج الفرق إلى بناء حديث (2.1.32 أو أحدث)، والإصدارات الأقدم تتجاهل المفتاح بصمت. شغّل Claude وتحقق من محدد النموذج (يستخدم الفيديو Opus 4.6 على Claude Max)، ثم اكتب موجهًا يحتوي الكلمات السحرية: "Use the agent teams feature." بدون هذه العبارة ينشئ Claude وكلاء فرعيين عاديين بدلًا من ذلك.
Claude Code v2.1.34 يستقبل موجه agent teams.شاهد عند 3:30
2. أنشئ أول فريق لك
- 5
شاهد القائد يقسّم العمل إلى قائمة مهام مشتركة
يحوّل القائد موجّهك إلى مهام، ثم ينشئ الزملاء. يعرض إدخال كل زميل مهمته و«shift+↑ to manage». انتبه لمؤشر الاعتمادية: "Build UI, styling, and user interaction > blocked by #1" — لا يستطيع زميل الواجهة تولّي مهمته قبل أن ينهي زميل المحرك عمله؛ وهكذا تمنع القائمة المشتركة ازدواجية العمل.
زmlaء اثنان في الخدمة، والمهمة #2 محجوبة بالمهمة #1.شاهد عند 4:30 - 6
دعهم يعملون واقرأ التقدم الحيّ
يعمل الزملاء بالتوازي في جلساتهم الخاصة. يعلّق القائد على الحالة — "Both agents are working" — بينما تحمل كل سطر مهمة اسم الزميل والوقت المنقضي واستهلاك الرموز. اضغط ctrl+o لتوسيع إدخال وctrl+t لإظهار لوحة الزملاء أو إخفائها في أي وقت.
عمل متوازٍ بمحاسبة رموز ووقت لكل مهمة.شاهد عند 5:00 - 7
اختياري: ثبِّت عدد الزملاء ونموذجهم
يمكنك تحديد ما تريده تمامًا: "Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate." تسمية نموذج أرخص لكل زميل هي أفضل رافعة لتوفير التكلفة — العمل الروتيني لا يحتاج Opus. وللمهام الخطرة، اطلب أيضًا اعتماد الخطة لينتظر مخطط الزميل موافقتك قبل كتابة أي كود.
مثال الوثائق الرسمي لتحديد الزملاء والنماذج.شاهد عند 6:30
3. قُد الفريق وتحقق وكرِّر
- 8
تابع تسليم الاعتمادية ومراجعة القائد
عندما ينهي زميل المحرك مهمته، تُفتح المهمة #2 ويتولّاها مطوّر الواجهة فورًا. ثم يقرأ القائد نفسه الملفات المعدلة — "Let me shut down the teammates and do a final review of the code to make sure everything integrates properly." لا تتدخل إلا إذا بدأ شيء خاطئًا.
المهمة #1 مكتملة، و#2 مفتوحة، وتبدأ المراجعة النهائية.شاهد عند 7:30 - 9
افتح المخرَج وتحقق منه بنفسك
يهبط ناتج الفريق ملفات عادية في مشروعك — هنا لعبة كنس الضبّ بثلاثة مستويات صعوبة وكشف بالامتلاء ونقرة أولى آمنة. افتحها في المتصفح واستخدمها فعلًا قبل تسريح الفريق: الوكلاء يتحققون من أكوادهم، لكن اختبار القبول مسؤوليتك.
مخرَج الفريق: نسخة عاملة من كنس الضبّ.شاهد عند 9:00 - 10
كرِّر بموجّه جديد للفريق نفسه
قائمة الميزات اجتازت الفحص، لذا يعيد الفيديو المحاولة: "Add more themes to it. Use team." في مهام البرمجة غالبًا ما يُبقي القائد الزملاء في وضع الاستعداد بدل حلّهم، فيصل طلبك اللاحق بسياق كامل لما بُني بالفعل. ولاحظ شريط الحالة: accept edits on (shift+tab للتبديل).
قائمة الميزات المُسلَّمة وموجّه الجولة الثانية.شاهد عند 10:00 - 11
قُد الأفراد من لوحة الزملاء
في فريق أكبر (التجربة الثانية في الفيديو تشغّل ستة زملاء)، تعرض اللوحة اسم كل زميل وكلمة حالة حية وعدّاد رموزه. shift+↑ / shift+↓ للاختيار، وEnter لفتح محادثته، وصندوق الرسائل يقبل الإشارات @ مثل "Message @infra-dev…" للوصول إلى زميل بعينه دون المرور بالقائد.
ستة زملاء، وعدّادات رموز حية، وصندوق رسائل بإشارة @.شاهد عند 13:30 - 12
أنحِ الزملاء بلطف
اطلب من القائد بالاسم — "Ask the ui-dev teammate to shut down" — فيوافق الزميل بعد إنهاء استدعاء الأداة الجاري أولًا. وزميل يرى عمله حيويًا يمكنه الرفض مع تفسير. وحين ينتهي كل شيء، تغلق "clean up the team" الجلسات المشتركة وتعود اللوحات إلى واحدة.
الزملاء الاثنان ينحوان بلطف أثناء التسوية.شاهد عند 8:00
4. اعرف الحدود قبل التوسع
- 13
اعرف قاعدة السياق قبل التوسع
يحمّل الزملاء CLAUDE.md وخوادم MCP والمهارات تلقائيًا، لكنهم لا يرثون سجل محادثة القائد أبدًا. سلِّم السياق صراحةً — مثال الوثائق ينشئ مراجع أمنٍ بموجّه يحدد الملفات بدقة ونقاط التركيص وصيغة التقرير. وقِس المهام بصدق: الصغيرة جدًا تُهدر التنسيق، والكبيرة جدًا تخاطر بجهد ضائع، والمناسبة هي مخرَج واحد مكتفٍ بذاته.
قاعدة وراثة السياق وقائمة قياس حجم المهام.شاهد عند 10:15 - 14
تقبّل أن الفرق لا تُستأنف
القيد الذي يفاجئ معظم الناس: /resume و/rewind لا يستعيدان الزملاء داخل العملية. بعد استئناف جلسة، قد يحاول القائد مراسلة زملاء لم يعودوا موجودين — حينها قل للقائد أن ينشئ زملاء جددًا. وتوقَّع أيضًا تأخر حالة المهام: إذا بدت مهمة عالقة، فتحقق مما إذا كان العمل منجزًا فعلًا وحدّث الحالة يدويًا.
لا استئناف للجلسة، مع تنبيه بشأن حالة المهام.شاهد عند 10:30 - 15
راجع القيود المتبقية ثم اختر عملًا حقيقيًا
ثلاث قواعد أخرى من الوثائق: القائد ثابت (لا يمكن ترقية زميل)، والأذونات المحددة عند الإنشاء تنتشر إلى الجميع — --dangerously-skip-permissions تسري على كل زميل، فغيِّر وضع المراجع لاحقًا إن لم ينبغي أن يعدّل — والألواح المنقسمة تتطلب tmux أو iTerm2، لأن الطرفية المدمجة في VS Code وWindows Terminal وGhostty غير مدعومة. ثم ابدأ بثلاثة إلى خمسة زملاء في عمل يتطلب تعاونًا حقيقيًا.
القائد ثابت، والأذونات تنتشر، والألواح المنقسمة تحتاج tmux.شاهد عند 11:30