DEV Community

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

Posted on • Originally published at apidog.com

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

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

جرّب Apidog اليوم

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

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

التغيير التأثير الإجراء
التفكير يعمل افتراضيًا احتمال اقتطاع صامت للمخرجات ارفع max_tokens
thinking: disabled مع جهد xhigh أو max HTTP 400 استخدم أحدهما فقط
إعادة معايرة مستويات الجهد نقطة تكلفة/جودة مختلفة أعد اختبار المستويات
سياق مليون رمز افتراضيًا رأس تجريبي زائد أزله
الحد الأدنى للتخزين المؤقت أصبح 512 رمزًا فرص توفير إضافية خزّن مقاطع مطالبات أقصر
رسائل النظام في منتصف المحادثة كانت تعيد 400 وأصبحت مقبولة بسّط الحلول البديلة
طبقة الأولوية غير مدعومة في Opus 5 أبقِ هذه الحركة على 4.8 عند الحاجة
الوضع السريع متاح في Opus 5 استخدمه للمسارات التفاعلية
fallbacks: "default" احتياطي جديد للرفض السيبراني رأس تجريبي اختياري
أخذ العينات وعدد الرموز لم تتغير عمليًا لا إجراء مطلوب

1. التفكير يعمل افتراضيًا وmax_tokens يقيّد كل شيء

هذا هو التغيير الأكثر احتمالًا لإحداث مشكلة في تكامل يعمل حاليًا بصمت.

في Opus 4.8، كان الطلب الذي لا يرسل حقل thinking يعمل دون تفكير. في Opus 5، يشغّل الطلب نفسه التفكير التكيفي تلقائيًا. لا تتغير بنية JSON، لكن النموذج يستهلك جزءًا من الميزانية في التفكير قبل إنشاء الإجابة المرئية.

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

طلب كان آمنًا في Opus 4.8 

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

لا تغيّر معرف النموذج فقط. ارفع الميزانية أولًا:

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

بعد رفع السقف، تحقّق من نقطتين في كل استجابة:

  1. راقب stop_reason:
    • max_tokens: تم اقتطاع الاستجابة.
    • end_turn: انتهى النموذج طبيعيًا.
  2. راجع كتلة usage لتعرف كم رمزًا استهلك التفكير في مطالباتك الحقيقية.

إذا كنت تحتاج فعلًا إلى السلوك القديم دون تفكير، أرسل التالي صراحة:

{
  "thinking": {
    "type": "disabled"
  }
}
Enter fullscreen mode Exit fullscreen mode

لكن راجع القسم التالي قبل ذلك، لأن تعطيل التفكير يتعارض مع مستويات جهد معينة.

2. خطأ 400: تعطيل التفكير مع جهد xhigh أو max

في Opus 5، يؤدي الجمع بين:

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

أو استخدام max بدلًا من xhigh إلى إرجاع HTTP 400.

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

طلب يفشل الآن 

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

الإصلاح أ: احتفظ بالقدرة

احذف thinking واترك مستوى الجهد العالي. هذا هو المسار المناسب للبرمجة والعمل الوكيلي:

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

الإصلاح ب: أبقِ التفكير معطّلًا

إذا كان المسار حساسًا للكمون ولا يحتاج إلى تفكير، استخدم high أو مستوى أقل:

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

تذكر Anthropic مشكلتين قد تظهران عند تعطيل التفكير:

  • قد تُكتب استدعاءات الأدوات كنص عادي بدل تنفيذها.
  • قد تظهر علامات XML داخلية مثل <thinking> في المخرجات المرئية.

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

3. أعد اختبار مستويات الجهد بدل نسخ إعدادات 4.8

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

عمليًا:

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

للبرمجة والعمل الوكيلي طويل المدى، يبقى xhigh نقطة بداية مناسبة. امنحه أيضًا ميزانية max_tokens كبيرة؛ 64 ألف رمز ميزانية بداية معقولة للمستويات العليا.

اختبر على مجموعة التقييم الخاصة بك، لا على معيار عام:

  1. ثبّت المطالبة.
  2. غيّر قيمة effort فقط.
  3. سجّل جودة المخرجات ووقت الاستجابة وكتلة usage.
  4. اختر المستوى بناءً على بيانات حملك الحقيقي.

راجع التعمق في معلمة الجهد لفهم المستويات، وتوزيع تسعير Opus 5 لتقييم أثرها في التكلفة.

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

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

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

الحد الأقصى للإخراج في Messages API هو 128 ألف رمز. إذا احتجت إلى أكثر، يصل Batch API إلى 300 ألف رمز إخراج باستخدام رأس الإصدار التجريبي:

output-300k-2026-03-24
Enter fullscreen mode Exit fullscreen mode

هذا إعداد منفصل عن طول السياق.

5. الحد الأدنى للتخزين المؤقت أصبح 512 رمزًا

في Opus 4.8، كان جزء المطالبة يحتاج إلى 1,024 رمزًا على الأقل ليكون مؤهلًا للتخزين المؤقت. في Opus 5، انخفض الحد إلى 512 رمزًا.

لا تحتاج إلى تعديل الكود الحالي، لكن راجع مطالباتك للعثور على:

  • مطالبات النظام.
  • تعريفات الأدوات.
  • كتل الأمثلة القليلة few-shot.
  • أي مقاطع ثابتة بين 512 و1,024 رمزًا.

هذه المقاطع قد تستحق الآن إضافة نقطة توقف cache_control. قراءات ذاكرة التخزين المؤقت بسعر 0.50 دولار لكل مليون رمز أقل تكلفة من إدخال الأساس البالغ 5 دولارات لكل مليون.

تحقق من نجاح التخزين المؤقت بقراءة:

usage.cache_read_input_tokens
Enter fullscreen mode Exit fullscreen mode

في الاستدعاء الثاني المطابق يجب ألا تكون القيمة صفرًا. راجع دليل خفض فاتورة Claude API لاستراتيجية أوسع للتخزين المؤقت.

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

كان Opus 4.8 يرفض رسالة من الشكل التالي داخل مصفوفة messages:

{
  "role": "system"
}
Enter fullscreen mode Exit fullscreen mode

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

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

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

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

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

لا يوجد بديل مباشر. لديك خياران:

  1. أبقِ الحركة الحساسة للكمون على claude-opus-4-8.
  2. انقلها إلى Opus 5 واقس زمن الاستجابة الفعلي تحت السعة القياسية.

لا ترحّل الأسطول كاملًا دفعة واحدة. قسّم الترحيل حسب عبء العمل ومتطلبات الكمون.

8. الوضع السريع والاحتياطي السيبراني

الوضع السريع يعمل في Opus 5

يعمل الوضع السريع في Opus 5 بسرعة إخراج تقارب 2.5 مرة، بسعر:

  • 10 دولارات لكل مليون رمز إدخال.
  • 50 دولارًا لكل مليون رمز إخراج.

إنه معاينة بحثية، ومتاح عبر واجهة برمجة التطبيقات من الطرف الأول فقط، وليس عبر Amazon Bedrock أو Google Cloud أو Microsoft Foundry. كما أنه لا يجمع مع Batch API.

استخدمه للمسارات التفاعلية، وليس للمهام الخلفية.

احتياطي من جانب الخادم للرفض السيبراني

يمكنك إرسال:

{
  "fallbacks": "default"
}
Enter fullscreen mode Exit fullscreen mode

مع رأس الإصدار التجريبي:

server-side-fallback-2026-07-01
Enter fullscreen mode Exit fullscreen mode

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

يوجد أيضًا رأس تجريبي آخر:

mid-conversation-tool-changes-2026-07-01
Enter fullscreen mode Exit fullscreen mode

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

9. ما لم يتغير

بعض العناصر يمكن أن تبقى كما هي:

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

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

اطلب الإيجاز صراحةً في المطالبة. راجع مطالبات Claude Opus 5 للحصول على أنماط مناسبة.

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

كل فرق سابق قابل للاختبار على مستوى HTTP خارج تطبيقك. استخدم هذه الحلقة في Apidog:

  1. احفظ طلبًا واحدًا إلى نقطة نهاية Messages، واستخدم متغير بيئة للمفتاح بدل وضعه داخل الطلب.
  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 الذي أُصدر على نطاق واسع، كما يبقى Mythos 5 متقدمًا على Opus 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.
  4. أزل قيمة الإصدار التجريبي للسياق الطويل من رأس anthropic-beta.
  5. أعد اختبار مستويات الجهد على تقييماتك الخاصة بدل نقل إعدادات 4.8.
  6. أضف نقاط توقف cache_control لمقاطع المطالبة بين 512 و1,024 رمزًا.
  7. حدّد الحركة التي تعتمد على طبقة الأولوية وقرر إن كانت ستبقى على claude-opus-4-8.
  8. احذف تعليمات التحقق الموروثة من المطالبات، وأضف تعليمات إيجاز صريحة عند الحاجة.
  9. فعّل fallbacks: "default" اختياريًا إذا كان عبء العمل قد يواجه رفضًا من الفئة السيبرانية.
  10. اجعل stop_reason: "max_tokens" فشلًا صريحًا في مجموعة الاختبارات.

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

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

هل الترحيل من Opus 4.8 إلى Opus 5 مباشر؟

قريب من المباشر، لكنه ليس تغييرًا آمنًا لمعرف النموذج فقط. يعمل التفكير افتراضيًا ويشارك ميزانية max_tokens، كما أن الجمع بين:

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

أو max يعيد HTTP 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 دولارًا للإخراج، لكن الفاتورة قد ترتفع إذا زادت رموز الإخراج بسبب التفكير الافتراضي.

Top comments (0)