تغییرات ناسازگار Claude Haiku 5.5: پنج خطای 400 هنگام مهاجرت از Haiku 4.5 و اصلاحات رسمی
تا 2026-10-10، صفحه رسمی What's new در Anthropic پنج تغییر از Claude Haiku 4.5 به Claude Haiku 5.5 را با برچسب Breaking مشخص میکند، و هر یک از آنها میتواند باعث شود یک درخواست 400 برگرداند: budget_tokens دستی، temperature / top_p / top_k غیرپیشفرض، یک prefill که به نوبت assistant ختم میشود، ابزار قدیمی computer_20250124، و ویرایش نوبت‌های پیشین هنگام ارسال دوباره بلوک‌های تفکر. این صفحه برای هر مورد بیان میکند چه چیزی تغییر کرده، رشته خطای عیناً نقل‌شده در جایی که مستندات رسمی آن را ارائه می‌دهند، و اصلاح مستندشده؛ در جایی که هیچ متن خطایی منتشر نشده است، فقط می‌گوید «خطای 400 برمی‌گرداند».
به‌روزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورت‌حساب به‌ازای توکن، آماده به کار در چند دقیقه.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار مورد از پنج موردی که ابتدا با آنها روبه‌رو می‌شوید
بودجه دستی تفکر: 400
راهنمای مهاجرت رسمی: مقدار thinking به‌صورت {"type": "enabled", "budget_tokens": N} خطای 400 برمی‌گرداند. برای مدل‌هایی که تفکر گسترده را حذف کردهاند، صفحه عیب‌یابی این متن خطا را که عیناً حفظ شده است ارائه میدهد: «"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.» اصلاح: به {"type": "adaptive"} تغییر دهید و عمق را با output_config.effort هدایت کنید.
پارامترهای نمونه‌گیری: فقط پیش‌فرض‌ها
راهنمای رسمی مهاجرت: اگر درخواست شامل temperature باشد، باید برابر 1 باشد و اگر شامل top_p باشد، باید مقدار پیشفرض آن یعنی 0.99 باشد؛ هر مقدار دیگری خطای 400 برمی‌گرداند، از جمله top_p برابر 1. هر مقدار top_k هم همین‌طور است و درخواستی که temperature و top_p را با هم ارسال کند نیز همین‌طور. برای این مورد هیچ متن خطایی منتشر نشده است. راهحل: هر سه را حذف کنید و رفتار را از طریق prompt هدایت کنید.
پایان‌یافتن با نوبت assistant: 400
Haiku 4.5 زمانی که تفکر خاموش است prefill را می‌پذیرد؛ Haiku 5.5 آن را حتی با خاموش بودن تفکر با خطای 400 رد میکند. صفحه خطاها می‌گوید Claude 4.6 و مدل‌های بعدی از prefill پشتیبانی نمی‌کنند، با این پیام: «This model does not support assistant message prefill. The conversation must end with a user message.» اصلاح: پیام‌ها را با یک نوبت user پایان دهید.
ابزار قدیمی computer use: 400
در Claude API و Google Cloud، Haiku 5.5 از computer use فقط از طریق مجموعه‌ابزار computer_toolset_20260801 پشتیبانی میکند، و درخواستی که computer_20250124 را اعلام کند خطای 400 برمی‌گرداند. برای این مورد هیچ متن خطایی منتشر نشده است. اصلاح: هدر بتای computer-use-2025-01-24 را حذف کنید و ورودی tools را با {"type": "computer_toolset_20260801"} جایگزین کنید.
این صفحه به چه چیزی پاسخ میدهد
تا 2026-10-10، اگر پس از جایگزینی claude-haiku-4-5 با claude-haiku-5-5 خطای 400 ظاهر شد، ابتدا درخواست را با پنج تغییر ناسازگار که Anthropic فهرست میکند بررسی کنید. یادداشت انتشار 2026-10-07 به‌روشنی می‌گوید: «کدی که برای Claude Haiku 4.5 نوشته شده است ممکن است روی Claude Haiku 5.5 بشکند.» چهار تغییر دیگر خطایی ایجاد نمی‌کنند اما پاسخ یا شمارش را تغییر می‌دهند: یک پاسخ میتواند با بلوک‌های تفکر آغاز شود؛ متن تفکر بهطور پیشفرض حذف میشود؛ به گفته Anthropic، همان متن تقریباً 30% توکن بیشتر حساب میشود؛ و بلوک‌های تفکر فقط در حساب کاربری‌ای کار میکنند که آنها را تولید کرده است یا حسابی که به آن مرتبط است. این صفحه فقط بدنه درخواست را پوشش میدهد، نه مشخصات یا قیمت‌ها.
2026-10-07: Claude Haiku 5.5 منتشر شد
یادداشت‌های انتشار Anthropic برای 2026-10-07: Claude Haiku 5.5 (claude-haiku-5-5) با پنجره زمینه 1M توکن، حداکثر خروجی 128k توکن و تفکر تطبیقی با پارامتر effort منتشر شد. همین ورودی هشدار میدهد که کدی که برای Haiku 4.5 نوشته شده میتواند بشکند: تفکر گسترده دستی (budget_tokens) خطای 400 برمی‌گرداند؛ تفکر تطبیقی بهطور پیشفرض فعال است، بنابراین یک پاسخ میتواند با بلوک‌های تفکر آغاز شود؛ و همان متن به‌عنوان توکنهای بیشتری شمرده میشود. راهنمای مهاجرت می‌افزاید که claude-haiku-5-5 یک شناسه مدل ثابت بدون پسوند تاریخ و بدون نام مستعار جداگانه است.
سه تاریخ
مرز زمانی حساب برای بررسی نوبت‌های قبلی. بر اساس راهنمای مهاجرت، در حساب‌هایی که پیش از 2026-08-31 00:00 UTC ایجاد شده‌اند، این خطای 400 فقط در درخواستهایی رخ میدهد که thinking.block_binding.prefix_mismatch_behavior را تنظیم میکنند؛ حساب‌هایی که بعداً ایجاد شده‌اند بهطور پیشفرض بررسی میشوند. راهنمای Preserved thinking هشدار میدهد که بنابراین اجرای بدون خطا با کلید قدیمی‌تر خودتان نشان نمیدهد که آیا کد شما تحت تأثیر قرار گرفته است یا نه.
روز انتشار. نمای کلی رسمی می‌گوید «منتشرشده در 7 اکتبر 2026»، anthropic.com همان روز «معرفی Claude Haiku 5.5» را منتشر کرد، و مدخل یادداشت انتشار از پیش هشدار میدهد که کد Haiku 4.5 میتواند بشکند.
در جدول رسمی منسوخ‌سازی، claude-haiku-4-5-20251001 هنوز فعال است، ستون «منسوخ» آن N/A را نشان میدهد، و ستون «تاریخ بازنشستگی احتمالی» آن «نه زودتر از 15 اکتبر 2026» را نشان میدهد — یک حداقل، نه تاریخ خاموشی. ردیف claude-haiku-5-5 «نه زودتر از 7 اکتبر 2027» را نشان میدهد.
لایه‌ها: متن رسمی / آنچه مستندات نمی‌گویند
تأییدشده بهطور رسمی (قابل بررسی واژه‌به‌واژه)
جدول What's new پنج تغییر را به‌عنوان Breaking علامت می‌زند: (1) تفکر گسترده دستی خطا برمی‌گرداند — budget_tokens را با تفکر تطبیقی جایگزین کنید؛ (2) پارامترهای نمونه‌برداری غیرپیشفرض خطا برمی‌گردانند — temperature، top_p و top_k را حذف کنید؛ (3) پیش‌پر کردن پیام assistant خطا برمی‌گرداند — پیام‌ها را با یک نوبت user پایان دهید؛ (4) computer use به toolset روی Claude API و Google Cloud نیاز دارد — computer_20250124 را با computer_toolset_20260801 جایگزین کنید؛ (5) تغییر نوبت‌های قبلی، بلوک‌های تفکر را بی‌اعتبار میکند — اگر بلوک‌های تفکر را برمی‌گردانید، گفتگوها را فقطافزودنی نگه دارید. چهار مورد دیگر با Changed علامت خورده‌اند: پاسخ‌ها می‌توانند با بلوک‌های تفکر آغاز شوند (بلوکها را بر اساس نوع انتخاب کنید)؛ متن تفکر بهطور پیشفرض حذف میشود (برای دریافت خلاصه، display را روی summarized قرار دهید)؛ همان متن به‌عنوان توکنهای بیشتری شمرده میشود (دوباره شمارش کنید و max_tokens و برآوردهای هزینه را بازبینی کنید)؛ و بازپخش بلوک‌های تفکر در میان حساب‌ها (هر گفتگو را از طریق حسابی که آن را تولید کرده بازپخش کنید).
آنچه مستندات نمی‌گویند
منتشر نشده و در اینجا تکمیل نشده است: متن خطای رد شدن پارامترهای نمونه‌برداری و computer_20250124 (راهنمای مهاجرت فقط می‌گوید «خطای 400 برمی‌گرداند»)؛ هیچ بازه معافیت یا برنامه عقب‌گردی برای پنج تغییر؛ تاریخ قطعی خاموشی برای Haiku 4.5 (جدول منسوخ‌سازی فقط «نه زودتر از 2026-10-15» را میدهد)؛ و هیچ ادعایی که چارچوب شخص ثالث مشخصی از پیش سازگار شده است.
دو مقایسه: میان نسل‌ها و درون یک نسل
Haiku 4.5 در برابر Haiku 5.5: تنظیمات تفکر با یکدیگر ناسازگارند
جدول به‌ازای هر مدل در صفحه عیب‌یابی: Haiku 4.5 فقط از تفکر گسترده پشتیبانی میکند، بهطور پیشفرض خاموش است و حالت adaptive را با خطای 400 رد میکند (متن خطایی که صفحه برای مدل‌هایی میدهد که فقط از تفکر گسترده پشتیبانی میکنند: «adaptive thinking is not supported on this model»)؛ Haiku 5.5 فقط از adaptive پشتیبانی میکند، بهطور پیشفرض روشن است و enabled را با خطای 400 رد میکند. اگر در طول مهاجرت هر دو مدل را اجرا می‌کنید، فیلد thinking را برای هر مدل جداگانه بنویسید — یک بدنه درخواست که thinking را حمل میکند نمی‌تواند برای هر دو کارساز باشد.
Haiku 5.5 در برابر Sonnet 5.5: خاموش کردن تفکر و ابزارهای اجباری متفاوت‌اند
Haiku 5.5 مقدار {"type": "disabled"} را در effort high یا پایین‌تر می‌پذیرد و در xhigh یا max خطای 400 برمی‌گرداند؛ Sonnet 5.5 برای disabled در هر سطح effort خطای 400 برمی‌گرداند. Haiku 5.5 یک tool_choice اجباری (any یا یک ابزار نام‌دار) را می‌پذیرد، اما پاسخ با فراخوانی ابزار آغاز میشود و بلوک تفکر ندارد؛ Sonnet 5.5 استفاده اجباری از ابزار را در هر درخواست با خطای 400 رد میکند. دو مهاجرت دقیقاً در همین دو نقطه تفاوت دارند، بنابراین اصلاحی که برای یک مدل نوشته شده نباید روی مدل دیگر کپی شود.
مراحل مهاجرت (طبق چک‌لیست رسمی)
(1) شناسه مدل: در Claude API، claude-haiku-4-5-20251001 یا claude-haiku-4-5 را به claude-haiku-5-5 تغییر دهید. (2) thinking: {"type": "enabled", "budget_tokens": N} را به {"type": "adaptive"} تغییر دهید و میزان thinking را با output_config.effort تنظیم کنید (مثال رسمی از medium استفاده میکند که effort پیشفرض Haiku 5.5 نیز هست)؛ جایی که Haiku 4.5 بدون thinking یا با بودجه کوچک اجرا می‌شد، effort پایین‌تری انتخاب کنید. بلوک‌های پاسخ را بر اساس فیلد type آنها انتخاب کنید؛ max_tokens کوچک میتواند با stop_reason max_tokens پس از یک بلوک thinking و پیش از هر متنی متوقف شود، بنابراین آن را افزایش دهید. (3) temperature، top_p و top_k را حذف کنید. (4) پیام‌ها را با یک نوبت کاربر (user turn) پایان دهید و هر prefill را بر اساس هدف جایگزین کنید: قالب خروجی — structured outputs، یا tools با فیلدهای enum برای دسته‌بندی؛ مقدمه‌ها — در system prompt پاسخ مستقیم بخواهید؛ ادامه‌ها — آنها را به پیام کاربر منتقل کنید؛ یادآورهای زمینه — آنها را در نوبت کاربر قرار دهید. (5) Computer use: هدر بتای computer-use-2025-01-24 را حذف کنید، ورودی tools را با {"type": "computer_toolset_20260801"} جایگزین کنید، مسیریابی را بر اساس name و toolset_name هر بلوک tool_use انجام دهید، و toolset_name را در نتایج بازتاب دهید؛ اگر محیط شما zoom را پیاده‌سازی نمیکند، "configs": {"zoom": {"enabled": false}} را اضافه کنید؛ اگر هدر بتای fine-grained-tool-streaming-2025-05-14 را ارسال می‌کنید، آن را حذف کنید. (6) وقتی بلوک‌های thinking را برمی‌گردانید، system، tools و پیامهای قبلی را دست‌نخورده بگذارید و فقط به انتها اضافه کنید؛ دستورالعمل‌ها را با یک پیام system میان‌گفتگو اضافه کنید. (7) توکن‌ها را با model تنظیم‌شده روی claude-haiku-5-5 دوباره بشمارید. در Claude Code، فرمان رسمی /claude-api migrate تغییر شناسه، تغییرات ناسازگار پارامترها، جایگزینی prefill و کالیبراسیون effort را اعمال میکند، سپس یک چک‌لیست برای تأیید دستی تولید میکند.
سمت QCode: Haiku 5.5 پشتیبانی میشود، با همان کلید
از تاریخ 2026-10-10، QCode از claude-haiku-5-5 پشتیبانی میکند: آن را با همان کلید روی همان نقطه پایانی (https://api.qcode.cc/api) و با تنظیم model روی claude-haiku-5-5 فراخوانی کنید؛ قیمت‌ها با دو سطح رسمی مطابقت دارند؛ طبق صفحه قیمت‌گذاری رسمی، آستانه همه توکنهای ورودی یک درخواست را می‌شمارد، شامل خواندن از کش و نوشتن در کش، و هر درخواست به‌صورت جداگانه قیمت‌گذاری میشود؛ بنابراین درخواستی که از آستانه عبور کند، برای کل درخواست قیمت‌های بالاتر را می‌پردازد، حتی وقتی بخشی از prompt آن از کش خوانده شده باشد. /models و داشبورد برای نرخ‌های واحد مرجع هستند. claude-haiku-4-5-20251001 موجود همچنان روی QCode قابل فراخوانی است (claude-sonnet-5-5 گزینه دیگری است)، بنابراین بدنه درخواست‌های Haiku 4.5 پیش از مهاجرت نیازی به تغییر ندارد. Claude از پروتکل Anthropic Messages استفاده میکند: طبق docs.qcode.cc، Claude Code مقدار ANTHROPIC_BASE_URL=https://api.qcode.cc/api را تنظیم میکند و SDK مسیر /api/v1/messages را می‌سازد؛ یک کلید در همه پروتکل‌ها کار میکند و مسیر درخواست پروتکل را تعیین میکند. صورت‌حساب بر اساس توکن است و قیمت هر مدل در /models قرار دارد. هر پنج تغییر این صفحه در بدنه درخواست قرار دارند و هیچ ارتباطی با Base URL ندارند: ابتدا بدنه را اصلاح کنید و پس از آن فقط model را به claude-haiku-5-5 تغییر دهید.
پرسش‌های متداول
Haiku 5.5 خطای 400 مربوط به temperature برمی‌گرداند — چگونه آن را برطرف کنم؟
temperature، top_p و top_k را از درخواست حذف کنید. راهنمای مهاجرت می‌گوید: اگر temperature وجود دارد باید 1 باشد، اگر top_p وجود دارد باید مقدار پیشفرض آن یعنی 0.99 باشد، و هر مقدار دیگری خطای 400 برمی‌گرداند، از جمله top_p برابر 1؛ هر مقدار top_k و هر درخواستی که هم temperature و هم top_p را ارسال کند نیز 400 برمی‌گرداند. مستندات Thinking اضافه میکند که این موضوع در هر درخواست اعمال میشود، چه thinking استفاده شود چه نه. هیچ متن خطایی برای این حالت منتشر نشده است و این صفحه متنی از خود نمی‌سازد.
آیا budget_tokens هنوز کار میکند؟ اگر بخواهم thinking را کاملاً خاموش کنم چه میشود؟
خیر. مقدار thinking برابر enabled همراه با budget_tokens خطای 400 برمی‌گرداند؛ به {"type": "adaptive"} تغییر دهید و عمق را با output_config.effort هدایت کنید. برای خاموش کردن thinking، Haiku 5.5 مقدار {"type": "disabled"} را در effort برابر high یا کمتر می‌پذیرد؛ در xhigh یا max، خطای 400 با این متن برمی‌گردد: output_config.effort 'xhigh' is not supported when thinking is disabled on this model. از effort برابر 'high' یا کمتر استفاده کنید، یا thinking را فعال کنید. Anthropic پارامتر effort را روش بهتر برای مبادله کیفیت با سرعت و هزینه نسبت به خاموش کردن thinking می‌داند.
اولین بلوک محتوا اکنون یک بلوک thinking است — آیا این یک باگ است؟
خیر. تفکر تطبیقی در Haiku 5.5 بهطور پیشفرض فعال است، بنابراین پاسخ میتواند با یک یا چند بلوک تفکر آغاز شود، حتی وقتی درخواست به تفکر اشاره نمیکند؛ بلوکها را بر اساس فیلد type آنها انتخاب کنید، نه بر اساس موقعیت. بهطور پیشفرض هر بلوک تفکر با فیلد thinking خالی و فقط یک امضا بازمیگردد؛ برای دریافت خلاصه، {"type": "adaptive", "display": "summarized"} را تنظیم کنید. توکنهای تفکر در max_tokens محاسبه میشوند، بنابراین یک محدودیت کوچک میتواند پس از یک بلوک تفکر و پیش از هر متنی متوقف شود.
معنای «The block is bound to a different conversation» در خطا چیست؟
یعنی پیش از یک بلوک تفکر که شما بازفرستادهاید، prompt سیستم، ابزارها یا پیامهای قبلی تغییر کردهاند. Haiku 4.5 این بررسی را انجام نمیدهد. در حسابهای کاربری ایجادشده پیش از 2026-08-31 00:00 UTC، خطا فقط در درخواستهایی ظاهر میشود که thinking.block_binding.prefix_mismatch_behavior را تنظیم میکنند؛ حسابهای جدیدتر آن را بهطور پیشفرض دریافت میکنند. ارسال دوباره همان بدنه آن را برطرف نمیکند. راهحل: مکالمه را فقطافزودنی نگه دارید و دستورها را با یک پیام سیستم میانمکالمه اضافه کنید، نه با ویرایش system یا tools؛ برای عبور درخواست فعلی، هدر بتا thinking-binding-controls-2026-08-01 را با تنظیم prefix_mismatch_behavior روی drop_block ارسال کنید.
آیا یک مسیر کد میتواند در طول مهاجرت Haiku 4.5 و Haiku 5.5 را هم‌زمان اجرا کند؟
با بدنه درخواستی که تفکر دارد، خیر. در جدول رسمی هر مدل، Haiku 4.5 فقط extended thinking را پشتیبانی میکند و adaptive را رد میکند، در حالی که Haiku 5.5 فقط adaptive را پشتیبانی میکند و enabled را رد میکند. پیش‌فرض‌های آنها هم متفاوت است: تفکر در Haiku 4.5 بهطور پیشفرض خاموش است و در Haiku 5.5 بهطور پیشفرض روشن است. فیلد thinking را بر اساس مدل شاخه‌بندی کنید.
Haiku 4.5 چه زمانی بازنشسته میشود — آیا باید همین حالا مهاجرت کنید؟
هیچ تاریخ خاموشسازی منتشر نشده است. در 2026-10-10، جدول منسوخشدن، claude-haiku-4-5-20251001 را با وضعیت فعال فهرست میکند، با «نامشخص» در ستون منسوخ و «نه پیش از 15 اکتبر 2026» در ستون تاریخ بازنشستگی تقریبی — یک حداقل، نه تاریخ خاموشی. ردیف claude-haiku-5-5 عبارت «نه پیش از 7 اکتبر 2027» را نشان میدهد. زمان مهاجرت را باید با آزمون روی بار کاری خودتان تعیین کنید.
منابع
مستندات رسمی Anthropic: صفحه تازه‌های Claude Haiku 5.5، راهنمای مهاجرت و مرور کلی مدل؛ مدخل یادداشت‌های انتشار API در 2026-10-07؛ صفحات عیب‌یابی تفکر، تفکر حفظ‌شده، تفکر و خطاهای API؛ صفحه ابزار استفاده از رایانه؛ جدول منسوخشدن مدل‌ها؛ و صفحه اخبار anthropic.com. در سمت QCode فقط از صفحه docs.qcode.cc درباره نقاط پایانی و مسیرهای API استفاده شده است. همه در 2026-10-10 واکشی شده‌اند و رشته‌های خطا عیناً حفظ شده‌اند.
ابتدا بدنه درخواست را اصلاح کنید، سپس مدل را عوض کنید
یک کلید QCode میتواند claude-haiku-4-5-20251001، claude-sonnet-5-5 و claude-opus-5-5 را فراخوانی کند؛ هزینه به‌ازای هر توکن و با قیمت هر مدل در /models محاسبه میشود؛ claude-haiku-5-5 نیز پشتیبانی میشود، بنابراین با همان کلید می‌توانید با تغییر مدل، بین مدل‌ها جابه‌جا شوید.
مطالب مرتبط
Claude API 2026-10-21: حذف پارامترهای نمونه‌گیری و نحوه مهاجرت
بررسی‌شده در 2026-10-26: Claude API 2026-10-21 پارامترهای temperature، top_p و top_k را حذف میکند و برای هر مدل 400 برمی‌گرداند؛ هیچ تاریخی برای منسوخشدن 2023-06-01 وجود ندارد؛ نسخه‌های SDK و مراحل مهاجرت.
ردیاب وضعیت Haiku 5.5
جدول زمانی رسمی و آنچه درباره Haiku 5.5 دانسته میشود؛ این صفحه فقط خطاهای مهاجرت و راه‌حل‌ها را پوشش میدهد.
راه‌اندازی نقطه پایانی سفارشی Claude Code
نحوه تنظیم دو متغیر ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN برای اینکه Claude Code به یک نقطه پایانی API سفارشی اشاره کند.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
بررسی‌شده در 2026-10-10؛ صفحات رسمی Anthropic مرجع هستند و تغییرات ممکن است بدون اطلاع رخ دهند. رشته‌های خطا عیناً و بدون ترجمه حفظ میشوند؛ جایی که مستندات هیچ متن خطایی منتشر نکرده‌اند، این صفحه فقط می‌گوید «returns a 400 error». درصدهایی مانند افزایش توکن، ارقام خود Anthropic هستند. در دسترس بودن مدل از /models تبعیت میکند. QCode وابسته به Anthropic نیست.