الترحيل من كلود أوبوس 4.8 إلى أوبوس 5: كل تغييرات كسر التوافق

يعد استبدال claude-opus-4-8 بـ claude-opus-5 تغييرًا في سطر واحد على ما يبدو. وهو كذلك إلى حد كبير. لكن بعض الإعدادات الافتراضية قد تغيرت تحتك، وبعض مجموعات الطلبات الصالحة سابقًا تعيد الآن رمز 400 ثابتًا، واختفت ميزة تدفع الفرق المؤسسية مقابلها في النموذج الجديد.

أصدرت Anthropic نموذج Claude Opus 5 في 24 يوليو 2026 بنفس سعر Opus 4.8 (5 دولارات لكل مليون رمز إدخال، و 25 دولارًا لكل مليون رمز إخراج)، لذا نادرًا ما يكون هذا قرارًا متعلقًا بالميزانية. إنه قرار يتعلق بالدقة. فيما يلي كل الاختلافات التي يمكن أن تعطل عملية دمج عاملة، مرتبة حسب احتمالية أن تواجهك في اليوم الأول، مع مقتطفات قبل وبعد يمكنك لصقها في عميلك. يعد دليل ترحيل Opus 4.8 إلى Opus 5 الخاص بـ Anthropic هو المصدر الأساسي لواجهة برمجة التطبيقات. لاختبار كل تغيير مقابل نقطة النهاية الحية أولاً، احفظ طلبًا واحدًا في Apidog واستنسخه لكل متغير.

النسخة المختصرة

1. التفكير قيد التشغيل افتراضيًا، و max_tokens لا يزال يحدد سقف كل شيء

هذا هو التغيير الذي يعطل التعليمات البرمجية الهادئة والفعالة.

في Opus 4.8، كان الطلب بدون حقل thinking يعمل بدون تفكير. في Opus 5، يقوم نفس الطلب بتشغيل التفكير التكيفي. لم تتغير صيغة JSON لديك، لكن النموذج الآن ينفق الرموز في التفكير قبل كتابة الإجابة المرئية. ولا يزال max_tokens يمثل حدًا صارمًا لرموز التفكير بالإضافة إلى رموز الاستجابة معًا، لذا فإن طلبًا كان يتناسب بشكل مريح مع ميزانية 1,024 رمزًا في 4.8 يمكن أن يستهلك الآن معظم تلك الميزانية في التفكير ويعيد إجابة مقتطعة.

إليك شكل طلب كان آمنًا في السابق:

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "لخص تقرير الحادث هذا في ثلاث نقاط."}
  ]
}

غيّر معرف النموذج فقط ولا شيء آخر، وسيكون لديك خطر الاقتطاع. الحل هو توفير مساحة للميزانية:

{
  "model": "claude-opus-5",
  "max_tokens": 8192,
  "messages": [
    {"role": "user", "content": "لخص تقرير الحادث هذا في ثلاث نقاط."}
  ]
}

هناك شيئان يجب التحقق منهما بعد رفع السقف. راقب stop_reason في الاستجابة: max_tokens يعني أنه تم قطعك، end_turn يعني أن النموذج انتهى. ثم اقرأ كتلة usage لترى كم استهلك التفكير بالفعل من الميزانية في مطالباتك الحقيقية، وحدد العدد من القياس بدلاً من التخمين.

إذا كنت تريد حقًا سلوك عدم التفكير القديم، فأرسل thinking: {"type": "disabled"} بشكل صريح. اقرأ القسم التالي أولاً، لأن هذا الحقل يتفاعل الآن مع الجهد بطريقة تعيد خطأً.

2. رمز 400: التفكير المعطل بالإضافة إلى جهد xhigh أو max

هذا هو الفخ الأكثر احتمالية للظهور في سجلات الأخطاء لديك، لأن كلا الجزأين كانا صالحين بشكل منفصل في Opus 4.8.

في Opus 5، يؤدي الجمع بين thinking: {"type": "disabled"} و output_config.effort المعين على xhigh أو max إلى إرجاع رمز HTTP 400. تطبق Anthropic هذا لكل طلب، لذا يفشل فورًا وباستمرار بدلاً من التدهور. المنطق واضح: المستويان الأعلى من الجهد موجودان لشراء المزيد من التفكير، لذا فإن طلب أقصى جهد مع إيقاف التفكير هو تناقض.

الطلب الذي يفشل الآن:

{
  "model": "claude-opus-5",
  "max_tokens": 8192,
  "thinking": {"type": "disabled"},
  "output_config": {"effort": "xhigh"},
  "messages": [
    {"role": "user", "content": "أعد هيكلة هذه الوحدة واشرح المقايضات."}
  ]
}

الإصلاح أ، حافظ على القدرة. أسقط حقل thinking، واحتفظ بالجهد العالي. هذا هو الاتجاه الذي أوصت به Anthropic، وهو الذي يجب اختياره للبرمجة والعمل الوكيل:

{
  "model": "claude-opus-5",
  "max_tokens": 32000,
  "output_config": {"effort": "xhigh"},
  "messages": [
    {"role": "user", "content": "أعد هيكلة هذه الوحدة واشرح المقايضات."}
  ]
}

الإصلاح ب، أبقِ التفكير معطلاً. لمسار حساس للكمون لا يحتاج إلى تفكير حقًا، احتفظ بـ disabled واخفض الجهد إلى high أو أقل:

{
  "model": "claude-opus-5",
  "max_tokens": 4096,
  "thinking": {"type": "disabled"},
  "output_config": {"effort": "high"},
  "messages": [
    {"role": "user", "content": "صنف هذه التذكرة إلى إحدى الفئات الخمس."}
  ]
}

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

3. تمت إعادة معايرة مستويات الجهد، لذا أعد المسح بدلاً من نسخ الإعدادات

يضبط Opus 5 الجهد الافتراضي على high، وتمت إعادة معايرة المستويات نفسها. أصبح low و medium أقوى بشكل ملحوظ في Opus 5 مقارنة بنماذج Opus السابقة، لذا فإن الإعداد الذي قمت بضبطه في 4.8 لم يعد يحقق نفس نقطة التكلفة والجودة. تنصح Anthropic صراحة بإجراء مسح جديد للجهد بدلاً من نقل تكوين 4.8 الخاص بك، وهذه النصيحة تسري في الاتجاهين:

• قد تصمد أعباء العمل المثبتة على high أو xhigh في 4.8 من أجل الجودة عند medium في Opus 5، مما يمثل تخفيضًا حقيقيًا في الفاتورة بنفس تسعير الرمز.
• قد تكون أعباء العمل المثبتة على low من أجل التكلفة تستحق رفع مستوى، لأن الجودة لكل رمز تحسنت.

للبرمجة والعمل الوكيل طويل المدى، يظل xhigh هو نقطة البداية الموصى بها. قم بإقرانه بـ max_tokens سخي (64 ألف هي ميزانية بداية معقولة في المستويات العليا) بحيث يكون للتفكير مكان يذهب إليه.

أجرِ المسح على مجموعة التقييم الخاصة بك، وليس على معيار أداء. ثبّت المطالبة، وغير قيمة الجهد فقط، وسجّل جودة الإخراج، ووقت الاستجابة، و usage لكل مستوى. يغطي التعمق في معلمة الجهد ميكانيكا كل مستوى؛ ولجانب التكلفة من نفس القرار، راجع توزيع تسعير Opus 5.

4. إزالة رأس الإصدار التجريبي السياقي الطويل

يشحن Opus 5 بنافذة سياق بحجم مليون رمز كإعداد افتراضي وكسقف أقصى. لا يوجد رأس تجريبي لتمكينه ولا توجد علاوة تسعير سياقية طويلة مرفقة.

إذا كان عميلك لا يزال يرسل قيمة الإصدار التجريبي السياقي الموسع في رأس anthropic-beta من إعداد Opus 4.8 الخاص بك، فهو الآن وزن ميت. قم بإزالته. قيم الإصدار التجريبي القديمة في عميل HTTP مشترك هي كيف ينتهي بك الأمر بتصحيح طلب غير ذي صلة بعد ستة أشهر.

الحد الأقصى للإخراج على Messages API هو 128 ألف رمز. إذا كنت بحاجة إلى المزيد، فإن Batch API يصل إلى 300 ألف رمز إخراج مع رأس الإصدار التجريبي output-300k-2026-03-24، وهو اختيار منفصل عن أي شيء كنت تفعله لطول السياق.

5. ينخفض الحد الأدنى لذاكرة التخزين المؤقت للمطالبة إلى 512 رمزًا

في Opus 4.8، كان يجب أن يصل جزء المطالبة إلى 1024 رمزًا ليكون مؤهلاً للتخزين المؤقت. في Opus 5، الحد الأدنى هو 512. لا شيء في التعليمات البرمجية الخاصة بك يحتاج إلى التغيير، وقراءات ذاكرة التخزين المؤقت بسعر 0.50 دولار لكل مليون هي أرخص الرموز في قائمة الأسعار مقابل 5 دولارات لمدخلات الأساس.

ما يستحق القيام به هو مراجعة. ابحث عن مطالبات النظام، وتعريفات الأدوات، وكتل "few-shot" التي تتراوح بين 512 و 1024 رمزًا ولم تكن تستحق نقطة توقف cache_control من قبل. إنها تستحق واحدة الآن. تأكد من التأثير بقراءة cache_read_input_tokens في كتلة usage الخاصة بالاستجابة: في الاستدعاء المتطابق الثاني يجب ألا تكون صفرًا. يغطي دليلنا لخفض فاتورة Claude API استراتيجية التخزين المؤقت الأوسع.

6. رسائل النظام في منتصف المحادثة مقبولة الآن

رفض Opus 4.8 إدخال {"role": "system"} داخل مصفوفة messages برمز 400. يقبله Opus 5. هذا إضافي، لذا لا يعطل شيئًا، لكنه يمكن أن يلغي حلًا بديلًا. إذا كنت قد أنشأت آلية تطوي تغييرات التعليمات في منتصف المحادثة في دور مستخدم اصطناعي، فيمكنك الآن وضع التعليمات في مكانها الصحيح:

{
  "model": "claude-opus-5",
  "max_tokens": 8192,
  "messages": [
    {"role": "user", "content": "صغ ملاحظة الإصدار."},
    {"role": "assistant", "content": "إليك مسودة أولية..."},
    {"role": "system", "content": "من الآن فصاعدًا، حافظ على الردود أقل من 150 كلمة."},
    {"role": "user", "content": "اجعلها أكثر إيجازًا."}
  ]
}

هذه قدرة لكل نموذج. إذا قمت بتوجيه نفس سجل المحادثة إلى Opus 4.8 كخيار احتياطي، فسيظل النموذج الأقدم يرجع رمز 400 على تلك الرسالة.

7. طبقة الأولوية غير مدعومة على Opus 5

هذا الأمر مؤلم للفرق المؤسسية، ومن السهل تفويته لأنه غياب بدلاً من خطأ يمكنك البحث عنه. يدعم Opus 4.8 طبقة الأولوية. لا يدعمها Opus 5. إذا قمت بشراء إنتاجية ملتزم بها لضمان وقت استجابة منخفض في مسار إنتاجي، فإن ترحيل هذا المسار يعيده إلى السعة القياسية.

لا يوجد حل ذكي. إما أن تبقي حركة المرور الحرجة من حيث وقت الاستجابة على claude-opus-4-8 بينما ينتقل كل شيء آخر إلى Opus 5، أو تقبل السعة القياسية وتقيس ما إذا كان وقت الاستجابة لديك يتدهور بالفعل. قسّم عملية الترحيل حسب عبء العمل بدلاً من قلب الأسطول بأكمله دفعة واحدة.

8. الوضع السريع يعمل الآن، وهناك خيار احتياطي جديد للرفض السيبراني

يعمل الوضع السريع على Opus 5. أرجع خطأً على Opus 4.7 وعمل بصمت بالسرعة القياسية على Opus 4.6. في Opus 5، يوفر سرعة إخراج تبلغ حوالي 2.5 ضعف بسعر 10 دولارات لكل مليون إدخال و 50 دولارًا لكل مليون إخراج. إنه معاينة بحثية، واجهة برمجة تطبيقات طرف أول فقط (ليس Amazon Bedrock، Google Cloud، أو Microsoft Foundry)، ولا يجمع مع Batch API. استخدمه في المسارات التفاعلية، وليس المهام الخلفية.

الخيار الاحتياطي من جانب الخادم للرفض السيبراني. يؤدي إرسال fallbacks: "default" مع رأس الإصدار التجريبي server-side-fallback-2026-07-01 إلى جعل الطلب الذي يرفضه Opus 5 لأسباب تتعلق بالفئة السيبرانية يرجع تلقائيًا إلى Opus 4.8. في أدوات الأمان حيث تظهر فائدة هذه الميزة.

يوجد أيضًا رأس تجريبي mid-conversation-tool-changes-2026-07-01 يتيح لك إضافة أو إزالة تعريفات الأدوات بين الأدوار دون إبطال ذاكرة التخزين المؤقت للمطالبة: رافعة تكلفة لجلسات الوكيل الطويلة مع مجموعة أدوات متغيرة.

9. ما لم يتغير

يوفّر الوقت معرفة ما يمكنك تركه كما هو:

• معلمات أخذ العينات لا تزال ترجع رمز 400. يتم رفض temperature، top_p، و top_k بالقيم غير الافتراضية، تمامًا كما في Opus 4.8. وجه السلوك من خلال مطالبة النظام.
• أعداد الرموز هي نفسها تقريبًا. يستخدم Opus 5 نفس عائلة الرموز المميزة مثل 4.8، لذا فإن ميزانيات الرموز الحالية ونماذج التكلفة تنتقل دون إعادة عد. هذا هو عكس الانتقال من Sonnet 4.6 إلى Sonnet 5، الذي غير الأعداد بنسبة 30٪ تقريبًا.
• التسعير الأساسي متطابق. 5 دولارات للإدخال، 25 دولارًا للإخراج، مطابق لـ Opus 4.8، 4.7، 4.6، و 4.5. انظر صفحة تسعير Opus 4.8.
• شكل الطلب والاستجابة. البث، واستخدام الأدوات، والرؤية، والمخرجات المنظمة، والدفعات تعمل جميعها بنفس الطريقة التي كانت تعمل بها.

شيء واحد تغير حتى عندما لم تتغير واجهة برمجة التطبيقات: يتحقق Opus 5 من عمله الخاص دون مطالبة، لذا فإن تعليمات "راجع إجابتك مرة أخرى" المنقولة تسبب تحققًا مفرطًا وإهدارًا للرموز. كما أن الاستجابات الافتراضية تعمل لفترة أطول من استجابات 4.8، ويؤدي تقليل الجهد إلى تقليل التفكير بدلاً من الطول المرئي، لذا اطلب الإيجاز صراحةً. هذه إصلاحات على مستوى المطالبة، مغطاة في مطالبات Claude Opus 5.

تحقق من الترحيل قبل نشره

كل عنصر أعلاه هو فرق على مستوى HTTP، مما يجعله قابلاً للاختبار خارج تطبيقك. حلقة عمل قابلة للتطبيق في Apidog:

1. احفظ طلبًا واحدًا إلى نقطة نهاية الرسائل مع تخزين مفتاحك كمتغير بيئة، وليس مضمنًا أبدًا في النص.
2. استنسخه إلى متغيرات: خط أساس claude-opus-4-8، و claude-opus-5 بالإعدادات الافتراضية، ونسخة واحدة لكل مستوى جهد.
3. قم بتشغيل تركيبة التفكير المعطل بالإضافة إلى xhigh عمدًا وسجل نص 400، حتى تتعرف عليه في سجلات الإنتاج.
4. تأكد من stop_reason بحيث تفشل استجابة max_tokens المقتطعة في اختبارك بدلاً من نشرها بصمت.
5. أرسل طلبًا مخزنًا مؤقتًا متطابقًا مرتين وتحقق من usage.cache_read_input_tokens في المكالمة الثانية.
6. قم بتشغيل طلب بث واحد وتأكد من أن محلل SSE الخاص بك يتعامل مع كتل التفكير التي تصل الآن افتراضيًا.

قم بتنزيل Apidog للاحتفاظ بذلك كمجموعة قابلة لإعادة الاستخدام لكل تبديل نموذج مستقبلي.

تحذير صريح قبل ترحيل كل شيء

Opus 5 ليس قمة مكدس Claude. يظل Fable 5 هو النموذج الأكثر قدرة من Anthropic الذي تم إصداره على نطاق واسع، ولا يزال Opus 5 يتخلف عن Mythos 5 في استغلال الأمن السيبراني وأبحاث البيولوجيا المستقلة. تقول Anthropic ذلك بنفسها في منشور الإطلاق. مطالبات معايير الإطلاق (Frontier-Bench، ARC-AGI 3، OSWorld 2.0، CursorBench 3.2) هي من تشغيل البائع ولم يتم إعادة إنتاجها بشكل مستقل اعتبارًا من 25 يوليو 2026. تعامل معها على أنها أرقام Anthropic المبلغ عنها وقم بإجراء تقييماتك الخاصة قبل الالتزام بعبء عمل إنتاجي. الملخص الدقيق: قدرة من الفئة الرائدة بنصف سعر الفئة الرائدة، مع سقف محدد فوقها.

قائمة التحقق للترحيل

اعمل على هذا بالترتيب:

1. غيّر سلسلة النموذج إلى claude-opus-5 بالضبط. بدون لاحقة تاريخ.
2. ارفع max_tokens على كل طلب كان يغفل thinking سابقًا. يعمل التفكير الآن افتراضيًا ويشارك تلك الميزانية.
3. ابحث في قاعدة التعليمات البرمجية الخاصة بك عن "disabled" وتأكد من عدم وجود طلب يقرنه بالجهد xhigh أو max. هذا الدمج يعيد رمز 400 ثابت.
4. أزل قيمة الإصدار التجريبي السياقي الطويل من anthropic-beta. نافذة الـ 1 مليون هي الافتراضية الآن.
5. أعد تشغيل مسح الجهد الخاص بك من الصفر على تقييماتك الخاصة. لا تنقل إعدادات 4.8.
6. أضف نقاط توقف cache_control إلى أجزاء المطالبة بين 512 و 1024 رمزًا.
7. حدد أي حركة مرور على طبقة الأولوية وقرر لكل عبء عمل ما إذا كانت ستبقى على claude-opus-4-8.
8. احذف تعليمات التحقق المنقولة من مطالباتك، وأضف تعليمات الإيجاز الصريحة حيث يهم طول الإخراج.
9. اختياريًا، قم بتمكين fallbacks: "default" إذا كان عبء عملك يؤدي إلى رفض الفئة السيبرانية.
10. تأكد من stop_reason في مجموعة اختباراتك بحيث يظهر الاقتطاع كفشل، وليس إجابة أسوأ بشكل طفيف.

للحصول على شرح كامل للطلب، انظر دليل Claude Opus 5 API، أو ابدأ بـ ما هو Claude Opus 5 للمواصفات والتوافر. إذا كنت لا تزال تشغل النموذج الأقدم في بعض الأماكن، فإن شرح Opus 4.8 و شرح واجهة برمجة التطبيقات الخاص به يظلان دقيقين له. يعتبر نظرة عامة على نماذج Anthropic هو المصدر الرسمي لمعرفات، ونوافذ السياق، والحدود.

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

هل الترحيل من Opus 4.8 إلى Opus 5 هو ترحيل مباشر؟ قريب، ولكن ليس تمامًا. يعمل تغيير سلسلة النموذج لمعظم الطلبات. هناك شيئان يمكن أن يتعطلا: يعمل التفكير الآن افتراضيًا ويشارك ميزانية max_tokens الخاصة بك، ويعيد thinking: {"type": "disabled"} مع الجهد xhigh أو max رمز 400. تتطلب حركة مرور طبقة الأولوية أيضًا قرارًا، حيث لا يدعم Opus 5 هذه الميزة.

لماذا أحصل على رمز 400 بعد التبديل إلى claude-opus-5؟ السبب الأكثر شيوعًا هو تعطيل التفكير أثناء طلب جهد xhigh أو max. إما أن تزيل حقل thinking وتحتفظ بالجهد العالي، أو تبقي التفكير معطلاً وتخفض الجهد إلى high أو أقل. لا تزال قيم temperature، top_p، أو top_k غير الافتراضية تعيد رمز 400، تمامًا كما في Opus 4.8.

هل أحتاج إلى إعادة عد الرموز الخاصة بي بعد الترحيل؟ لا. يستخدم Opus 5 نفس عائلة الرموز المميزة مثل Opus 4.8، لذا فإن الأعداد لم تتغير تقريبًا وتنتقل الميزانيات الحالية. الحمل الزائد لمطالبة نظام استخدام الأدوات أقل قليلاً عند 286 رمزًا مقابل 290. التسعير الأساسي متطابق أيضًا، عند 5 دولارات للإدخال و 25 دولارًا للإخراج، على الرغم من أن فاتورتك لا تزال تتغير إذا زادت رموز الإخراج بسبب التفكير الافتراضي.