PreModelSwitch
از 2.1.251: مسدود کردن / تأیید کردن / حاشیه‌نویسی کردن تغییر مدل
Claude Code 2.1.251 (2026-08-28) هوکهای PreModelSwitch و PostModelSwitch را اضافه میکند. تغییرات: تغییر مدل را مسدود، تأیید یا حاشیه‌نویسی کنید. هوکهای ازسرگیری مربوط به SessionStart اکنون کهنگی نشست و هزینه تخمینی کشگذاری مجدد را نیز دریافت میکنند. این‌ها رویدادهای رسمی هوک هستند، نه دستورالعمل‌هایی برای بازنویسی هدرهای HTTP یا جعل هویت کلاینت دیگر.
به‌روزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدل‌های چینی — آنچه این صفحه توضیح میدهد را در عمل پیاده کنید.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار واقعیتی که می‌توانید به آن‌ها استناد کنید
نام رویداد پیش از تغییر
فهرست تغییرات آن را با PostModelSwitch جفت میکند. این رویداد پیش از تغییر مدل از طریق /model، انتخابگر، SDK یا ازسرگیری نشست اجرا میشود.
سه اقدام رسمی
رد کردن تغییر را لغو میکند؛ پرسش نیازمند تأیید است (در حالت بدون رابط رد میشود)؛ حاشیه‌نویسی زمینه را برای درخواست بعدی تزریق میکند. کد خروج 2 نیز میتواند مسدود کند. این معنای هوک در سطح محصول است.
2026-08-28
همان تغییرات همچنین خطای effort … is not supported when thinking is disabled را برطرف کرد. یک ارتقا، دو سطح.
فیلدهای جدید ازسرگیری
هوکهای ازسرگیری مربوط به SessionStart اکنون کهنگی نشست و هزینه تخمینی کشگذاری مجدد را دریافت میکنند. وقتی تغییر مدل کش را بی‌اعتبار میکند، این یک نشانه قابل مشاهده از هزینه است، نه دور زدن پرداخت.
SessionStart هرگز /model میان‌نشست را نمی‌دید
راهنماهای موجود هوکها Stop، SessionStart و رویدادهای ابزار را پوشش می‌دهند. پیش از 2.1.251، تغییر /model در میانه نشست یا تغییر انتخابگر جفت هوک متناظری نداشت. PreModelSwitch همان شکاف است: سیاست، حسابرسی و promptها می‌توانند به خود تغییر متصل شوند، نه اینکه فقط در شروع نشست اجرا شوند.
انتخابگر میتواند میزان تلاش را نیز برای هر نشست تنظیم کند
همان انتشار: انتخابگر مدل میتواند میزان تلاش و یک پرچم به نام ultracode را برای نشست تنظیم کند؛ /effort اکنون یک پیش‌فرض را برای هر مدل به خاطر می‌سپارد. «مدل بعدی» که PreModelSwitch میبیند ممکن است میزان تلاش داشته باشد. درخواست را مشاهده کنید. شناسههای کلاینت به سبک Originator را بازنویسی نکنید.
خط زمانی
Claude Code از قبل SessionStart، Stop و رویدادهای ابزار را داشت. سازمان‌ها از آن‌ها برای حسابرسی و مسدودسازی استفاده میکنند.
رویدادهای هوک PreModelSwitch و PostModelSwitch اضافه شدند (تغییر مدل را block، confirm یا annotate کنید).
به تغییرات و مستندات هوکهای محلی خود اعتماد کنید. فیلدهای payload از schema نسخه‌ای که اجرا می‌کنید پیروی میکنند. این صفحه هدرهای منتشرنشده را از خود نمی‌سازد.
تأییدشده در برابر برداشت نادرست
تأییدشده
نام رویدادها، block/confirm/annotate، همان مسیر /model و انتخابگر، کهنگی resume و هزینه re-cache: تغییرات 2.1.251، بازبینی‌شده در 2026-08-30.
برداشت نادرست
«از هوک برای جعل شناسه مدل دیگر در gateway استفاده کنید» — موضوع، جریان تغییر خود Claude Code است. این صفحه رویدادهای رسمی را بیان میکند؛ بازنویسی هدرها یا originator برای تغییر یک کاتالوگ را توصیف نمیکند. «ask در headless پنجره باز میکند» — تغییرات: ask در headless رد میکند.
هوکهای شروع در برابر هوکهای تغییر
SessionStart: باز شدن نشست / resume
قواعد مخزن را تزریق کنید، فضای کاری را بررسی کنید. از 2.1.251، resume همچنین کهنگی و تخمین re-cache را حمل میکند. /model میان‌نشست را نمی‌بیند.
PreModelSwitch: پیش از هر تغییر مدل
«این مخزن نباید به آن سطح منتقل شود»، «پیش از تغییر تأیید کنید»، «برای مدل بعدی یک محدودیت را annotate کنید». 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 و تغییرهای ناشی از resume است. به جدول رویداد در مستندات هوکهای نسخه خود اعتماد کنید.
block در برابر confirm؟
تغییرات: deny لغو میکند؛ ask تأیید میکند و در headless رد میکند. annotate مسدود نمیکند؛ زمینه اضافه میکند.
همان اصلاح effort در 2.1.251 است؟
خیر. خط دیگر آن روز، خطای 400 برای xhigh/max + thinking off است. هوکها رویداد هستند؛ effort یک ترکیب پارامتر است.
آیا یک هوک میتواند باعث شود gateway فکر کند من کلاینت دیگری هستم؟
این صفحه بازنویسی شناسههای کلاینت یا originator را توصیف نمیکند. هوکها تغییر مدل داخلی Claude Code را مشاهده و محدود میکنند.
آیا هزینه کشگذاری مجدد در resume صورتحساب میشود؟
تغییرات: هزینه تخمینی کشگذاری مجدد، برای تصمیمهای هوک. هزینههای واقعی همچنان بر اساس توکنها و قیمتهای رسمی است، نه آن فیلد بهعنوان دفتر کل مستقل.
آیا QCode این هوکها را ارسال میکند؟
خیر. هوکها بخشی از چرخه عمر کلاینت هستند. API فقط همان Messages / Completions را میبیند که شما میفرستید.
منابع
تغییرات Claude Code 2.1.251 (2026-08-28): رویدادهای هوک PreModelSwitch و PostModelSwitch اضافه شدند (block، confirm یا annotate برای یک تغییر مدل)؛ هوکهای resume مربوط به SessionStart اکنون کهنگی نشست و هزینه تخمینی کشگذاری مجدد را دریافت میکنند. code.claude.com/docs/en/changelog. بازبینی مجدد 2026-08-30.
تغییرهای مدل می‌توانند هوکهای رسمی داشته باشند؛ صورتحساب همچنان بر اساس شناسههای فروخته‌شده است
PreModelSwitch یک رویداد کلاینت Claude Code است. برای دسترسی API، قیمت رسمی × هزینه سرویس روی مدل‌هایی که به فروش می‌رسند.
مرتبط
ارائه‌دهنده سفارشی ZCode: چگونه از API مدل خودتان استفاده کنید (2026-11)
استفاده از کلید API خودتان در ZCode: Add Provider در دسکتاپ و provider_config.json در CLI، اینکه هر Base URL به /v1 نیاز دارد یا نه، و نتایج آزمایش CLI 0.17.1.
ابزارهای کدنویسی با هوش مصنوعی که از API سفارشی پشتیبانی میکنند
16 ابزار BYOK: پروتکل، محل پیکربندی، پشتیبانی از Claude و صفحه راه‌اندازی، بررسی‌شده در 2026-10-08.
راهنمای راه‌اندازی مدل سفارشی Trae
نحوه پر کردن مدل سفارشی Trae: قالب API، URL درخواست، شناسه مدل و کلید API، به‌همراه محدودیت حالت Auto و خطاهای رایج.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
برداشت از تغییرات Claude Code 2.1.251 است، نه وعده‌ای درباره فیلدهای payload منتشرنشده. QCode هوکهای کلاینت را اجرا نمیکند و سیاست مدل سازمان را دور نمی‌زند.