تشغيل الوكلاء الفرعيين في Claude Code بنموذج مختلف: إسناد العمل إلى Sonnet وHaiku، الإعدادات والقياسات

تريد أن تبقى جلسة Claude Code الرئيسية على Opus 5، وأن يبقى الجهد (effort) مرتفعًا أيضًا. لكن تشغيل أعمال مثل الترجمة أو مراجعة عدد كبير من الملفات بالنموذج نفسه هدرٌ واضح. ومن هنا يأتي السؤال: ألا يمكن تشغيل الوكلاء الفرعيين وحدهم على Sonnet أو Haiku؟

الجواب باختصار: نعم. يُحدَّد نموذج الوكيل الفرعي بمعزل عن الجلسة الرئيسية، ويمكنك تغييره بالتحديد عند الاستدعاء، أو عبر model في ملف التعريف، أو بمتغير بيئة. ويمكن كذلك تحديد مستوى جهد مختلف لكل وكيل فرعي.

في هذا المقال أرتّب المواصفات الواردة في الوثائق الرسمية حتى 15 سبتمبر 2026، ثم أعرض نتائج تشغيل وكلاء فرعيين فعليًا بنماذج أخرى والتحقق منها في سجلات المحادثة. فقد أسندت الترجمة نفسها إلى Opus 5 وSonnet 5 وHaiku 4.5 مرتين لكلٍّ منها، وقارنت الوقت والتكلفة وجودة الترجمة.

1. ما يمكن فعله: نموذج وجهد مختلفان عن الجلسة الرئيسية

الوكيل الفرعي عاملٌ يشغّله Claude Code ليتولى جزءًا من العمل، وله سياق مستقل. فهو لا يشارك الجلسة الرئيسية سجلّ المحادثة، ولا يعيد إليها عند انتهائه إلا النتيجة (تناولت الفرق بينه وبين فرق الوكلاء في Subagents مقابل Agent Teams في Claude Code).

وتذكر الوثائق الرسمية أمرين يمكن تحديدهما لكل وكيل فرعي على حدة، هما:

أي إن تركيبة مثل «الجلسة الرئيسية على Opus 5 بجهد high، والمترجم على Sonnet 5 بجهد medium» ممكنة كما هي ضمن حدود المواصفات الرسمية. أما معنى الجهد نفسه فراجِع ضبط الجهد (Effort) في Claude Code: الدليل الكامل.

المصدر: وثائق Claude Code الرسمية «Create custom subagents» (Supported frontmatter fields)، وثائق Claude Code الرسمية «Model configuration» (أولوية إعدادات الجهد)

2. الترتيب الذي يُحدَّد به النموذج

كما في الشكل أعلى المقال، يُحدَّد نموذج الوكيل الفرعي بالترتيب «التحديد عند الاستدعاء» ← «model في ملف التعريف» ← «متغير البيئة CLAUDE_CODE_SUBAGENT_MODEL» ← «نموذج الجلسة الرئيسية»، ويُعتمد أول ما ينطبق منها. وهناك ثلاث نقاط تستحق الانتباه.

الأولى: الترتيب يختلف باختلاف الإصدار. قبل v2.1.251 كان متغير البيئة في الأعلى، فكان يتجاوز التحديد عند الاستدعاء وmodel في ملف التعريف (بما في ذلك inherit). فإذا كتبت model: sonnet في التعريف ولم يُطبَّق، فتحقّق أولًا من الإصدار ومن متغير البيئة.

الثانية: هناك إعداد منفصل حين تريد توحيد الجميع على نموذج واحد. فمتغير البيئة وحده لا يُلزم الوكلاء الفرعيين الذين كُتب model في ملفات تعريفهم. ولفرض النموذج على الجميع، اضبط CLAUDE_CODE_SUBAGENT_MODEL_FORCE على 1 إضافةً إلى CLAUDE_CODE_SUBAGENT_MODEL (منذ v2.1.257).

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

عند الفرض، يُتجاهل model في ملفات التعريف، بما فيها Explore وPlan المدمجان، ولا يعود بإمكان Claude تحديد النموذج عند الاستدعاء. وهناك استثناءان يبقيان على نموذج الجلسة الرئيسية: fork الذي يرث المحادثة كاملة، وتشغيل مهارة مضبوطة على model: inherit داخل وكيل فرعي.

الثالثة: وجهة sonnet وopus تختلف باختلاف جهة الاتصال. فالكلمة نفسها sonnet قد تقود إلى نماذج مختلفة كما يلي.

المصدر: وثائق Claude Code الرسمية «Model configuration» (الجدول حتى 15 سبتمبر 2026). لتثبيت إصدار بعينه، اكتب معرّف النموذج الكامل بدل الاسم المختصر

وإذا كانت إعدادات الإدارة في مؤسستك تقيّد النماذج المتاحة (availableModels)، فإن model الخاص بالوكيل الفرعي ومتغير البيئة يخضعان لهذا القيد أيضًا.

3. طرق الإعداد (خمس طرق)

① الكتابة في ملف التعريف (لدورٍ تريده دائمًا على النموذج نفسه)

أسهل الطرق استخدامًا أن تنشئ ملف تعريف لكل دور. فإن وضعته في .claude/agents/ داخل المشروع أمكنت مشاركته عبر git، وإن أردت استخدامه في كل مشاريعك فضعه في ~/.claude/agents/.

---
name: translator
description: يترجم المقالات اليابانية إلى الإنجليزية. يُستخدم عند طلب الترجمة
model: sonnet
effort: medium
tools: Read, Write, Grep
---
أنت مترجم للمقالات التقنية. لا تغيّر وسوم HTML ولا سماتها،
وحوّل النص الظاهر وحده إلى إنجليزية طبيعية.

عند وجود عدة تعريفات بالاسم نفسه، تكون الأولوية بهذا الترتيب: إعدادات الإدارة في المؤسسة، ثم --agents عند التشغيل، ثم المشروع، ثم المستخدم، ثم الإضافات. ومنذ v2.1.198 لم يعد الأمر /agents يفتح شاشة الإنشاء، فإما أن تطلب من Claude إنشاء التعريف، وإما أن تكتب الملف بنفسك.

② التحديد عند الاستدعاء (لتغييره في تلك المرة فقط)

حتى من دون تعريف، يستطيع Claude إرفاق نموذج حين يشغّل وكيلًا فرعيًا. فإذا طلبت في المحادثة شيئًا مثل «أسند هذه المراجعة إلى وكيل فرعي على Haiku»، شغّله Claude مع إرفاق النموذج بذلك الاستدعاء. وهذا التحديد مقدَّم على ملف التعريف. وللتأكد من أن النموذج أُرفق فعلًا، استخدم الطريقة الواردة في القسم 5.

③ تحديد القيمة الافتراضية بمتغير بيئة (لتغيير كل ما لم يُحدَّد له نموذج دفعة واحدة)

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "sonnet"
  }
}

إذا كتبته في env داخل settings.json، فإنه يسري على الوكلاء الفرعيين الذين لم يُحدَّد نموذجهم بطريقة أخرى. وبحسب الوثائق الرسمية، يشمل ذلك أيضًا أعضاء فرق الوكلاء ووكلاء سير العمل. لكن هذا وحده لا يغيّر نموذج Explore وPlan المدمجين (القسم 4).

④ التمرير عبر --agents عند التشغيل (لتلك الجلسة فقط)

claude --agents '{
  "translator": {
    "description": "Translates Japanese articles into English.",
    "prompt": "You are a technical translator. Keep all HTML tags.",
    "model": "sonnet",
    "effort": "medium"
  }
}'

لا يُحفظ في أي ملف، ولا يمكن استخدامه إلا طوال تلك الجلسة.

⑤ التعريف عبر Claude Agent SDK

from claude_agent_sdk import ClaudeAgentOptions, AgentDefinition

options = ClaudeAgentOptions(
    agents={
        "translator": AgentDefinition(
            description="Translates Japanese articles into English.",
            prompt="You are a technical translator. Keep all HTML tags.",
            tools=["Read", "Write"],
            model="sonnet",
            effort="medium",
        ),
    }
)

في AgentDefinition ضمن SDK أيضًا، يمكنك أن تكتب في model اسمًا مختصرًا أو inherit أو معرّف نموذج كاملًا. وإن لم تكتبه، يُحدَّد بالترتيب المبيَّن أعلاه. وتشير الوثائق الرسمية إلى أن Opus 5 أميل من النماذج السابقة إلى توزيع العمل على وكلاء فرعيين، وتقترح إعدادات تضع حدًّا لعدد الوكلاء العاملين في وقت واحد (الافتراضي 20) أو للمبلغ المُنفَق.

المصدر: وثائق Claude Code الرسمية «Create custom subagents» (أماكن الحفظ والأولوية، و--agents، والتغيير في /agents، ومتغير البيئة)، وثائق Claude Code الرسمية «Model configuration» (نطاق CLAUDE_CODE_SUBAGENT_MODEL)، وثائق Claude Code الرسمية «Subagents in the SDK» (AgentDefinition، وإعدادات الحدود)

4. بأيّ نموذج يعمل الوكلاء الفرعيون المدمجون؟

حتى إن لم تعرّف شيئًا بنفسك، يأتي Claude Code ومعه عدد من الوكلاء الفرعيين. وهذا نموذج كلٍّ منهم.

المصدر: وثائق Claude Code الرسمية «Create custom subagents» (Built-in subagents، حتى 15 سبتمبر 2026)

منذ v2.1.198 لم يعد Explore يعمل دائمًا على Haiku. فقد صار يرث نموذج الجلسة الرئيسية، وحدّه الأعلى Opus في Claude API. فإذا كانت الجلسة الرئيسية على نموذج أعلى مثل Fable عمل Explore على Opus، وإذا كانت على Sonnet أو Haiku عمل بذلك النموذج. ولإعادته إلى Haiku، تقترح الوثائق الرسمية إنشاء ملف تعريف باسم Explore وكتابة model: haiku فيه (لأن تعريفك مقدَّم على المدمج الذي يحمل الاسم نفسه).

ولتغيير نموذج Explore وPlan بمتغير البيئة، عليك أن تضبط أيضًا CLAUDE_CODE_SUBAGENT_MODEL_FORCE الوارد في القسم 2.

5. القياس ①: هل عمل فعلًا بذلك النموذج؟

تحقّقت على جهازي (الجلسة الرئيسية على Opus 5 بجهد high) من أن السلوك يطابق المواصفات. أسندت إلى general-purpose المدمج المهمة الصغيرة نفسها، «اقرأ README ولخّصه في ثلاثة أسطر»، بثلاث طرق: مع تحديد النموذج sonnet، ومع تحديده haiku، ومن دون تحديد.

وللتحقق طريقتان. أثناء التشغيل، يعرض /tasks نموذج الوكيل الفرعي في القائمة (كما تذكر الوثائق الرسمية). وبعد الانتهاء، افتح ملفات agent-*.jsonl في مجلد subagents/ ضمن سجلات المحادثة على جهازك، وانظر إلى message.model في كل ردّ. أما مكان السجلات وطريقة قراءتها فتناولتهما بالتفصيل في استهلاك Claude Code حسب الجلسة: كيف تقيسه.

المصدر: قياساتي الخاصة (15 سبتمبر 2026، تطبيق سطح المكتب على Windows. سُجِّل النموذج نفسه في جميع ردود كل وكيل فرعي)

عمل كلٌّ منها بالنموذج المحدَّد، وورث الوكيل الذي لم يُحدَّد له نموذج نموذجَ الجلسة الرئيسية. وفي ملف agent-*.meta.json داخل المجلد نفسه، لا تبقى القيمة المحدَّدة، مثل "model": "sonnet"، إلا حين يُحدَّد النموذج.

6. القياس ②: عشرات آلاف التوكنات لمجرد التشغيل

وكشفت السجلات نفسها أمرًا آخر: يقرأ الوكيل الفرعي عشرات آلاف التوكنات في ردّه الأول وحده، قبل أن يبدأ العمل. والسبب أن موجّه النظام الخاص به وتعريفات الأدوات وCLAUDE.md وغيرها تُحمَّل في البداية.

المصدر: قياساتي الخاصة (15 سبتمبر 2026. عدد التوكنات في الردّ الأول لكل وكيل فرعي. كانت جميع عمليات الكتابة في تخزين مؤقت مدته 5 دقائق)

ويمكن أن نستخلص من هذه الأرقام ثلاثة أمور.

الأول: بين الوكلاء الفرعيين العاملين على النموذج نفسه، يُقرأ الجزء المشترك في بداية الطلب من التخزين المؤقت. ففي التشغيل الثاني مع Sonnet 5 صار نحو 45 ألف توكن قراءةً من التخزين المؤقت (بسعر يساوي 0.1 من سعر الإدخال). وتذكر الوثائق الرسمية أيضًا أن الطلبات الموجَّهة إلى النموذج نفسه والمتطابقة في بدايتها تتشارك التخزين المؤقت. وفي المقابل، التخزين المؤقت منفصل لكل نموذج، ولا يقرأ الوكيل الفرعي التخزين المؤقت للجلسة الرئيسية كذلك (لأن محتوى البداية مختلف).

الثاني: حتى مع الاشتراك، ينتهي التخزين المؤقت للوكيل الفرعي بعد 5 دقائق. فبحسب الوثائق الرسمية، حين تستخدم Claude Code ضمن خطتك تكون المدة ساعة واحدة لمحادثة الجلسة الرئيسية، و5 دقائق للوكلاء الفرعيين. فإذا شغّلت الوكيل الفرعي التالي بعد أكثر من 5 دقائق، بدأ مجددًا بالكتابة. ولجعلها ساعة، اضبط الإعداد subagentPromptCacheTtl أو متغير البيئة CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL على 1h (منذ v2.1.242). ولتحديد ذلك لكل وكيل فرعي على حدة، اكتب cacheTtl ضمن experimental في ملف التعريف (منذ v2.1.248؛ وما دام اشتراك Claude يستهلك رصيد الاستخدام الإضافي، أي usage credits، تُتجاهل القيمة 1h هنا). وسعر الكتابة في تخزين الساعة ضعفا سعر الإدخال (مقابل 1.25 ضعف لتخزين الدقائق الخمس).

الثالث: عدد التوكنات لدى Haiku 4.5 يظهر أقل للنص نفسه. فبحسب صفحة الأسعار الرسمية، تستخدم نماذج Claude 4.7 وما بعدها مُجزِّئًا (tokenizer) جديدًا يعدّ للنص نفسه توكنات أكثر بنحو 30%. أما Haiku 4.5 فمن جيل سابق لـ 4.7، ولا يرد ضمن النماذج التي تستخدم المُجزِّئ الجديد. ولذلك إن قارنت أرقام الجدول كما هي بدا Haiku أخفّ مما هو عليه فعلًا.

وإذا وزّعت أعمالًا صغيرة على وكلاء فرعيين كثيرين، أُضيفت هذه «الكلفة الناتجة عن التشغيل وحده» مع كل وكيل. وإسناد العمل إلى نموذج أرخص لا يخفض كلفة العمل نفسه فحسب، بل يخفض هذه الكلفة أيضًا.

المصدر: وثائق Claude Code الرسمية «How Claude Code uses prompt caching» (التخزين المؤقت لكل نموذج، والوكلاء الفرعيون والتخزين المؤقت، ومدة صلاحية التخزين المؤقت)، Claude Platform Docs «Pricing» (المُجزِّئ، ومضاعفات التخزين المؤقت)، وثائق Claude Code الرسمية «Create custom subagents» (omitClaudeMd)

7. القياس ③: الترجمة نفسها لثلاثة نماذج، مرتين لكلٍّ منها

جرّبت فعليًا فكرة «خفض الترجمة وحدها» التي انطلق منها سؤال بداية المقال. اخترت قسمًا واحدًا من النسخة اليابانية لمقال في هذا الموقع (6,265 حرفًا بصيغة HTML، يضم جدولًا وبطاقات أرقام ومقتطفات من الشيفرة)، وأسندت إلى كل نموذج مهمة ترجمته إلى الإنجليزية من دون تغيير بنية الوسوم بالتعليمات نفسها، مرتين لكلٍّ منها، أي 6 مرات إجمالًا. وعمل Opus 5 وSonnet 5 بجهد high الموروث من الجلسة الرئيسية (أما Haiku 4.5 فلا يدعم الجهد).

المصدر: قياساتي الخاصة (15 سبتمبر 2026. التكلفة محسوبة بضرب أعداد التوكنات في سجلات المحادثة في أسعار الوحدة الرسمية المُعلَنة، ولا تشمل الإخراج؛ انظر الملاحظة أدناه)

لم أُدرج الإخراج في عمود التكلفة لأن أعداد توكنات الإخراج في السجلات لم تكن جديرة بالثقة. فقد وجدت ردًّا كتب إلى ملفٍ ترجمةً من نحو 8,800 حرف، ومع ذلك سُجِّل له 18 توكن إخراج فقط. وسعر الإخراج لكل مليون توكن هو $25 مع Opus 5، و$10 مع Sonnet 5، و$5 مع Haiku 4.5، وجاءت الترجمات كلها بالإنجليزية في حدود 8,500 إلى 8,900 حرف.

أما جودة الترجمة فتحقّقت منها بنفسي بمقابلة كل جملة بالأصل الياباني.

• لم أجد خطأً في فهم المعنى في أيٍّ من المرات الست. وبقيت الأرقام والجداول والروابط الداخلية صحيحة. وهو نص كثير الأرقام والقوائم، أي من الفئة السهلة نسبيًا في الترجمة
• ظهر الفرق في سهولة القراءة واتساق الكتابة. ففي المرة الأولى خلط Haiku 4.5 في ضمير المتكلم بين «my» و«the author's»، وفي المرة الثانية جاء بترتيب كلمات متكلَّف مثل «G from 9th rises to 6th». أما Sonnet 5 فكتب إنجليزية طبيعية، لكنه كتب «subagent» بصيغة «Sub-agent» في المرة الأولى و«Subagent» في الثانية، فتذبذبت الكتابة من مرة إلى أخرى. وجاءت مصطلحات Opus 5 متسقة في المرتين
• أبطأ النماذج كان أرخصها، Haiku 4.5. وظهر لدى Sonnet 5 فرق يقارب الضعف في الوقت بين المرتين. ولأن عدد المحاولات قليل، فاعتبر ترتيب السرعة مؤشرًا تقريبيًا لا أكثر

8. الأثر في التكلفة وحدود الاستهلاك

يختلف حساب أثر خفض نموذج الوكيل الفرعي بحسب ما إذا كنت تدفع بحسب الاستخدام عبر API، أو تستخدم اشتراكًا مثل Pro وMax.

الدفع بحسب الاستخدام عبر API: نسبة الأسعار تنعكس مباشرة

المصدر: Claude Platform Docs «Pricing» (لكل مليون توكن، حتى 15 سبتمبر 2026. أصبح سعر Sonnet 5 عند إطلاقه هو سعره الرسمي كما هو)

سعر Sonnet 5 خُمسا سعر Opus 5، وسعر Haiku 4.5 خُمسه. وفي قياس القسم 7، جاءت كلفة الإدخال والتخزين المؤقت مع Sonnet 5 نحو نصف كلفتها مع Opus 5، ومع Haiku 4.5 نحو خُمسها. وجاء Haiku 4.5 قريبًا من نسبة الأسعار، أما Sonnet 5 فجاء أعلى من نسبة الأسعار (الخُمسين). والسبب أن عدد الردود وحجم ما يُقرأ في كل ردّ اختلفا من نموذج إلى آخر (مع Sonnet 5 كانت 4 ردود في مرة و6 في الأخرى، ومع Opus 5 كانت 4 ردود في المرتين، ويدخل في حالة Haiku 4.5 أيضًا اختلاف المُجزِّئ).

الاشتراك: حدود لا يعيدها تغيير النموذج

في Pro وMax، حد الجلسة والحد الأسبوعي مشتركان بين كل النماذج. فإذا استنفدتهما، فلن يعيدك تبديل النموذج عبر /model إلى العمل. وإلى جانب ذلك توجد حدود لكل عائلة نماذج، مثل «حد Opus» و«حد Sonnet»، وحين تبلغ أحدها فقط يمكنك المتابعة بالتبديل إلى نموذج من خارج تلك العائلة.

🟡 لم يُنشر مقدار ما تطول به حدود الخطة إذا جعلت الوكلاء الفرعيين على Sonnet أو Haiku. يمكن اعتبار نسبة أسعار API مؤشرًا، لكن الوثائق لا تقول إن الحدود تنقص بتلك النسبة نفسها. ولمعرفة أيّ الوكلاء الفرعيين يستهلك أكثر، راجع تفصيل الخطة في /usage (النسب بحسب المهارة والوكيل الفرعي والإضافة وخادم MCP).

المصدر: وثائق Claude Code الرسمية «Error reference» (You've hit your session limit: الحد المشترك بين كل النماذج والحدود الخاصة بكل عائلة نماذج)، وثائق Claude Code الرسمية «Manage costs effectively» (تفصيل الخطة في /usage)

9. أيّ الأعمال تنقلها إلى نموذج أرخص؟

تذكر الوثائق الرسمية على سبيل الإرشاد أن Sonnet يؤدي معظم أعمال البرمجة جيدًا وبتكلفة أقل من Opus، وأن Opus يُدَّخر لقرارات التصميم المعقدة والاستدلال متعدد الخطوات، وأن مهام الوكلاء الفرعيين البسيطة يُحدَّد لها model: haiku في ملف التعريف. كما توصي باستخدام Sonnet لأعضاء فرق الوكلاء.

وبناءً على ذلك، أعرض ثلاثة معايير للقرار مستمدة من قياس القسم 7 ومن تجربة تشغيل هذا الموقع.

وإذا ترددت، فالطريقة المضمونة هي أن تسند عملًا واحدًا معتادًا إلى النموذج الأرخص، وتقارن نتيجته بنتيجة نموذجك الحالي جنبًا إلى جنب. يكفي تغيير سطر model واحد في ملف التعريف للتجربة، وإن لم يناسبك عدت عنه فورًا. أما إن كان ما تريد توزيعه هو نموذج الجلسة الرئيسية لا نموذج الوكيل الفرعي، بحيث يُستخدم Opus للتخطيط وحده وSonnet للتنفيذ، فهذا ما يفعله opusplan؛ راجع ما هو opusplan في Claude Code؟

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

س1. إذا غيّرت /model في الجلسة الرئيسية أثناء المحادثة، هل يتغير الوكيل الفرعي أيضًا؟
لا يتغير الوكيل الفرعي الذي يُحدَّد نموذجه عند الاستدعاء، أو عبر model في ملف التعريف (عدا inherit)، أو بمتغير البيئة. أما الوكيل الفرعي الذي لا ينطبق عليه أيٌّ من ذلك، والوكيل الذي ضُبط على inherit في ملف تعريفه، فيتبعان نموذج الجلسة الرئيسية. ولاحظ أن تبديل نموذج الجلسة الرئيسية يعني إعادة بناء التخزين المؤقت للجلسة الرئيسية.

س2. هل يمكن خفض الجهد وحده مع إبقاء النموذج؟
نعم. إذا كتبت مثلًا effort: medium في ملف التعريف، فلن يُطبَّق ذلك الجهد إلا طوال عمل ذلك الوكيل الفرعي. لكن إن كان متغير البيئة CLAUDE_CODE_EFFORT_LEVEL مضبوطًا، فالأولوية له.

س3. إذا كتبت model: sonnet في Amazon Bedrock، فأيّ نموذج سيُستخدم؟
بحسب الوثائق الرسمية حتى 15 سبتمبر 2026، هو Sonnet 4.5. أما في Anthropic API فهو Sonnet 5، أي إن ملف التعريف نفسه يعطي نتيجة مختلفة بحسب جهة الاتصال. ولتثبيت الإصدار، اكتب معرّف النموذج الكامل.

س4. هل من الأوفر جعل التخزين المؤقت للوكيل الفرعي ساعة واحدة؟
يعتمد ذلك على طريقة استخدامك. إن كنت تشغّل النوع نفسه من الوكلاء الفرعيين مرارًا بفواصل تزيد على 5 دقائق، فستقلّل الكتابة في كل مرة. في المقابل، سعر الكتابة في تخزين الساعة ضعفا سعر الإدخال (1.25 ضعف للدقائق الخمس)، فإن كنت تشغّلها دفعة واحدة في وقت قصير فحسب، فالدقائق الخمس أرخص. وقد جمعتُ إعدادات جعل التخزين المؤقت ساعة وشروطها في القسم 6.

س5. حدّدت النموذج، لكن يبدو أنه لا يُطبَّق.
تحقّق بهذا الترتيب: ① هل CLAUDE_CODE_SUBAGENT_MODEL_FORCE مفعَّل (فيُتجاهل ما في ملف التعريف)؟ ② هل تستخدم إصدارًا أقدم من v2.1.251 مع ضبط متغير البيئة؟ ③ هل تسمح إعدادات الإدارة في مؤسستك بذلك النموذج؟ ولمعرفة النموذج الذي عمل به فعلًا، استخدم /tasks أثناء التشغيل، أو message.model في سجلات المحادثة بعد الانتهاء.

المصادر

• Claude Code Docs — Create custom subagents (بنود ملف التعريف، وترتيب تحديد النموذج واختلافه بين الإصدارات، وCLAUDE_CODE_SUBAGENT_MODEL_FORCE، والوكلاء الفرعيون المدمجون، وأماكن الحفظ والأولوية، و--agents، وomitClaudeMd، والتحقق عبر /tasks)
• Claude Code Docs — Model configuration (وجهات الأسماء المختصرة، ونطاق CLAUDE_CODE_SUBAGENT_MODEL، وأولوية إعدادات الجهد، وavailableModels)
• Claude Code Docs — How Claude Code uses prompt caching (التخزين المؤقت لكل نموذج، ومدة صلاحيته للوكلاء الفرعيين، وsubagentPromptCacheTtl وتحديدها عبر متغير البيئة وملف التعريف)
• Claude Code Docs — Manage costs effectively (إرشادات اختيار النموذج، والتوصية باستخدام Sonnet لأعضاء فرق الوكلاء، وتفصيل /usage)
• Claude Code Docs — Error reference (الحد المشترك بين كل النماذج والحدود الخاصة بكل عائلة نماذج)
• Claude Code Docs — Subagents in the SDK (model وeffort في AgentDefinition، وOpus 5 وإعدادات الحدود)
• Claude Code Docs — Orchestrate teams of Claude Code sessions (كيف يُحدَّد نموذج أعضاء فرق الوكلاء)
• Claude Platform Docs — Pricing (أسعار كل نموذج، ومضاعفات التخزين المؤقت، والمُجزِّئ)

مقالات ذات صلة

• Subagents مقابل Agent Teams في Claude Code — ما هو الوكيل الفرعي
• ضبط الجهد (Effort) في Claude Code: الدليل الكامل — معنى الجهد
• استهلاك Claude Code حسب الجلسة: كيف تقيسه — طريقة قراءة سجلات المحادثة
• ما الذي يلتهم سياق Claude Code فعلًا؟ القياس وترتيب الحذف — كيف يُقرأ CLAUDE.md في كل مرة
• ما هو opusplan في Claude Code؟ — تشغيل الجلسة الرئيسية على Opus ما دامت في plan mode وحده
• 10 نصائح لتوفير توكنات Claude Code وتكاليف الاستخدام الإضافي — مواضع أخرى يمكن التوفير فيها