ملاحظة المؤلف: أُعدّت هذه المقالة استنادًا إلى وثائق Anthropic الرسمية بتاريخ 2026-11-08 (UTC+8) وإلى دليل معاملات التفكير (thinking) الخاص بـ Claude في APIYI المحدّث في 2026-11-09 الساعة 10:40، وكان تاريخ التحقق من المعايير 2026-11-13؛ والغرض منها مساعدتك على تجنّب خطأ 400 المرتبط بمعامل thinking في claude-opus-5-5 و claude-sonnet-5-5.
إذا مرّرت type الخاص بـ thinking على claude-opus-5-5 بالقيمة disabled، فسيُعيد الـ API مباشرةً خطأ 400 — وهذا هو المعيار المنصوص عليه صراحةً في وثائق Anthropic الرسمية بتاريخ 2026-11-08 (UTC+8). وقد حدّث APIYI (apiyi.com) في 2026-11-09 الساعة 10:40 دليل معاملات التفكير في Claude بشكل متزامن، ووضّح الطريقة الصحيحة لكتابة معرّفي النموذجين. تقدّم هذه المقالة قراءة سريعة لتأثير هذا التغيير على الجهات التي تستدعي Claude API.
هذا ليس كلامًا من مصادر غير موثوقة: كلا الاستنتاجين الرئيسيين يستندان إلى الوثائق — فلا يمكن إيقاف التفكير في claude-opus-5-5، بل يمكن فقط خفض effort؛ أما في claude-sonnet-5-5 فإن إيقاف التفكير المسبق (pre-thinking) يتطلب استخدام between_tools بدلاً من ذلك.
القيمة الأساسية: تعرّف في 3 دقائق على الطريقة الصحيحة لكتابة معرّفي النموذجين، وحدود معامل between_tools، ومنهجية تتبّع خطأ 400.
نظرة سريعة على المعلومات الأساسية: معايير thinking في claude-opus-5-5 و claude-sonnet-5-5
ابدأ بجدول الخلاصة، ثم نفصّل كل بند على حدة:
| بند المعلومات | التفاصيل |
|---|---|
| المواصفات الرسمية | 2026-11-08 (UTC+8) وثائق Anthropic الرسمية |
| تحديث دليل APIYI | 2026-11-09 10:40، تمت المزامنة على docs.apiyi.com |
| claude-opus-5-5 | عدم تمرير thinking يعني تفكيرًا تكيفيًا؛ وتمرير disabled يُرجع 400 |
| claude-sonnet-5-5 | عدم تمرير thinking يعني أيضًا تفكيرًا تكيفيًا؛ ولإيقاف التفكير المسبق استخدم between_tools |
القيمة الافتراضية لـ effort |
medium في Opus 5.5، وhigh في Sonnet 5.5 |
| الحد الأقصى للإخراج | 128000 لكلٍّ من معرّفي النموذجين، وتُحتسب رموز التفكير ضمنها |
معايير claude-opus-5-5 واضحة إلى حد كبير. عندما لا يمرّر الطلب الحقل thinking، يدخل النموذج في وضع التفكير التكيفي، ويقرر بنفسه ما إذا كان سيفكّر في تلك المرة وإلى أي عمق؛ أما إذا ضبطت type داخل thinking على disabled، فإن الواجهة لن تتجاهلها بصمت، بل ستُرجع 400 مباشرة. بعبارة أخرى، لا يوجد مفتاح لإيقاف التفكير في هذا المعرّف، والوسيلة الوحيدة التي تذكرها الوثائق للضبط هي تقليل effort، والمستوى الافتراضي هو medium.
أما وضع claude-sonnet-5-5 فيختلف قليلًا. فهو يدعم أيضًا التفكير التكيفي عند عدم تمرير thinking، لكنه يملك مسارًا إضافيًا معترفًا به رسميًا لإيقاف التفكير: ضبط type على between_tools، فيتوقف التفكير المسبق ويبقى فقط تحديث التقدم بين استدعاءات الأدوات. وحدود هذا المسار مكتوبة بوضوح أيضًا، ويُفضّل الرجوع مباشرة إلى الجدول التالي:
| بند القيد | المواصفة في الوثائق |
|---|---|
قيم effort |
لا تقبل سوى low وmedium وhigh |
| الحد الأعلى للمستوى | لا يمكن أن يتجاوز high |
| قيود الاستخدام المشترك | لا يمكن أن يُرفق مع display أو budget_tokens في الوقت نفسه |
| التأثير الفعلي | إيقاف التفكير المسبق، مع الاحتفاظ فقط بتحديثات التقدم بين استدعاءات الأدوات |
وهناك تفصيل يسهل نسيانه: رموز التفكير تُحتسب ضمن max_tokens. الحد الأقصى للإخراج لكلا معرّفي النموذجين هو 128000، وإذا ضغط الطلب max_tokens إلى قيمة منخفضة جدًا، فقد يأكل التفكير أولًا معظم الميزانية، ثم يُقطع النص المرافق. عند تشخيص مشكلة «الردود التي تقصر بشكل مفاجئ»، يجدر أولًا التأكد من مقدار ما يشغله التفكير.
شرح الرسم: سلسلة الاستدعاء في الرسم مبنية على بوابة تنسيق Anthropic الأصلي لدى APIYI على apiyi.com. عند استخدام تنسيق Anthropic، يكون عنوان base هو https://api.apiyi.com، وانتبه لعدم كتابته بصيغة تحتوي على /v1.
تحليل التأثير: من يتأثر من إرجاع disabled للخطأ 400
يتوزع أثر هذا التغيير في القواعد على مطوّري الاستدعاء على ثلاثة محاور: معالجة الأخطاء، وتركيب المعاملات، وتخطيط الميزانية. وسنفصّل كل واحدة منها ليكون الصورة أوضح.
أثره على الشيفرة القائمة: نقل كتابة disabled
| الحالة | الكتابة القديمة | النتيجة الآن | الطريقة الصحيحة |
|---|---|---|---|
| الرغبة في إيقاف التفكير مع claude-opus-5-5 | تمرير disabled في type |
إرجاع الخطأ 400 | لا يمكن الإيقاف، والحل الوحيد هو تقليل effort |
| الرغبة في إيقاف التفكير المسبق مع claude-sonnet-5-5 | تمرير disabled في type |
إرجاع الخطأ 400 | استخدم between_tools بدلاً منه |
| الرغبة في ضبط ميزانية التفكير بدقة | between_tools مع budget_tokens |
التركيب غير مقبول | لا يمكن تمريرهما معًا، استخدم المستويات الثلاثة في effort |
| القلق من أن يأكل التفكير مساحة الناتج | ضبط max_tokens بقيمة صغيرة جدًا |
يُقطع النص الأساسي | التفكير يُحتسب ضمن max_tokens، فاترك فائضًا احتياطيًا |
التأثير الأول هو ازدياد قيود تركيب المعاملات. فـ between_tools لا يمكن أن يظهر مع budget_tokens أو مع display في الوقت نفسه، وهذا يعني أن أسلوب الضبط الدقيق لميزانية التفكير لم يبقَ له أثر على هذا المسار، ولم يتبقَّ سوى الضبط غير المباشر عبر المستويات الثلاثة low وmedium وhigh. وإذا أضفنا إلى ذلك قاعدة أن «رموز التفكير تُحتسب ضمن max_tokens»، فإن مطوّر الاستدعاء بحاجة إلى إعادة إيجاد توازن بين effort وmax_tokens.
التأثير الثاني هو أن منطق الفروع يحتاج إلى تحديث. فإذا كان السكربت يقرر تمرير disabled بناءً على معرّف النموذج، فعند مواجهة هذين المعرّفين يجب أن يسلك فرعين: الأول يتقبّل واقع «عدم إمكانية الإيقاف» ويستخدم effort بمستوى أدنى، والثاني يتحوّل إلى between_tools. وإذا جمعت هذا النوع من الفروع في مكان واحد ضمن الإعدادات لتصيانته، فسيكون حجم التعديل أصغر عند أي تغيير لاحق في القواعد.
وبالمناسبة، توضح الصفحة نفسها أيضًا أن تمرير disabled إلى Fable 5.1 وFable 5 يُرجع الخطأ 400 كذلك، وأن الإيقاف غير ممكن معهما؛ أما Haiku 5.5 وOpus 5 فيظل disabled متاحًا معهما عندما لا يتجاوز effort مستوى high. وإذا كانت الشيفرة تخدم عدة معرّفات نماذج في الوقت نفسه، فمن المستحسن أن تصون مصفوفة تشغيل لكل نموذج بدل تطبيق الكتابة نفسها على الجميع.
تأثير ذلك على بنية التكلفة: رموز التفكير والاستهلاك
في جدول APIYI (apiyi.com) الإجمالي، يُسعَّر claude-sonnet-5-5 عند الإدخال بـ$2، والإخراج بـ$10، وقراءة الذاكرة المؤقتة بـ$0.1. ولأن رموز التفكير تُحتسب ضمن max_tokens، فإن إيقاف التفكير المسبق أو اختيار مستوى effort سيظهر مباشرةً في استهلاك الرموز. وفي سيناريوهات الاستدعاء عالي التكرار تتضاعف هذه الفجوة، لذا يستحق الأمر إجراء حساب سريع للتكلفة عند تعديل الكود.
شرح الصورة: جمعت المعايير من الوثائق الرسمية بتاريخ 2026-11-08، ويمكن التحقق منها مقابل النص الأصلي في مركز وثائق APIYI على apiyi.com.
| معرّف النموذج | توفّر disabled |
ما تنص عليه الوثائق |
|---|---|---|
| claude-opus-5-5 | غير متاح، يعيد 400 | لا يمكن إيقاف التفكير، ويمكن فقط خفض effort (الافتراضي medium) |
| claude-sonnet-5-5 | غير متاح، يعيد 400 | استخدم بدلاً من ذلك between_tools (الافتراضي high) |
| Fable 5.1 / Fable 5 | غير متاح، يعيد 400 | لا يمكن إيقافه أيضاً |
| Haiku 5.5 / Opus 5 | متاح عندما لا يزيد effort عن high |
الصيغة القديمة صالحة فقط مع هذين المعرّفين |
كيفية التحقق السريع من between_tools في claude-sonnet-5-5
قبل نشر التغييرات، يُفضّل التحقق أولًا من فروق السلوك باستخدام حجم مرور صغير. سجّل في APIYI (apiyi.com) واحصل على مفتاح API؛ فالمستخدمون الجدد لديهم رصيد اختبار مجاني. أرسل الطلبات إلى https://api.apiyi.com، واضبط type داخل thinking على between_tools، واختر أحد المستويات الثلاثة لـ effort، ثم نفّذ دورة أولى، وبعدها قارن مع الوضع التكيفي الذي لا يرسل thinking، وراقب التغيّرات في بنية المخرجات واستهلاك tokens.
🚀 اقتراح للتحقق السريع: احصل على رصيد اختبار مجاني عبر APIYI apiyi.com، وشغّل نفس مجموعة الموجهات مرة بنمط
between_toolsومرة بالنمط التكيفي، وتأكد من الفروق قبل تعديل الكود الموجود. تدعم المنصة الاستدعاء الموحّد لنماذج رئيسية مثل Claude وOpenAI وGemini، وتعمل الواجهة المتوافقة مع OpenAI بالدفع حسب الاستخدام، ما يسهّل المقارنة الأفقية والتبديل.
الأسئلة الشائعة: disabled وbetween_tools وأخطاء 400
س1: هل يمكن فعلًا تعطيل التفكير في claude-opus-5-5؟
لا. ينص البيان الرسمي بتاريخ 2026-11-08 صراحةً على أن تمرير `disabled` سيُعيد خطأ 400، فهذا المعرّف للنموذج لا يمتلك مفتاحًا لتعطيل التفكير، وكل ما يمكن فعله هو تقليل عمق التفكير عبر `effort`، والدرجة الافتراضية هي `medium`. وإذا كان السيناريو يتطلب غياب التفكير تمامًا، فلا خيار سوى تغيير معرّف النموذج.
س2: هل يمكن استخدام `between_tools` في claude-sonnet-5-5 مع `budget_tokens`؟
لا. توثّق الوثائق بوضوح أن `between_tools` لا يمكن أن يحمل في الوقت نفسه `display` أو `budget_tokens`، وأن `effort` المرافق يقبل فقط المستويات `low` و`medium` و`high` ولا يتجاوز `high`. وإذا كنت تريد التحكم الدقيق في ميزانية التفكير، فلا بد من العودة إلى الوضع التكيفي أو تغيير معرّف النموذج.
س3: لماذا يعيد طلب Claude الخاص بي فجأة خطأ 400؟
تحقق أولًا من أن `type` الخاص بـ`thinking` في جسم الطلب لم يُضبط على `disabled` — فعلى claude-opus-5-5 وclaude-sonnet-5-5 هذا هو شرط التفعيل المذكور في الوثائق. بعد التأكد، تعامل وفق جدول المقارنة في هذا المقال: في الأول قلّل `effort`، وفي الثاني بدّل إلى `between_tools`. والكتابة الصحيحة تتبع الوثائق الرسمية بتاريخ 2026-11-08 (UTC+8)، وقد تمت مزامنة صفحة APIYI في 2026-11-09 الساعة 10:40.
س4: كيف أتحقق سريعًا من تأثير `between_tools` في claude-sonnet-5-5؟
سجّل حسابًا في APIYI (apiyi.com) واحصل على مفتاح API؛ فالمستخدمون الجدد لديهم حصة اختبار مجانية. أرسل الطلب إلى `https://api.apiyi.com`، واضبط `type` الخاص بـ`thinking` على `between_tools` واختر أي درجة من `effort`، ثم شغّل دورة واحدة وستتمكن من مقارنة الفرق مع الوضع التكيفي.
س5: هل تستهلك رموز التفكير من ميزانية الإخراج؟
نعم. تُحتسب رموز التفكير ضمن `max_tokens`، والحد الأقصى للإخراج في كلا معرّفي النموذج هو 128000. وعندما تضبط `max_tokens` في الطلب على قيمة منخفضة جدًا، فقد يستهلك التفكير الميزانية أولًا ويُقطع النص الأساسي، لذا يُنصح بترك مساحة كافية للنص.
النقاط الأساسية في claude-opus-5-5 و claude-sonnet-5-5 (Key Takeaways)
- لا يمكن إيقاف التفكير في claude-opus-5-5: تمرير
disabledيُرجع خطأ 400 مباشرة، ولا يمكنك إلا خفض المستوى عبرeffort، والقيمة الافتراضية هيmedium. - claude-sonnet-5-5 يعتمد
between_tools: لإيقاف التفكير المسبق، مع الإبقاء فقط على تحديثات التقدم بين استدعاءات الأدوات. - ثلاثة خطوط حمراء في المعاملات:
effortيقبل فقطlowوmediumوhigh، ولا يمكن أن يتجاوزhigh، ويُمنع استخدامه معdisplayوbudget_tokens. - قاعدة الميزانية: تُحتسب tokens التفكير ضمن
max_tokens، والحد الأعلى لكلا المعرّفين هو 128000. - مدخل التحقق: APIYI apiyi.com، وقاعدة تنسيق Anthropic هي
https://api.apiyi.com، دون إضافة/v1.
الخلاصة: ثلاثة إجراءات لتجنّب خطأ 400
يمكن تلخيص قواعد claude-opus-5-5 و claude-sonnet-5-5 في ثلاث جمل:
- claude-opus-5-5: تمرير
disabledيُرجع خطأ 400، فالتفكير لا يمكن إيقافه، وكل ما تستطيع فعله هو خفضeffort. - claude-sonnet-5-5: لإيقاف التفكير المسبق استخدم
between_tools، مع ثلاث درجات منeffort، ويُمنع استخدامه معdisplayوbudget_tokens. - الميزانية: تُحتسب tokens التفكير ضمن
max_tokens، والحد الأعلى 128000، فاترك هامشًا للنص الأساسي.
إذا كنت عالقًا بسبب خطأ 400 هذا، فإننا ننصحك أولًا بتشغيل تجربة على between_tools في APIYI apiyi.com باستخدام حصة الاختبار المجانية، والتأكد من السلوك قبل تعديل الكود الحالي. تكفي مفتاح API واحد على المنصة لاستدعاء النماذج الرئيسية مثل OpenAI وClaude وGemini، مع دفع حسب الاستخدام، وهو مناسب للمقارنة والتبديل السريع.
📚 المراجع
- دليل معاملات التفكير في Claude من APIYI: الصيغ المناسبة لاستخدام effort وthinking
- الرابط:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
الوصف: نسخة محدّثة بتاريخ 2026-11-09 10:40، وهي المصدر الرئيسي للوقائع في هذا المقال
-
تحديثات دليل APIYI: التوضيح الرسمي لمزامنة الصياغة في هذه الجولة
- الرابط:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
الوصف: يوثّق عملية المواءمة مع الوثائق الرسمية بتاريخ 2026-11-08
-
وثائق Anthropic الرسمية: الصياغة الأصلية لمعامل thinking
- الرابط:
docs.anthropic.com - الوصف: يُنصح بقراءتها جنبًا إلى جنب للتأكد من أحدث صيغة
المؤلف: فريق APIYI التقني
التواصل التقني: نرحب بتواصلكم معنا عبر الصفحة الرئيسية لموقع APIYI، ولمزيد من المواد يمكنكم زيارة مركز الوثائق docs.apiyi.com
