العمل المتوازي في Claude Code: worktree والوكلاء وسير العمل
Markdownأربع طبقات للعمل المتوازي في Claude Code، وعزل الملفات باستخدام git worktree، والتحقق من النتائج، وأدوات الواجهة الرسومية، وحدود عبء العمل والرموز.
قراءة المقال كاملًا
أهم النقاط
يوفر Claude Code أربع طرق لتقسيم العمل بين عدة وكلاء: وكلاء فرعيون في جلسة واحدة، ومهارات تتضمن تعليمات، وفرق وكلاء لها قائد ونوافذ منفصلة، وDynamic Workflows، وهي شيفرة JavaScript يشغّلها وقت التشغيل. إذا أردت تشغيل أكثر من خمس نسخ من Claude Code بالتوازي على جهاز واحد، فاستخدم git worktree لعزل الملفات. الحد الرسمي لوقت التشغيل هو 16 وكيلًا في الوقت نفسه، و1000 لكل عملية تشغيل. المشكلة الأساسية ليست في الشيفرة. فعبارة «لدي 50 وكيلًا يعملون» تعني غالبًا «هناك 50 وكيلًا يولّدون كلامًا فارغًا بالتوازي من دون أن يراجعه أحد». تعالج Outcomes هذه المشكلة عبر قائمة معايير ووكيل مراجعة مستقل.
مواد عملية للعمل مع الوكلاء بالتوازي: وثائق Ailoot.
يجمع هذا الدليل الخبرة العملية وخريطة توضح مواضع استخدام الأدوات. ويعرض العناصر الرسمية الأربعة في Claude Code، وخريطة لمجالات استخدامها، وإطارًا لمقاومة المبالغة يوضح عدد الوكلاء المتوازيين الذي يحتاج إليه فعلًا من يمارس البرمجة بالحدس. ترتبط جميع الأرقام والاقتباسات بمصادر أولية من Anthropic.
ما المقصود بتعدد الوكلاء في Claude Code، ولماذا لا يعني «1000 وكيل»؟
أهم النقاط
تعدد الوكلاء في Claude Code هو أي حالة تنفّذ فيها عدة مسارات عمل مهمةً بدلًا من محادثة واحدة. قد يعني ذلك عدة جلسات في نوافذ مختلفة، أو قائدًا مع وكلاء تابعين داخل جلسة واحدة، أو نصًا برمجيًا ينسّقه وقت التشغيل. «1000 وكيل» هو الحد التقني الأعلى لسير عمل ديناميكي واحد. إنه حاجز حماية من حلقة تشغيل جامحة، وليس توصية بحجم عبء العمل.
إعداد تعدد الوكلاء هو إعداد تُقسّم فيه المهمة إلى عدة مسارات عمل مستقلة، يتولى كل منها جزءًا منها ويعيد نتيجة. أبسط مثال: تكتب الواجهة الأمامية في نافذة Claude Code والواجهة الخلفية في نافذة أخرى على الجهاز نفسه، مع مستودع git مشترك بينهما. هذا وحده يُعد تعددًا للوكلاء، حتى لو كان وصفه بأنه «تنسيق» كلمة غير ضرورية.
إعداد أكثر تعقيدًا: تشغّل داخل جلسة Claude Code واحدة خمسة وكلاء فرعيين بأدوار مختلفة (مطوّر واجهة أمامية، ومطوّر واجهة خلفية، ومراجع أمان، ومختبِر، وكاتب توثيق)، ويعيد كل منهم الجزء الخاص به من النتيجة إلى المحادثة المشتركة. إنه النهج نفسه، لكن بنقطة تحكم واحدة.
إعداد أكثر تعقيدًا: تقول لـ Claude: «أجرِ تدقيقًا أمنيًا أسبوعيًا على الملفات الـ 500 كلها في مشروعي»، فيكتب نصًا برمجيًا للتنسيق باستخدام JavaScript. يشغّل وقت التشغيل عشرات الوكلاء في الخلفية، ويدقق كل وكيل قسمه، ثم يتحقق وكلاء مستقلون من نتائج بعضهم بعضًا، وتحصل على تقرير واحد. هذا هو Dynamic Workflows، الذي أطلقته Anthropic في 28 مايو 2026. للاطلاع على تفصيل الميزات، راجع الدليل المنفصل إلى Dynamic Workflows.
الفرق بين هذه السيناريوهات الثلاثة ليس عدد الوكلاء. الفرق هو من يقرر ما الذي سيفعله الوكيل التالي. في السيناريو الأول أنت من يقرر. وفي الثاني يقرر Claude مع تقدم المحادثة. أما في الثالث فنص JavaScript كتبه Claude هو من يقرر.
وبالمناسبة، «1000 وكيل» رقم حقيقي. إنه الحد الأعلى لسير عمل ديناميكي واحد في Claude Code. تقول وثائق Anthropic الرسمية:
ما يصل إلى 16 وكيلًا متزامنًا، وعدد أقل على الأجهزة ذات قدرة CPU المحدودة. إجمالي 1000 وكيل لكل عملية تشغيل، لمنع الحلقات الجامحة.
بعبارة أخرى، هذا إجراء وقائي تقني ضد السلوك الجامح، وليس عبء عمل موصى به. عمليًا، تنجز 95% من المهام عبر 2–8 مسارات عمل متوازية. إذا كنت تخطط لاستخدام عدد أكبر، فاسأل نفسك أولًا عمّا ستفعله.
العناصر الأربعة في Claude Code: الوكلاء الفرعيون والمهارات وفرق الوكلاء وسير العمل
أهم النقاط
تصف وثائق Claude Code الرسمية أربع طبقات متميزة للعمل متعدد الوكلاء. الوكلاء الفرعيون عاملون مؤقتون ضمن جلسة واحدة. والمهارات تعليمات يتبعها Claude. أما فرق الوكلاء فهي «زملاء» دائمون في نوافذ منفصلة، يقودهم قائد. وسير العمل نصوص برمجية ينسّقها وقت التشغيل. لكل منها حد تزامن خاص ومكان لحفظ النتائج الوسيطة.
لدى Claude Code أربعة عناصر رسمية لتقسيم مهمة واحدة بين عدة وكلاء. جمعتها Anthropic في جدول مقارنة ضمن وثائق Dynamic Workflows. إليك المقارنة بلغة بسيطة:
| الوكلاء الفرعيون | المهارات | فرق الوكلاء | سير العمل | |
|---|---|---|---|---|
| ما هو؟ | عامل يشغّله Claude | تعليمات يتبعها Claude | قائد وفريق في نوافذ منفصلة | نص برمجي ينفذه وقت التشغيل |
| من يحدد الخطوات؟ | Claude مع تقدم المحادثة | Claude استنادًا إلى التعليمات | القائد | النص البرمجي نفسه |
| أين توجد النتائج؟ | في نافذة سياق Claude | في نافذة السياق | في قائمة مهام مشتركة | في متغيرات النص البرمجي |
| ما الذي يمكن إعادة استخدامه؟ | وصف العامل | التعليمات نفسها | وصف الفريق | التنسيق بأكمله |
| الحجم | بضعة وكلاء في كل مرة | العدد نفسه | بضعة زملاء دائمين | عشرات ومئات في كل عملية تشغيل |
| ماذا يحدث عند المقاطعة؟ | يُعاد بدء الدور | يُعاد بدء الدور | يواصل الزملاء العمل | يُستأنف في الجلسة نفسها |
يحل كل عنصر من هذه العناصر مشكلة مختلفة. تُستخدم الوكلاء الفرعية لتفويض 2–3 عمليات تحقق ضمن مهمة واحدة. وتفيد المهارات عندما تكون لديك تعليمات جاهزة ينبغي لـ Claude اتباعها (مثل «راجع PR باستخدام قائمة التحقق هذه»). أما فرق الوكلاء فتفيد عندما تكون أجزاء عدة من المنتج موزعة على نوافذ مختلفة وتحتاج إلى منسق واحد. وتناسب مسارات العمل المهام الأكبر من أن تتسع لها نافذة سياق واحدة.
تتناول دليل الوكلاء الفرعيين في Claude Code لعام 2026 هذه الوكلاء بالتفصيل. وتجد شجرة القرار لاختيار «ما الذي تستخدمه لمهمة معينة» في دليل المهارات والوكلاء الفرعيين وMCP والإضافات. يشرح هذا الدليل كيفية جمعها في إعداد متعدد الوكلاء يعتمد على git worktree.
المستوى 1: الوكلاء الفرعيون في جلسة واحدة — أسهل نقطة للبدء
أهم النقاط
الوكيل الفرعي «عامل» مؤقت ضمن جلسة Claude. تقول للوكيل الرئيسي: «شغّل أربعة وكلاء فرعيين: مطوّر واجهة أمامية، ومطوّر واجهة خلفية، ومختبِر، وكاتب توثيق»، فيتولى كل واحد جزأه ثم يعيد النتيجة إلى المحادثة المشتركة. التزامن: من 2 إلى 5 وكلاء فرعيين، جميعهم ضمن سياق مشترك واحد.
الوكيل الفرعي أبسط طريقة لتقسيم مهمة. تعمل المحادثة الرئيسية بوصفها المنسق، والوكلاء الفرعيون عمال مؤقتون يشغّلهم الوكيل الرئيسي مع تقدم العمل.
مثال محدد من المشروع الموصوف. بعد إعداد المسودة الأولى لدليل، تُرتب المراجعة كما يلي: يتلقى Claude الطلب «شغّل ستة وكلاء فرعيين بالتوازي: يتحقق الأول من مؤشرات النصوص المولدة بالذكاء الاصطناعي، والثاني من المفردات القانونية، والثالث من الأسلوب والنبرة، والرابع يتحقق من الحقائق باستخدام WebFetch، والخامس يراجع بنية SEO، والسادس يتحقق من دقة الروابط الداخلية». يعيد كل وكيل تقريرًا، ثم تُطبّق التعديلات.
من الناحية التقنية، يتم ذلك باستخدام ملفات في .claude/agents/[subagent-name].md تصف الدور والأدوات. ويجري الاستدعاء من خلال أداة Agent في المحادثة الرئيسية. يقرر Claude متى يرسل طلبًا إلى وكيل فرعي.
أين تنجح. المهام التي تتضمن 3–7 عمليات تحقق متوازية لعنصر واحد (كود أو نص أو تصميم). كل عملية تحقق مستقلة، وتناسب نتائجها نافذة السياق الرئيسية.
أين تتعثر. إذا كان لديك أكثر من 50 ملفًا أو احتاج كل تحقق إلى سياق مستقل بحجم 50K رمز، فستمتلئ النافذة الرئيسية. عندها تحتاج إلى سير عمل أو فرق وكلاء.
الخطر الرئيسي. يستهلك كل وكيل فرعي الرموز بصورة مستقلة. إذا شغّلت ستة وكلاء على مشروع يضم 200 ملف وأعاد كل منهم قراءة الملفات الـ 200 كلها، فستدفع 6×. لذلك يجب أن تحدد بدقة الملفات التي ينبغي للوكيل الفرعي فحصها. راجع دليل أين تذهب الرموز في Claude Code للتفاصيل.
المستوى 2: git worktree — عزل الملفات بين الجلسات المتوازية
أهم النقاط
يتشارك الوكلاء الفرعيون جلسة واحدة ونظام ملفات واحدًا. إذا أردت نسختين كاملتين من Claude Code في طرفيتين مختلفتين لتحرير المشروع نفسه، فستحتاج إلى نسختي عمل منفصلتين. يوفر لك git worktree ذلك مجانًا: مصدر حقيقة واحد في .git ودليلان مستقلان على القرص.
عندما لا تكفي الوكلاء الفرعية وتحتاج إلى نسختين كاملتين من Claude Code في طرفيتين مختلفتين للعمل على المستودع نفسه، تظهر مشكلة معروفة. يبدأ كلاهما بتحرير الملف نفسه؛ يحفظ أحدهما أولًا، ثم يكتب الثاني فوقه. قال عميل لفريق الدعم الأسبوع الماضي: «خمسة يكتبون فوق تعديلات بعضهم في الوقت نفسه».
الحل هو git worktree. إنها ميزة مدمجة في git تتيح لك امتلاك عدة نسخ عمل للمستودع نفسه، لكل منها فرع خاص، مع مشاركة مستودع .git. أصل واحد، وأدلة مختلفة على القرص، من دون تداخل في الملفات. يشرح دليل Git worktree في Claude Code هذه الآلية بالتفصيل.
أوامر لإعداد يستغرق خمس دقائق:
# من دليل المشروع الرئيسي
cd ~/projects/my-app
# أنشئ worktree لـ feature/auth
git worktree add ../my-app-auth feature/auth
# أنشئ worktree لـ feature/billing
git worktree add ../my-app-billing feature/billing
# افتح نافذتي طرفية
cd ~/projects/my-app-auth && claude # Claude Code الأول
cd ~/projects/my-app-billing && claude # Claude Code الثاني
تعمل كل نسخة على فرعها الخاص. وتكتب كل نسخة من Claude Code في دليلها الخاص. عند انتهاء المهمة، نفّذ git push من فرعها، ثم نفّذ git worktree remove ../my-app-auth.
ما ينبغي معرفته. لا ينسخ worktree مجلد node_modules أو .venv أو غيرهما من الملفات الموجودة في .gitignore. إذا احتجت إلى تبعيات مستقلة (إصدار مختلف من مكتبة في كل فرع)، فنفّذ npm install بشكل منفصل في الدليل الجديد بعد worktree add.
عدد worktrees لكل شخص. استنادًا إلى استطلاعات الفرق لعام 2026، يبلغ الحد العملي 4–8 worktrees متوازية لكل مطوّر. العامل المحدِّد ليس Claude، بل قدرة الشخص على مراجعة النتائج وقبولها. إذا كان لديك 10 worktrees، فستنتظر المراجعة.
في الممارسة الموصوفة، يستخدم الناس عادةً 2–3 worktrees متوازية: worktree رئيسي للعمل النشط، وآخر احتياطي للإصلاحات العاجلة، وثالث للتجربة (ميزة جديدة لست متأكدًا منها). لا حاجة إلى أكثر من ذلك.
المستوى 3: فرق الوكلاء — عدة نوافذ ووكيل قائد واحد
أهم النقاط
فرق الوكلاء هي عدة نسخ من Claude Code تعمل معًا في نوافذ مختلفة: يتابع وكيل قائد واحد قائمة مهام مشتركة، ويرفع الآخرون تقاريرهم إليه ويتواصلون عبر نظام ملفات مشترك. إنها طبقة تنسيق تقع بين «الوكلاء الفرعيين في محادثة واحدة» و«Dynamic Workflows بوصفها كودًا».
فرق الوكلاء عنصر جديد نسبيًا. الفكرة هي أن يحتفظ وكيل قائد بالخطة المشتركة في صورة قائمة مهام، وتتولى عدة جلسات نظيرة في نوافذ منفصلة المهام التي يسندها إليها القائد. تعمل كلها على نظام الملفات نفسه ويمكنها الاطلاع على العناصر الوسيطة التي ينتجها بعضها.
يفيد هذا النهج عندما تنقسم المهمة إلى 3–5 مسارات عمل كبيرة، يستغرق كل منها ساعات (ترحيل وحدة كبيرة، أو إعادة كتابة نظام فرعي، أو إجراء تدقيق أمني كامل). في هذه الحالة، يحفظ القائد الخطة في ملف مهام مشترك واحد بمسار مطلق خارج أشجار العمل. يقرأ العمال ذلك المسار ويبلغون النتائج؛ ويحدث القائد وحده الحالات لتجنب تنافس الكتابة إلى ملف التنسيق.
من الناحية التقنية، فرق الوكلاء هي عدة نوافذ تعمل عبر git worktree مع نقطة تخطيط مشتركة واحدة. عمليًا، يدير 80% من الأشخاص فرق الوكلاء يدويًا (كما وُصف أعلاه باستخدام worktree)، ولا يستخدمون «إطار عمل للفرق» خاصًا. وهذا مقبول.
إذا لم تكن متأكدًا من حاجتك إلى إطار عمل أصلًا، فالأرجح أنك لا تحتاج إليه. استخدم worktree يدويًا ووكيلًا قائدًا واحدًا في الدليل الرئيسي.
المستوى 4: Dynamic Workflows — Claude يكتب نص تنسيق برمجيًا بلغة JS
أهم النقاط
Dynamic Workflow هو نص JavaScript يكتبه Claude لمهمتك وينفذه وقت التشغيل في الخلفية. يشغّل وقت التشغيل ما يصل إلى 16 وكيلًا في وقت واحد (1000 لكل عملية تشغيل)، بينما تظل الجلسة متجاوبة. يمكن تفعيله بكلمة workflow في prompt، أو بإعداد /effort ultracode، أو بالأمر المدمج /deep-research. أُطلق في 28 مايو 2026؛ ويتطلب Claude Code v2.1.154+.
تُبقي المستويات الثلاثة السابقة الخطة داخل محادثة: في ذهن الوكيل الرئيسي أو في قائمة مهام وكيل القيادة. تنقل Dynamic Workflows الخطة إلى الكود. يصوغ Claude المهمة في نص JavaScript، وينفّذه وقت التشغيل في بيئة معزولة. وتُحفظ النتائج الوسيطة في متغيرات النص بدلًا من سياقك، فيما تظل الجلسة متجاوبة أثناء عمل الوكلاء في الخلفية.
مثال محدد من الوثائق الرسمية. تقول:
ultracode: راجع كل نقاط API تحت src/routes/ بحثًا عن فحوصات المصادقة المفقودة
يكتب Claude نص JavaScript بمنطق تقريبي كهذا: «خذ جميع الملفات من src/routes/، وقسّمها إلى مجموعات من 30 نقطة API، وشغّل وكيلًا على كل مجموعة لإجراء الفحص نفسه، ثم شغّل وكيلَي تقييم مستقلين لمراجعة النتائج، وادمجها في تقرير نهائي». ينفّذ النص، وتحصل على جدول بالنتائج وقائمة بنقاط API التي تحتاج بالتأكيد إلى مراجعة.
مجالات الاستخدام:
- تدقيق المشروع بالكامل بحثًا عن مشكلة واحدة (الأمان أو الأنواع أو واجهات API المهملة).
- عمليات الترحيل الكبيرة (500+ ملف تحكمها قاعدة مشتركة).
- أسئلة البحث التي تتطلب التحقق من عدة زوايا مستقلة (تستخدم Anthropic ذلك في الأمر المدمج
/deep-research).
يتوفر تحليل مفصل لـ Dynamic Workflows وحدودها وآلية عمل ultracode في الدليل المنفصل إلى Dynamic Workflows في Claude Code.
متى لا تستخدمه. عندما تكون المهمة واضحة ومتسلسلة. لا تحتاج إلى workflow لمهمة مثل «أكمل هذا المكوّن». يكون workflow منطقيًا عندما تنقسم المهمة إلى 10+ مهام فرعية مستقلة وتحتاج إلى التحقق المتبادل بينها.
القيد الرئيسي. يستهلك workflow رموزًا أكثر بكثير من الجلسة العادية. توصي Anthropic في وثائقها بما يلي:
قد تستهلك مسارات العمل الديناميكية رموزًا أكثر بكثير من جلسة Claude Code المعتادة، لذا نوصي بالبدء بمهمة محدودة النطاق.
بعبارة أخرى، شغّل أول workflow على دليل واحد، لا على المشروع بأكمله. تعرّف على تكلفته، ثم قرر إن كان توسيع النطاق يستحق ذلك.
Outcomes: قائمة معايير ومراجع مستقل
أهم النقاط
المشكلة الرئيسية في تعدد الوكلاء أن الوكلاء ينتجون أشياء تبدو مكتملة. تبدو الاقتباسات صحيحة، والتقارير مكتملة. Outcomes من Anthropic هو وكيل ثانٍ في سياق جديد يقرأ قائمة المعايير ويفحص عمل الوكيل الأول. أُطلق في 6 مايو 2026 في Code with Claude. زاد إكمال المهام بمقدار 6× لدى Harvey وخفّض وقت المراجعة بنسبة 50% لدى Wisedocs.
أخطر ما في العمل متعدد الوكلاء هو الثقة بمخرجات الوكلاء. يعيد كل وكيل نصًا يبدو كأنه عمل مكتمل. يبدو الاقتباس صحيحًا، والتقرير كاملًا، والترحيل منتهيًا. مع وكيل واحد يمكنك التحقق بنفسك. أما مع 10 وكلاء فلا تستطيع، إذ لن يتوفر لك الوقت.
تعالج Anthropic المشكلة عبر Outcomes، وهي ميزة ضمن Managed Agents أُطلقت في 6 مايو 2026. الفكرة بسيطة: تُضاف إلى الجلسة وكيل ثانٍ (مقيّم) مهمته الوحيدة فحص عمل الوكيل الأول وفق قائمة معايير صارمة.
آلية عملها التقنية: تكتب قائمة معايير، وهي وثيقة markdown تتضمن قائمة مفصلة بما يعنيه «الإنجاز»، والمصادر التي ينبغي التحقق منها، والتسميات المطلوب استخدامها. تنشئ المنصة تلقائيًا وكيل تقييم في نافذة سياق جديدة. لا يتلقى سوى قائمة المعايير والنتيجة، ولا شيء آخر. بعد كل محاولة من الوكيل الرئيسي (الكاتب)، يعيد المقيّم قراءة النتيجة، ثم إما يقبلها أو يعيد قائمة مفصلة بما لم يكتمل بعد.
اقتباس من Anthropic Cookbook:
الوكلاء بارعون في إنتاج أشياء تبدو مكتملة. اطلب من أحدهم إنشاء تقرير بحثي يتضمن إحالات، وستحصل على وثيقة مصقولة وهوامش. لكن إذا دققت أكثر، ستجد أن الموضوع عولج سطحيًا، أو أن اقتباسًا ابتعد عن مصدره، أو أن الإحالة تشير إلى بيان صحفي بدلًا من الوثيقة الأصلية.
أرقام الأثر الفعلي: بعد دمج Outcomes في Claude Managed Agents، ارتفع معدل إكمال المهام لدى شركة الذكاء الاصطناعي Harvey بنحو 6×. وفي Wisedocs (التوثيق الطبي)، انخفض الوقت المستغرق لمراجعة المستند بنسبة 50%. هذه الأرقام واردة في الإعلان الرسمي عن الميزة.
ما يهم من يمارس البرمجة بالحدس، لا الشركات الكبرى، هو أن Outcomes نمط عمل وليس ميزة بعينها فحسب. يمكنك إنشاء وكيل تقييم خاص بك عبر وصف المعايير نفسها في .claude/agents/grader.md وطلب تشغيله من الوكيل الرئيسي بعد كل محاولة. يعمل ذلك مع أي إعداد متعدد الوكلاء، وليس مع Managed Agents وحدها.
القاعدة الرئيسية لكتابة قائمة المعايير في Cookbook هي تحديد شيء قابل للتحقق بدلًا من شيء عام. لا تقل «تحقق من أن الملخص يتناول الفوترة»، بل قل «افتح الملخص، واعثر على القسم الخاص بالفوترة، وتأكد من أنه يحدد مبلغًا بالدولار $ أو نسبة من الإيرادات». تسمح التعليمات الأولى للمقيّم بتصفح النص ووضع علامة. أما الثانية فتجعله يفتح المستند ويبحث عن رقم محدد.
نمط مضاد: «50 وكيلًا يفعلون أشياء لا معنى لها»
أهم النقاط
الخطأ الرئيسي في أي إعداد متوازٍ هو تشغيل عدد كبير من الوكلاء من دون فهم ما يفعله كل واحد. عمليًا، أثناء إنشاء وكيل ذكاء اصطناعي، لم يتجاوز عدد مسارات العمل المتوازية 2–3 خلال 3–4 ساعات. عندما يتباهى ممارس البرمجة بالحدس بوجود «50 وكيلًا بالتوازي»، فهذا يعني غالبًا «50 وكيلًا يولّدون قمامة بالتوازي من دون أن يراجعها أحد». علامة الخطر أنك لا تستطيع شرح المهمة المحددة التي يحلها كل وكيل في 30 ثانية.
هذا هو النمط المضاد المركزي في العمل متعدد الوكلاء. يتعلم شخص ما أن Claude Code يمكنه تشغيل 16 وكيلًا في الوقت نفسه، وأن Dynamic Workflows يمكنه تشغيل 1000 في كل مرة، فيجلس ويطلقها. النتيجة: صفر. استهلاك الرموز: 10× جلسة عادية.
اختبار بسيط: خذ ورقة وارسم مربعًا لكل وكيل من وكلائك. اكتب في كل مربع:
- ماذا يفعل بالضبط (جملة واحدة).
- ما الملفات التي يمسها.
- ماذا يعيد.
- من يتحقق منه.
إذا لم تستطع الإجابة عن أي بند في 30 ثانية، فلا ينبغي أن يكون لديك ذلك الوكيل. تنجح هذه القاعدة في كل مستوى: الوكلاء الفرعيون، وفرق الوكلاء، وDynamic Workflows.
النمط المضاد الثاني هو تنفيذ العمل بالتوازي حين ينبغي تنفيذه بالتتابع. إذا كانت الواجهة الأمامية تحتاج إلى الواجهة الخلفية أولًا لأنها تقرأ مخطط API، فلا تشغّلهما بالتوازي. نفّذ الواجهة الخلفية أولًا، ثم الأمامية. يجب أن تكون المهام متوازية فقط إذا كانت مستقلة.
النمط المضاد الثالث هو استخدام تعدد الوكلاء لزيادة السرعة. لا ينجح ذلك إلا إلى حد معين. إذا قسمت مهمة إلى أربعة مسارات عمل مستقلة، فستنتهي في الوقت الذي يستغرقه مسار واحد تقريبًا (مع إضافة وقت تنسيق بسيط). لكن إذا شغّلت 50 مسارًا على جهاز واحد، فسيعمل كل منها ببطء أكبر لأنها تتشارك CPU. الحد العملي على الحاسوب المحمول هو 4–6 نسخ متزامنة من Claude Code؛ وبعد ذلك يبدأ خفض السرعة.
ما التكلفة، وكيف تتجنب استنزاف حدودك؟
أهم النقاط
يزيد إعداد تعدد الوكلاء استهلاك الرموز بمضاعفات. الوكلاء الفرعيون: 2×–4× جلسة عادية. فرق الوكلاء: 3×–6×. Dynamic Workflows: 10×–30×. أهم قواعد التوفير: حدّد الملفات لكل وكيل، ولا تشغّل workflow على المشروع كله دفعة واحدة، وتحقق من التكلفة على جزء صغير.
في مايو–يونيو 2026، واجه القطاع حقيقة أن البرمجة بالذكاء الاصطناعي أعلى تكلفة مما كان متوقعًا.
تكلفة جلسة محادثة عادية واحدة في Claude Code معقولة نسبيًا. أما تفعيل Dynamic Workflows على مستودع كامل فيعني فاتورة أعلى بـ 20×. وجاء في وثائق Anthropic الرسمية:
يشغّل workflow عددًا كبيرًا من الوكلاء، لذلك قد تستهلك عملية تشغيل واحدة رموزًا أكثر بكثير من إنجاز المهمة نفسها في محادثة عادية. لفهم التكلفة قبل عملية تشغيل واسعة، جرّب workflow على جزء صغير.
ما الذي ينبغي فعله عمليًا؟ إليك قواعد التوفير المستمدة من الممارسة الموصوفة.
حدّد ملفات كل وكيل بدقة. لا تقل «راجع المشروع وابحث عن المشكلات»، بل قل «راجع
src/auth/*.tsوتحقق من أن كل دالة تتحقق منuserId». سيعطيك prompt الثاني العمل المحدد الذي تدفع مقابله.جرّب workflow دائمًا على دليل واحد أولًا. لا تبدأ بكل
src/. ابدأ بـsrc/auth/. إذا أعجبتك النتائج وفهمت التكلفة، فوسّع نطاقه بعد ذلك.استخدم
/effort highافتراضيًا، ولا تستخدمultracodeإلا عن قصد. يعني/effort ultracodeالجمع بين xhigh والتنسيق التلقائي. تكلفته مرتفعة جدًا. استخدمه عندما تحتاج المهمة فعلًا إلى عدة مسارات عمل متوازية.حوّل الوكلاء الفرعيين إلى نموذج أصغر كلما أمكن. إذا كان لديك ستة وكلاء فرعيين يراجعون دليلًا واحدًا، فلا يحتاج وكيل QA الذي يبحث عن محتوى مولّد بالذكاء الاصطناعي ولا مدقق الروابط الداخلية إلى Opus. يكفي Sonnet. وهذا يقلل الاستخدام بمقدار 3–5×.
للاطلاع على تفاصيل توفير الرموز، راجع دليل أين تذهب الرموز في Claude Code وكيف لا تستنزف حدود Claude Code.
من أين تبدأ اليوم: قائمة تحقق مدتها 30 دقيقة
أهم النقاط
ليس عليك الانتقال مباشرة إلى Dynamic Workflows. يستغرق إعداد أساسي متعدد الوكلاء 30 دقيقة: اثنان من worktree، وطرفيتان، وقائمة تحقق واحدة للقائد في tasks.md. وهذا يكفي لـ 80% من الحالات. أما الـ 20% الأخرى (تدقيق أو ترحيل كبير) فستظهر حاجتها طبيعيًا بعد أسبوعين تقريبًا.
حدّث Claude Code إلى v2.1.154+
هذا هو الحد الأدنى من الإصدارات التي تدعم Dynamic Workflows. نفّذ
claude updateفي الطرفية.فعّل Dynamic Workflows في /config
تكون معطلة افتراضيًا في خطة Pro. افتح
/config، واعثر على السطر “Dynamic workflows”، ثم فعّله. وهي مفعّلة مسبقًا في خطط Max وTeam وEnterprise.أنشئ أول worktree
في دليل المشروع الرئيسي، نفّذ
git worktree add ../<project>-experiment <branch>. افتح نافذة طرفية ثانية في ذلك الدليل، ثم نفّذclaude.أضف قائمة مهام مشتركة
استخدم مسارًا مطلقًا واحدًا خارج جميع أشجار العمل. لكل شجرة ملف
tasks.mdمستقل لا يتزامن تلقائيًا. اجعل جلسة القيادة الكاتب الوحيد؛ يقرأ العمال القائمة المشتركة ويبلغون النتائج للقائد.
أنشئ مجلد التنسيق وقائمة المهام مرة واحدة:
mkdir -p "$HOME/projects/my-app-coordination"
printf '%s\n' '# Tasks' '- Auth: assigned to the auth worktree' '- Billing: assigned to the billing worktree' > "$HOME/projects/my-app-coordination/tasks.md"
في الطرفية الأولى:
cd "$HOME/projects/my-app-auth"
printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
claude
في الطرفية الثانية:
cd "$HOME/projects/my-app-billing"
printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
claude
أعط الوكيل في الجلستين المسار المطلق الموسع نفسه المطبوع أعلاه: «اقرأ قائمة المهام المشتركة هذه. اعمل على مهمتك وملفاتك الموكلة فقط. لا تعدل القائمة؛ أبلغ القائد بالإتمام والعوائق، فهو يملك تحديثها». تحقق من قدرة الوكيلين على قراءة الملف نفسه قبل البدء، واحسم أي طلب إذن لذلك المسار. تنسق القائمة الحالة، بينما تبقى تغييرات الشيفرة في أشجار عمل مستقلة.
اعمل بهذه الطريقة أسبوعًا
لا تثبّت غلاف واجهة رسومية فورًا. اقضِ أسبوعًا في العمل يدويًا باستخدام اثنين من worktree. ستعرف ما ينقصك، ثم اختر أداة لمعالجة نقطة ألم محددة.
بعد ذلك فقط فعّل `/effort ultracode`
اختر مهمة، مثل «اعثر على كل نقاط API التي تفتقر إلى فحوصات المصادقة في src/routes/». فعّل
/effort ultracode. راقب workflow الذي يكتبه Claude، وتكلفته، والنتيجة التي ينتجها. سيكون ذلك أول Dynamic Workflow لك.
الخطوات التالية: الذاكرة بين الجلسات وCode Review وMulti-Agent v2
أهم النقاط
يتعامل الإعداد الأساسي متعدد الوكلاء مع 80% من المهام. وتشمل الميزات الثلاث المرتقبة Managed Agents مع Dreaming (ذاكرة بين الجلسات)، وCode Review ينفذه فريق من الوكلاء عند كل PR، وMulti-Agent Orchestration v2 في Claude Agent SDK. كلها إما في معاينة بحثية أو نسخة تجريبية عامة أو أُعلن عنها لإتاحة محدودة فقط.
ما الذي ظهر في مايو–يونيو 2026، وإلى أين يتجه تعدد الوكلاء في Claude Code؟
Managed Agents مع Dreaming. أُطلقت في 6 مايو 2026 في Code with Claude. إنها عملية مجدولة تقرأ سجلات محادثات الوكيل السابقة بين الجلسات، وتتعرف على الأنماط المتكررة، وتحدّث ذاكرته. ازداد إكمال المهام في شركة الذكاء الاصطناعي القانونية Harvey ستة أضعاف تحديدًا بعد Dreaming. لا تزال في معاينة بحثية.
Outcomes بوصفها ميزة في Managed Agents. سبق وصفها. تتوفر عبر Claude Agent SDK، وليس مباشرة في CLI الخاص بـ Claude Code. ويمكنك تطبيق النمط نفسه يدويًا الآن باستخدام وكيل فرعي مقيّم.
Multi-Agent Orchestration v2 في Claude Agent SDK. يفوّض وكيل قائد الوكلاء الفرعيين بنفسه باستخدام نظام ملفات مشترك. هذه خطوة من «شغّل N من الوكلاء الفرعيين يدويًا» إلى «صف المهمة ودع القائد يقرر بنفسه من سيفوّض إليه وكيف». إذا كنت تتعلم استخدام الوكلاء الفرعيين للتو، فلا تقلق بشأن v2 بعد. أتقن النمط الكلاسيكي — «وكيل رئيسي واحد + 3–5 وكلاء فرعيين بأدوار محددة» — ثم انتقل إلى v2 طبيعيًا بعد 3–6 أشهر.
Code Review ينفذه فريق من الوكلاء. أعلنت Anthropic في Code with Claude عن ميزة لمراجعة الكود تلقائيًا عند فتح PR. يفحص فريق من وكلاء الذكاء الاصطناعي التغييرات بالتوازي، ويبحث عن الأخطاء، ويتحقق من النتائج فيما بينه، ويرتبها حسب درجة الخطورة. وهي متاحة في خطتي Team وEnterprise، لكنها لم تتوفر بعد في Pro.
Plugin Marketplace. أُطلق في 23 مايو 2026، ضمن v2.1.128-136. بعض إضافات السوق إعدادات متعددة الوكلاء جاهزة (parallel-review وsecurity-audit وmigration-helper). يمكنك تثبيتها عبر /plugin install <name>@claude-plugins-official واستكشاف طريقة إعدادها؛ وهذا أسلوب جيد لتعلّم كتابة إضافاتك الخاصة.
لا يزال تعدد الوكلاء في Claude Code يبدو كمجموعة من العناصر في مراحل نضج مختلفة. الوكلاء الفرعيون وgit worktree مستقران ومثبتان ويعملان في كل مكان. أما فرق الوكلاء فنصفها مؤتمت ونصفها يدوي. وDynamic Workflows في معاينة بحثية وتتغير بسرعة. وManaged Agents v2 مخصص للمؤسسات. وهذا يعني أن الإعداد الأمثل لمن يمارس البرمجة بالحدس خلال العام المقبل لن يكون أحدث إصدار، بل الحد الأدنى اللازم للمهمة المحددة. اثنان من worktree ووكيل فرعي مقيّم واحد يكفيان لشهر من العمل النشط. أضف التعقيد فقط عندما تبدأ بالشعور بالقيود.
إعداد عملي للبرمجة بالحدس
أهم النقاط
لا ينجح إعداد تعدد الوكلاء إلا إذا بُني على هندسة متعمدة للسياق. ومن دونها، يتحول أي تنسيق متوازٍ إلى نمط «50 وكيلًا يفعلون أشياء لا معنى لها».
مواد عملية: وثائق Ailoot.
المصادر
- Anthropic - تنسيق الوكلاء الفرعيين على نطاق واسع باستخدام Dynamic Workflows (الوثائق الرسمية)
- Anthropic - تقديم Dynamic Workflows في Claude Code
- Anthropic Cookbook - Outcomes: وكلاء يتحققون من عملهم بأنفسهم
- Anthropic - الجديد في Claude Managed Agents (Dreaming وOutcomes وMulti-Agent v2)
- Claude Code - تشغيل الوكلاء بالتوازي (وثائق الوكلاء الفرعيين وفرق الوكلاء)
مواد وأدوات إضافية: Ailoot.
المزيد من التفاصيل
أسئلة شائعة
لماذا تعرض شجرتا عمل ملفي tasks.md مختلفين؟
لكل شجرة ملفاتها. ضع قائمة التنسيق في مسار مطلق واحد خارج الشجرتين، وأعط المسار الموسع نفسه للوكيلين، وتحقق من قدرتهما على قراءته قبل البدء.
من يحدث قائمة المهام المشتركة؟
عيّن جلسة قيادة واحدة ككاتبها الوحيد. يقرأ العمال القائمة ويحررون ملفات شجرة عملهم الموكلة فقط، ويبلغون النتائج والعوائق للقائد؛ فمشاركة المسار وحدها لا تمنع التعديلات المتزامنة.