لأول مرة منذ 2023 تصدر Anthropic نسخة جديدة من واجهتها، وحزم SDK تنتقل إليها افتراضياً، فتتوقف طلبات كانت تعمل قبلها.
ضمن ملف: Anthropic، نماذج الذكاء الاصطناعي
بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
المصدر الأساسي: ClaudeDevs (X via Thread Reader App)
لماذا يهم
يتأثر كل مطور يبني على Claude ويحدّث حزم SDK تلقائياً، إذ قد تفشل طلباته أو يفقد التحكم بمعاملات العيّنة دون أن يغيّر سطراً واحداً.
أطلقت Anthropic إصدار 2026-10-21 من واجهة Claude البرمجية (وفقاً لـ ClaudeDevs). تصفه الشركة بأنه أول إصدار رسمي منذ عام 2023 (وفقاً لـ ClaudeDevs). أهم ما فيه حذف معاملات temperature وtop_p وtop_k من Messages API. والمعلومات هنا مصدرها وحيد هو سلسلة منشورات حساب ClaudeDevs التابع للشركة على X، ولم نجد تغطية مستقلة تؤكد التفاصيل أو تضيف إليها حتى الآن.
لفهم ما يحدث، تذكّر أن Anthropic تربط سلوك الواجهة برقم إصدار على شكل تاريخ يرسله الكود مع كل طلب. ظلت الواجهة تتطور لسنوات تحت إصدار 2023-06-01 نفسه (وفقاً لـ ClaudeDevs). الجديد أن الشركة قررت جمع التغييرات الكاسرة في إصدار مستقل. وبحسب ClaudeDevs، تنوي الشركة إصدار نسخ بوتيرة أعلى حتى يتعامل المطورون مع التغييرات الكاسرة قبل أن يفرضها نموذج جديد. هذه الجملة تستحق الانتباه، فهي تلمّح إلى أن النماذج القادمة قد لا تقبل بعض ما كانت النماذج السابقة تقبله. والطمأنة الأساسية أن إصدار 2023-06-01 ليس مُهملاً (not deprecated) بحسب الشركة، ولم يُعلَن أي موعد لإيقافه.
تشمل التغييرات ثلاثة محاور بحسب ClaudeDevs: حذف معاملات العيّنة الثلاثة من Messages API، وإرجاع خطأ 400 (وفقاً لـ ClaudeDevs) عند وضع مستندات (documents) داخل أدوار المساعد أو استشهادات (citations) داخل أدوار المستخدم، واستبدال عدد من الحقول المُهملة في Admin API وEnterprise Analytics API. لم تشرح الشركة في المنشور سبب حذف معاملات العيّنة، ولم تسمّ الحقول المستبدلة، وأحالت التفاصيل إلى دليل الترحيل الرسمي. وصدرت في اليوم نفسه إصدارات رئيسية جديدة من حزم SDK وأداة سطر الأوامر ant، وكلها تعتمد الإصدار الجديد افتراضياً.
هذا التفصيل الأخير هو مصدر الخطر الحقيقي. إذا حدّثت حزمة SDK دون انتباه، ستنتقل إلى الإصدار الجديد تلقائياً، وقد تبدأ طلبات كانت تعمل أمس بالفشل. لذلك نقترح هذا الترتيب للانتقال:
- ثبّت رقم الإصدار قبل أي ترقية. إن كان كودك يعتمد على القيمة الافتراضية للـSDK، اضبط الإصدار 2023-06-01 صراحةً حتى لا تنقلك ترقية روتينية للحزمة إلى 2026-10-21 قبل أن تكون مستعداً.
- ابحث في الكود عن temperature وtop_p وtop_k. كل استدعاء لـ Messages API يمرر أحد هذه المعاملات يحتاج مراجعة. لم يوضح المنشور هل تُرفض هذه المعاملات بخطأ أم تُتجاهل بصمت، فاختبر الحالتين بنفسك.
- راجع بنية سجل المحادثة. إن كان تطبيقك يعيد إدراج مستندات داخل رسائل المساعد، أو يمرر citations ضمن رسائل المستخدم، فهذه الطلبات ستعيد خطأ 400 في الإصدار الجديد بحسب ClaudeDevs.
- افحص تكاملات Admin وEnterprise Analytics. إن كانت لديك لوحات أو تقارير تقرأ من هذه الواجهات، قارن الحقول التي تستخدمها بقائمة الحقول المستبدلة في دليل الترحيل.
- استعن بمهارة /claude-api داخل Claude Code. تقول الشركة إنها تساعد في تحديث الكود. وإن فضّلت العمل يدوياً، فالبديل هو المرور على كل تغيير عبر الدليل.
- رقِّ الحزم ثم اختبر في بيئة تجريبية. بعد إصلاح النقاط السابقة، حدّث إلى الإصدار الرئيسي الجديد من SDK أو ant، وشغّل اختباراتك قبل النشر.
متى لا تحتاج إلى الانتقال الآن؟ إن كان تطبيقك مستقراً على 2023-06-01 ولا يحتاج ميزات جديدة، فلا شيء يجبرك على الترحيل اليوم، لأن الإصدار القديم ليس مُهملاً ولم يُحدد موعد لإيقافه بعد. لكن الخسارة الأكبر في رأينا تقع على من بنى منتجه على ضبط دقيق لـ temperature، مثل تطبيقات تريد مخرجات شبه حتمية أو أخرى تريد تنوعاً إبداعياً. هؤلاء سيفقدون أداة تحكم مباشرة دون أن يشرح المنشور البديل. وبما أن الشركة تربط التغييرات صراحةً بالنماذج القادمة، فالأفضل أن تبدأ تجربة سلوك تطبيقك دون هذه المعاملات من الآن، بدلاً من انتظار نموذج لا يدعمها.
الإيقاع المعلن يتسق مع ما يفعله الحساب نفسه في بقية منتجاته. فقد أعلن في يوليو إصدار MCP 2026-07-28 بالتسمية التاريخية ذاتها، وجعل البروتوكول فيه stateless (وفقاً لـ ClaudeDevs). ما يحتاجه المطور العربي الذي يبني على Claude إذن هو عادة جديدة: تثبيت رقم الإصدار صراحةً في كل مشروع، ومتابعة سجل التغييرات كما يتابع تحديثات النماذج.
المصادر
- Thread by @ClaudeDevs on Thread Reader App threadreaderapp.com
- Migrating to API version 2026-10-21 platform.claude.com
