رقّي كود Claude API إلى النسخة الجديدة بدون أخطاءUpgrade your Claude API code to the new API version

المصطلحات

API version (نسخة الـ API)

قيمة الـ header اللي اسمه anthropic-version. هي اللي تحدد شكل الطلبات والردود المقبولة. النسخة الجديدة هي 2026-10-21، والقديمة 2023-06-01.

Breaking change (تغيير كاسر)

تغيير يخلي طلبًا كان يشتغل أمس يرجع خطأ اليوم. هنا الخطأ هو 400.

Sampling parameters (معاملات العينة)

الإعدادات temperature وtop_p وtop_k اللي تتحكم بعشوائية الرد. في النسخة الجديدة أصبحت محذوفة.

SDK (حزمة المطور)

المكتبة الرسمية اللي تتكلم مع الـ API بدلك. النسخ الرئيسية الجديدة منها ترسل النسخة الجديدة تلقائيًا.

الخطوات

1. 1

   الخطوة 1

   افحص كودك قبل أي ترقية

   ابدأ بمعرفة ما يتأثر. الترقية نفسها سهلة، لكن ثلاثة أشياء في الطلبات راح ترجع 400 في النسخة الجديدة.

   الأول: أي استخدام لـ temperature أو top_p أو top_k، حتى لو بقيمتها الافتراضية. الثاني: كتلة document موضوعة مباشرة داخل رسالة من assistant. الثالث: كتلة text داخل رسالة من user وفيها citations غير فارغة.

   أعطِ Claude Code مشروعك وخلّه يبحث لك عنها.

   platform.claude.com

   

   برومبتفحص المشروع

   نسخ

   ابحث في هذا المشروع عن كل استدعاء لـ Claude API أو Anthropic SDK. أريد قائمة بالملفات والأسطر لكل حالة من هذه الحالات: 1) استخدام temperature أو top_p أو top_k. 2) كتلة document داخل رسالة بدور assistant. 3) كتلة text فيها citations داخل رسالة بدور user، أو داخل search_result. لا تعدّل أي ملف الآن. اعرض لي النتيجة مرتبة حسب الملف، ثم اقترح التعديل لكل حالة.

   نصيحة: إذا عندك Claude Code حديث، جرّب الأمر /claude-api api-version لينقل كود الـ API للنسخة الجديدة.