عیب‌یابی · effort × thinking

زمانی که thinking غیرفعال است، پشتیبانی نمی‌شود
xhigh / max به‌همراه خاموش بودن thinking منجر به 400 می‌شود؛ 2.1.251 به‌جای آن high می‌فرستد

از 2026-10-20، این خطای 400 یعنی سطح effort و کلید thinking با هم سازگار نیستند: Opus 5 و Haiku 5.5 اجازه می‌دهند thinking در high و پایین‌تر از آن خاموش باشد، اما در xhigh یا max باید روشن باشد؛ در حالی که Opus 5.5 و Fable 5.1 هرگز اجازه خاموش بودن آن را نمی‌دهند. راه‌حل یک‌مرحله‌ای روشن کردن thinking است؛ در مدل‌هایی که خاموش بودن آن را مجاز می‌دانند، کاهش effort به high یا پایین‌تر نیز کار می‌کند. Claude Code 2.1.251 (2026-08-28) درخواست‌های Opus 5 را که با effort در xhigh/max و در حالی که thinking خاموش بود شکست می‌خوردند، اصلاح کرد؛ متن خطا این است: effort … is not supported when thinking is disabled، و کلاینت در آن ترکیب effort را high می‌فرستد.

به‌روزرسانی شده 2026-11-14

یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورت‌حساب به‌ازای توکن، آماده به کار در چند دقیقه.

#زمانی که thinking غیرفعال است، پشتیبانی نمی‌شود#xhigh / max#Claude Code 2.1.251#HTTP 400

چهار واقعیت که می‌توانید به آن‌ها استناد کنید

زمانی که thinking غیرفعال است، پشتیبانی نمی‌شود

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

اغلب جمله کامل این است: output_config.effort 'xhigh' is not supported when thinking is disabled on this model. این نیم‌جمله با changelog و issueها مطابقت دارد.

xhigh / max

سطوحی که با thinking غیرفعال قابل ترکیب نیستند

متن رسمی بررسی‌شده در 2026-10-20 اکنون به‌ازای هر مدل است: در API، Opus 5.5 و Fable 5.1 در هیچ سطح effort نمی‌توانند thinking را خاموش داشته باشند (خاموش کردن آن منجر به 400 می‌شود)؛ Haiku 5.5 و Opus 5 می‌توانند آن را در high و پایین‌تر خاموش کنند، در حالی که xhigh یا max به‌همراه thinking خاموش، 400 برمی‌گرداند؛ Sonnet 5.5 حالت thinking غیرفعال را رد می‌کند، و thinking اولیه در آن با thinking: {type: "between_tools"} خاموش می‌شود، که خودش در xhigh یا max شکست می‌خورد.

2.1.251

مجموعه اصلاحات Claude Code

changelog 2026-08-28: درخواست‌های Opus 5 را که با آن متن تحت‌اللفظی شکست می‌خوردند، زمانی که effort برابر xhigh/max بود و thinking خاموش شده بود، اصلاح کرد؛ اکنون در آن حالت effort به‌صورت high فرستاده می‌شود.

400

این خطای 429 مربوط به سهمیه نیست

ترکیب پارامترها رد می‌شود. نه به‌دلیل سقف هفتگی است و نه به‌دلیل اینکه موجودی اعتبار خیلی کم است. تلاش دوباره با همان body همچنان 400 می‌دهد.

effort و thinking دو پیچ تنظیم جداگانه‌اند

مرکز راهنمایی Anthropic این‌گونه بیان می‌کند: effort تعیین می‌کند هر مرحله چقدر دقیق باشد، thinking تعیین می‌کند آیا استدلال ابتدا در یک بلوک قابل گسترش نمایش داده می‌شود یا نه. این دو با هم ترکیب می‌شوند، اما نه در هر ترکیبی. متن بررسی‌شده در 2026-10-20 مدل‌به‌مدل است: Opus 5 به‌طور پیش‌فرض thinking می‌کند و API اجازه می‌دهد thinking در high و پایین‌تر خاموش شود، در حالی که خاموش کردن آن در سطوح بالاتر رد می‌شود؛ Fable 5 و کلاس Mythos حالت thinking غیرفعال را کاملاً رد می‌کنند. از 2026-10-20 دو مدل دیگر هم به آن فهرست تعلق دارند: Opus 5.5 و Fable 5.1 در هیچ سطح effort نمی‌توانند thinking خاموش داشته باشند، و Sonnet 5.5 می‌خواهد thinking: {type: "between_tools"} باشد.

چرا کلاینت یک ترکیب غیرمجاز ارسال کرد

بررسی‌شده در 2026-10-20: مقاله مرکز راهنمایی «Change the model, effort, and thinking settings» اکنون به‌ازای هر مدل مشخص می‌کند آیا thinking می‌تواند خاموش شود یا نه - در Claude، برای Haiku 5.5، Sonnet 5.5، Opus 5.5، Fable 5.1 و Opus 5 اصلاً نمی‌توان آن را خاموش کرد، و در Opus 5.5 و Fable 5.1 نیز در API در هر سطح effort همیشه روشن است؛ Haiku 5.5 و Opus 5 می‌توانند آن را در high و پایین‌تر خاموش کنند، و xhigh یا max با thinking خاموش خطا می‌دهد؛ Sonnet 5.5 از تنظیم جدید between_tools برای خاموش کردن thinking اولیه استفاده می‌کند. issue در GitHub از زمان Opus 4.8 وجود داشته است: با alwaysThinkingEnabled: true و effortLevel: xhigh در تنظیمات، برخی درخواست‌ها همچنان thinking را حذف می‌کنند و در عین حال xhigh می‌فرستند؛ از این رو 400 رخ می‌دهد. اصلاح 2.1.251 یک تنزل سمت کلاینت است: در آن حالت high می‌فرستد. خود اعتبارسنجی در API باقی می‌ماند.

خط زمانی

از 2026-07 (ردپای issue)

anthropics/claude-code#76689 و موارد مشابه، متن تحت‌اللفظی 400 را ثبت می‌کنند: output_config.effort 'xhigh' is not supported when thinking is disabled on this model.

متن مستندشده (بازیابی‌شده در 2026-10-20)

مستندات رسمی بازیابی‌شده در 2026-10-20: Opus 5 می‌تواند thinking را در high و پایین‌تر خاموش کند، xhigh/max به‌همراه خاموش بودن، 400 می‌دهد؛ Fable 5 / Mythos 5 حالت thinking غیرفعال را رد می‌کنند؛ Opus 5.5 و Fable 5.1 در هیچ سطحی نمی‌توانند thinking را خاموش کنند؛ Haiku 5.5 می‌تواند آن را در high و پایین‌تر خاموش کند؛ Sonnet 5.5 می‌خواهد thinking: {type: "between_tools"} باشد.

2026-08-28 · 2.1.251

changelog Claude Code این خطا را باگ می‌نامد و آن را با فرستادن effort به‌صورت high اصلاح می‌کند. همان انتشار PreModelSwitch را اضافه می‌کند. ارتقای کلاینت باعث نمی‌شود API ترکیب xhigh+disabled را بپذیرد.

تأییدشده در برابر اشتباه

تأییدشده

زیررشته عبارت، خطای 400، عدم امکان استفاده هم‌زمان xhigh/max و خاموش بودن thinking، ارسال high توسط کلاینت در 2.1.251، و مجاز بودن خاموش کردن thinking در Opus 5 در high و پایین‌تر، همه از changelog و مستندات پلتفرم آمده‌اند (بررسی‌شده در 2026-10-20). دو مورد دیگر نیز در 2026-10-20 تأیید شد: قواعد هر مدل در مرکز راهنما، و نسخه فعلی Claude Code یعنی 2.1.304.

اشتباه‌های رایج

«این تمام شدن سهمیه است» - وضعیت 400 است و متن درباره effort/thinking است. «ارتقا به 2.1.251 باعث می‌شود بتوانم max را با thinking خاموش استفاده کنم» - اصلاح، آن را به high تنزل می‌دهد و این محدودیت را برنمی‌دارد. «تغییر هدرهای درخواست باعث عبور آن می‌شود» - سرور ترکیب پارامترها را اعتبارسنجی می‌کند و مستندات رسمی ترکیب‌های مجاز effort و thinking را ارائه می‌دهند. بازبینی مجدد با مستندات رسمی در 2026-10-20: این محدودیت برای هر مدل جداگانه نوشته شده است، بنابراین جمله «high و پایین‌تر» مربوط به Opus 5 را به همه idها تعمیم ندهید.

خاموش کردن thinking در برابر حفظ effort

باید thinking را خاموش کنید: effort را به high یا پایین‌تر کاهش دهید

ترکیب مستندشده عبارت است از thinking خاموش + high/medium/low. وقتی xhigh/max را انتخاب می‌کنید و thinking را خاموش می‌کنید، Claude Code 2.1.251 خودش high را ارسال می‌کند. فراخوانی مستقیم API یعنی خودتان output_config.effort را تغییر دهید. یک نکته از عبارت بررسی‌شده در 2026-10-20: Sonnet 5.5 نمی‌تواند از disabled استفاده کند و به thinking: {type: "between_tools"} نیاز دارد.

باید xhigh / max را حفظ کنید: thinking را فعال کنید

xhigh/max نیازمند روشن بودن thinking است (Opus 5 و مدل‌های جدیدتری که این محدودیت را دارند). در Fable 5 به‌هیچ‌وجه نمی‌توان thinking را خاموش کرد، بنابراین طبق مستندات این خطای 400 نباید روی آن مدل‌ها ظاهر شود. در عبارت بررسی‌شده در 2026-10-20، Haiku 5.5 مانند Opus 5 رفتار می‌کند (خاموش کردن thinking فقط در high و پایین‌تر)، Opus 5.5 و Fable 5.1 در هیچ سطحی نمی‌توانند thinking را خاموش کنند، و Sonnet 5.5 مقدار disabled را رد می‌کند و به thinking: {type: "between_tools"} نیاز دارد.

چه کاری انجام دهید (ترکیب رسمی؛ نیازی به تغییر پلتفرم نیست)

ابتدا بررسی کنید آیا متن شامل is not supported when thinking is disabled است یا نه. سپس بررسی کنید آیا effort برابر xhigh/max است و thinking خاموش است. یکی را انتخاب کنید: effort را کاهش دهید یا thinking را روشن کنید. Claude Code را به 2.1.251 یا جدیدتر ارتقا دهید (نسخه فعلی در 2026-10-20 برابر 2.1.304 است) تا کلاینت ارسال ترکیب غیرمجاز را متوقف کند. ترکیب مجاز هر مدل را در مستندات رسمی thinking جست‌وجو کنید.

این خطای 400 خطای موجودی QCode نیست

این خطای 400 به معنای رد کردن یک ترکیب پارامتر توسط API مدل است. QCode به‌ازای هر توکن شارژ می‌کند، نرخ‌های هر مدل در /models است، و همان Messages API را فوروارد می‌کند: ترکیب غیرمجاز effort/thinking فقط به این دلیل که از یک رله عبور کرده، مجاز نمی‌شود. Opus 5 در جدول مصرف فراخوانی‌های واقعی دارد؛ چیزی که باید اصلاح شود، بدنه درخواست است.

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

خطای کامل چه شکلی است؟

معمولاً: API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. برای تطبیق، از is not supported when thinking is disabled استفاده کنید.

آیا پس از 2.1.251 هم باید ارتقا داد؟

بله. کلاینت‌های قدیمی‌تر هنوز می‌توانند xhigh + thinking خاموش را تولید کنند. پس از ارتقا، کلاینت high ارسال می‌کند؛ فراخوانندگان مستقیم API همچنان باید از این ترکیب ناسازگار پرهیز کنند.

آیا Sonnet 5 هم این کار را می‌کند؟

مستندات رسمی برای هر مدل مشخص می‌کنند که آیا thinking می‌تواند خاموش شود یا نه. عبارت تأییدشده در 2026-10-20: Opus 5 و Haiku 5.5 آن را در high و پایین‌تر مجاز می‌دانند و بالاتر از آن خطای 400 برمی‌گردانند؛ Opus 5.5 و Fable 5.1 آن را در هیچ سطحی مجاز نمی‌دانند؛ Sonnet 5.5 مقدار disabled را رد می‌کند و به thinking: {type: "between_tools"} نیاز دارد. برای سایر مدل‌ها، جدول را در مستندات thinking بخوانید و جمله یک مدل را به همه idها تعمیم ندهید.

چرا alwaysThinkingEnabled: true همچنان شکست می‌خورد؟

گزارش‌های مشکل نشان می‌دهند که کلاینت بلوک thinking را حذف می‌کند اما همچنان xhigh را ارسال می‌کند. این ردپای یک باگ کلاینت است؛ نسخه 2.1.251 آن را به سطح پایین‌تر می‌برد. فرض نکنید که این تنظیم در هر درخواست معادل روشن بودن thinking است.

آیا به سقف ماهانه / اعتبار مربوط است؟

نه. آن‌ها 429 بدون retry-after هستند، یا اعتبار پیش‌پرداخت صفر است. این یک رد پارامتر با کد 400 است.

آیا QCode مقدار xhigh را به high بازنویسی می‌کند؟

بازنویسی در Claude Code 2.1.251 در کلاینت رسمی انجام می‌شود: وقتی xhigh/max را همراه با thinking خاموش می‌بیند، high ارسال می‌کند. مستندات Anthropic ترکیب‌های مجاز را تعریف می‌کنند؛ این بازنویسی رفتار کلاینت است، نه وعده یک نماینده فروش.

منابع

خط اصلاح و عبارت‌پردازی از تغییرات Claude Code 2.1.251 (2026-08-28)، به‌همراه نسخه فعلی 2.1.304 (دریافت‌شده در 2026-10-20). مستندات thinking در https://docs.claude.com/en/docs/build-with-claude/thinking.md و یادداشت‌های effort / thinking در platform.claude.com (بررسی‌شده در 2026-10-20). نمونه‌ای از متن خطا در anthropics/claude-code#76689 است. مقاله مرکز راهنمایی درباره تغییر مدل، effort و thinking (support.claude.com/en/articles/8664678-change-the-model-effort-and-thinking-settings، بررسی‌شده در 2026-10-20، به‌ازای هر مدل درباره اینکه آیا thinking می‌تواند خاموش شود و در between_tools روشن شود).

پیش از چرخش کلیدها، ترکیب پارامترها را اصلاح کنید

خطای 400 از xhigh/max به‌همراه خاموش‌بودن thinking می‌آید. به Claude Code 2.1.251 (اکنون 2.1.304) بروید، یا effort را پایین بیاورید / thinking را مطابق مستندات روشن کنید. QCode به‌ازای هر توکن شارژ می‌کند؛ نرخ‌های هر مدل در /models است.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط