Claude Code پشت گیتویهای شخص ثالث: خطاهای رایج و راهحلهای رسمی (2026، تا 2.1.310)
تا تاریخ 2026-10-26، آخرین اصلاحات گیتوی 2.1.305 (رگرسیون tool search از 2.1.304: وقتی نقطه پایانی یا یک گیتوی tool search را رد میکند، Claude Code بهجای شکست هر درخواست، بدون آن دوباره تلاش میکند) و 2.1.310 (وقتی یک گیتوی یا سرور سازگار مقدار beta مربوط به effort-2025-11-24 یا پیامهای سیستمی در میانه مکالمه را رد میکند، Claude Code بدون آنها دوباره تلاش میکند) هستند. تا تاریخ 2026-10-07، خطاهای رایج 400 که Claude Code پشت یک گیتوی شخص ثالث یا یک ANTHROPIC_BASE_URL سفارشی نشان میدهد، هرکدام یک راهحل یا راهحل موقت رسمی دارند: «400 … Input tag 'advisor_20260301'» در 2.1.276 و نسخههای بعدی برطرف شده است؛ اگر گیتوی شما خروجیهای ساختاریافته را رد میکند، CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 را تنظیم کنید که در 2.1.288 اضافه شد؛ و درخواستهایی که وقتی یک گیتوی یک هدر beta را با وضعیتی غیر از 400 رد میکرد شکست میخوردند، در 2.1.290 برطرف شدند. برای «Extra inputs are not permitted»، مرجع رسمی خطا گیتویی را مقصر میداند که هدر anthropic-beta را حذف کرده است؛ از آن بخواهید هدر را بدون تغییر ارسال کند. این صفحه متن دقیق، علت و راهحل هر خطا را با نقل از تغییرنامه رسمی Claude Code و مستندات گیتوی فهرست میکند.
بهروزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدلهای پیشروی چینی، با صورتحساب بهازای توکن، آماده به کار در چند دقیقه.
- صورتحساب بهازای توکن — نرخهای زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعالسازی فوری
چهار نسخه و هدر که باید به خاطر بسپارید
خطای 400 مربوط به advisor_20260301 را برطرف میکند
بر اساس تغییرنامه رسمی، وقتی ANTHROPIC_BASE_URL به یک پروکسی یا گیتوی اشاره میکرد، هر درخواست با «400 … Input tag 'advisor_20260301'» شکست میخورد — رگرسیون 2.1.275 که در 2.1.276 برطرف شد و در 2026-09-18 منتشر شد.
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS را اضافه میکند
عناوین نشست، بازیابی حافظه و هوکهای prompt را که پشت گیتویهایی که خروجیهای ساختاریافته را رد میکنند شکست میخورند، برطرف میکند. تنظیم آن روی 1 فقط فیلد output_config.format و مقدار beta جفتشده با آن را حذف میکند؛ سایر قابلیتهای پیشانتشار فعال میمانند.
رد شدن هدر beta با وضعیت غیر 400 را برطرف میکند
بر اساس تغییرنامه رسمی: درخواستهایی را برطرف میکند که پشت پروکسیها و گیتویهایی شکست میخورند که یکی از هدرهای beta مربوط به Claude Code را با وضعیتی غیر از 400 یا همراه با یک beta دوم رد میکنند (انتشار: 2026-10-05).
هدرهایی که گیتوی باید بدون تغییر ارسال کند
بر اساس راهنمای رسمی سازگاری گیتوی: هر دو را بدون تغییر ارسال کنید و مقادیر تکتک anthropic-beta را در فهرست مجاز قرار ندهید، زیرا این مجموعه با انتشارهای Claude Code تغییر میکند.
چرا بهمحض قرار گرفتن یک گیتوی در مسیر، خطاهای 400 ظاهر میشوند
تا تاریخ 2026-10-26، دو اصلاح دیگر مربوط به گیتوی پس از 2.1.304 اعمال شدهاند: 2.1.305 رگرسیون جستجوی ابزار از 2.1.304 را برطرف میکند، و 2.1.310 درخواستهایی را که وقتی یک گیتوی مقدار beta مربوط به effort-2025-11-24 یا پیامهای سیستمی در میانه مکالمه را رد میکند شکست میخورند برطرف میکند. تا تاریخ 2026-10-07، خطاهای 400 مربوط به Claude Code پشت یک گیتوی شخص ثالث دو منبع اصلی دارند. یکی رگرسیونهای سمت کلاینت است — شِمای ابزار Artifact در 2.1.265 تا 2.1.267 و ورودی ابزار advisor در 2.1.275 — که یک ارتقا آن را برطرف میکند. دیگری گیتویای است که هدرهای beta را همراه با فیلدهای بدنه درخواست که با آنها جفت میشوند ارسال نمیکند. راهنمای رسمی سازگاری میگوید Claude Code با گیتوی ANTHROPIC_BASE_URL مانند یک نقطه پایانی با قالب Anthropic رفتار میکند و همان هدرهای beta و فیلدهای بدنهای را برای آن میفرستد که به api.anthropic.com میفرستد؛ گیتویای که هدر را حذف میکند و در همان حال بدنه را عبور میدهد، یا بدنه را به سرویسی با شِمای متفاوت ارسال میکند، خطاهای سخت 400 تولید میکند؛ و تنها زمانی که هر دو نیمه با هم غایب باشند، قابلیت بیسروصدا خاموش میشود. این راهنما میافزاید که گیتویای که بدنههای درخواست را برای بازرسی محتوا بازنویسی میکند، جفتشدگی را به همین شکل میشکند.
اصلاحات گیتوی 2.1.305/2.1.310 و قانون 1M در 2.1.285
2.1.305 (2026-10-20 UTC) رگرسیون جستجوی ابزار پشت دروازه در 2.1.304 را برطرف میکند: وقتی نقطه پایانی یا یک دروازه جستجوی ابزار را رد میکند، یا یک دروازه ToolSearch را مجاز نمیداند، همه درخواستها شکست میخوردند؛ Claude Code اکنون بدون جستجوی ابزار دوباره تلاش میکند. 2.1.307 (2026-10-21 UTC) /claude-api api-version را اضافه میکند تا کد Claude API به نسخه API 2026-10-21 منتقل شود. 2.1.310 (2026-10-23 UTC) مشکل شکست درخواستها را زمانی برطرف میکند که یک دروازه یا سرور سازگار مقدار beta مربوط به effort-2025-11-24 یا پیامهای سیستمی میانگفتگو را رد میکند، با تلاش دوباره بدون آنها. در تاریخچه تغییرات Claude Code 2.1.285 (منتشرشده در 2026-09-29) آمده است: «نشستهای پشت یک ANTHROPIC_BASE_URL سفارشی را تغییر داد تا از پنجره زمینه 1M مدلهایی که آن را دارند (Opus 4.7+، Sonnet 5+، Fable) استفاده کنند؛ اگر دروازه شما در 200K متوقف میشود، /autocompact 200k را اجرا کنید». به عبارت دیگر، مدلهای دارای پنجره 1M (Opus 4.7+، Sonnet 5+، Fable) پشت یک نقطه پایانی سفارشی با 1M اجرا میشوند، و زمانی که دروازه در 200K متوقف میشود، /autocompact 200k را اجرا میکنید. صفحه رسمی پیکربندی مدل میافزاید که Claude Code نمیتواند محدودیت کمتری را که دروازه یا سرور پشت آن اعمال میکند تشخیص دهد؛ اگر دروازه شما درخواستهای بالای 200K توکن را رد میکند، CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 را در محیطی که Claude Code را راهاندازی میکند تنظیم کنید.
خط زمانی (تاریخهای انتشار GitHub)
Claude Code 2.1.276 منتشر میشود و مشکل شکست خوردن همه درخواستها با «400 … Input tag 'advisor_20260301'» را زمانی که ANTHROPIC_BASE_URL به یک پروکسی یا دروازه اشاره میکند برطرف میکند — رگرسیونی از 2.1.275 که روز قبل منتشر شده بود.
2.1.288 با CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS جدید منتشر میشود؛ روز قبل، 2.1.287 باعث شد CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS قالب structured-output را نیز از درخواستهای عنوان نشست و prompt-hook حذف کند.
2.1.290 منتشر میشود و شکست درخواستها را زمانی برطرف میکند که یک دروازه یک هدر beta را با وضعیتی غیر از 400 یا همراه با یک beta دوم رد میکند. در بررسی پیشتر در 2026-10-07، آخرین نسخه 2.1.292 بود (منتشرشده در 2026-10-06)؛ تا 2026-10-26 آخرین نسخه 2.1.310 است (منتشرشده در 2026-10-23).
تأییدشده در برابر تأییدنشده
تأییدشده (عیناً در منابع رسمی)
افزودهشده تا 2026-10-26: مدخل 2.1.305 میگوید این یک رگرسیون 2.1.304 است و اینکه Claude Code بدون جستجوی ابزار دوباره تلاش میکند؛ مدخل 2.1.310 میگوید وقتی مقدار beta با نام effort-2025-11-24 یا پیامهای سیستمی میانگفتگو رد میشوند، بدون آنها دوباره تلاش میکند. همه موارد زیر را میتوان کلمهبهکلمه در changelog و مستندات رسمی Claude Code بررسی کرد: 2.1.276 خطای 400 مربوط به advisor_20260301 را برطرف میکند (یک رگرسیون 2.1.275)، و از 2.1.280، وقتی advisor روشن است، Claude Code پس از همان رد شدن یک بار بدون آن مدخل دوباره تلاش میکند؛ 2.1.287 دامنه CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS را به قالب structured-output گسترش میدهد، و 2.1.288 متغیر CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS را اضافه میکند؛ 2.1.290 مشکل هدرهای beta را که با وضعیتی غیر از 400 رد میشوند برطرف میکند؛ از 2.1.285، مدلهای دارای پنجره 1M پشت نقاط پایانی سفارشی بهطور پیشفرض با 1M اجرا میشوند؛ یک دروازه باید anthropic-version (در حال حاضر 2023-06-01) و anthropic-beta را بدون تغییر ارسال کند؛ و چون بازیابی Claude Code بر اساس عبارت خطا تطبیق داده میشود، بدنه پاسخهای خطا نیز باید بدون تغییر ارسال شوند. تاریخهای انتشار از GitHub Releases میآیند.
تأییدنشده یا بهصورت رسمی بیاننشده
سه پرسش پاسخ رسمی ندارند، پس از آنها نتیجهگیری نکنید. نخست، مدخل changelog مربوط به 2.1.290 هیچ متن خطایی نمیدهد و هدر beta دخیل را نام نمیبرد. دوم، اینکه دروازه شما کدام هدرها را ارسال میکند، کدام فیلدها را اعتبارسنجی میکند و حد زمینه آن چقدر است به همان دروازه بستگی دارد؛ مستندات رسمی در این باره پاسخی نمیدهند، و Claude Code نمیتواند حد پایینتری را که دروازه اعمال میکند تشخیص دهد. سوم، مجموعه قابلیتهایی که Claude Code ارسال میکند با هر انتشار بیشتر میشود، و توصیه رسمی این است که دروازه خود را در برابر انتشارهای جدید آزمایش کنید نه اینکه فهرستی مشاهدهشده را قطعی کنید — بنابراین این فهرست نهایی نیست، و وعدهای داده نمیشود که هر دروازهای، از جمله QCode، مقدار beta خاصی را بپذیرد. ④ مدخلهای 2.1.305 و 2.1.310 هیچ متن خطایی برای این رد شدنها نمیدهند و نمیگویند کدام دروازهها یا سرورهای سازگار آنها را رد میکنند.
کدام راهحل: ارتقا، تغییر دروازه، یا تنظیم یک متغیر
ارتقای Claude Code در برابر یک متغیر موقت
برای رگرسیونهای سمت کلاینت، ابتدا ارتقا دهید: خطای 400 طرحواره ابزار در 2.1.265–2.1.267 از 2.1.268 برطرف شده است و مورد advisor_20260301 در 2.1.275 از 2.1.276 برطرف شده است. اگر هنوز نمیتوانید ارتقا دهید، راهحلهای موقت رسمی بهترتیب خاموش کردن ابزار Artifact (CLAUDE_CODE_DISABLE_ARTIFACT=1) و تنظیم CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 هستند. برای ارتقا، صفحه راهاندازی رسمی دستور claude update را میدهد؛ برای نصب با npm، دستور npm install -g @anthropic-ai/claude-code@latest را میدهد.
DISABLE_EXPERIMENTAL_BETAS در برابر DISABLE_STRUCTURED_OUTPUTS
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 گسترده است: مدیریت context و فیلد context_management آن، فیلدهای ابزار بتا مانند strict و defer_loading، فیلد output_config.format خروجی ساختیافته (2.1.287+) و output_config.task_budget و جستوجوی ابزار MCP را حذف میکند. مقادیر بتا برای context گسترده، thinking درهمآمیخته و effort، و نه مقادیری که خودتان از طریق ANTHROPIC_BETAS اضافه میکنید، حذف نمیشوند. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 (2.1.288+) تنها فیلد format خروجی ساختیافته و مقدار بتای همراه آن را حذف میکند و سایر قابلیتهای پیشانتشار را روشن باقی میگذارد.
متن خطا ← علت ← رفع، یکبهیک
① «400 … Input tag 'advisor_20260301'» در هر درخواست ← در طول عرضه تدریجی در 2.1.275، درخواستها حتی وقتی advisor خاموش است شامل یک ورودی ابزار advisor هستند، و یک gateway که انواع ابزار را اعتبارسنجی میکند کل درخواست را رد میکند ← به 2.1.276 یا بالاتر ارتقا دهید؛ در 2.1.275، CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 را تنظیم کنید. وقتی advisor روشن است، از 2.1.280 Claude Code یک بار بدون آن ورودی دوباره تلاش میکند و advisor را برای آن Base URL تا زمان خروج کنار میگذارد. ② «API Error: 400 ... Extra inputs are not permitted ... context_management» ← یک proxy یا gateway LLM هدر درخواست anthropic-beta را حذف کرده بود، بنابراین API فیلدهایی را که به آن وابستهاند رد کرد ← از gateway بخواهید anthropic-beta را بدون تغییر ارسال کند؛ بهعنوان گزینه جایگزین، CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید. Claude Code این 400ها را دوباره تلاش نمیکند. ③ خطای «Unexpected value(s)» برای هدر anthropic-beta → gateway یک مقدار beta را رد میکند ← CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید؛ درخواستهایی که به این دلیل شکست میخورند که gateway یک هدر beta را با وضعیتی غیر از 400 رد میکند، یا همراه با یک beta دوم، در 2.1.290 اصلاح شدهاند (تغییرات برای این مورد متن خطایی ارائه نمیدهد)؛ خطای «API Error: 400» در هر نوبت پشت یک gateway که پاسخهای خطا را بازنویسی میکند، در 2.1.275 اصلاح شد. ④ یک 400 که به output_config اشاره میکند، اغلب «Extra inputs are not permitted»، همراه با شکست عنوانهای نشست، یادآوری حافظه یا hookهای prompt ← سرویس پشت gateway فیلدهای structured-output را رد میکند ← در 2.1.288 یا بالاتر، CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 را تنظیم کنید که فقط فیلد format را حذف میکند؛ یا CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید (این مورد را از 2.1.287 پوشش میدهد) که effort را سر جای خود باقی میگذارد. ⑤ یک 400 که به thinking یا adaptive اشاره میکند، مانند «Input tag 'adaptive' found» → build مدل پشت gateway استدلال adaptive را نمیپذیرد ← آن مدل را ارتقا دهید؛ در Opus 4.6 و Sonnet 4.6، بهجای آن CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 کار میکند. ⑥ یک 400 در هر درخواست در 2.1.265–2.1.267، که gateway اسکیمای ورودی یک ابزار یا pattern آن را با عبارت خودش رد میکند ← یک regex در اسکیمای ورودی ابزار Artifact که چنین نقاط پایانی آن را رد میکنند ← به 2.1.268 یا بالاتر ارتقا دهید، یا ابزار Artifact را خاموش کنید. ⑦ «API returned an empty or malformed response (HTTP 200)» → gateway یا یک proxy واسط پاسخی غیر API برگردانده است، اغلب یک خطای HTML یا صفحه ورود ← با یک درخواست curl مستقیم آزمایش کنید و آن hop را که با چیزی غیر از پاسخ Claude API پاسخ میدهد اصلاح کنید؛ همان خطا که بهدلیل برچسبگذاری پاسخ non-streaming بهعنوان text/plain توسط gateway ایجاد شده بود، در 2.1.271 اصلاح شد. ⑧ یک 400 که محدودیت context را با عبارت خود gateway بیان میکند، مانند «ContextWindowExceededError» یا «prompt توکن count of N exceeds the limit of M» → gateway پنجرهای کوچکتر از پنجره مدل اعمال میکند و خطا را بازنویسی میکند، بنابراین Claude Code بهطور خودکار فشردهسازی و تلاش دوباره انجام نمیدهد ← برای بازیابی /compact را اجرا کنید؛ برای جلوگیری از آن، CLAUDE_CODE_AUTO_COMPACT_WINDOW را روی محدودیت gateway تنظیم کنید (حداقل 100,000)؛ از 2.1.285، اگر gateway در 200K متوقف میشود، /autocompact 200k را اجرا کنید.
در QCode
تا تاریخ 2026-10-26 (صفحه عیبیابی با تاریخ بهروزرسانی 2026-10-16 علامتگذاری شده است؛ همین پیکربندی در 2026-10-07 نیز دیده شده است)، مستندات QCode، Claude Code را اینگونه پیکربندی میکند: ANTHROPIC_BASE_URL برابر https://api.qcode.cc/api است (بدون /v1 و بدون اسلش انتهایی)، و ANTHROPIC_AUTH_TOKEN همان کلیدی است که با cr_ شروع میشود و آن را در کنسول ایجاد میکنید؛ مدلهای Claude فقط روی نقطه پایانی پروتکل Anthropic کار میکنند. صفحه عیبیابی QCode همان راهحلها را فهرست میکند: برای خطای «400 … Input tag 'advisor_20260301'» در 2.1.275، به 2.1.276 یا جدیدتر ارتقا دهید؛ برای «Unexpected value(s) … anthropic-beta»، مقدار CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید؛ و توصیه میکند مطمئن شوید آخرین نسخه را اجرا میکنید، زیرا بسیاری از مشکلات در انتشارهای جدیدتر قبلاً رفع شدهاند. با خودآزمایی curl از مستندات شروع کنید: یک POST به /api/v1/messages بدون بدنه که 400 برمیگرداند یعنی مسیر و کلید هر دو درست کار میکنند، در حالی که 401 یعنی کلید نامعتبر است. هزینهها بر اساس توکن محاسبه میشود؛ برای قیمت هر مدل به /models مراجعه کنید.
پرسشهای متداول
چگونه خطای «400 … Input tag 'advisor_20260301'» را برطرف کنم؟
به Claude Code 2.1.276 یا جدیدتر ارتقا دهید. این یک رگرسیون در 2.1.275 است: در طول یک عرضه تدریجی، درخواستها حتی وقتی advisor خاموش بود، یک ورودی ابزار advisor را حمل میکردند، و گیتویهایی که انواع ابزار را اعتبارسنجی میکردند کل درخواست را رد میکردند؛ از 2.1.276، آن ورودی پشت گیتوی ANTHROPIC_BASE_URL ارسال نمیشود مگر اینکه advisor را روشن کنید. اگر هنوز نمیتوانید ارتقا دهید، CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 را تنظیم کنید. با روشن بودن advisor، از 2.1.280، Claude Code پس از همان رد شدن، یک بار بدون آن ورودی دوباره تلاش میکند، سپس advisor را برای آن Base URL — در حالی که /advisor در دسترس نیست — تا زمانی که خارج شود کنار میگذارد.
آیا «Extra inputs are not permitted» مشکل گیتوی است؟
معمولاً بله. مرجع رسمی خطاها میگوید یک پراکسی یا گیتوی LLM بین Claude Code و API هدر درخواست anthropic-beta را حذف کرده است، بنابراین API فیلدهایی را که به آن وابستهاند رد کرده است؛ متن معمول آن «API Error: 400 ... Extra inputs are not permitted ... context_management» است. راهحل واقعی این است که گیتوی anthropic-beta را بدون تغییر ارسال کند؛ راهحل جایگزین این است که پیش از اجرا، CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید. مستندات همچنین اشاره میکند که برخی بتاها با آن متغیر کنترل نمیشوند و Claude Code خطاهای 400 ناشی از مدیریت زمینه یا فیلدهای طرحواره ابزار را دوباره تلاش نمیکند.
کدام هدرهای درخواست را باید یک گیتوی ارسال کند؟
anthropic-version و anthropic-beta، بدون تغییر — بهعلاوه anthropic-workspace-id زمانی که گیتوی در جلوی Claude Platform on AWS قرار دارد. anthropic-version در حال حاضر 2023-06-01 است؛ anthropic-beta را عیناً ارسال کنید و مقادیر جداگانه را در فهرست مجاز قرار ندهید، زیرا مجموعه آن با انتشارهای Claude Code تغییر میکند. اعتبارنامه بسته به اینکه کدام متغیر اعتبارنامه را تنظیم کردهاید، در Authorization یا x-api-key منتقل میشود، و هر چیزی که با forward-unchanged علامتگذاری نشده باشد، بر عهده گیتوی است که آن را مصرف کند یا نادیده بگیرد. مستندات همچنین از گیتویها میخواهد بدنه پاسخ خطا را بدون تغییر ارسال کنند، زیرا تلاشهای خودکار مجدد Claude Code با متن خطا تطبیق داده میشوند.
تفاوت بین ANTHROPIC_BETAS و CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS چیست؟
این دو در جهت مخالف عمل میکنند. ANTHROPIC_BETAS فهرستی جداشده با کاما از مقادیر اضافی anthropic-beta است؛ طبق مستندات، Claude Code از قبل هدرهای بتای مورد نیازش را ارسال میکند و این متغیر پیش از آنکه Claude Code پشتیبانی بومی اضافه کند، استفاده از یک بتای API Anthropic را فعال میکند. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 مقادیر anthropic-beta پیشانتشار و فیلدهای بدنهای را که با آنها جفت میشوند حذف میکند، برای گیتویهایی که با «Unexpected value(s)» یا «Extra inputs are not permitted» پاسخ میدهند. مورد دوم مقادیری را که از طریق ANTHROPIC_BETAS اضافه میکنید حذف نمیکند، بنابراین اگر گیتوی یکی از آنها را رد کند، خودتان آن را از ANTHROPIC_BETAS حذف کنید.
گیتوی شما فقط 200K را پشتیبانی میکند. بعد از 2.1.285 چه باید بکنید؟
/autocompact 200k را اجرا کنید — این همان راهحلی است که مدخل تغییرات 2.1.285 ارائه میدهد. از 2.1.285، مدلهایی با پنجره 1M (Opus 4.7+، Sonnet 5+، Fable) پشت یک ANTHROPIC_BASE_URL سفارشی با 1M اجرا میشوند، و صفحه رسمی پیکربندی مدل میگوید Claude Code نمیتواند حد پایینتری را که گیتوی اعمال میکند تشخیص دهد. برای اعمال آن در هر اجرا، CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 را در محیطی که Claude Code را راهاندازی میکند تنظیم کنید. اگر گیتوی سرریز را با عبارت خودش گزارش کند، مثلاً ContextWindowExceededError، Claude Code بهطور خودکار فشردهسازی و تلاش مجدد نمیکند، بنابراین ابتدا /compact را دستی اجرا کنید.
وقتی این خطاها را در QCode میبینید، ابتدا چه چیزی را باید بررسی کنید؟
نسخه Claude Code خود را بررسی کنید و به جدیدترین نسخه ارتقا دهید؛ مستندات QCode نیز اشاره میکند که بسیاری از مشکلات در انتشارهای جدیدتر برطرف شدهاند. تا 2026-10-07 جدیدترین نسخه 2.1.292 است و فرمان رسمی ارتقا claude update است. سپس پیکربندی را بررسی کنید: ANTHROPIC_BASE_URL باید https://api.qcode.cc/api باشد (بدون /v1 و بدون اسلش پایانی)، و اعتبارنامه در ANTHROPIC_AUTH_TOKEN قرار دارد که بهصورت هدر Authorization: Bearer ارسال میشود. اگر «Unexpected value(s) … anthropic-beta» همچنان ادامه یابد، مطابق مستندات QCode مقدار CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کنید.
منابع
شماره نسخهها و اصلاحات: تغییرات رسمی Claude Code (فایل CHANGELOG.md در مخزن anthropics/claude-code: ورودیهای 2.1.268، 2.1.271، 2.1.275، 2.1.276، 2.1.280، 2.1.285، 2.1.287، 2.1.288 و 2.1.290)، همراه با تاریخهای انتشار از همان مخزن در GitHub Releases (UTC). علتها و اصلاحات: جدول عیبیابی گیتوی، راهنمای سازگاری گیتوی و مرجع خطاها در code.claude.com، بهعلاوه صفحههای متغیرهای محیطی، پیکربندی مدل و نصب. ترتیب راهاندازی و عیبیابی QCode: راهنمای عیبیابی، صفحه متغیرهای محیطی و صفحه نقطههای پایانی/مسیرهای API در docs.qcode.cc. همه در 2026-10-07 دریافت و در 2026-10-26 دوباره بررسی شدند.
به نسخه جدید ارتقا دهید، سپس دوباره متصل شوید
Base URL را روی https://api.qcode.cc/api تنظیم کنید و کلید خود را در ANTHROPIC_AUTH_TOKEN قرار دهید — یک کلید cr_ باعث اتصال Claude Code میشود. صورتحساب بهازای هر توکن است؛ برای قیمت هر مدل /models را ببینید.
مطالب مرتبط
راهاندازی نقطه پایانی سفارشی Claude Code (ANTHROPIC_BASE_URL)
Claude Code را به یک نقطه پایانی سفارشی متصل کنید: دو متغیر، اینکه اعتبارنامه در کدام هدر قرار میگیرد، و قالب settings.json.
پنجره زمینه 1M Claude Code پشت گیتوی
از 2.1.285 نقطههای پایانی سفارشی بهطور پیشفرض 1M هستند؛ وقتی گیتوی شما در 200K متوقف میشود چه چیزی را تنظیم کنید.
سرویس رله API Claude Code: دو متغیر محیطی و هزینهها
بررسیشده در 2026-11-04: سرویس رله API Claude Code چیست، پروتکل Anthropic و Base URL، کلید و هزینهها، روشهای پرداخت و زمانهای واریز، ویژگیها و برداشتهای نادرست.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
شماره نسخهها، متن خطاها و اظهارات رسمی این صفحه در 2026-10-07 و دوباره در 2026-10-26 با تغییرات و مستندات رسمی Anthropic که اولویت دارند تطبیق داده شد؛ تغییرات سمت Anthropic ممکن است بدون اطلاع قبلی رخ دهد. اینکه یک گیتوی مشخص کدام هدرها را فوروارد میکند و محدودیت زمینه آن چیست، تابع مستندات همان ارائهدهنده است؛ دسترسپذیری مدل همان چیزی است که /models نشان میدهد.