# الوكلاء الفرعيون في Claude Code: طريقة إعدادهم وتكلفتهم

> كيف يعمل الوكلاء الفرعيون في Claude Code، وكيف تكتب وكيلًا في مجلد .claude/agents، وأي نموذج يعمل عليه كل وكيل، وكم يكلّف بمفتاح API.

آخر تحديث: 2026-11-01

الوكلاء الفرعيون في Claude Code مساعدون يكلّفهم Claude بمهام جانبية. يعمل كل وكيل في نافذة سياق خاصة به بتعليماته وأدواته وصلاحياته، ولا يعود إلى محادثتك الرئيسية إلا بنتيجته. وتعرّف الوكيل في ملف Markdown داخل المجلد `.claude/agents/`، وإذا عمل Claude Code بمفتاح API فتُحاسب طلبات كل وكيل لكل توكن مثل أي طلب آخر.

## ما الوكيل الفرعي في Claude Code؟

تصف Anthropic الوكلاء الفرعيين بأنهم مساعدون متخصصون، يتولى كل منهم نوعًا محددًا من المهام. استخدم وكيلًا فرعيًا حين تملأ مهمة جانبية محادثتك الرئيسية بنتائج بحث أو سجلات أو محتوى ملفات لن تحتاج إليه مرة أخرى. فالوكيل ينجز هذا العمل في سياقه الخاص، ثم يعيد نتيجة قصيرة.

ويقرر Claude متى يكلّف وكيلًا بناءً على طلبك وعلى الحقل `description` في ملف كل وكيل، لذلك يهم الوصف أكثر من الاسم. وإذا كتبت فيه عبارة مثل `use proactively`، شجّعت Claude على تكليف الوكيل دون أن تطلب ذلك.

## ما الوكلاء الفرعيون المدمجون في Claude Code؟

- **Explore:** وكيل سريع للقراءة فقط، يبحث عن الملفات وفي الكود.
- **Plan:** وكيل بحث للقراءة فقط، يستخدمه Claude في وضع التخطيط قبل أن يقترح خطته.
- **General-purpose:** يملك كل الأدوات، ويناسب البحث المعقد والعمل متعدد الخطوات وتعديل الكود.

ويبدأ Explore وPlan دون ملفات `CLAUDE.md`، فيبقى البحث سريعًا وقليل التكلفة. وإذا أنشأت وكيلًا باسم `Explore` فإنه يحل محل الوكيل المدمج، أما المتغير `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1` فيزيل Explore وPlan كليهما.

## كيف تنشئ وكيلًا فرعيًا؟

الوكيل الفرعي ملف Markdown في أوله بيانات بصيغة YAML. والحقلان المطلوبان هما `name` و`description` فقط، ويصبح النص الذي يلي البيانات موجّه النظام (system prompt) للوكيل. ويحدد مكان حفظ الملف من يستطيع استخدامه:

- **المجلد `.claude/agents/` في مشروعك:** لهذا المشروع وحده. أضف المجلد إلى المستودع ليشاركه فريقك.
- **المجلد `~/.claude/agents/`:** لكل المشاريع على جهازك.
- **الخيار `--agents`:** تعريف بصيغة JSON للجلسة الحالية وحدها.

وهذا وكيل مراجعة يقرأ الكود ويبلّغ عن المشكلات دون أن يغيّر شيئًا:

```text
---
name: code-reviewer
description: Reviews code for bugs, security issues and readability. Use proactively after code changes.
tools: Read, Grep, Glob
model: inherit
---
You are a code reviewer. Read the changed files, then list concrete
problems with file and line, most serious first. Don't edit files.
Keep the report short.
```

ويمكنك أيضًا أن تطلب من Claude أن يكتب الملف لك. ويلتقط Claude Code التغييرات في المجلدين خلال ثوانٍ. وأعد تشغيله إذا أنشأت مجلد `agents` لم يكن موجودًا حين بدأت الجلسة، أو إذا أضفت وكيلًا أو عدّلته في مجلد أضفته بالخيار `--add-dir` أو بالأمر `/add-dir`، أو إذا بدأت الجلسة بالخيار `--disable-slash-commands`.

## كيف تشغّل وكيلًا فرعيًا؟

- **اطلبه:** «استخدم الوكيل الفرعي `code-reviewer` لمراجعة آخر تعديل».
- **اذكره:** اكتب `@` واختر الوكيل، أو اكتب `@agent-code-reviewer`.
- **شغّل الجلسة كلها به:** يعطي الأمر `claude --agent code-reviewer` المحادثة الرئيسية موجّه الوكيل وأدواته ونموذجه. واضبط `"agent": "code-reviewer"` في `.claude/settings.json` ليصبح ذلك الافتراضي في المشروع.

والوكلاء الذين يبدؤهم Claude من المحادثة الرئيسية يعملون في الخلفية، فتواصل عملك. وتظهر طلبات الإذن التي يحتاجونها في جلستك الرئيسية وعليها اسم الوكيل، ويعرض الأمر `/tasks` الوكلاء العاملين والنموذج الذي يستخدمه كل منهم.

## أي حقول البيانات أهم؟

- **`tools` و`disallowedTools`:** قائمة سماح وقائمة منع. وإذا لم تذكر `tools`، يحصل الوكيل على كل الأدوات.
- **`model`:** اسم مختصر مثل `sonnet` أو `opus`، أو معرّف نموذج كامل، أو `inherit` لنموذج المحادثة الرئيسية.
- **`maxTurns`:** حد لعدد دورات الوكيل.
- **`effort`:** مقدار تفكير الوكيل، من `low` إلى `max`.
- **`isolation: worktree`:** يشغّل الوكيل في نسخة عمل git مؤقتة، فلا تمس تعديلاته نسختك.
- **`permissionMode` و`skills` و`mcpServers` و`hooks` و`memory`:** وضع الأذونات الخاص به، ومهارات تُحمّل له مسبقًا، وخوادم MCP خاصة به، وخطافات (hooks) لا تعمل إلا له، وملاحظات تُحفظ بين الجلسات.

## أي نموذج يستخدمه الوكيل الفرعي؟

يختار Claude Code النموذج بهذا الترتيب:

1. اسم مختصر لنموذج يحدده Claude حين يبدأ ذلك الوكيل.
2. الحقل `model` في ملف الوكيل.
3. متغير البيئة `CLAUDE_CODE_SUBAGENT_MODEL`.
4. نموذج المحادثة الرئيسية.

واضبط `CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1` (من الإصدار 2.1.257) ليتقدّم المتغير على كل حقول `model`. وتنتقل الأسماء المختصرة إلى نماذج أحدث مع الوقت، فثبّت نموذج الوكيل بمعرّف نموذج كامل. وعبر بوابة (gateway)، اختر معرّفًا تقدّمه البوابة، لأنها ترفض النموذج الذي لم تُضبط لتقديمه. وهذه أحدث نماذج Claude في Claude Code، بسعرنا لكل مليون توكن:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Claude Sonnet 5.5 | `claude-sonnet-5.5` | 0.60 US$ | 3 US$ | 1M |
| Claude Opus 5.5 | `claude-opus-5.5` | 1.20 US$ | 6 US$ | 1M |
| Claude Fable 5.1 | `claude-fable-5.1` | 3 US$ | 15 US$ | — |

وكل النماذج التي تعمل في Claude Code مذكورة في [صفحة إعداد Claude Code](https://5abeer.ai/ar/docs/apps/claude-code.md#models).

## كيف تشغّل الوكلاء الفرعيين بمفتاح من 5abeer؟

يستخدم الوكلاء الفرعيون عنوان الأساس والمفتاح اللذين تستخدمهما الجلسة الرئيسية، فما إن يعمل Claude Code بمفتاح من 5abeer حتى يعمل به كل وكيل فرعي:

### 1. اشحن رصيدك

ادفع بإحدى [طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md). ويُخصم من هذا الرصيد كل طلب يرسله وكيل فرعي.

### 2. أنشئ مفتاحًا لنماذج Claude

أنشئ مفتاحًا لمزوّد Anthropic كما في [إنشاء مفتاح](https://5abeer.ai/ar/docs/start/keys.md#create). وسمّه `claude-code` ليسهل عليك أن تجد استخدامه.

### 3. أضف الإعدادات

ضع هذه الإعدادات في `~/.claude/settings.json`، وضع مفتاحك مكان النص `YOUR_5ABEER_API_KEY`:

`~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}
```

### 4. جرّب وكيلًا فرعيًا

شغّل `claude` في مشروعك واطلب «استخدم الوكيل Explore لتجد المكان الذي نحلّل فيه التواريخ». وشغّل `/tasks` أثناء عمله لترى الوكيل ونموذجه.

ومع باقة من 5abeer تشمل Claude Code، يضبط تطبيق 5abeer AI برنامج Claude Code دون مفتاح، كما في [إعداد Claude Code](https://5abeer.ai/ar/docs/apps/claude-code.md#easy)، ويعمل الوكلاء الفرعيون ضمن حدود الباقة.

## كم يكلّف الوكلاء الفرعيون؟

نقل العمل إلى وكيل فرعي لا يلغي تكلفته. فوثائق Anthropic تقول إن كل وكيل فرعي ينفق توكنات خاصة به أثناء عمله: يبدأ من الصفر، ويقرأ الملفات التي يحتاجها، ويرسل دوراته الخاصة. أما التوفير فيكون في المحادثة الرئيسية، لأنها لا تحمل إلى الطلبات اللاحقة إلا النتيجة القصيرة، بدلًا من كل ما قرأه الوكيل.

ومثال ذلك وكيل مراجعة يقرأ 400 ألف توكن على مدى دوراته ويكتب 20 ألفًا، على النموذج الافتراضي:

مثال: 400,000 توكن إدخال و20,000 توكن إخراج على Claude Sonnet 5.5 (`claude-sonnet-5.5`) تكلّف 0.30 US$ بسعرنا مقابل 1.00 US$ بالسعر الرسمي (أقل بنسبة 70%). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

والمهمة نفسها على أحدث نموذج Opus، وهو [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5):

مثال: 400,000 توكن إدخال و20,000 توكن إخراج على Claude Opus 5.5 (`claude-opus-5.5`) تكلّف 0.60 US$ بسعرنا مقابل 2.00 US$ بالسعر الرسمي (أقل بنسبة 70%). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

ويكلّف خمسة مراجعين يعملون معًا نحو خمسة أضعاف ذلك. فأعطِ Claude Code مفتاحًا خاصًا به عليه حد إنفاق، كما في [تحكّم في كل مفتاح](https://5abeer.ai/ar/docs/start/keys.md#controls)، وراجع استخدامه في [تتبّع استخدامك](https://5abeer.ai/ar/docs/start/pricing.md#usage). وسعرنا بجوار السعر الرسمي في [صفحة Claude API](https://5abeer.ai/ar/api/claude)، ويقارن دليل [أرخص طريقة لاستخدام Claude Code](https://5abeer.ai/ar/guides/claude-code-cheapest-way) بين المفتاح والباقة.

## كيف تُبقي تكلفة الوكلاء الفرعيين منخفضة؟

- **أعطِ كل وكيل مهمة ضيقة.** فطلب «ابحث عن المكان الذي نحلّل فيه التواريخ» يقرأ ملفات أقل بكثير من «راجع المستودع كله».
- **اختصر الأوصاف.** فكل وصف يُحمَّل في السياق الرئيسي، ويحذّرك Claude Code عند البدء إذا تجاوزت أوصاف وكلائك مجتمعةً 15,000 توكن.
- **قيّد الأدوات والدورات.** فالمراجع الذي لا يملك إلا `Read, Grep, Glob` وعليه حد `maxTurns` لا يستطيع أن يشغّل أوامر طويلة.
- **اطلب نتيجة قصيرة.** فهي تنضم إلى المحادثة الرئيسية وتُرسل من جديد مع كل طلب لاحق.
- **لا تستخدم نموذجًا قويًا إلا حيث يستحق.** اضبط `model` لكل وكيل بدلًا من تشغيل كل الوكلاء على Opus.
- **تفرّع حين تحتاج المهمة إلى سياقك.** ينشئ الأمر `/subtask` فرعًا (fork) من المحادثة الحالية، وتقول الوثائق إن الفرع أقل تكلفة من وكيل فرعي جديد في المهام التي تحتاج إلى السياق نفسه، لأنه يعيد استخدام ذاكرة التخزين المؤقت للموجّه (prompt cache).

## متى لا تحتاج إلى وكيل فرعي؟

تنصح وثائق Anthropic بالبقاء في المحادثة الرئيسية حين تحتاج المهمة إلى أخذ ورد متكرر، أو حين يتشارك التخطيط والبناء والاختبار قدرًا كبيرًا من السياق، أو في تعديل سريع ومحدد، أو حين يهمك زمن الاستجابة، لأن الوكيل الفرعي الجديد يحتاج إلى وقت ليجمع السياق. أما الموجّهات التي تكررها ويجب أن تعمل في المحادثة الرئيسية، فالمهارة (skill) أنسب لها.

## الأخطاء الشائعة وحلولها

يستخدم الوكلاء الفرعيون مفتاح الجلسة، فتظهر لهم الأخطاء نفسها التي تظهر في المحادثة الرئيسية:

- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY): المفتاح في `~/.claude/settings.json` غير صحيح أو حُذف.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): المفتاح لمزوّد آخر غير Claude.
- [`MODEL_UNAVAILABLE`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_UNAVAILABLE): النموذج المذكور في الحقل `model` لوكيل فرعي غير متاح الآن. أعد المحاولة، أو اضبطه على `inherit`.
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): الرصيد لا يكفي لهذا الطلب. اشحن رصيدك ثم أعد المحاولة.
- [`API_KEY_QUOTA_EXHAUSTED`](https://5abeer.ai/ar/docs/help/errors.md#API_KEY_QUOTA_EXHAUSTED): وصل المفتاح إلى حد إنفاقه، وكثيرًا ما يحدث ذلك حين يعمل عدة وكلاء معًا.

وكل رمز مشروح في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

## أسئلة شائعة

### هل يستهلك الوكلاء الفرعيون توكنات أكثر؟

في المجموع غالبًا نعم، لأن كل وكيل يبني سياقه من الصفر. وفي المقابل تبقى محادثتك الرئيسية صغيرة، وحمل نتيجة قصيرة أقل تكلفة من حمل الناتج الخام الذي تحل محله.

### هل يستطيع الوكيل الفرعي أن يبدأ وكلاء فرعيين خاصين به؟

نعم، حتى ثلاث طبقات تحت المحادثة الرئيسية افتراضيًا. ولتمنعه من ذلك، لا تضع `Agent` في قائمة `tools` الخاصة به، أو أضفها إلى `disallowedTools`.

### كم وكيلًا فرعيًا يمكن أن يعمل في الوقت نفسه؟

حتى 20 وكيلًا افتراضيًا، وبعدها يظهر الخطأ `Concurrent subagent limit reached`. ويرسل كل وكيل طلباته الخاصة، لذلك يبلغ التشغيل المتوازي حد إنفاق المفتاح أسرع.

### لماذا لا يفتح الأمر /agents شاشة إعداد؟

منذ الإصدار 2.1.198 صار يوجّهك إلى مجلدات الوكلاء بدلًا من ذلك. اطلب من Claude أن ينشئ الوكيل، أو عدّل الملف في `.claude/agents/` أو `~/.claude/agents/`.

### هل يعمل الوكلاء الفرعيون على باقة من 5abeer؟

نعم، إذا كانت باقتك تشمل Claude Code. وتُحسب طلبات الوكلاء ضمن حدود الباقة مثل بقية الجلسة. راجع [ما الذي تشغّله كل باقة](https://5abeer.ai/ar/docs/subscriptions/plan-apps.md#claude-code) و[صفحة الأسعار](https://5abeer.ai/ar/pricing) و[Claude API أم اشتراك Claude Pro/Max](https://5abeer.ai/ar/guides/claude-api-vs-subscription).

### كيف أدفع ثمن الـ API؟

تشحن رصيدك في 5abeer بأي طريقة من [طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md#methods)، وتُخصم طلبات Claude Code من هذا الرصيد.

### هل 5abeer جزء من Anthropic؟

لا. 5abeer خدمة مستقلة لا تتبع Anthropic.

## المصادر

راجعناها في 2026-11-01:

- وثائق Claude Code: [Create custom subagents](https://code.claude.com/docs/en/sub-agents)
- وثائق Claude Code: [Model configuration](https://code.claude.com/docs/en/model-config)
- وثائق Claude Code: [Other LLM gateways](https://code.claude.com/docs/en/llm-gateway)

## ابدأ

احصل على تطبيق 5abeer AI لتشغّل Claude Code ووكلاءه الفرعيين على باقتك، أو أنشئ مفتاحًا لنماذج Claude واتبع الخطوات السابقة.