الهندسة · خطافات Claude Code

PreModelSwitch
بدءًا من 2.1.251: حظر تبديل النموذج أو تأكيده أو إضافة تعليق عليه

يضيف Claude Code 2.1.251 (2026-08-28) خطافات PreModelSwitch وPostModelSwitch. سجل التغييرات: حظر تبديل النموذج أو تأكيده أو إضافة تعليق عليه. تتلقى خطافات الاستئناف SessionStart الآن أيضًا تقادم الجلسة وتكلفة إعادة التخزين المؤقت المقدّرة. هذه أحداث خطاف رسمية، وليست تعليمات لإعادة كتابة ترويسات HTTP أو انتحال هوية عميل آخر.

آخر تحديث 2026-11-14

مفتاح واحد لـ Claude وGPT والنماذج الصينية — طبّق ما تصفه هذه الصفحة.

#PreModelSwitch#PostModelSwitch#2.1.251#حظر / تأكيد / إضافة تعليقات توضيحية

أربع حقائق يمكن الاستشهاد بها

PreModelSwitch

اسم الحدث قبل التبديل

يقرنه سجل التغييرات بـ PostModelSwitch. ويعمل قبل أي تبديل من /model أو المنتقي أو SDK أو الاستئناف.

حظر / تأكيد / إضافة تعليقات توضيحية

ثلاثة إجراءات رسمية

يلغي Deny التبديل؛ يتطلب ask تأكيدًا (يُرفض في headless)؛ ويحقن annotate سياقًا للطلب التالي. ويمكن أن يؤدي رمز الخروج 2 إلى الحظر أيضًا. تلك هي دلالات خطاف المنتج.

2.1.251

2026-08-28

أصلح سجل التغييرات نفسه أيضًا مشكلة «effort … is not supported when thinking is disabled». ترقية واحدة، سطحان.

تكلفة إعادة التخزين المؤقت

حقول الاستئناف الجديدة

تتلقى خطافات الاستئناف SessionStart الآن تقادم الجلسة وتكلفة إعادة التخزين المؤقت المقدّرة. وعندما يبطل تبديل النموذج التخزين المؤقت، فإن ذلك إشارة تكلفة قابلة للملاحظة، وليس تجاوزًا للفوترة.

لم يكن SessionStart يرى أبدًا /model في منتصف الجلسة

تغطي أدلة الخطافات الحالية Stop وSessionStart وأحداث الأدوات. قبل 2.1.251، لم يكن لتغيير /model أو المنتقي في منتصف الجلسة زوج خطافات مطابق. وPreModelSwitch هو ذلك الفراغ: يمكن للسياسات والتدقيق والـ prompts أن تتعلق بالتبديل نفسه بدلًا من الاقتصار على العمل عند بداية الجلسة.

يمكن للمنتقي أيضًا تعيين effort لكل جلسة

الإصدار نفسه: يمكن لمنتقي النموذج تعيين effort وعلامة ultracode للجلسة؛ ويحفظ /effort الآن قيمة افتراضية لكل نموذج. وقد يحمل «النموذج التالي» الذي يراه PreModelSwitch قيمة effort. راقب الطلب. لا تُعِد كتابة معرّفات العميل على نمط Originator.

الخط الزمني

الخطافات الحالية

كان لدى Claude Code بالفعل SessionStart وStop وأحداث الأدوات. وتستخدمها المؤسسات للتدقيق والحظر.

2026-08-28 · 2.1.251

أُضيفت أحداث الخطاف PreModelSwitch وPostModelSwitch (block أو confirm أو annotate لتبديل النموذج).

بعد الترقية

اعتمد على سجل التغييرات المحلي ووثائق الخطافات لديك. تتبع حقول payload مخطط الإصدار الذي تشغله. لا تبتكر هذه الصفحة ترويسات غير منشورة.

مؤكّد مقابل قراءة خاطئة

مؤكّد

أسماء الأحداث، وblock/confirm/annotate، والمسار نفسه الذي يسلكه /model والمنتقي، وتقادم الاستئناف وتكلفة إعادة التخزين المؤقت: سجل تغييرات 2.1.251، أُعيد التحقق منه في 2026-08-30.

قراءة خاطئة

«استخدام الخطاف لتزوير معرّف نموذج آخر عند البوابة» — الحديث هنا عن مسار التبديل الخاص بـ Claude Code نفسه. تعرض هذه الصفحة الأحداث الرسمية؛ ولا تصف إعادة كتابة الترويسات أو originator لتغيير كتالوج. «ask يفتح نافذة في headless» — سجل التغييرات: يرفض ask في headless.

خطافات البداية مقابل خطافات التبديل

SessionStart: فتح الجلسة / الاستئناف

يحقن قواعد المستودع ويتحقق من مساحة العمل. ومن 2.1.251، يحمل الاستئناف أيضًا التقادم وتقدير إعادة التخزين المؤقت. ولا يرى /model في منتصف الجلسة.

PreModelSwitch: قبل كل تغيير للنموذج

«يجب ألا ينتقل هذا المستودع إلى تلك الفئة»، «أكّد قبل التبديل»، «أضف تعليقًا بقيد للنموذج التالي». ويسجل PostModelSwitch بعد وقوع الأمر.

كيف تُربط الخطافات الرسمية (ملاحظة)

رقِّ إلى 2.1.251+، وسجّل PreModelSwitch / PostModelSwitch وفق وثائق خطافات Claude Code. إجراءات سجل التغييرات: block وconfirm وannotate. لا توفر هذه الصفحة خطوات لتزوير معرّفات النماذج أو إعادة كتابة ترويسات HTTP أو تجاوز سياسة النماذج في المؤسسة. وإذا كان ينبغي للسياسة أن توقف تبديلًا، فاستخدم deny الرسمي / exit 2.

لا يشغّل QCode هذه الخطافات

يعمل PreModelSwitch داخل عميل Claude Code. وQCode هو API للنماذج. وأي معرّف مُباع يُستهدف فعليًا بعد التبديل يتبع حقل model الذي ترسله وكتالوج /models. وبالنسبة إلى API الخاص بك، استخدم مفتاحًا مُجهّزًا مسبقًا بالسعر الرسمي × رسوم الخدمة.

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

متى يُطلق PreModelSwitch؟

تشمل الملاحظات العامة /model والمنتقي وSDK والتبديلات الناتجة عن الاستئناف. اعتمد على جدول الأحداث في وثائق الخطافات الخاصة بإصدارك.

block مقابل confirm؟

سجل التغييرات: يلغي deny التبديل؛ ويؤكد ask، ويرفض في headless. ولا يحظر annotate؛ بل يضيف سياقًا.

هل هو نفسه إصلاح effort في 2.1.251؟

لا. والبند الآخر في ذلك اليوم هو الخطأ 400 الخاص بـ xhigh/max + thinking off. الخطافات أحداث؛ وeffort تركيبة معاملات.

هل يمكن لخطاف أن يجعل البوابة تظن أنني عميل آخر؟

لا تصف هذه الصفحة إعادة كتابة معرّفات العميل أو originator. وتراقب الخطافات تبديل النموذج الداخلي في Claude Code وتقيّده.

هل تكلفة إعادة التخزين المؤقت عند resume تُعد فاتورة؟

سجل التغييرات: تكلفة إعادة التخزين المؤقت المقدّرة، لأغراض قرارات hook. لا تزال الرسوم الفعلية تتبع tokens والأسعار الرسمية، وليس ذلك الحقل بوصفه سجلًا محاسبيًا مستقلًا.

هل يمرّر QCode هذه الـ hooks؟

لا. الـ hooks جزء من دورة حياة العميل. لا ترى API سوى Messages / Completions التي ترسلها.

المصادر

سجل تغييرات Claude Code 2.1.251 (2026-08-28): أُضيفت أحداث hook PreModelSwitch وPostModelSwitch (حظر أو تأكيد أو تعليق على تبديل النموذج)؛ أصبحت hooks الخاصة بـ resume في SessionStart تتلقى تقادم الجلسة وتكلفة إعادة التخزين المؤقت المقدّرة. code.claude.com/docs/en/changelog. أُعيد التحقق في 2026-08-30.

قد تكون لتبديلات النموذج hooks رسمية؛ ولا تزال الفوترة تتبع المعرّفات التي تُباع

PreModelSwitch حدث في عميل Claude Code. أما الوصول عبر API، فالسعر الرسمي × رسوم الخدمة على النماذج التي تُباع.

لست متأكدًا من أين تبدأ؟

جرّبه لمدة أسبوع

الباقة الصغيرة: $4 مقابل $30 من الحصة، مدة الصلاحية: 7 يوم

استخدمها كل يوم

Starter: $9.00 شهريًا مع $5 من الحصة كل يوم — $0.060 فقط لكل $1 من الحصة، مقارنةً بنحو $0.113 لـ الباقة المتوسطة