إصدار Claude API 2026-10-21: ما الذي تغيّر وكيفية الترقية بأمان

إصدار Claude API 2026-10-21 هو أول قيمة جديدة لـ anthropic-version منذ 2023-06-01. وهو يُجري ثلاثة تغييرات كاسرة على Messages API: أصبح temperature وtop_p وtop_k تُعيد الآن خطأ 400، وأصبحت كتل document في رسائل assistant تُعيد خطأ 400، وأصبحت citations على كتل text في رسائل user تُعيد خطأ 400. كما يُعيد تسمية عدة حقول في Admin API وEnterprise Analytics API. يمكنك الاشتراك فيه بإرسال anthropic-version: 2026-10-21 أو بالترقية إلى الإصدارات الرئيسية الجديدة من SDK (Python 2.0.0 وTypeScript 1.0.0 وGo 2.0.0 وغيرها).

المشكلة الكامنة: ترقية الـ SDK هي الطريقة التي ستنتقل بها معظم الفرق إلى الإصدار الجديد "بالخطأ". فأمر روتيني مثل pip install -U anthropic أو npm update يتجاوز إصدارًا رئيسيًا يقلب كل طلب إلى 2026-10-21 دفعة واحدة. يسرد هذا الدليل كل تغيير توثّقه Anthropic، ويوضح أيّها يضرّ في الكود الفعلي، ويمنحك ترتيبًا آمنًا للترقية.

ما هو ترويسة anthropic-version؟

ترويسة anthropic-version هي ترويسة طلب مطلوبة تحدّد شكل Claude API الذي تحصل عليه. داخل الإصدار الواحد، تحافظ Anthropic على ثبات معاملات الإدخال والإخراج الموجودة، لكنها قد تضيف مدخلات اختيارية، وقيم إخراج جديدة، وأنواعًا جديدة من التعدادات مثل أنواع أحداث البثّ، وشروط خطأ جديدة. لا تصل التغييرات الكاسرة إلا مع تاريخ إصدار جديد.

من صفحة إدارة الإصدارات، يوجد ثلاثة إصدارات:

إذا كنت تستخدم SDK رسميًا، فلن تضبط الترويسة بنفسك أبدًا. فكل إصدار رئيسي من SDK يُرسل الإصدار الذي كان سارياً وقت إطلاق ذلك الإصدار الرئيسي. ولهذا فإن ترقية الـ SDK وترقية إصدار API هما الحدث نفسه بالنسبة لمعظم قواعد الكود.

التغييرات الكاسرة في Claude API 2026-10-21

تنطبق هذه التغييرات على POST /v1/messages، وعلى عدّ الرموز، وعلى كل طلب داخل Message Batch أُنشئ بـ 2026-10-21.

1. إزالة temperature وtop_p وtop_k

هذا هو التغيير الذي سيصطدم به معظم الناس. فأي طلب يُرسل temperature أو top_p أو top_k يُعيد خطأ 400، على كل الموديلات، حتى لو أرسلت القيمة الافتراضية. ويكفي وجود temperature: 1.0 في ملف إعدادات لكسر الاستدعاء.

وما يحدث لجودة المخرجات يعتمد على الموديل:

• Claude 4.7 وما بعده يقبل بالفعل قيم أخذ العينات الافتراضية فقط، لذا فإن إزالة المعاملات لا تغيّر شيئًا في طريقة أخذ العينات لديه.
• الموديلات الأقدم التي تقبل قيمًا أخرى، مثل Claude Sonnet 4.6، تفقد أي أثر حصلت عليه من خفض temperature. ودليل الترحيل صريح في ذلك: لا يوجد إعداد آخر يحلّ محله.

إذا كان طلب ما يعتمد فعلاً على قيمة غير افتراضية، فتمنحك Anthropic خيارين: التوقف عن إرسالها، أو إبقاء ذلك الطلب تحديدًا على 2023-06-01.

2. كتل document في رسائل assistant تُعيد خطأ 400

بعض التطبيقات تُعيد تشغيل سجل المحادثة مع كتلة document مستقرة مباشرة في دور assistant. وفي ظل 2026-10-21 يُرفض ذلك. انقل المستندات إلى رسائل user. أما المستند المتداخل داخل كتلة أخرى، مثل نتيجة أداة جلب ويب أعادها Claude، فلا يزال مقبولًا.

3. الاستشهادات في رسائل user تُعيد خطأ 400

كتلة text تحتوي على مصفوفة citations غير فارغة في رسالة user تفشل الآن، ويشمل ذلك النص داخل كتل search_result. أزل citations من تلك الكتل. أما الاستشهادات على ردود assistant الخاصة بـ Claude التي تُعيد إرسالها فلا بأس بها، وكذلك "citations": {"enabled": true} على المستندات ونتائج البحث.

4. إعادة تسمية حقول Admin API وEnterprise Analytics

لم تعد الاستجابات تتضمن أسماء الحقول القديمة:

التغيير الخاص بمفتاح API هو الأكثر خفاءً. في ظل 2023-06-01، كان workspace_id يساوي null لكل من المفاتيح المرتبطة بمساحة العمل الافتراضية والمفاتيح الخاصة بكل مساحات العمل. أما في ظل 2026-10-21، فإن scope.workspace_id يحمل المعرّف الحقيقي لمساحة العمل الافتراضية، ويكون المفتاح الخاص بكل مساحات العمل بـ scope: {"type": "organization"} بدون workspace_id. وإذا كانت لوحة التحكم لديك تعامل null على أنه "مساحة العمل الافتراضية"، فستسيء تسمية المفاتيح بعد الترقية.

إصدارات SDK التي ترسل 2026-10-21

أطلقت Anthropic إصدارات SDK رئيسية جديدة في 21 أكتوبر 2026، وكل منها يُرسل 2026-10-21 افتراضيًا، وفقًا لـملاحظات الإصدار:

كما تأتي الإصدارات الرئيسية الجديدة بتغييرات لا تعتمد على إصدار API على الإطلاق:

• مفاتيح API تُرسل كـ Authorization: Bearer <key> بدلاً من X-Api-Key. يقبل Claude API أيًّا منهما، لكن أي وكيل وسيط أو بوابة أو مُرشّح سجلات أو بديل اختباري يقرأ X-Api-Key لن يرى المفتاح بعد الآن.
• إزالة Text Completions من SDK الخاص بـ TypeScript وGo وJava وRuby ومن الـ CLI. استخدم Messages API.
• اختفاء betas من طرق Models غير التجريبية. استدعِ client.beta.models بدلاً منها.
• أصبح MessageParam اتحادًا بنوع واحد لكل دور في SDKs المُنمّطة، لذا تحتاج بعض تعليقات الأنواع إلى تحديث.
• يحتاج Go إلى مسار استيراد جديد ينتهي بـ /v2، وعلى مستخدمي TypeScript على حزم Bedrock أو Vertex أو Foundry أو AWS أو Google Cloud نقلها إلى v1 في الترقية ذاتها، وإلا فسيُثبّت مدير الحزم نسخة ثانية أقدم من SDK الأساسي.
• تغيّرت الرخصة من MIT إلى Apache 2.0.

ثبّت إصدارك الرئيسي الحالي قبل أن تفعل أي شيء آخر. فهذا يمنع أي روبوت إدارة الاعتماديات من ترقيتك في منتصف دورة العمل.

استثناء Amazon Bedrock

على Amazon Bedrock، يعمل 2026-10-21 فقط مع موديلات Claude 4.7 وما بعده. وإذا كنت لا تزال تستدعي Opus 4.6 أو موديلًا أقدم هناك، فابقَ على إصدار SDK الحالي أو استمر في إرسال ترويستك الحالية، وبدّل الموديل أولًا.

كيفية الترقية إلى Claude API إصدار 2026-10-21 بأمان

ترتيب دليل الترحيل هو: بدّل الإصدار، وأصلح التغييرات الكاسرة، واختبر قبل الإصدار. وهكذا يبدو ذلك عمليًا.

1. ثبّت إصدار SDK الرئيسي القديم. مثل anthropic<2 في Python أو "@anthropic-ai/sdk": "^0" في npm.
2. ابحث في كودك وإعداداتك عن temperature وtop_p وtop_k وX-Api-Key وcompletions.create، وأي حقل من حقول Admin API الواردة في الجدول أعلاه.
3. احسم أمر أخذ العينات. على Claude 4.7 وما بعده، احذف المعاملات. وعلى الموديلات الأقدم، إما أن تقبل أخذ العينات الافتراضي أو تُبقي تلك الاستدعاءات على 2023-06-01.
4. أصلح بناء الرسائل. انقل المستندات الموجودة في جهة assistant إلى أدوار user، وأزل citations من كتل نص user.
5. اختبر الحمولات نفسها تحت كلا الإصدارين وقارن رموز الحالة وأشكال الاستجابة.
6. رقِّ الـ SDK وأطلق إصلاحات الكود معًا. توصي Anthropic بإطلاق الترقية مع إصلاحاتك، وليس قبلها.

وبدون SDK، يكون التبديل ترويسة واحدة:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

أضف "temperature": 0.2 إلى ذلك الجسم وستحصل على خطأ 400. وأرسل الجسم نفسه مع anthropic-version: 2023-06-01 وسينجح. وهذا الزوج من النتائج هو بالضبط ما يجب أن تلتقطه الخطوة 5 لكل حمولة ترسلها في الإنتاج.

دع Claude Code يختبر كلا الإصدارين باستخدام Apidog CLI

الخطوة 5 مُملّة يدويًا: لديك عشرات من أشكال الحمولات، وكل واحدة تحتاج إلى التشغيل مرتين. فوّض الأمر إلى وكيل البرمجة لديك بدلاً من ذلك. يمنح Apidog CLI كلاً من Claude Code (أو Codex وCursor وOpenCode) أوامر لإنشاء حالات اختبار وتشغيلها، بحيث يقوم الوكيل بالمقارنة وتقرأ أنت الملخص.

أعدّه مرة واحدة:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

ثم أعطِ Claude Code موجّهًا واحدًا:

In Apidog project <id>, create an environment "claude-api" with base URL
https://api.anthropic.com. For each JSON payload in ./fixtures/claude/, add a
POST /v1/messages test case that sends the header anthropic-version: {{anthropic_version}}
and asserts status 200 and a non-empty content array. Run every case twice, once with
anthropic_version=2023-06-01 and once with 2026-10-21, and list each case that passes
on the old version but fails on the new one, with the error message.

يتحقق الوكيل من مخطط كل حمولة قبل أن يكتب أي شيء، ثم يشغّل الحالات:

apidog environment create claude-api --project <id> --base-url https://api.anthropic.com
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2023-06-01" -r cli,json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2026-10-21" -r cli,json

يستبدل علم --env-var قيمة الترويسة دون المساس بحالة الاختبار، لذا يكون الفرق متغيرًا واحدًا. أضف --upload-report لعرض كلا التشغيلين في تطبيق Apidog، أو ضع تشغيل 2026-10-21 في CI مع -r junit حتى لا تستطيع ترقية اعتمادية ما إطلاق حقل temperature إلى الإنتاج. ويغطي دليل Apidog CLI في Claude Code الإعداد بمزيد من التفصيل، ويسرد مرجع apidog run كل علم. وتغطي خطة Apidog المجانية ما يصل إلى 4 مستخدمين.

هل أصبح 2023-06-01 مهملًا؟

لم يُنشر أي تاريخ لإيقافه. تسرد صفحة إدارة الإصدارات 2023-06-01 دون أي إشعار إهمال، ودليل الترحيل نفسه يخبرك بإبقاء الطلبات التي تحتاج إلى temperature غير افتراضية على 2023-06-01. ولا تزال Anthropic توصي بأحدث إصدار "كلما أمكن".

وهذا مهم للتخطيط. فترقية اليوم اختيارية، لكن 2026-10-21 هو أول إصدار جديد منذ أكثر من ثلاث سنوات، وستأتي التغييرات الكاسرة المستقبلية بالطريقة ذاتها، لذا فإن التعامل مع اختبار الإصدارات كمهمة روتينية في CI الآن أرخص من ترحيل متسرّع لاحقًا. وإذا كنت تضبط إعداداتك بالفعل حول حدود معدل Claude API أو تكلفة Claude API، فأضف فحص الإصدار إلى المسار نفسه. ويشرح دليلنا حول أفضل ممارسات إدارة إصدارات API لماذا تُسهّل الإصدارات المبنية على التواريخ كهذا الإصدار الأمر.

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

هل يجب أن أرقّي إلى Claude API إصدار 2026-10-21 الآن؟

لا. لا يزال 2023-06-01 يعمل وليس له تاريخ إيقاف منشور. أنت ترقّي عندما ترسل الترويسة الجديدة أو تثبّت إصدارًا رئيسيًا من SDK يعتمدها افتراضيًا.

لماذا يُعيد طلبي خطأ 400 بعد ترقية الـ SDK؟

الإصدارات الرئيسية الجديدة من SDK ترسل 2026-10-21، وهو يرفض temperature وtop_p وtop_k، وكتل document في جهة assistant، وcitations على كتل نص user. افحص حمولتك بحثًا عن هذه أولًا.

هل يمكنني الإبقاء على temperature في بعض الطلبات؟

نعم، بإبقاء تلك الطلبات تحديدًا على 2023-06-01. ففي ظل 2026-10-21 لا يوجد إعداد بديل، وموديلات Claude 4.7 وما بعده تأخذ العينات بالقيم الافتراضية فقط على أي حال.

هل يعمل 2026-10-21 على Amazon Bedrock؟

فقط مع موديلات Claude 4.7 وما بعده. أما موديلات Bedrock الأقدم فتحتاج إلى إصدار SDK الحالي لديك أو الترويسة الحالية إلى أن تبدّل الموديلات.

هل سيرى الوكيل الوسيط مفتاح API الخاص بي؟

لا، إن كان يقرأ X-Api-Key. فإصدارات SDK الجديدة ترسل المفتاح كـ Authorization: Bearer. حدّث الوكيل الوسيط ليقرأ Authorization، أو اضبط الـ SDK ليرسل X-Api-Key بنفسك.

هل يغيّر الإصدار الجديد أحداث البثّ؟

لا تسرد Anthropic أي تغيير في صيغة البثّ في 2026-10-21. فصيغة البثّ التي تستخدمها اليوم جاءت مع 2023-06-01.