راهنمای مهاجرت و ارتقا

Claude Sonnet 5 در برابر Sonnet 4.6

تعویض شناسه مدل مستقیم است — اما سه تغییر ناسازگار و یک توکن‌ساز جدید می‌توانند شما را غافلگیر کنند. در ادامه دقیقاً می‌بینید پیش از فعال‌سازی، چه چیزی را در یکپارچه‌سازی‌های API و رله خود باید تغییر دهید.

#Claude Sonnet 5 #Claude Sonnet 4.6 #مهاجرت API #توکن‌ساز

نتیجه: تعویض مستقیم شناسه مدل — اما ابتدا آزمایش کنید

Claude Sonnet 5 (منتشرشده در 2026-06-30) جانشین توصیه‌شده Sonnet 4.6 است و به کیفیت رده Opus 4.8 با قیمتی کمتر نزدیک می‌شود. تعویض شناسه مدل ساده است؛ آنچه دردسر ایجاد می‌کند قرارداد درخواست پیرامون آن است.

✅ چه چیزهایی بدون تغییر کار می‌کنند

همان Messages API، همان نقطه پایانی و همان احراز هویت. شناسه مدل را از claude-sonnet-4-6 به claude-sonnet-5 تغییر دهید (Bedrock: anthropic.claude-sonnet-5) و بیشتر درخواست‌ها بدون مشکل کار می‌کنند. پنجره زمینه به‌طور پیش‌فرض به 1M توکن می‌رسد — گزینه کوچک‌تری برای انتخاب وجود ندارد — و حداکثر خروجی 128K است (تا 300K از طریق هدر بتای batches با نام output-300k-2026-03-24).

⚠️ چه چیزی را ابتدا آزمایش کنید

تفکر تطبیقی اکنون به‌طور پیش‌فرض فعال است، بنابراین تأخیر و شکل خروجی تغییر می‌کنند؛ پیکربندی تفکر گسترده دستی و هر temperature/top_p/top_k غیرپیش‌فرض اکنون HTTP 400 برمی‌گردانند؛ و یک توکن‌ساز جدید شمارش توکن‌های شما را تغییر می‌دهد. درصد کوچکی از ترافیک را به Sonnet 5 هدایت کنید، ارزیابی‌های خود را اجرا کنید، سپس افزایش دهید. هیچ مهلت مهاجرت اجباری شما را تحت فشار نمی‌گذارد.

تفاوت مشخصات: Sonnet 4.6 در برابر Sonnet 5

مقایسه کنار به کنار فیلدهایی که واقعاً روی یکپارچه‌سازی شما اثر می‌گذارند.

مشخصه Claude Sonnet 4.6 Claude Sonnet 5
شناسه مدلclaude-sonnet-4-6claude-sonnet-5 (اسنپ‌شات بدون تاریخ)
پنجره زمینهپنجره استاندارد Sonnet 4.61M توکن (پیش‌فرض = حداکثر)
حداکثر خروجیسقف خروجی Sonnet 4.6128K (300K از طریق هدر بتای batches)
تفکرتفکر گسترده با پیکربندی صریحتفکر تطبیقی به‌طور پیش‌فرض فعال؛ effort از low→max (پیش‌فرض high)
پارامترهای نمونه‌گیریtemperature / top_p / top_k پذیرفته می‌شوندمقادیر غیرپیش‌فرض HTTP 400 برمی‌گردانند — آن‌ها را حذف کنید
قیمت (ورودی / خروجی)$3 / $15 به‌ازای هر MTok$2 / $10 (استاندارد)
وضعیت چرخه عمرفعال (بازنشستگی احتمالی نه پیش از 17 فوریه 2027)پیش‌فرض توصیه‌شده جدید

قیمت‌گذاری و مشخصات بر اساس anthropic.com/news/claude-sonnet-5 و مستندات platform.claude.com است. تاریخ قطع دانش ژانویه 2026 است. قیمت‌گذاری معرفی محدود به زمان است، نه دائمی.

3 تغییر ناسازگار که باید مدیریت کنید

این‌ها تفاوت‌های قرارداد درخواست هستند که می‌توانند یک استقرار موفق را به انبوهی از HTTP 400 یا رفتار غیرمنتظره تبدیل کنند. پیش از تعویض شناسه مدل در محیط عملیاتی، هر سه را برطرف کنید.

1 · تفکر تطبیقی به‌طور پیش‌فرض فعال است

Sonnet 5 از همان ابتدا به‌صورت تطبیقی استدلال می‌کند، بنابراین پاسخ‌ها ممکن است فازی از تفکر را شامل شوند که در 4.6 برای آن انتخاب نکرده بودید. این موضوع تأخیر، شکل استریم و مصرف توکن را تغییر می‌دهد. آن را با سطوح effort — low، medium، high، xhigh، max (پیش‌فرض high) — کنترل کنید، نه با روشن و خاموش کردن دستی تفکر.

2 · تفکر گسترده دستی 400 برمی‌گرداند

چون تفکر به‌طور پیش‌فرض تطبیقی است، پیکربندی صریح بلوک‌های تفکر دستی یا گسترده به همان شکلی که ممکن است در مدل‌های قبلی انجام می‌دادید، اکنون HTTP 400 برمی‌گرداند. هر پیکربندی صریح تفکر را از سازنده درخواست خود حذف کنید و به‌جای آن به پارامتر effort تکیه کنید.

3 · temperature/top_p/top_k غیرپیش‌فرض 400 برمی‌گردانند

دقیقاً مانند Opus 4.7 و نسخه‌های بعدی، Sonnet 5 مقادیر غیرپیش‌فرض temperature، top_p و top_k را با HTTP 400 رد می‌کند. این فیلدها را از payloadهای خود حذف کنید (یا با حذف آن‌ها، مقدارشان را در پیش‌فرض رها کنید). wrapperهای SDK و میان‌افزار رله را که به‌طور خودکار temperature پیش‌فرض تزریق می‌کنند بررسی کنید.

توکن‌ساز جدید: حدود 30% توکن بیشتر برای همان متن

این کم‌واضح‌ترین تغییر و محتمل‌ترین گزینه برای برهم زدن بودجه‌ها و منطق برش شماست.

Sonnet 5 یک توکن‌ایزر جدید ارائه می‌کند. همان رشته ورودی به توکن‌هایی حدود 30% بیشتر از آنچه Sonnet 4.6 تولید می‌کرد کدگذاری می‌شود. هیچ‌چیز در متن شما تغییر نمی‌کند — این شمارش است که تغییر می‌کند. این کار قیمت هر درخواست را بازتعیین می‌کند و ساختار هر بودجه max_tokens را تغییر می‌دهد؛ بنابراین برای همان متن، بهتر است $2/$10 را در مقایسه با $3/$15 مربوط به Sonnet 4.6 تقریباً هزینه‌خنثی بدانید، نه تخفیف ثابت 33%.

max_tokens متن کمتری را پوشش می‌دهد

از آنجا که توکن‌های خروجی چگال‌تر شده‌اند، یک مقدار ثابت max_tokens اکنون کاراکترهای کمتری از متن تولیدشده را پوشش می‌دهد. اگر برای خروجی ساختاریافته سقفی برای max_tokens تعیین می‌کنید، آن سقف را بالاتر ببرید، وگرنه ممکن است پاسخ‌های شما در میانه پاسخ قطع شوند، جایی که 4.6 کامل می‌شد.

هزینه اعتبار هر درخواست افزایش می‌یابد

تعداد توکن‌های ورودی و خروجی هر دو برای همان محتوا حدود 30% بیشتر می‌شود؛ بنابراین هزینه مؤثر هر درخواست از آنچه اختلاف قیمت اعلامی نشان می‌دهد بیشتر است. مدل هزینه خود را روی ترافیک واقعی دوباره اجرا کنید، نه اینکه فرض کنید کاهش قیمت صرفاً صرفه‌جویی است.

دوباره بشمارید، تعمیم ندهید

از برآوردهای توکن Sonnet 4.6 دوباره استفاده نکنید. پیش از تعیین محدودیت‌های محیط عملیاتی، از نقطه پایانی count_tokens روی Sonnet 5 استفاده کنید تا prompt‌ها، فضای باقی‌مانده پنجره زمینه و بودجه‌های محدودیت نرخ درخواست را دوباره اندازه‌گیری کنید.

مهاجرت در یک diff

کل مهاجرت معمولاً شامل تغییر model id و حذف فیلدهای نمونه‌گیری و تفکر دستی است. در ادامه یک قبل/بعد حداقلی آمده است.

قبل — Sonnet 4.6
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 4096,
  "temperature": 0.7,
  "top_p": 0.9,
  "messages": [...]
}
بعد — Sonnet 5
{
  "model": "claude-sonnet-5",
  "max_tokens": 4096,
  // omit temperature / top_p / top_k
  // adaptive thinking is on by default
  "messages": [...]
}

همان نقطه پایانی، هدرها و توکن احراز هویت را نگه دارید. temperature، top_p و top_k را حذف کنید (مقادیر غیرپیش‌فرض 400 برمی‌گردانند). هر پیکربندی صریح extended-thinking را بردارید و به‌جای آن از پارامتر effort استفاده کنید. max_tokens را با توکن‌ایزر جدید دوباره بررسی کنید تا خروجی‌های طولانی قطع نشوند. در یک سرویس رله، همین تغییرات را در middleware خود اعمال کنید تا دوباره یک temperature پیش‌فرض تزریق نکند.

Sonnet 4.6 بازنشسته نشده است — هیچ مهاجرت اجباری وجود ندارد

Claude Sonnet 4.6 (claude-sonnet-4-6) همچنان فعال است. Anthropic تاریخ بازنشستگی احتمالی را نه پیش از 17 فوریه 2027 ذکر می‌کند و آن تاریخ قابل تغییر است. Sonnet 5 پیش‌فرض جدید توصیه‌شده است، اما هیچ مهلتی برای شما وجود ندارد: در حین اعتبارسنجی 5 طبق برنامه خودتان، 4.6 را در محیط عملیاتی نگه دارید و سپس وقتی ارزیابی‌هایتان نتیجه مطلوب داد، تغییر دهید.

پرسش‌های متداول مهاجرت

آیا باید از Sonnet 4.6 به Sonnet 5 ارتقا دهم؟

برای بیشتر بارهای کاری، بله — Sonnet 5 با قیمت اعلامی پایین‌تر به کیفیت کلاس Opus 4.8 نزدیک می‌شود و جانشین توصیه‌شده است. اما آن را یک تغییر کد در نظر بگیرید، نه تغییر پیکربندی: جابه‌جایی model id بدون تغییر کد انجام می‌شود، ولی تفکر تطبیقی اکنون به‌صورت پیش‌فرض فعال است و تفکر گسترده دستی یا temperature/top_p/top_k غیرپیش‌فرض اکنون HTTP 400 برمی‌گردانند. ابتدا درصد کوچکی از ترافیک را مهاجرت دهید، ارزیابی‌هایتان را اجرا کنید و سپس تدریجاً افزایش دهید. هیچ مهلت مهاجرت اجباری وجود ندارد، پس می‌توانید با آرامش پیش بروید.

چرا Sonnet 5 برای همان متن توکن بیشتری می‌شمارد؟

Sonnet 5 یک توکن‌ایزر جدید ارائه می‌کند. رشته ورودی یکسان به توکن‌هایی حدود 30% بیشتر از آنچه Sonnet 4.6 تولید می‌کرد کدگذاری می‌شود. تعداد توکن‌های ورودی و خروجی هر درخواست شما افزایش می‌یابد، بودجه max_tokens شما کاراکترهای کمتری را پوشش می‌دهد و هزینه اعتبار مؤثر هر درخواست بیشتر از آن است که اختلاف خام قیمت به‌ازای هر توکن نشان می‌دهد. به همین دلیل در همان متن، $2/$10 را بهتر است در مقایسه با $3/$15 مربوط به Sonnet 4.6 تقریباً هزینه‌خنثی بدانید — نه تخفیف ثابت 33%.

آیا پارامترهای temperature، top_p و top_k من هنوز کار می‌کنند؟

خیر. مانند Opus 4.7 و نسخه‌های بعد از آن، Sonnet 5 مقادیر غیرپیش‌فرض temperature، top_p و top_k را با HTTP 400 رد می‌کند — کافی است آن فیلدها را حذف کنید. پیکربندی صریح یا دستی extended-thinking نیز HTTP 400 برمی‌گرداند، چون تفکر تطبیقی به‌صورت پیش‌فرض فعال است؛ استدلال را با سطوح effort یعنی low / medium / high / xhigh / max کنترل کنید (پیش‌فرض high). پیش از تغییر model id، سازنده درخواست و middleware رله خود را از نظر پارامترهای نمونه‌گیری سخت‌کدشده بررسی کنید.

آیا Sonnet 4.6 حذف می‌شود؟

خیر. Claude Sonnet 4.6 همچنان Active است و بازنشستگی احتمالی آن زودتر از 17 فوریه 2027 نخواهد بود که قابل تغییر است. Sonnet 5 پیش‌فرض جدید توصیه‌شده است، اما هیچ مهلت مهاجرت اجباری وجود ندارد — می‌توانید تا زمانی که 5 را اعتبارسنجی می‌کنید، 4.6 را در محیط عملیاتی اجرا کنید.

مهاجرت به Claude Sonnet 5 در QCode

Sonnet 5 و Sonnet 4.6 را کنار هم از طریق یک API و نقطه پایانی Claude Code اجرا کنید — شناسه‌های مدل را جابه‌جا کنید، ارزیابی‌ها را مقایسه کنید و هر زمان که آماده بودید، افزایش دهید.

اول امتحان کنید، بعد تصمیم بگیرید

مطمئن نیستید کدام سطح را انتخاب کنید؟ با Starter ($9.00/ماه) شروع کنید و وقتی راضی بودید ارتقا دهید — ارزش استفاده‌نشده پلن قبلی به موجودی شما برمی‌گردد.