الوكلاء الفرعيون في Claude Code هم نُسخ Claude متخصصة ومعزولة يمكن لجلستك الرئيسية أن تُسند إليها مهمة محدودة — بحثًا في قاعدة الشيفرة، أو مراجعةً، أو دفعة من قراءات الملفات — بحيث يجري هذا العمل في نافذة سياقه الخاصة ولا يعود منه سوى الملخص. وهم موجودون لحل مشكلة واحدة: فالجلسة الطويلة تمتلئ ببطء بالسجلّات وأكوام الملفات التي لن تنظر إليها مرة أخرى، وتتراجع جودة الإجابات مع امتلائها. يؤدي الوكيل الفرعي العمل المُزعج في مكان آخر ويُبقي محادثتك الرئيسية نظيفة. يغطي هذا الدليل ماهية الوكلاء الفرعيين في Claude Code، وكيفية بناء واحد، والأنواع الثلاثة المُدمجة، وكيف يختلفون عن Skills وفِرَق الوكلاء، والجزء الذي تتجاوزه معظم الدروس التعليمية: متى لا يستحقون تكلفة الرموز.
ما هو الوكيل الفرعي في Claude Code؟
الوكيل الفرعي هو نسخة Claude مُسمّاة ومعزولة لها موجّه النظام الخاص بها، ونافذة سياقها الخاصة، ووصولها الخاص إلى الأدوات، وأذوناتها الخاصة. تُعرّف واحدًا كملف Markdown مع مقدمة YAML، ويقرأ Claude Code حقل description ليقرر متى يُفوّض إليه. وعندما تتطابق مهمة ما، يعمل الوكيل الفرعي وحده، ثم يُعيد نتيجة قصيرة إلى الوكيل الأصل — ولا يرى الأصل قط عمليات البحث أو السجلّات الوسيطة. هذا العزل هو الغاية كلها: توثيق Anthropic الرسمي يصف الوكلاء الفرعيين بأنهم الحل لمهمة جانبية كانت لولا ذلك «ستُغرق محادثتك الرئيسية بنتائج البحث أو السجلّات أو محتويات الملفات التي لن ترجع إليها مرة أخرى». تحصل كل مهمة مُفوّضة على ميزانية سياق جديدة، ولهذا يصف الممارسون الوكلاء الفرعيين بأنهم علاج لتآكل السياق الذي يتراكم عبر الجلسات الطويلة.
كيف تُنشئ وكيلًا فرعيًا في Claude Code؟
الوكيل الفرعي ليس سوى ملف Markdown مع مقدمة YAML، محفوظ في أحد موضعين: .claude/agents/ (مقيّد بالمشروع، أدرجه في git ليشاركه فريقك) أو ~/.claude/agents/ (مقيّد بالمستخدم، متاح في كل مشروع على جهازك). وعند تعارض name، يفوز التعريف الأقرب إلى مجلد عملك، وتأخذ وكلاء المشروع الأسبقية على وكلاء المستخدم. المطلوب فقط name وdescription؛ وكل ما عداهما اختياري. يبدو المُراجع الأدنى كالتالي:
---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes.
tools: Read, Grep, Glob
model: haiku
---
You are a senior code reviewer. Review the diff for bugs, security
issues, and unclear naming. Return a short, specific list of findings.
أهم حقول المقدمة، بحسب المرجع الرسمي:
| الحقل | إلزامي | ماذا يفعل |
|---|---|---|
name | نعم | مُعرّف بأحرف صغيرة وشرطات يُستخدم لاستدعاء الوكيل الفرعي |
description | نعم | يُخبر Claude متى يُفوّض — اكتبه كأنه قاعدة توجيه |
tools | لا | قائمة بيضاء بالأدوات؛ يرث كل الأدوات إذا حُذف |
disallowedTools | لا | يُزيل أدوات محددة من المجموعة الموروثة |
model | لا | haiku أو sonnet أو opus أو fable، أو مُعرّف نموذج كامل، أو inherit (الافتراضي) |
permissionMode | لا | default وacceptEdits وplan وdontAsk، وغيرها |
يرث الوكيل الفرعي افتراضيًا كل أداة تملكها جلستك الرئيسية، بما في ذلك أي أدوات خادم MCP، ولذلك يوجد حقلا tools وdisallowedTools لتضييق تلك المجموعة — فالمُراجع للقراءة فقط المُزوّد بـtools: Read, Grep, Glob يعجز فعليًا عن تعديل الملفات. لاحظ أن /agents لم يعد يفتح مُرشدًا تفاعليًا في الإصدارات الحالية — تكتب الملف بنفسك أو تطلب من Claude كتابته، ويُعيد Claude Code تحميل التغيير تلقائيًا خلال ثوانٍ قليلة. وحقل description هو الحقل الوحيد الجدير بالاهتمام البالغ: فهو ما يطابقه المُنسّق، ولذا فإن «Use proactively after code changes» يُستدعى بموثوقية أعلى بكثير من عبارة غامضة مثل «reviews code».
ما هم الوكلاء الفرعيون الثلاثة المُدمجون؟
تحصل على ثلاثة وكلاء فرعيين قبل أن تكتب أيًّا من وكلائك الخاصين، ويوجّه Claude إليهم تلقائيًا:
- Explore — اكتشاف الملفات للقراءة فقط والبحث في قاعدة الشيفرة. يقرأ مقتطفات لتحديد مواضع الأشياء، ثم يُعيد ملخصًا. في الإصدارات الحديثة يرث نموذج جلستك (بحدٍّ أقصى Opus على Claude API) بدلًا من العمل دائمًا على Haiku، وإن كان بإمكانك تجاوز ذلك بتعريف
Exploreخاص بك بـmodel: haiku. - Plan — يجمع السياق ويصوغ استراتيجيةً قبل أن تلتزم بالتغييرات، ويُستخدم في وضع التخطيط (plan mode).
- general-purpose — يتولى المهام التي تمزج بين الاستكشاف والتعديل عندما لا يناسبها أيٌّ من السابقين.
التوجيه التلقائي مريح، لكنه، كما يشير أحد التقارير المفصّلة، «غير مثالي في الممارسة» — إذا أردت وكيلًا فرعيًا بعينه، فسمِّه صراحةً («use the code-reviewer subagent»). يغطي الوكلاء المُدمجون معظم حالات التفويض لمرة واحدة؛ ولا تحتاج إلى وكلاء فرعيين مخصصين إلا عندما تستمر في استحضار النوع نفسه من العامل بالتعليمات نفسها.
الوكلاء الفرعيون مقابل Skills وأوامر الشرطة المائلة وفِرَق الوكلاء
تتداخل هذه الميزات الأربع بما يكفي لإرباك الناس، والفارق في جوهره يتعلق بـالسياق. يُشغّل الوكيل الفرعي العمل في نافذة منفصلة. أما Skill فيحقن تعليمات وملفات في النافذة الحالية. وأمر الشرطة المائلة موجّهٌ محفوظ تُشغّله يدويًا. وفِرَق الوكلاء هي جلسات كاملة متعددة تعمل بالتوازي.
| الميزة | تعمل في | الأفضل لـ | تعزل السياق؟ |
|---|---|---|---|
| الوكيل الفرعي | نافذة سياقه الخاصة | البحث المحدود والمراجعة والتفويض | نعم |
| Skill | المحادثة الرئيسية | الخبرات القابلة لإعادة الاستخدام والملفات المرجعية | لا |
| أمر الشرطة المائلة | المحادثة الرئيسية | موجّه جاهز تستدعيه يدويًا | لا |
| فريق الوكلاء | جلسات متوازية منفصلة | مسارات عمل طويلة ومستقلة | نعم (لكل جلسة) |
قاعدة عامة: التجئ إلى وكيل فرعي عندما يكون الناتج مهمًّا لكن العملية ضوضاء لا تريدها في مسارك الرئيسي. والتجئ إلى Skill عندما تريد أن يُبقي النموذج الخبرة نصب عينيه — وهو المنطق نفسه وراء كتابة ملف AGENTS.md جيد.
متى تُثمر الوكلاء الفرعيون في Claude Code فعلًا؟
هنا تصمت معظم الدروس التعليمية. الوكلاء الفرعيون ليسوا مجانيين — فالتفويض ينسخ السياق، وتُشير التقارير إلى أن مسارات العمل متعددة الوكلاء تستهلك نحو 4–7 أضعاف الرموز مقارنةً بجلسة واحدة، مع اقتراب فِرَق الوكلاء الكاملة من 15 ضعفًا. وفي خطة Claude Code Max يكون كثير من ذلك قراءات مُخزّنة مؤقتًا بسعر أقل، ما يُخفّف الفاتورة، لكن المُضاعِف حقيقي.
إنهم يُثمرون في المهام كثيفة القراءة والمحدودة ذات الناتج النظيف: «اعثر على كل موضع استدعاء لهذه الدالة»، و«لخّص هذا النظام الفرعي»، و«تحقّق من أن هذا التغيير لم يكسر المخطط». إن تشغيل وكيلين أو ثلاثة وكلاء بحث مُركّزين بالتوازي وترك الجلسة الرئيسية تُوحّد النتائج يُبقي سياقك نظيفًا مع تقليص الزمن الفعلي. أما ما لا يُثمرون فيه فهو مهام البرمجة المتوازية ذات التبعيات المشتركة، أو حين يُفوّض نموذج قادر بدافع العادة — فالتعديل المباشر غالبًا أسرع وأرخص من استحضار عامل ليقوم به. وإذا كانت المهمة تتسع لنافذتك الرئيسية وستُشير إلى ناتجها أثناء عملك، فالوكيل الفرعي عادةً هو الأداة الخاطئة.
ما هم الوكلاء الفرعيون المُتداخلون؟
اعتبارًا من الإصدار Claude Code v2.1.172 (10 يونيو 2026)، يمكن للوكلاء الفرعيين أن يستحضروا وكلاءهم الفرعيين، حتى خمسة مستويات في العمق — إذ يمكن لوكيل فرعي بدور المهندس القائد أن يُفوّض إلى عمّال على مستوى الوحدات، الذين يُفوّضون بدورهم من جديد. وهذا يحاكي كيف يُفكّك فريق هندسي حقيقي العمل، لكن حساب الرموز يتراكم بشدة: يحصل كل مستوى على نافذة سياقه الخاصة، بحيث يُضيف كل استدعاء متداخل نحو 30–60% رموزًا إضافية، وتتراكم تلك الأعباء بسرعة كلما تعمّقت السلسلة. وحدّ المستويات الخمسة هو حدّ للمكدّس (stack)، لا هدف — إذ تعيش معظم السلاسل المفيدة عند العمق اثنين أو ثلاثة. والنمط المعياري للتحكم في التكلفة هو التوجيه بحسب النموذج كلما نزلت: نموذج أقوى في الجذر للتخطيط، ثم نماذج أرخص وأسرع عند الأوراق تقوم بالجزء الأكبر من القراءة. التداخل قوي للعمل الهرمي حقًّا ومُهدر لكل ما عداه.
كيف نستخدم الوكلاء الفرعيين في TechRiseUps
نحن نبني هذا الموقع ونُشغّله باستخدام Claude Code، فالوكلاء الفرعيون ليسوا نظريين هنا. يستخدم خط النشر الآلي لدينا وكيل مُراجع بعينٍ جديدة كبوابة صارمة: بعد كتابة المسودة، يُقيّمها وكيل منفصل بسياقه الخاص وفق معيار محدد ويُعيد حُكم PASS / FIX / FAIL قبل نشر أي شيء. وإجراء المراجعة في نافذة معزولة أمر مهم — فهو لا يرى قط تفكير الكاتب، فيراجع المقال كما سيصل إليه القارئ فعلًا، لا النية الكامنة وراءه. ونعتمد أيضًا على وكلاء بحث للقراءة فقط لجمع المصادر دون تكديس المسار الرئيسي. والتحفّظ الصادق الذي يتوافق مع تحليل التكلفة أعلاه: نحن نقصر التفويض على خطوات محدودة ومُحدّدة جيدًا. أما التعديلات السريعة فنتجاوزه فيها، لأن العبء لا يستحق العناء.
الأسئلة الشائعة
ما الفرق بين الوكيل الفرعي في Claude Code وبين Skill؟ يُشغّل الوكيل الفرعي مهمةً في نافذة سياقه المعزولة ويُعيد ملخصًا؛ أما Skill فيحقن تعليمات وملفات مرجعية في محادثتك الحالية. استخدم وكيلًا فرعيًا لإبقاء العمل المُزعج خارج مسارك الرئيسي، واستخدم Skill لإبقاء الخبرة المفيدة نصب عيني النموذج.
هل يُكلّف الوكلاء الفرعيون رموزًا أكثر؟ نعم. ينسخ التفويض السياق إلى نافذة جديدة، ولذا يُشار عادةً إلى أن تشغيل الوكلاء المتعددين يبلغ 4–7 أضعاف رموز الجلسة الواحدة، وتُضاعف السلاسل المتداخلة ذلك أكثر. وفي الخطط التي يكون فيها معظم ذلك قراءات مُخزّنة مؤقتًا تكون التكلفة الفعلية أقل، لكن الوكلاء الفرعيين أداة كفاءة للسياق، لا لإنفاق الرموز.
أين تُخزَّن وكلاء Claude Code الفرعيون؟
في .claude/agents/ للوكلاء الفرعيين المقيّدين بالمشروع (القابلين للمشاركة عبر git) أو في ~/.claude/agents/ للوكلاء الشخصيين المتاحين عبر كل مشاريعك. ويُمسح كلاهما تراجعيًا، ويفوز التعريف الأقرب إلى مجلد عملك عند تعارض الأسماء.
هل يمكن لوكيل فرعي أن يستدعي وكيلًا فرعيًا آخر؟ نعم، منذ الإصدار v2.1.172 يمكن للوكلاء الفرعيين أن يتداخلوا حتى خمسة مستويات في العمق، وإن كانت معظم مسارات العمل العملية تبقى عند مستويين أو ثلاثة لأن تكلفة الرموز تتراكم مع كل طبقة.
هل يمكنني اختيار النموذج الذي يستخدمه الوكيل الفرعي؟
نعم — عيّن حقل model إلى haiku أو sonnet أو opus أو fable، أو مُعرّف نموذج كامل، أو inherit. وتوجيه النماذج الرخيصة مثل Haiku إلى الوكلاء الفرعيين كثيفي القراءة هو الطريقة الأساسية التي يُبقي بها الناس تكاليف الوكلاء المتعددين منخفضة.
المصادر
- Anthropic — إنشاء وكلاء فرعيين مخصصين (التوثيق الرسمي): التعريف، وحقول المقدمة، ومواضع الملفات، والأنواع المُدمجة، والاستدعاء.
- ksred.com — وكلاء ووكلاء Claude Code الفرعيون: ما الذي يُطلقونه فعلًا: عزل السياق، والأنواع الثلاثة المُدمجة، ومُضاعِفات تكلفة الرموز.
- ofox.ai — وكلاء Claude Code الفرعيون المتداخلون: 5 مستويات في العمق، وحساب الرموز: إصدار التداخل v2.1.172، وحدود العمق، وتكلفة الرموز المتراكمة.
وقاص احمد وسیر
وقاص احمد وسیر مطوّر ومهندس أتمتة بخبرة تزيد على 8 سنوات في بناء أنظمة إنتاجية يستخدمها أكثر من 100 ألف شخص. يبني تطبيقات SaaS متعددة المستأجرين، وأتمتة بالذكاء الاصطناعي (n8n، تدفقات LLM، بوتات واتساب)، وبنية استضافة (WHM/cPanel، CloudLinux) — وهو صانع WaSphere وFlowMaticX وعلامة الاستضافة WaseerHost. أنجز أكثر من 100 مشروع لشركات صغيرة ومتوسطة ووكالات وشركات ناشئة ممولة.



