ملاحظة المؤلف: إن claude-haiku-5-5 يفكّر افتراضيًا، وإن حاولت إيقاف التفكير وظهر خطأ، فالسبب في الغالب أن قيمة effort أعلى من high. يشرح هذا المقال القاعدة، وطريقة إصلاح من ثلاث خطوات، وحدود المعاملات.
خفض مقدار التفكير في claude-haiku-5-5 وترك مساحة الإخراج للنص الأساسي مطلب شائع عند تشغيل المهام المجمّعة والمهام المنظمة. ربما تكون قد ضبطت thinking على disabled، لكن الواجهة أعادت خطأً: تريد إيقاف التفكير، فلماذا يتم اعتراضك؟ يوضح هذا المقال قاعدة التعاون بين effort و disabled لمساعدتك على إتقان الطريقة الصحيحة لإيقاف التفكير في claude-haiku-5-5 بسرعة.
هذه ليست مسألة غامضة ولا خللًا في النموذج. التوثيق ينص بوضوح: إذا لم تُمرّر thinking إلى claude-haiku-5-5 فإنه يفكّر تكيفيًا، أي أنه مفعّل افتراضيًا؛ ولإيقاف التفكير تستخدم النوع disabled في thinking، لكن هذه الصيغة لا تُقبل إلا عندما لا تزيد effort على high. تعتمد معاملات هذا المقال على وثائق Anthropic الرسمية بتاريخ 2026-11-08 (UTC+8)، بتاريخ مراجعة 2026-11-13.
القيمة الأساسية: بعد قراءة هذا المقال ستعرف السبب الحقيقي للخطأ، وطريقة إصلاح من ثلاث خطوات، والعلاقة بين max_tokens ورموز التفكير، ولن تعترضك هذه القاعدة بعد اليوم في أي بيئة تستدعي فيها النموذج.
النقاط الأساسية في claude-haiku-5-5
نضع الاستنتاجات أولاً، فمن كان على عجلة من أمره يكفيه هذا القسم:
| النقطة | ما تقوله الوثائق | تأثيرها عليك |
|---|---|---|
| التفكير مفعّل افتراضيًا | عدم تمرير thinking يعني تفكيرًا تكيفيًا مفعّلًا افتراضيًا |
إن أردت توفير الحصة فعليك تعطيله صراحةً |
| مفتاح التعطيل | ضبط thinking على type: disabled |
الطريقة الوحيدة للتعطيل |
| شرط effort | لا يُقبل disabled إلا عندما لا يكون effort أعلى من high |
استخدام xhigh أو max سيؤدي إلى خطأ |
| القيمة الافتراضية لـ effort | الافتراضي medium، وهو نفسه في claude-opus-5-5 |
ما لم ترفعها بنفسك فلن تقع في المشكلة |
| حدود الحصة | الحد الأقصى للمخرجات 128000، ورموز التفكير تُحتسب ضمن max_tokens |
التفكير يزاحم مساحة النص الأساسي |
شرح تفصيلي لنموذج claude-haiku-5-5
أولاً: يفكّر افتراضيًا. يعمل claude-haiku-5-5 افتراضيًا بقدرة التفكير مفعّلة: عندما لا يظهر الحقل thinking في الطلب، يعمل وفق التفكير التكيفي. لا تفصّل الوثائق تفاصيل القرار في الوضع التكيفي، لكن المؤكد أن التفكير يكون مفعّلاً في الحالة الافتراضية.
إذا كانت حالتك أسئلة وأجوبة قصيرة، أو وسم بيانات بالجملة، أو تحويل صيغ، أو مهام لا تحتاج إلى استدلال عميق، فإن توكنات التفكير تصبح مجرد كلفة زائدة. تذكر الوثائق أيضًا أن توكنات التفكير تُحتسب ضمن max_tokens، وأن الحد الأقصى للإخراج هو 128000، فكلما زاد التفكير قلّت المساحة المتاحة للمحتوى الأساسي. ومن هنا جاءت الحاجة إلى «إيقاف التفكير وترك المساحة للمحتوى الأساسي».
ثانيًا: الإيقاف له شروط. المفتاح الوحيد لإيقاف التفكير هو ضبط thinking على type: disabled. لكن الوثائق توضح أن هذه الصيغة لا تُقبل إلا عندما لا يتجاوز effort مستوى high: عندما يكون effort هو medium أو high فكل شيء يعمل، وبمجرد ضبطه على xhigh أو max يفشل الطلب بخطأ. إرشاد الإصلاح الرسمي واضح أيضًا: اخفض effort إلى high أو أقل. وإذا كنت تستدعي claude-haiku-5-5 عبر APIYI على apiyi.com، فعند تتبع هذا النوع من الأخطاء ابدأ أيضًا بفحص هذا التركيب من المعاملات.
ثالثًا: القيمة الافتراضية هي الخيار الآمن. القيمة الافتراضية لـ effort في claude-haiku-5-5 هي medium، مثل claude-opus-5-5، بينما افتراضية معظم النماذج الأخرى هي high. المسار الأكثر شيوعًا للوقوع في المشكلة هو: نقل الكود من نموذج آخر، ورفع effort صراحة إلى xhigh أو max لتحسين الجودة بشكل معتاد، وإضافة disabled في الوقت نفسه للتحكم في التكلفة؛ فتتعارض النيتان ويظهر الخطأ.
في المقابل، طالما لا ترفع effort بنفسك إلى مستوى أعلى، فإن medium الافتراضي يحقق بطبيعته شرط «ألا يتجاوز high»، ويعمل disabled بشكل سليم. وعند الحاجة إلى التبديل والمقارنة بين نماذج مختلفة، يمكنك على APIYI عبر apiyi.com استدعاء عدة نماذج بمفتاح API واحد، ما يغنيك عن تعديل إعدادات التكامل مرارًا.
المخطط أعلاه هو مسار استكشاف الأخطاء القياسي، والحالة الأكثر شيوعًا تعلق عند مربع القرار الأوسط: تجاوز effort للحد. بعد الإصلاح، يُنصح أولاً بإجراء تجربة تحقق بميزانية صغيرة على APIYI عبر apiyi.com، والتأكد من أن الاستجابة سليمة، ثم إدخاله إلى حركة الإنتاج.
البدء السريع مع claude-haiku-5-5: الإصلاح في ثلاث خطوات
لا حاجة للتنقيب في وثائق طويلة؛ نفّذ الخطوات الثلاث التالية، وستُحل هذه الفئة من الأخطاء في الغالب:
- تأكد من معرّف النموذج: يجب أن تكون قيمة
modelفي الطلبclaude-haiku-5-5، لاستبعاد أي تداخل ناتج عن كتابة اسم الطراز خطأً. - اخفض قيمة effort: اضبطها على
highأو أقل. القيمةmediumهي الافتراضية، ويمكنك عدم تمريرها أصلاً؛ المهم ألا تمررxhighأوmax. - ثم عطّل التفكير: اضبط
thinkingعلى{"type": "disabled"}. عندئذٍ لن تتجاوزeffortقيمةhigh، وسيُقبل الطلب بشكل طبيعي.
مرجع سريع لمعاملات طلب claude-haiku-5-5
| المعامل | القيمة المقترحة | الوصف |
|---|---|---|
model |
claude-haiku-5-5 |
الطراز موضوع هذا المقال، احرص على عدم كتابته بإصدار آخر |
thinking |
{"type": "disabled"} |
المفتاح الوحيد لتعطيل التفكير |
effort |
medium (افتراضي) أو high |
يجب ألا تتجاوز high، وإلا فستتعارض مع disabled |
القيم الممنوعة لـ effort |
xhigh، max |
اقترانها بـ disabled يؤدي إلى خطأ |
max_tokens |
الحد الأقصى 128000 | تُحتسب رموز التفكير ضمن هذه القيمة، وبعد تعطيل التفكير يمكن تخصيصها بالكامل للنص الأساسي |
معلومات الربط أيضًا ليست معقدة، وعلى سبيل المثال APIYI:
- عنوان الوصول:
https://api.apiyi.com/v1 - طريقة المصادقة: مفتاح API واحد يكفي
- نمط الواجهة: واجهة متوافقة مع OpenAI
- طريقة الفوترة: فوترة حسب الاستخدام بأسعار مخفضة، وللمستخدمين الجدد حصة اختبار مجانية
- التغطية: النماذج السائدة مثل OpenAI وClaude وGemini
🚀 بدء سريع: يُوصى بإتمام هذا التحقق على APIYI عبر apiyi.com. بعد التسجيل، شغّل الطلب المُصلَح باستخدام حصة الاختبار المجانية، وتأكد من أن
disabledيعمل كما ينبغي وأن الخطأ اختفى، ثم اربطه بعملك الفعلي؛ وستكتمل الدورة في بضع دقائق.
توافق effort مع claude-haiku-5-5
الجدول التالي هو أهم ما في المقال كله، ويُستحسن حفظه مباشرة في ملاحظات الفريق:
قيمة effort |
مع disabled |
النتيجة |
|---|---|---|
medium (الافتراضي) |
متوافق | إغلاق التفكير بشكل طبيعي |
high |
متوافق | إغلاق التفكير بشكل طبيعي |
xhigh |
تعارض | يُرجع الطلب خطأً |
max |
تعارض | يُرجع الطلب خطأً |
قارن طلبك بهذا الجدول وستصبح方向واضحة: يكفي أن يظهر الخطأ في طلب أُرسل معه disabled حتى يكون ردّ فعلك الأول هو فحص ما إذا كان effort قد تجاوز خط high. والحل المذكور في الوثائق يتلخص في جملة واحدة: اخفض effort إلى high أو أقل، ولا يوجد أي طريق آخر للالتفاف على المشكلة.
مقارنة effort الافتراضي بين claude-haiku-5-5 وبقية الطرازات
| النموذج | effort الافتراضي |
العلاقة بإغلاق التفكير |
|---|---|---|
| claude-haiku-5-5 | medium |
يحقق افتراضيًا شرط «ألا يتجاوز high»، لذا يعمل disabled مباشرة |
| claude-opus-5-5 | medium |
القيمة الافتراضية نفسها في haiku، وقواعد مفتاح التفكير الخاصة به لا يتناولها هذا المقال |
| معظم النماذج الأخرى | high |
القيمة الافتراضية داخل الحد أيضًا، ولا يتجاوزها إلا الرفع اليدوي |
هذا الجدول يشرح «لماذا يحدث الخطأ في طلبي أنا تحديدًا»: القيمة الافتراضية لـ effort تختلف من طراز لآخر، وعند نقل الشيفرة مع الاحتفاظ بعادات المعاملات القديمة يصبح من السهل جدًا ضبط effort صراحةً على xhigh أو max. ومقارنة القيمة الافتراضية قبل الترحيل هي أقل إجراء وقائي تكلفةً.
قائمة فحص الأخطاء والتحقق الذاتي لـ claude-haiku-5-5
| العرض | السبب الأكثر احتمالًا | طريقة المعالجة |
|---|---|---|
ما زال الخطأ يظهر حتى بعد تمرير disabled |
قيمة effort هي xhigh أو max |
خفّض effort إلى high أو أقل |
غير متأكد من قيمة effort |
عند عدم تمريره تكون القيمة الافتراضية medium |
القيمة الافتراضية تستوفي الشرط، ولا حاجة إلى معالجة إضافية |
| يصبح نص الإجابة أقصر أو يتعرض للقطع | تُحتسب رموز التفكير ضمن max_tokens |
أوقف التفكير، أو زد max_tokens ضمن الحد الأعلى 128000 |
| تريد جودة استدلال أعمق | عند إيقاف التفكير لن تحصل على عملية تفكير | أزل disabled، وعُد إلى التفكير التكيفي الافتراضي |
بعد الانتهاء من الإصلاح، راجع قائمة التحقق الذاتي هذه قبل إرسال الطلب:
modelمكتوب بدقة على النحوclaude-haiku-5-5effortغير مُمرَّر، أو صريحًاmediumأوhighthinkingيساوي{"type": "disabled"}max_tokensلا يتجاوز 128000
عند تحقق الشروط الأربعة جميعًا، لن تعود هذه الفئة من الأخطاء إلى الظهور. كما أن تثبيت تركيبة المعاملات النهائية في قالب طلب يساعد على تجنب التعديلات الخاطئة لاحقًا.
الأسئلة الشائعة حول claude-haiku-5-5
س1: هل يفكّر claude-haiku-5-5 افتراضيًا؟
نعم. تشير الوثائق إلى أنه عند عدم تمرير `thinking`، يعمل claude-haiku-5-5 وفق التفكير التكيفي، وهو مفعّل افتراضيًا. وإذا أردت أن تخصص ميزانية الإخراج بالكامل للنص الأساسي، فستحتاج إلى تمرير `disabled` صراحةً لإيقافه.
س2: لماذا يظهر خطأ حتى بعد تمرير disabled؟
السبب الأكثر شيوعًا هو أن `effort` أعلى من `high`. توضح الوثائق أن `disabled` لا يُقبل إلا عندما لا يكون `effort` أعلى من `high`، وأن استخدامه مع `xhigh` أو `max` يسبب خطأ. وطريقة الإصلاح هي خفض `effort` إلى `high` أو أقل.
س3: ماذا يحدث إذا لم يتم تمرير effort؟
القيمة الافتراضية هي `medium`. القيمة الافتراضية في claude-haiku-5-5 هي نفسها في claude-opus-5-5، أي `medium`، بينما القيمة الافتراضية لدى معظم النماذج الأخرى هي `high`. القيمة الافتراضية بحد ذاتها تحقق شرط «ألا تكون أعلى من high»، لذا يمكن استخدامها مباشرة مع `disabled`.
س4: ما التغير في طول الإخراج بعد إيقاف التفكير؟
تذكر الوثائق أن رموز التفكير تُحتسب ضمن `max_tokens`، وأن الحد الأقصى للإخراج هو 128000. بعد إيقاف التفكير، يمكن استخدام ميزانية `max_tokens` نفسها بالكامل للنص الأساسي، وينخفض بالتالي خطر الاقتطاع.
س5: ماذا أفعل إذا احتجت مؤقتًا إلى استدلال أعمق؟
أزل `disabled` ودع claude-haiku-5-5 يعود إلى التفكير التكيفي الافتراضي. وإذا أردت رفع `effort` في الوقت نفسه، فاحرص على عدم البقاء في التركيبة «`xhigh` أو `max` مع `disabled`».
س6: كيف أتحقق سريعًا من أن الإصلاح أصبح فعّالاً؟
بعد التسجيل في APIYI على apiyi.com والحصول على رصيد اختبار مجاني، استخدم نقطة النهاية `https://api.apiyi.com/v1`، وشغّل طلبًا واحدًا باستخدام المعاملات بعد الإصلاح: إذا لم يعد الطلب يُرجع خطأً وعاد النص الأساسي بشكل طبيعي، فهذا يعني أن `disabled` أصبح فعّالاً. تعتمد المنصة الفوترة حسب الاستخدام، لذا فإن تكلفة التحقق بميزانية صغيرة منخفضة.
س7: هل يأتي الخطأ دائمًا من effort؟
ليس بالضرورة، لكن هذه إحدى الحالات الموثقة صراحةً. تحقق أولًا من أن `model` مكتوب بدقة على النحو `claude-haiku-5-5`، ثم افحص ما إذا كانت تركيبة `thinking` و`effort` تتجاوز الحدود. وبعد استبعاد ذلك، ابحث في أسباب أخرى. وإذا واجهت خطأً عند الاستدعاء عبر APIYI، فابدأ أيضًا بفحص هذين المعاملين.
س8: ما الإصدار المرجعي لقواعد هذه المعاملات؟
يعتمد هذا المقال على وثائق Anthropic الرسمية بتاريخ 2026-11-08 (UTC+8)، وكان تاريخ التحقق 2026-11-13. وإذا عدّلت Anthropic لاحقًا قواعد `effort` و`disabled`، فيُرجى الاعتماد على أحدث الوثائق.
الخلاصة
إيقاف التفكير في claude-haiku-5-5 يتوقف على أربع نقاط أساسية:
- التفكير مفعّل افتراضيًا: عدم تمرير
thinkingيعني تفكيرًا تكيفيًا مفعّلًا تلقائيًا، وإن أردت توفير الحصة فعليك إيقافه بشكل صريح. - الإيقاف له شرط: عند ضبط
thinkingعلىdisabled، يجب أن تكون قيمةeffortلا تتجاوزhigh؛ أما استخدامxhighأوmaxفسيؤدي إلى خطأ. - الافتراضي آمن: قيمة
effortالافتراضية هيmedium، وهي نفس القيمة في claude-opus-5-5، فإن لم ترفعها بنفسك فلن يحدث أي تعارض. - حدود الحصة: الحد الأقصى للإخراج هو 128000، ورموز التفكير تُحتسب ضمن
max_tokens، وبعد الإيقاف تذهب الحصة كاملة إلى النص الأساسي.
في المرة القادمة التي تصادف فيها رسالة «أريد إيقاف التفكير لكني أحصل على خطأ»، تحقّق أولًا مما إذا كان effort قد تجاوز حد high، ثم رتّب تركيبة المعاملات، وستُحل المشكلة في أغلب الحالات. أنصح بالتحقق السريع من النتائج عبر APIYI على apiyi.com باستخدام حصة الاختبار المجانية؛ فمفتاح API واحد يكفي لاستدعاء claude-haiku-5-5 وعدد من النماذج السائدة، كما أن الواجهة المتوافقة مع OpenAI تجعل تبديل الطُرز أسهل بكثير.
📚 المراجع
- وثائق APIYI: شرح معاملَي effort و thinking في Claude
- الرابط:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
الوصف: قيم effort، والشروط التي يُقبل فيها disabled، وصيغة رسائل الأخطاء
-
وثائق APIYI: تحديث دليل التفكير في Claude (2026-11)
- الرابط:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
الوصف: سجل التحديثات والخلفية الخاصة بالدليل المتعلق بالتفكير
-
وثائق Anthropic الرسمية
- الرابط:
docs.anthropic.com - الوصف: تعتمد معاملات هذا المقال على الصيغة الرسمية لإصدار 2026-11-08 (UTC+8)
المؤلف: فريق APIYI التقني
للتواصل التقني: نرحّب بتواصلكم معنا عبر الصفحة الرئيسية لموقع APIYI، ولمزيد من المواد يمكنكم زيارة مركز الوثائق
