DEV Community

Cover image for الفرق بين كلود سونيت 5 وسونيت 4.6: التغييرات الرئيسية وهل يجب الترقية؟
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

الفرق بين كلود سونيت 5 وسونيت 4.6: التغييرات الرئيسية وهل يجب الترقية؟

أصدرت Anthropic نموذج Claude Sonnet 5 في 30 يونيو 2026 كبديل مباشر لـ Sonnet 4.6. الترقية قد تبدو كتغيير بسيط في معرف النموذج، لكن هناك تفاصيل يجب اختبارها قبل الإنتاج: مُحلل رموز جديد، تفكير تكيفي مفعّل افتراضيًا، ومعلمات طلب كانت تعمل سابقًا وتُرجع الآن أخطاء 400.

جرّب Apidog اليوم

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

Claude Sonnet 5

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

يحتفظ Sonnet 5 بنفس تسعيرة الرمز مثل Sonnet 4.6، لذلك لا يتغير السعر النظري لكل مليون رمز. لكن عدد الرموز الناتج عن نفس النص قد يتغير بسبب المُحلل الجديد، وهذا يؤثر على التكلفة الفعلية لكل طلب.

الخاصية Sonnet 4.6 (claude-sonnet-4-6) Sonnet 5 (claude-sonnet-5)
تاريخ الإصدار النموذج السابق 30 يونيو 2026
نافذة السياق تصل إلى مليون رمز مليون رمز، افتراضيًا وكحد أقصى
الحد الأقصى للإخراج 128 ألف رمز 128 ألف رمز
التفكير الافتراضي معطل عند غياب حقل thinking التفكير التكيفي مفعل افتراضيًا
التفكير الموسع budget_tokens مهمل يُرجع خطأ 400
معلمات العينات temperature, top_p, top_k مقبولة القيم غير الافتراضية تُرجع خطأ 400
مُحلل الرموز مُحلل أقدم مُحلل جديد، حوالي 30% رموز أكثر لنفس النص
السعر القياسي 3 دولارات / 15 دولارًا لكل مليون إدخال/إخراج 3 دولارات / 15 دولارًا لكل مليون إدخال/إخراج
سعر الافتتاح غير متاح 2 دولار / 10 دولارات لكل مليون حتى 31 أغسطس 2026

ما يزال Sonnet 5 يدعم المخرجات المنظمة، والرؤية، والتخزين المؤقت للموجهات، واستخدام الأدوات، والدفعات. الميزة غير المتاحة في Sonnet 5 هي Priority Tier.

ما الذي تحسن في Sonnet 5؟

تضع Anthropic نموذج Sonnet 5 كنموذج Sonnet أكثر قدرة في المهام الوكيلية واستخدام الأدوات. هذه أرقام إطلاق Anthropic وليست اختبارات مستقلة، لذلك استخدمها كمؤشر أولي ثم اختبر على موجهاتك الفعلية.

المعيار Sonnet 4.6 Sonnet 5
SWE-bench Pro، البرمجة الوكيلية 58.1% 63.2%
OSWorld-Verified، استخدام الحاسوب 78.5% 81.2%

هذه التحسينات مهمة إذا كان تطبيقك يعتمد على:

  • وكلاء يكتبون أو يصلحون الكود.
  • أدوات تنفيذ أوامر أو تفاعل مع الطرفية.
  • سير عمل يستدعي APIs أو أدوات خارجية.
  • مهام متعددة الخطوات تحتاج تخطيطًا واستخدام أدوات.

للمقارنة مع النموذج الأعلى، راجع Sonnet 5 vs Opus 4.8.

مقارنة Sonnet 5

وفقًا لمقاييس Anthropic، Sonnet 5 أكثر أمانًا من 4.6: سلوك غير مرغوب فيه أقل، هلوسة وتملق أقل، ومقاومة أفضل لحقن الأوامر. نقطة تنفيذ مهمة: عند رفض طلب محظور، قد تعود الاستجابة كـ HTTP 200 مع:

{
  "stop_reason": "refusal"
}
Enter fullscreen mode Exit fullscreen mode

لذلك لا تعتمد على كود HTTP فقط. افحص stop_reason داخل الاستجابة.

التغييرات الثلاثة التي تحتاج تعديلًا في الكود

معظم عمليات الترحيل إلى Sonnet 5 تدور حول ثلاث نقاط فقط:

  1. التفكير التكيفي أصبح مفعّلًا افتراضيًا.
  2. budget_tokens لم يعد مقبولًا.
  3. معلمات العينات غير الافتراضية تُرجع خطأ 400.

1. التفكير التكيفي مفعل افتراضيًا

في Sonnet 4.6، إذا لم ترسل حقل thinking فهذا يعني أن التفكير غير مفعّل. في Sonnet 5، غياب الحقل يعني استخدام التفكير التكيفي افتراضيًا.

هذا يؤثر مباشرة على max_tokens، لأن الميزانية تشمل الآن رموز التفكير بالإضافة إلى نص الاستجابة. إذا كانت قيمة max_tokens لديك محسوبة فقط لحجم النص النهائي، قد تحصل على استجابة مقطوعة.

إذا كنت تريد سلوكًا قريبًا من Sonnet 4.6، عطّل التفكير صراحة:

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    thinking={"type": "disabled"},
    messages=[
        {
            "role": "user",
            "content": "Return the OpenAPI 3.1 path object for GET /invoices/{id}."
        }
    ],
)

print(response.content[0].text)
Enter fullscreen mode Exit fullscreen mode

إذا أردت استخدام التفكير التكيفي، حدد مستوى الجهد بدلًا من ميزانية رموز يدوية:

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=8192,
    thinking={"type": "adaptive"},
    effort="medium",
    messages=[
        {
            "role": "user",
            "content": "Draft integration tests for the POST /orders endpoint."
        }
    ],
)
Enter fullscreen mode Exit fullscreen mode

القيم المتاحة للجهد هي:

low
medium
high
xhigh
Enter fullscreen mode Exit fullscreen mode

استخدم low للمهام البسيطة، وhigh أو xhigh للمهام البرمجية أو الوكيلية المعقدة.

2. أزل budget_tokens

النمط القديم التالي لم يعد صالحًا في Sonnet 5:

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 4096
  }
}
Enter fullscreen mode Exit fullscreen mode

في Sonnet 5، هذا يُرجع خطأ 400. استبدله بـ:

{
  "thinking": {
    "type": "adaptive"
  },
  "effort": "high"
}
Enter fullscreen mode Exit fullscreen mode

قاعدة ترحيل بسيطة:

الكود القديم البديل في Sonnet 5
budget_tokens صغير effort="low" أو effort="medium"
budget_tokens متوسط effort="medium"
budget_tokens كبير effort="high" أو effort="xhigh"

3. أزل معلمات العينات غير الافتراضية

في Sonnet 5، تعيين هذه القيم إلى قيم غير افتراضية يُرجع خطأ 400:

{
  "temperature": 0,
  "top_p": 0.9,
  "top_k": 40
}
Enter fullscreen mode Exit fullscreen mode

احذفها من الطلب، ووجّه السلوك عبر موجه النظام بدلًا منها.

بدلًا من:

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=2048,
    temperature=0,
    messages=[
        {"role": "user", "content": "Generate a JSON response only."}
    ],
)
Enter fullscreen mode Exit fullscreen mode

استخدم تعليمات واضحة:

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=2048,
    system=(
        "أجب بصيغة JSON صالحة فقط. "
        "لا تضف شرحًا خارج JSON. "
        "اتبع المخطط المطلوب حرفيًا."
    ),
    messages=[
        {"role": "user", "content": "Generate a JSON response for an invoice summary."}
    ],
)
Enter fullscreen mode Exit fullscreen mode

نقطة إضافية: التعبئة المسبقة لرسالة المساعد ما تزال غير مدعومة وتُرجع خطأ 400. إذا كنت تستخدمها لفرض بداية معينة للاستجابة، استخدم المخرجات المنظمة أو output_config.format أو تعليمات النظام.

ملاحظة مهمة حول المُحلل اللغوي

يستخدم Sonnet 5 مُحلل رموز جديدًا. لن تحتاج إلى تغيير شكل الطلب أو الاستجابة، لكن نفس النص قد ينتج حوالي 30% رموزًا أكثر مقارنة بـ Sonnet 4.6.

هذا يؤثر على أربعة أشياء:

  • usage.input_tokens
  • usage.output_tokens
  • حجم max_tokens
  • تكلفة الطلب الفعلية

مثال تقريبي:

نفس النص Sonnet 4.6 Sonnet 5
إجمالي الرموز 10,000 13,000 تقريبًا
السعر لكل رمز نفسه نفسه
التكلفة الفعلية الأساس أعلى بحوالي 30%

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

يمكنك قياس عدد الرموز عبر نقطة نهاية عد الرموز:

curl https://api.anthropic.com/v1/messages/count_tokens \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "messages": [
      {
        "role": "user",
        "content": "Summarize the changelog for our billing API v3 release."
      }
    ]
  }'
Enter fullscreen mode Exit fullscreen mode

ثم شغّل الطلب نفسه مع:

"model": "claude-sonnet-4-6"
Enter fullscreen mode Exit fullscreen mode

وقارن النتائج. هذا هو تأثير الترقية على ميزانيتك الفعلية.

تكاليف الترقية

بالأسعار القياسية، Sonnet 5 يساوي Sonnet 4.6 لكل رمز:

النوع السعر القياسي
مليون رمز إدخال 3 دولارات
مليون رمز إخراج 15 دولارًا

حتى 31 أغسطس 2026، يوجد سعر تمهيدي:

النوع السعر التمهيدي
مليون رمز إدخال 2 دولار
مليون رمز إخراج 10 دولارات

عمليًا:

  • خلال فترة السعر التمهيدي، قد يعوض السعر الأقل جزءًا من زيادة عدد الرموز.
  • بعد 31 أغسطس، تعود الأسعار القياسية، وقد تكون تكلفة نفس النص أعلى بسبب المُحلل الجديد.
  • لا تستخدم تقديرات Sonnet 4.6 كما هي. أعد القياس على حركة المرور الحقيقية.

لأسعار الدفعات والتخزين المؤقت للموجهات، راجع صفحة تسعير Anthropic.

إذا كنت تقارن مع الجيل السابق، راجع أيضًا تسعير Sonnet 4.6 وتكلفة Claude API.

هل يجب أن ترقي؟

يعتمد القرار على نوع عبء العمل.

قم بالترقية الآن إذا كنت تبني وكلاء أو أدوات برمجة

Sonnet 5 مناسب أكثر إذا كان تطبيقك يعتمد على:

  • توليد الكود.
  • إصلاح الأخطاء.
  • تشغيل أدوات.
  • تنفيذ خطوات متعددة.
  • التعامل مع APIs داخل حلقة وكيلية.

في هذه الحالة، راجع التغييرات الثلاثة، أعد قياس الرموز، ثم اختبر على مجموعة موجهات إنتاجية.

ترقية Sonnet 5

قم بالترقية بحذر إذا كان لديك حجم إنتاجي كبير

إذا كنت تشغل آلاف أو ملايين الطلبات، لا تبدّل معرف النموذج مباشرة. نفّذ خطة اختبار:

  1. اختر عينة من موجهات الإنتاج.
  2. شغّلها على Sonnet 4.6 وSonnet 5.
  3. قارن usage.
  4. قارن جودة الاستجابة.
  5. راقب حالات stop_reason.
  6. عدّل max_tokens.
  7. انشر تدريجيًا.

أصلح الكود أولًا إذا كنت تستخدم temperature أو budget_tokens

إذا كان التكامل الحالي يحتوي على:

temperature
top_p
top_k
budget_tokens
assistant prefill
Enter fullscreen mode Exit fullscreen mode

فلا تبدأ الترحيل قبل إزالتها أو استبدالها. هذه أكثر أسباب أخطاء 400 شيوعًا بعد الانتقال.

لا تهاجر الآن إذا كنت تحتاج Priority Tier

Priority Tier غير متاح في Sonnet 5. إذا كان اتفاق مستوى الخدمة لديك يعتمد عليه، أبقِ تلك المسارات على Sonnet 4.6.

للمقارنة مع السطح السابق، راجع دليل Sonnet 4.6 API.

اختبر الترحيل باستخدام مجموعة طلبات محفوظة في Apidog

أفضل طريقة للترقية هي اختبار Sonnet 5 على موجهاتك، لا على الجداول المعيارية فقط.

Apidog أداة لتطوير واختبار APIs. وبما أن Claude API عبارة عن طلبات HTTP مع رؤوس وجسم JSON واستجابة JSON، يمكنك حفظ طلباتك في Apidog وتشغيلها كمجموعة اختبار قابلة للتكرار.

Apidog

خطة اختبار عملية:

  1. احفظ طلبات Messages API الحالية كمجموعة في Apidog.
  2. استخدم متغير بيئة لـ ANTHROPIC_API_KEY.
  3. أنشئ بيئتين:
    • claude-sonnet-4-6
    • claude-sonnet-5
  4. اجعل قيمة model متغيرًا بيئيًا.
  5. أضف تأكيدات على:
    • وجود content
    • قيمة stop_reason
    • حدود usage.input_tokens
    • حدود usage.output_tokens
  6. شغّل المجموعة على Sonnet 4.6.
  7. شغّلها مرة أخرى على Sonnet 5.
  8. قارن النتائج قبل النشر.

مثال جسم طلب قابل للتحويل بين النموذجين:

{
  "model": "{{CLAUDE_MODEL}}",
  "max_tokens": 2048,
  "thinking": {
    "type": "disabled"
  },
  "messages": [
    {
      "role": "user",
      "content": "Generate OpenAPI documentation for GET /customers/{id}."
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

ثم عرّف المتغير في البيئة الأولى:

CLAUDE_MODEL=claude-sonnet-4-6
Enter fullscreen mode Exit fullscreen mode

وفي البيئة الثانية:

CLAUDE_MODEL=claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

يمكنك أيضًا محاكاة نقطة نهاية Claude في Apidog لاختبار المسارات المحيطة، مثل التعامل مع:

{
  "stop_reason": "refusal"
}
Enter fullscreen mode Exit fullscreen mode

بدون إنفاق رموز أثناء بناء التكامل.

ابدأ من تنزيل Apidog، أو افتح Apidog في المتصفح. وإذا كنت تنتقل من Postman، راجع دليل اختبار API بدون Postman.

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

قبل تغيير النموذج في الإنتاج، نفّذ هذه القائمة:

  • [ ] غيّر النموذج في بيئة اختبار فقط إلى claude-sonnet-5.
  • [ ] أزل temperature وtop_p وtop_k غير الافتراضية.
  • [ ] أزل budget_tokens.
  • [ ] استبدل التفكير اليدوي بـ thinking={"type": "adaptive"} وeffort.
  • [ ] عطّل التفكير صراحة في المسارات التي لا تحتاجه.
  • [ ] أعد حساب max_tokens.
  • [ ] قارن usage بين Sonnet 4.6 وSonnet 5.
  • [ ] اختبر stop_reason: "refusal".
  • [ ] تحقق من التكلفة على عينة إنتاجية.
  • [ ] انشر تدريجيًا وراقب الأخطاء 400.

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

هل Claude Sonnet 5 بديل مباشر لـ Sonnet 4.6؟

غالبًا نعم. يمكنك تغيير معرف النموذج من claude-sonnet-4-6 إلى claude-sonnet-5، لكن راجع التفكير التكيفي، وbudget_tokens، ومعلمات العينات. راجع دليل Sonnet 5 API لإعداد الطلب الكامل.

هل Sonnet 5 أغلى من Sonnet 4.6؟

لكل رمز، لا. السعر القياسي هو 3 دولارات لكل مليون إدخال و15 دولارًا لكل مليون إخراج. لكن المُحلل الجديد قد ينتج حوالي 30% رموزًا أكثر لنفس النص، لذلك قد ترتفع تكلفة الطلب المكافئ.

لماذا تُقطع الاستجابة بعد الترقية؟

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

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

هل أحتاج إلى تغيير الكود بسبب المُحلل الجديد؟

لا تحتاج إلى تغيير شكل الطلب أو الاستجابة. لكن يجب إعادة قياس عدد الرموز، وتقديرات التكلفة، وقيم max_tokens.

ماذا حدث لـ temperature وbudget_tokens؟

القيم غير الافتراضية لـ temperature وtop_p وtop_k تُرجع خطأ 400. كذلك budget_tokens يُرجع خطأ 400. استخدم موجه النظام للتحكم في السلوك، واستخدم thinking مع effort بدل الميزانية اليدوية. يغطي دليل تغييرات Fable 5 و Mythos API النمط نفسه في الفئة الأعلى.

Top comments (0)