مرجع خطاها

این صفحه خطاهای زمانِ اجرایی را که Claude Code نمایش می‌دهد و نحوه‌ی بازیابی از هرکدام را فهرست می‌کند، به‌علاوه‌ی اینکه وقتی پاسخ‌ها بدونِ خطا نامناسب به نظر می‌رسند چه چیزی را بررسی کنی. برای خطاهای نصب مثلِ command not found یا شکست‌های TLS هنگامِ راه‌اندازی، عیب‌یابیِ نصب و ورود را ببین.

این خطاها و دستورهای بازیابی در سراسرِ CLI، اپِ Desktop و Claude Code on the web اعمال می‌شوند، چون هر سه همان CLI Claude Code را می‌پیچند. برای مشکل‌های مخصوصِ هر سطح، بخشِ عیب‌یابیِ صفحه‌ی همان سطح را ببین.

خطایت را پیدا کن

پیامی را که در ترمینالت می‌بینی با یک بخشِ زیر مطابقت بده.

پیام	بخش
`API Error: 500 Internal server error`	خطاهای سرور
`API Error: Repeated 529 Overloaded errors`	خطاهای سرور
`Request timed out`	خطاهای سرور، یا شبکه اگر پیام به اتصالِ اینترنتت اشاره کند
`<model> is temporarily unavailable, so auto mode cannot determine the safety of...`	خطاهای سرور
`Auto mode could not evaluate this action and is blocking it for safety`	خطاهای سرور
`Auto mode classifier transcript exceeded context window`	خطاهای سرور
`You've hit your session limit` / `You've hit your weekly limit`	حدودِ استفاده
`Usage credits required for 1M context`	حدودِ استفاده
`Server is temporarily limiting requests`	حدودِ استفاده
`Request rejected (429)`	حدودِ استفاده
`Credit balance is too low`	حدودِ استفاده
`Not logged in · Please run /login`	احراز هویت
`Could not resolve authentication method`	احراز هویت
`Invalid API key`	احراز هویت
`This organization has been disabled`	احراز هویت
`Your organization has disabled API key authentication`	احراز هویت
`Your organization has disabled Claude subscription access`	احراز هویت
`Routines are disabled by your organization's policy`	احراز هویت
`OAuth token revoked` / `OAuth token has expired`	احراز هویت
`does not meet scope requirement user:profile`	احراز هویت
`Unable to connect to API`	شبکه
`SSL certificate verification failed`	شبکه
`403` با `x-deny-reason: host_not_allowed` در یک نشستِ ابری یا routine	شبکه
`Prompt is too long`	خطاهای درخواست
`Error during compaction: Conversation too long`	خطاهای درخواست
`Request too large`	خطاهای درخواست
`Image was too large`	خطاهای درخواست
`Unable to resize image`	خطاهای درخواست
`PDF too large` / `PDF is password protected`	خطاهای درخواست
`Extra inputs are not permitted`	خطاهای درخواست
`There's an issue with the selected model`	خطاهای درخواست
`Claude Opus is not available with the Claude Pro plan`	خطاهای درخواست
`thinking.type.enabled is not supported for this model`	خطاهای درخواست
`max_tokens must be greater than thinking.budget_tokens`	خطاهای درخواست
`API Error: 400 due to tool use concurrency issues`	خطاهای درخواست
`Claude Code is unable to respond to this request, which appears to violate our Usage Policy`	خطاهای درخواست
پاسخ‌ها از حدِ معمول کم‌کیفیت‌تر به نظر می‌رسند	کیفیتِ پاسخ

retryهای خودکار

Claude Code شکست‌های گذرا را پیش از نشان‌دادنِ خطا به تو retry می‌کند. خطاهای سرور، پاسخ‌های overloaded، تایم‌اوتِ درخواست، throttleهای موقتِ 429 و اتصال‌های قطع‌شده همگی تا ۱۰ بار با backoff نمایی retry می‌شوند. حین retry، اسپینر یک شمارشِ معکوسِ Retrying in Ns · attempt x/y نشان می‌دهد.

وقتی یکی از خطاهای این صفحه را می‌بینی، آن retryها از قبل تمام شده‌اند. می‌توانی رفتار را با دو متغیرِ محیطی تنظیم کنی:

متغیر	پیش‌فرض	اثر
`CLAUDE_CODE_MAX_RETRIES`	10	تعدادِ تلاش‌های retry. در اسکریپت‌ها پایینش بیاور تا شکست‌ها سریع‌تر نمایان شوند؛ برای سپری‌کردنِ حادثه‌های طولانی‌تر بالایش ببر.
`API_TIMEOUT_MS`	600000	مهلتِ به‌ازای هر درخواست به میلی‌ثانیه. برای شبکه‌ها یا پراکسی‌های کند بالایش ببر.

خطاهای سرور

این خطاها از ارائه‌دهنده‌ی inference می‌آیند، نه حساب یا درخواستِ تو. روی Anthropic API یعنی زیرساختِ Anthropic. روی Bedrock، Vertex AI، Foundry یا یک gateway سفارشی، یعنی زیرساختِ همان ارائه‌دهنده.

API Error: 500 Internal server error

Claude Code کدِ وضعیت و پیامِ خطای API را برای هر پاسخِ 5xx نشان می‌دهد. نمونه‌ی زیر یک پاسخِ 500 روی Anthropic API را نشان می‌دهد:

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

جمله‌ی پایانی نام می‌برد که سلامتِ سرویس را کجا بررسی کنی و بسته به ارائه‌دهنده فرق می‌کند. پیکربندی‌های Bedrock، Vertex AI و Foundry وضعیتِ سرویسِ همان ارائه‌دهنده را نام می‌برند. یک ANTHROPIC_BASE_URL سفارشی هاستِ gateway را نام می‌برد.

این نشان‌دهنده‌ی یک شکستِ غیرمنتظره داخلِ API است. علتش پرامپت، تنظیمات یا حسابِ تو نیست.

چه کار کنی:

status.claude.com، یا صفحه‌ی وضعیتِ ارائه‌دهنده که در پیام نام برده شده، را برای حادثه‌های فعال بررسی کن
یک دقیقه صبر کن، سپس پیامت را دوباره بفرست. پیامِ اصلی‌ات همچنان در مکالمه هست، پس برای یک پرامپتِ طولانی می‌توانی به‌جای چسباندنِ دوباره‌ی کلش، try again را تایپ کنی.
اگر خطا بدونِ حادثه‌ی منتشرشده ادامه دارد، /feedback را اجرا کن تا Anthropic بتواند با جزئیاتِ درخواستت بررسی کند. اگر /feedback در محیطت در دسترس نیست، گزارشِ خطا را ببین.

API Error: Repeated 529 Overloaded errors

API به‌طورِ موقت در همه‌ی کاربران به ظرفیتِ کامل رسیده است. Claude Code پیش از نشان‌دادنِ این پیام از قبل چند بار retry کرده:

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

جمله‌ی پایانی به‌همان‌شکلِ خطای 500 بالا بسته به ارائه‌دهنده فرق می‌کند. یک 529 حدِ استفاده‌ی تو نیست و به سهمیه‌ات حساب نمی‌شود.

چه کار کنی:

status.claude.com، یا صفحه‌ی وضعیتِ ارائه‌دهنده که در پیام نام برده شده، را برای اطلاعیه‌های ظرفیت بررسی کن
چند دقیقه دیگر دوباره امتحان کن
/model را اجرا کن و به مدلِ دیگری سوییچ کن تا به کار ادامه دهی، چون ظرفیت به‌ازای هر مدل ردیابی می‌شود. Claude Code وقتی یک مدل زیرِ بارِ به‌خصوص بالایی است این را به تو پیشنهاد می‌کند، مثلاً Opus is experiencing high load, please use /model to switch to Sonnet.

Request timed out

API پیش از ضرب‌الاجلِ اتصال پاسخ نداد.

Request timed out

این می‌تواند در دوره‌های بارِ بالا یا وقتی یک پاسخِ خیلی بزرگ در حالِ تولید است اتفاق بیفتد. مهلتِ پیش‌فرضِ درخواست ۱۰ دقیقه است.

چه کار کنی:

درخواست را retry کن
برای کارهای طولانی‌مدت، کار را به پرامپت‌های کوچک‌تر بشکن
اگر یک شبکه یا پراکسیِ کند علتش است، API_TIMEOUT_MS را همان‌طور که در retryهای خودکار توصیف شده بالا ببر
اگر تایم‌اوت‌ها مکرر است و شبکه‌ات وگرنه سالم است، خطاهای شبکه و اتصال را در ادامه ببین

auto mode نمی‌تواند ایمنیِ یک اقدام را تعیین کند

مدلی که auto mode برای طبقه‌بندیِ اقدام‌ها استفاده می‌کند نتوانست تصمیمی بگیرد، پس auto mode اقدام را به‌صورت خودکار تأیید نکرد. پیامی که می‌بینی به این بستگی دارد که چرا طبقه‌بند شکست خورد.

خواندن‌ها، جست‌وجوها و ویرایش‌ها داخلِ دایرکتوریِ کاری‌ات از طبقه‌بند رد می‌شوند، پس در همه‌ی این موارد به کار ادامه می‌دهند.

وقتی مدلِ طبقه‌بند overloaded است:

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

چه کار کنی:

پس از چند ثانیه retry کن؛ Claude همان پیام را می‌بیند و معمولاً خودش retry می‌کند
اگر retryها مدام شکست می‌خورند، با کارهای فقط‌خواندنی ادامه بده و بعداً به اقدامِ مسدودشده برگرد
این گذرا است و به واجدِشرایط‌بودنِ auto mode ربطی ندارد؛ نیازی به تغییرِ تنظیمات نداری

وقتی طبقه‌بند یک پاسخِ غیرقابل‌تجزیه برگرداند:

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

چه کار کنی:

اقدام را retry کن؛ این معمولاً در تلاشِ بعدی موفق می‌شود
claude --debug را اجرا کن و اقدام را تکرار کن تا پاسخِ زیرینِ طبقه‌بند را در لاگِ دیباگ ببینی

وقتی مکالمه از پنجره‌ی کانتکستِ طبقه‌بند بزرگ‌تر شده:

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

در یک نشستِ تعاملی، auto mode برای آن اقدام به یک پرامپتِ دسترسیِ معمولی برمی‌گردد تا بتوانی دستی تأیید یا رد کنی. در حالتِ غیرتعاملی اجرا متوقف می‌شود چون رونوشت فقط بزرگ‌تر می‌شود و retry نمی‌تواند موفق شود.

چه کار کنی:

اقدام را در پرامپتی که ظاهر می‌شود تأیید یا رد کن
/compact را اجرا کن تا اندازه‌ی مکالمه کم شود تا اقدام‌های بعدی دوباره داخلِ پنجره‌ی طبقه‌بند جا شوند

حدودِ استفاده

این خطاها یعنی یک سهمیه‌ی مرتبط با حساب یا پلنت به حدِ خود رسیده است. این‌ها از خطاهای سرور که همه را تحتِ‌تأثیر می‌گذارند متمایزند.

You’ve hit your session limit

پلن‌های اشتراکی یک سهمیه‌ی استفاده‌ی غلتان در بر دارند. وقتی تمام شود یکی از این پیام‌ها را می‌بینی:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Claude Code درخواست‌های بیشتر را تا زمانِ ریستِ نشان‌داده‌شده در پیام مسدود می‌کند.

چه کار کنی:

منتظرِ زمانِ ریستِ نشان‌داده‌شده در خطا بمان
/usage را اجرا کن تا حدودِ پلنت و زمانِ ریستشان را ببینی
/usage-credits را اجرا کن تا روی Pro و Max استفاده‌ی اضافی بخری، یا روی Team و Enterprise از مدیرت درخواست کنی. برای نحوه‌ی محاسبه‌ی هزینه، اعتبارهای استفاده برای پلن‌های پولی را ببین.
برای ارتقای پلنت به حدودِ پایه‌ی بالاتر، claude.com/pricing را ببین

برای دیدنِ سهمیه‌ی باقی‌مانده‌ات پیش از رسیدن به حد، فیلدهای rate_limits را به یک status line سفارشی اضافه کن، یا در اپِ Desktop روی حلقه‌ی استفاده کنارِ انتخابگرِ مدل کلیک کن.

Usage credits required for 1M context

مدلِ انتخاب‌شده از پنجره‌ی کانتکستِ گسترده‌ی ۱M-توکنی استفاده می‌کند، و پلنت آن را فقط از طریقِ اعتبارهای استفاده در بر می‌گیرد.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

این یک بررسیِ استحقاق است، نه اتمامِ سهمیه. این حتی وقتی سهمیه‌های نشستی و هفتگی‌ات ظرفیتِ باقی‌مانده دارند فعال می‌شود. برای اینکه کدام پلن‌ها ۱M context را مستقیم در بر دارند و کدام به اعتبارهای استفاده نیاز دارند، کانتکستِ گسترده را ببین.

{/* min-version: 2.1.172 */}وقتی این خطا وسطِ مکالمه ظاهر می‌شود چون کانتکست از ۲۰۰K توکن فراتر رفته، Claude Code به‌صورت خودکار مکالمه را به زیرِ حدِ کانتکستِ استاندارد فشرده می‌کند و نشست را پس از آن در همان حد نگه می‌دارد، پس نیازی به اقدام نیست. روی نسخه‌های قبل از v2.1.172، خطا روی هر درخواستِ بعدی از جمله /compact تکرار می‌شد؛ روی آن نسخه‌ها /clear را اجرا کن تا بازیابی کنی. گام‌های زیر وقتی اعمال می‌شوند که عمداً یک مدلِ [1m] را انتخاب کرده باشی.

چه کار کنی:

/model را اجرا کن و گونه‌ی بدونِ پسوندِ [1m] را انتخاب کن تا به پنجره‌ی کانتکستِ استاندارد برگردی
/usage-credits را اجرا کن تا صورت‌حسابِ متری برای گونه‌ی ۱M روی Pro و Max را روشن کنی، یا روی Team و Enterprise از مدیرت درخواست کنی
اگر خطا پس از /model ادامه دارد، ممکن است یک شناسه‌ی مدلِ ۱M جای دیگری تنظیم شده باشد. برای محل‌های پیکربندی که باید به‌ترتیبِ اولویت بررسی کنی، مشکلی با مدلِ انتخاب‌شده وجود دارد را ببین.
برای حذفِ کاملِ گونه‌های ۱M از انتخابگرِ مدل، CLAUDE_CODE_DISABLE_1M_CONTEXT=1 را تنظیم کن

Server is temporarily limiting requests

API یک throttle کوتاه‌مدت اعمال کرد که به سهمیه‌ی پلنت ربطی ندارد.

API Error: Server is temporarily limiting requests (not your usage limit)

این پیش از نشان‌داده‌شدن به‌صورت خودکار retry می‌شود.

چه کار کنی:

کمی صبر کن و دوباره امتحان کن
اگر ادامه داشت status.claude.com را بررسی کن

Request rejected (429)

به حدِ نرخِ پیکربندی‌شده برای کلیدِ API، پروژه‌ی Amazon Bedrock یا پروژه‌ی Google Vertex AI تو رسیده‌ای.

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

جمله‌ی پایانی نام می‌برد که سلامتِ سرویس را کجا بررسی کنی و بسته به ارائه‌دهنده فرق می‌کند. پیکربندی‌های Bedrock، Vertex AI و Foundry به‌جای صفحه‌ی وضعیتِ Anthropic، وضعیتِ سرویسِ همان ارائه‌دهنده را نام می‌برند. یک ANTHROPIC_BASE_URL سفارشی هاستِ gateway را نام می‌برد.

چه کار کنی:

/status را اجرا کن و تأیید کن اعتبارنامه‌ی فعال همانی است که انتظار داری. یک ANTHROPIC_API_KEY سرگردان در محیطت می‌تواند درخواست‌ها را به‌جای اشتراکت از طریقِ یک کلیدِ سطح-پایین مسیریابی کند.
کنسولِ ارائه‌دهنده‌ات را برای حدودِ فعال بررسی کن و در صورتِ نیاز یک سطحِ بالاتر درخواست کن
برای کلیدهای Anthropic API، برای اینکه سطح‌ها چطور کار می‌کنند و چطور سقف‌های به‌ازای هر فضای‌کاری بگذاری، مرجعِ حدودِ نرخ را ببین
همزمانی را کاهش بده: CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY را پایین بیاور، از اجرای ساب‌ایجنت‌های موازیِ زیاد بپرهیز، یا برای اجراهای اسکریپتیِ پرحجم با /model به یک مدلِ کوچک‌تر سوییچ کن

Credit balance is too low

سازمانِ Console تو اعتبارِ پیش‌پرداختش تمام شده است.

Credit balance is too low

چه کار کنی:

در platform.claude.com/settings/billing اعتبار اضافه کن، و فعال‌کردنِ auto-reload در همان‌جا را در نظر بگیر تا موجودی پیش از رسیدن به صفر دوباره پر شود
اگر یک پلنِ Pro، Max، Team یا Enterprise داری، با /login به احراز هویتِ اشتراکی سوییچ کن
سقف‌های هزینه‌ی به‌ازای هر فضای‌کاری را در Console بگذار تا جلوی تخلیه‌ی موجودیِ سازمان توسطِ یک پروژه‌ی واحد را بگیری. مدیریتِ مؤثرِ هزینه‌ها را ببین.

خطاهای احراز هویت

این خطاها یعنی Claude Code نمی‌تواند هویتت را به API ثابت کند. هر زمان /status را اجرا کن تا ببینی کدام اعتبارنامه در حالِ حاضر فعال است.

Not logged in

هیچ اعتبارنامه‌ی معتبری برای این نشست در دسترس نیست.

Not logged in · Please run /login

چه کار کنی:

/login را اجرا کن تا با اشتراکِ Claude یا حسابِ Console خود احراز هویت کنی
اگر انتظار داشتی یک متغیرِ محیطی احراز هویتت کند، تأیید کن ANTHROPIC_API_KEY در شلی که claude را اجرا کردی تنظیم و export شده
برای CI یا اتوماسیون که ورودِ تعاملی ممکن نیست، یک اسکریپتِ apiKeyHelper پیکربندی کن که هنگامِ شروع یک کلید واکشی کند
برای درکِ اینکه وقتی چند اعتبارنامه حاضرند کدام برنده می‌شود، تقدمِ احراز هویت را ببین

اگر مدام از تو خواسته می‌شود وارد شوی، برای اصلاحاتِ ساعتِ سیستم و Keychain در macOS، وارد نشده یا توکن منقضی شده را ببین.

Could not resolve authentication method

نشست بدونِ هیچ اعتبارنامه‌ای به کلاینتِ API رسید. این در نشست‌های پس‌زمینه، نشست‌های ابری و کانتکست‌های Agent SDK ظاهر می‌شود که در آن‌ها بررسیِ ورودِ تعاملی پیش از اولین درخواست اجرا نمی‌شود.

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

{/* min-version: 2.1.174 */}پیش از v2.1.174، یک نشستِ پس‌زمینه یا ابری که به یک workerِ بی‌کارِ از پیش راه‌اندازی‌شده اختصاص داده شده بود می‌توانست این‌طور شکست بخورد حتی وقتی اعتبارنامه‌های معتبر پیکربندی شده بودند. برای بازیابی ارتقا بده. روی نسخه‌های فعلی، خطا یعنی هیچ اعتبارنامه‌ای برای فرآیندِ worker در دسترس نبود.

چه کار کنی:

اگر این در یک نشستِ پس‌زمینه یا ابری ظاهر می‌شود و اعتبارنامه‌هایت از قبل پیکربندی شده‌اند، به v2.1.174 یا بالاتر ارتقا بده
تأیید کن ANTHROPIC_API_KEY، CLAUDE_CODE_OAUTH_TOKEN یا اعتبارنامه‌های ارائه‌دهنده‌ی ابری‌ات در محیطی که worker را اجرا می‌کند تنظیم شده‌اند، نه فقط در شلِ تعاملی‌ات
برای Agent SDK، راه‌اندازیِ احراز هویت را ببین
/status را در یک نشستِ تعاملی در همان محیط اجرا کن تا تأیید کنی کدام منبعِ اعتبارنامه resolve می‌شود

Invalid API key

متغیرِ محیطیِ ANTHROPIC_API_KEY یا اسکریپتِ apiKeyHelper کلیدی برگرداند که API ردش کرد.

Invalid API key · Fix external API key

چه کار کنی:

غلطِ تایپی را بررسی کن و تأیید کن کلید در Console باطل نشده
env | grep ANTHROPIC را در همان شل اجرا کن. ابزارهایی مثلِ direnv، پلاگین‌های شلِ dotenv و ترمینال‌های IDE می‌توانند یک کلیدِ کهنه را از یک فایلِ .env در پروژه‌ات بدونِ اینکه صریحاً تنظیمش کنی بارگذاری کنند.
ANTHROPIC_API_KEY را unset کن و /login را اجرا کن تا به‌جایش از احراز هویتِ اشتراکی استفاده کنی
اگر کلید از یک اسکریپتِ apiKeyHelper می‌آید، اسکریپت را مستقیم اجرا کن تا تأیید کنی یک کلیدِ معتبر روی stdout چاپ می‌کند
/status را اجرا کن تا تأیید کنی Claude Code واقعاً از کدام منبعِ اعتبارنامه استفاده می‌کند

This organization has been disabled

یک ANTHROPIC_API_KEY کهنه از یک سازمانِ غیرفعالِ Console بر ورودِ اشتراکی‌ات غلبه می‌کند.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

متغیرهای محیطی بر /login ارجح‌اند، پس کلیدی که در profile شلت export شده یا از یک فایلِ .env بارگذاری شده استفاده می‌شود حتی وقتی یک اشتراکِ Pro یا Max فعال داری. در حالتِ غیرتعاملی (-p)، اگر کلید موجود باشد همیشه استفاده می‌شود.

چه کار کنی:

ANTHROPIC_API_KEY را در شلِ فعلی unset کن و از profile شلت حذفش کن، سپس claude را دوباره اجرا کن
بعد از آن /status را اجرا کن تا تأیید کنی اعتبارنامه‌ی فعال اشتراکت است
اگر هیچ متغیرِ محیطی‌ای تنظیم نشده و خطا ادامه دارد، سازمانِ غیرفعال همانی است که به /login تو گره خورده. با پشتیبانی تماس بگیر یا با حسابِ دیگری وارد شو.

Your organization has disabled API key authentication

مدیرِ سازمانِ Console تو احراز هویتِ کلیدِ API را خاموش کرده، پس API کلیدی را که Claude Code می‌فرستد رد می‌کند. راهنماییِ بازیابی پس از · بسته به اینکه کلید از کجا آمده فرق می‌کند:

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

متغیرهای محیطی و apiKeyHelper بر /login ارجح‌اند، پس اجرای تنهای /login کمکی نمی‌کند تا وقتی یکی از این دو همچنان یک کلید تأمین می‌کند. تقدمِ احراز هویت را ببین.

چه کار کنی:

اگر پیام ANTHROPIC_API_KEY را نام می‌برد، آن را در شلِ فعلی unset کن و از profile شل یا فایلِ .env خود حذفش کن، سپس claude را دوباره اجرا کن
اگر پیام apiKeyHelper را نام می‌برد، تنظیمِ apiKeyHelper را از settings.json خود حذف کن
/login را اجرا کن تا با حسابِ claude.ai خود وارد شوی
بعد از آن /status را اجرا کن تا تأیید کنی اعتبارنامه‌ی فعال اشتراکت است نه یک کلیدِ API
اگر برای اتوماسیون به احراز هویتِ کلیدِ API نیاز داری، از مدیرِ سازمانت بخواه آن را در Console دوباره فعال کند

Your organization has disabled Claude subscription access

سازمانِ Claude تو اجازه‌ی ورود به Claude Code با یک ورودِ اشتراکی را نمی‌دهد. اجرای دوباره‌ی /login با همان حساب همان خطا را برمی‌گرداند.

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

این یک تنظیمِ سازمانیِ سمتِ سرور است، پس نمی‌توان آن را از تنظیماتِ محلی، متغیرهای محیطی یا پرچم‌های CLI بازنویسی کرد. Agent SDK و حالتِ غیرتعاملیِ -p این را به‌عنوان کدِ خطای oauth_org_not_allowed نمایان می‌کنند.

چه کار کنی:

از مدیرت بخواه دسترسیِ Claude Code را برای سازمانت فعال کند
به‌جای اشتراکت با یک کلیدِ API Console احراز هویت کن. برای راه‌اندازی، احراز هویتِ Claude Console را ببین.
اگر خودت مدیری و گزینه‌ای برای فعال‌کردنِ دسترسی نمی‌بینی، با پشتیبانی Anthropic تماس بگیر

Routines are disabled by your organization’s policy

مدیرِ Team یا Enterprise تو routineها را در سطحِ سازمان خاموش کرده. خطا وقتی ظاهر می‌شود که می‌کوشی یک routine بسازی یا اجرا کنی، از جمله از /schedule و رابطِ Routines در claude.ai/code.

Routines are disabled by your organization's policy.

این یک تنظیمِ سمتِ سرور است، پس نمی‌توان آن را از تنظیماتِ محلی، متغیرهای محیطی یا پرچم‌های CLI بازنویسی کرد.

چه کار کنی:

از مدیرت بخواه کلیدِ Routines را در claude.ai/admin-settings/claude-code فعال کند
برای کارِ زمان‌بندی‌شده‌ی یک‌باره که به routineهای سطح-سازمان نیاز ندارد، کارهای زمان‌بندی‌شده را ببین

OAuth token revoked or expired

ورودِ ذخیره‌شده‌ات دیگر معتبر نیست. یک توکنِ باطل‌شده یعنی همه‌جا خارج شده‌ای یا یک مدیر دسترسی را حذف کرده؛ یک توکنِ منقضی یعنی refresh خودکار وسطِ نشست شکست خورده.

OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error

چه کار کنی:

/login را اجرا کن تا دوباره وارد شوی
اگر خطا در همان نشست پس از احراز هویتِ دوباره برمی‌گردد، اول /logout را اجرا کن تا توکنِ ذخیره‌شده را کاملاً پاک کنی، سپس /login
برای پرامپت‌های مکررِ ورود در طولِ اجراها، بررسی‌های ساعتِ سیستم و Keychain در macOS را در عیب‌یابی ببین
برای سایر شکست‌ها از جمله 403 Forbidden و مشکل‌های مرورگرِ OAuth، ورود و احراز هویت را ببین

OAuth scope requirement

توکنِ ذخیره‌شده از یک scope دسترسی که یک قابلیتِ جدیدتر به آن نیاز دارد قدیمی‌تر است. این را بیشتر از /usage و نشانگرِ استفاده در status line می‌بینی:

OAuth token does not meet scope requirement: user:profile

چه کار کنی:

/login را اجرا کن تا یک توکنِ تازه با scopeهای فعلی بسازی. نیازی نیست اول خارج شوی.

خطاهای شبکه و اتصال

این خطاها یعنی یک درخواستِ شبکه از Claude Code نتوانست به مقصدش برسد. معمولاً در شبکه‌ی محلی، پراکسی یا فایروالِ تو، یا در سیاستِ شبکه‌ی محیطِ ابری ریشه دارند.

Unable to connect to API

اتصالِ TCP به API شکست خورد یا هیچ‌وقت کامل نشد.

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

علت‌های رایج شامل نبودِ دسترسیِ اینترنت، یک VPN که api.anthropic.com را مسدود می‌کند، یا یک پراکسیِ شرکتیِ موردنیاز که پیکربندی نشده است.

چه کار کنی:

تأیید کن می‌توانی از همان شل با اجرای curl -I https://api.anthropic.com به هاستِ API برسی. روی Windows PowerShell از curl.exe -I https://api.anthropic.com استفاده کن تا اَلیاسِ داخلیِ Invoke-WebRequest به کار نرود.
اگر پشتِ یک پراکسیِ شرکتی هستی، پیش از اجرای Claude Code HTTPS_PROXY را تنظیم کن و پیکربندیِ شبکه را ببین
اگر از طریقِ یک LLM gateway یا relay مسیریابی می‌کنی، ANTHROPIC_BASE_URL را روی آدرسش تنظیم کن. برای راه‌اندازی، پیکربندیِ LLM gateway را ببین.
مطمئن شو فایروالت هاست‌های فهرست‌شده در نیازمندی‌های دسترسیِ شبکه را اجازه می‌دهد
شکست‌های متناوب به‌صورت خودکار retry می‌شوند؛ شکست‌های پایدار به یک مشکلِ شبکه‌ی محلی اشاره دارند

اگر curl موفق شد اما Claude Code همچنان شکست می‌خورد، علت معمولاً چیزی بینِ زمانِ اجرا و شبکه است نه خودِ شبکه:

روی Linux و WSL، /etc/resolv.conf را برای یک nameserver غیرقابل‌دسترس بررسی کن. WSL به‌خصوص می‌تواند یک resolver خراب را از میزبان به ارث ببرد.
روی macOS، یک کلاینتِ VPN که قطع شده یا حذف نصب شده می‌تواند یک رابطِ تونل یا قاعده‌ی مسیریابی پشتِ سر بگذارد. ifconfig را برای رابط‌های کهنه‌ی utun بررسی کن و افزونه‌ی شبکه‌ی VPN را در System Settings حذف کن.
Docker Desktop و زمانِ‌اجراهای کانتینرِ مشابه می‌توانند ترافیکِ خروجی را رهگیری کنند. آن‌ها را ببند و دوباره امتحان کن تا این را رد کنی.

SSL certificate errors

یک پراکسی یا دستگاهِ امنیتی روی شبکه‌ات ترافیکِ TLS را با گواهیِ خودش رهگیری می‌کند، و Claude Code به آن اعتماد ندارد.

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

چه کار کنی:

بسته‌ی CA سازمانت را export کن و Claude Code را با NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem به آن اشاره بده
برای دستورالعمل‌های کاملِ راه‌اندازی، پیکربندیِ شبکه را ببین
NODE_TLS_REJECT_UNAUTHORIZED=0 را تنظیم نکن، که اعتبارسنجیِ گواهی را به‌کلی غیرفعال می‌کند

Host not allowed in a cloud session

یک درخواستِ HTTP خروجی از یک نشستِ ابری یا routine توسطِ سیاستِ شبکه‌ی محیط مسدود شد.

HTTP 403
x-deny-reason: host_not_allowed

ممکن است یک گواهیِ TLS هم ببینی که با گواهیِ واقعیِ مقصد نمی‌خواند. محیطِ ابری ترافیکِ خروجی را از طریقِ یک پراکسی که سیاستِ شبکه را اعمال می‌کند مسیریابی می‌کند، پس یک گواهیِ ناهماهنگ یعنی پراکسی اتصال را خاتمه داد، نه مقصد.

این یک مشکلِ شبکه‌ی سمتِ کلاینت نیست. نشست‌های ابری و routineها داخلِ یک محیطِ sandbox اجرا می‌شوند که ترافیکِ خروجی‌اش به فهرستِ مجازِ محیط فیلتر می‌شود. محیطِ Default از دسترسیِ Trusted استفاده می‌کند، که فهرستِ مجازِ پیش‌فرضِ رجیستری‌های پکیج، APIهای ارائه‌دهنده‌ی ابری، رجیستری‌های کانتینر و دامنه‌های رایجِ توسعه را اجازه می‌دهد اما هرچیزِ دیگری را مسدود می‌کند.

چه کار کنی:

routine را برای ویرایش باز کن، یا یک نشستِ ابری شروع کن. آیکونِ ابری که نامِ محیطت مثلِ Default را نشان می‌دهد انتخاب کن تا انتخابگر باز شود. روی محیطت hover کن و آیکونِ تنظیمات را کلیک کن.
در دیالوگِ Update cloud environment، Network access را از Trusted به Custom تغییر بده، سپس دامنه‌ی مسدودشده را به Allowed domains اضافه کن. هر دامنه را در یک خط وارد کن. گزینه‌ی Also include default list of common package managers را تیک بزن تا فهرستِ مجازِ پیش‌فرض کنارِ دامنه‌های سفارشی‌ات بماند. اگر دسترسیِ نامحدود می‌خواهی به‌جایش Full را انتخاب کن.
روی Save changes کلیک کن. اجرای بعدی از فهرستِ مجازِ به‌روزشده استفاده می‌کند.

برای سطح‌های دسترسی و فهرستِ مجازِ پیش‌فرض، دسترسیِ شبکه را ببین. نشست‌های CLI محلی تحتِ‌تأثیرِ این سیاست نیستند.

خطاهای درخواست

این خطاها یعنی API درخواستت را دریافت کرد اما محتوایش را رد کرد.

Prompt is too long

مکالمه به‌علاوه‌ی فایل‌های پیوست از پنجره‌ی کانتکستِ مدل فراتر می‌رود.

Prompt is too long

چه کار کنی:

/compact را اجرا کن تا نوبت‌های قبلی را خلاصه کنی و فضا آزاد شود، یا /clear تا از نو شروع کنی
/context را اجرا کن تا تفکیکِ آنچه پنجره را مصرف می‌کند ببینی: system prompt، ابزارها، فایل‌های حافظه و پیام‌ها
MCP serverهایی را که استفاده نمی‌کنی با /mcp disable <name> غیرفعال کن تا تعریف‌های ابزارشان از کانتکست حذف شود
فایل‌های حافظه‌ی CLAUDE.md بزرگ را کوتاه کن، یا دستورالعمل‌ها را به قواعدِ محدودشده به مسیر منتقل کن که فقط وقتی مرتبط‌اند بارگذاری می‌شوند
ساب‌ایجنت‌ها هر تعریفِ ابزارِ MCP را از نشستِ والد به ارث می‌برند، که می‌تواند پنجره‌ی کانتکستشان را پیش از نوبتِ اول پر کند. پیش از ساختِ ساب‌ایجنت‌ها MCP serverهایی را که استفاده نمی‌کنی غیرفعال کن.
auto-compact به‌صورت پیش‌فرض روشن است و معمولاً جلوی این خطا را می‌گیرد. اگر DISABLE_AUTO_COMPACT را تنظیم کرده‌ای، آن را دوباره فعال کن یا پیش از پرشدنِ پنجره دستی /compact را اجرا کن.

برای یک نمای تعاملی از نحوه‌ی پرشدنِ کانتکست، کاوشِ پنجره‌ی کانتکست را ببین.

Error during compaction: Conversation too long

خودِ /compact شکست خورد چون فضای کافیِ آزاد برای نگه‌داشتنِ خلاصه‌ای که تولید می‌کند وجود ندارد.

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

این می‌تواند وقتی پنجره در لحظه‌ی فعال‌شدنِ auto-compact از قبل پر است اتفاق بیفتد، یا وقتی پس از دیدنِ Prompt is too long دستی /compact را اجرا می‌کنی.

چه کار کنی:

Esc را دو بار بزن تا فهرستِ پیام باز شود و چند نوبت به عقب برگرد. این جدیدترین پیام‌ها را از کانتکست می‌اندازد. سپس دوباره /compact را اجرا کن.
اگر عقب‌رفتن فضای کافی آزاد نکرد، /clear را اجرا کن تا یک نشستِ تازه شروع کنی. مکالمه‌ی قبلی‌ات حفظ می‌شود و می‌توان با /resume دوباره بازش کرد.

Request too large

بدنه‌ی خامِ درخواست پیش از توکنایز شدن از حدِ بایتِ API فراتر رفت، معمولاً به‌خاطرِ یک فایل یا پیوستِ بزرگِ چسبانده‌شده.

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

این یک حدِ اندازه روی درخواستِ HTTP است، جدا از حدِ پنجره‌ی کانتکست.

چه کار کنی:

Esc را دو بار بزن و از نوبتی که محتوای بیش‌ازحد را اضافه کرد عقب‌تر برگرد
به فایل‌های بزرگ به‌جای چسباندنِ محتوایشان با مسیر ارجاع بده، تا Claude بتواند آن‌ها را تکه‌تکه بخواند
برای تصاویر، تصویر خیلی بزرگ بود را در ادامه ببین

Image was too large

یک تصویرِ چسبانده‌شده یا پیوست‌شده از حدودِ اندازه یا ابعادِ API فراتر می‌رود.

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

{/* min-version: 2.1.142 */}Claude Code تصویرِ غیرقابل‌پردازش را با یک placeholder متنی جایگزین می‌کند و retry می‌کند، پس پیام‌های بعدی موفق می‌شوند. روی نسخه‌های قبل از 2.1.142، یک تصویرِ چسبانده‌شده می‌توانست در مکالمه بماند و همان خطا را روی هر پیامِ بعدی تکرار کند. برای بازیابی روی آن نسخه‌ها، Esc را دو بار بزن و از نوبتی که تصویر در آن اضافه شد عقب‌تر برگرد.

چه کار کنی:

تصویر را پیش از چسباندن resize کن. API تصاویر را تا ۸۰۰۰ پیکسل روی بلندترین لبه برای یک تصویرِ تکی می‌پذیرد، یا ۲۰۰۰ پیکسل وقتی تصاویرِ زیادی در کانتکست هستند.
به‌جای کلِ صفحه، یک اسکرین‌شاتِ محدودتر از ناحیه‌ی مرتبط بگیر

Unable to resize image

Claude Code نتوانست یک تصویرِ پیوست‌شده را پیش از فرستادن به API کوچک کند.

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code معمولاً تصاویرِ بزرگ را به‌صورت خودکار resize می‌کند. این خطاها یعنی پردازشگرِ بومیِ تصویر در بارگذاری شکست خورد یا خطا برگرداند، پس نشد تصویر را برای جا شدن در حدودِ API ریسایز کرد.

چه کار کنی:

اگر پیام از تو می‌خواهد تصویر را تبدیل کنی، آن را به PNG، JPEG، GIF یا WebP تبدیل و دوباره پیوست کن. Claude Code می‌تواند ابعادِ این فرمت‌ها را بدونِ پردازشگرِ تصویر تأیید کند.
اگر پیام یک حدِ ابعاد یا اندازه گزارش می‌کند، تصویر را پیش از پیوست به زیرِ آن حد resize یا فشرده کن.

PDF errors

PDFی که پیوست کردی نتوانست پردازش شود.

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

چه کار کنی:

برای PDFهای بیش‌ازحد بزرگ، از Claude بخواه به‌جای پیوستِ کلِ فایل یک بازه‌ی صفحه را با ابزارِ Read بخواند، یا با ابزاری مثلِ pdftotext متن را استخراج کن و فایلِ خروجی را با مسیر ارجاع بده
برای PDFهای محافظت‌شده یا نامعتبر، رمز را بردار یا فایل را از اپلیکیشنِ منبعش دوباره export کن، سپس دوباره امتحان کن

Extra inputs are not permitted

یک پراکسی یا LLM gateway بینِ Claude Code و API هدرِ درخواستِ anthropic-beta را حذف کرد، پس API فیلدهایی را که به آن وابسته‌اند رد کرد.

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code فیلدهای فقط-beta مثلِ context_management، effort و input_examples ابزار را کنارِ یک هدرِ anthropic-beta که فعالشان می‌کند می‌فرستد. وقتی یک gateway بدنه را forward می‌کند اما هدر را می‌اندازد، API فیلدهایی می‌بیند که نمی‌شناسد.

چه کار کنی:

gateway خود را پیکربندی کن تا هدرِ anthropic-beta را forward کند. پیکربندیِ LLM gateway را ببین.
به‌عنوان fallback، پیش از اجرا CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را تنظیم کن. این قابلیت‌هایی را که به هدرِ beta نیاز دارند غیرفعال می‌کند تا درخواست‌ها از طریقِ یک gateway که نمی‌تواند آن را forward کند موفق شوند.

There’s an issue with the selected model

نامِ مدلِ پیکربندی‌شده شناسایی نشد یا حسابت به آن دسترسی ندارد. از نسخه‌ی v2.1.160 راهنماییِ پایانی، که اینجا در فرمِ تعاملی‌اش نشان داده شده، بسته به سطح فرق می‌کند.

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

چه کار کنی:

CLI تعاملی: /model را اجرا کن تا از مدل‌های موجود برای حسابت انتخاب کنی.
حالتِ غیرتعاملی (-p): --model را با یک اَلیاس یا شناسه‌ی معتبر پاس بده، یا ANTHROPIC_MODEL را تنظیم کن. متنِ خطا روی این سطح Run --model را نشان می‌دهد.
Agent SDK: متنِ خطا راهنمایی را حذف می‌کند چون مدل برنامه‌ای تنظیم می‌شود. model روی Options را در TypeScript یا ClaudeAgentOptions(model=...) را در Python تنظیم کن، و خطای ساختاریافته‌ی model_not_found را مدیریت کن تا retry یا انتخابگرِ مدلِ خودت را نمایان کنی.
از یک اَلیاس مثلِ sonnet یا opus به‌جای یک شناسه‌ی کاملِ نسخه‌دار استفاده کن. اَلیاس‌ها به یک پیش‌فرضِ نگه‌داری‌شده resolve می‌شوند پس کهنه نمی‌شوند. پیکربندیِ مدل را ببین.
اگر مدلِ اشتباه مدام در CLI برمی‌گردد، یک شناسه‌ی کهنه جایی تنظیم شده. به ترتیبِ اولویت بررسی کن: پرچمِ --model، متغیرِ محیطیِ ANTHROPIC_MODEL، سپس فیلدِ model در .claude/settings.local.json، .claude/settings.json پروژه‌ات، و ~/.claude/settings.json. مقدارِ کهنه را حذف کن و Claude Code به پیش‌فرضِ حسابت برمی‌گردد.
برای استقرارهای Vertex AI، عیب‌یابیِ Vertex AI را ببین.

Claude Opus is not available with the Claude Pro plan

پلنِ اشتراکیِ فعالت مدلی را که انتخاب کردی در بر نمی‌گیرد.

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

چه کار کنی:

/model را اجرا کن و مدلی را انتخاب کن که پلنت در بر می‌گیرد
اگر اخیراً پلنت را ارتقا داده‌ای و همچنان این را می‌بینی، /logout سپس /login را اجرا کن. توکنِ ذخیره‌شده پلنت را در زمانِ ورود منعکس می‌کند، پس ارتقا در وب تا زمانی که دوباره احراز هویت نکنی در یک نشستِ موجود اثر نمی‌کند.
برای اینکه کدام مدل‌ها را هر پلن در بر می‌گیرد، claude.com/pricing را ببین

thinking.type.enabled is not supported for this model

نسخه‌ی Claude Code تو از کمینه‌ی موردنیاز برای Opus 4.7 یا Opus 4.8 قدیمی‌تر است. CLI یک پیکربندیِ thinking فرستاد که مدل دیگر نمی‌پذیردش.

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

چه کار کنی:

claude update را اجرا کن و Claude Code را restart کن. Opus 4.7 به v2.1.111 یا بالاتر نیاز دارد. Opus 4.8 به v2.1.154 یا بالاتر نیاز دارد
اگر نمی‌توانی ارتقا دهی، /model را اجرا کن و به‌جایش Opus 4.6 یا Sonnet را انتخاب کن
اگر در Agent SDK به این برخوردی، عیب‌یابیِ SDK را ببین

Thinking budget exceeds output limit

بودجه‌ی extended thinking پیکربندی‌شده از بیشینه‌ی طولِ پاسخ فراتر می‌رود، پس فضایی برای خودِ جواب نمی‌ماند.

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code این مقدارها را روی Anthropic API به‌صورت خودکار تنظیم می‌کند. معمولاً این خطا را روی Amazon Bedrock یا Google Vertex AI می‌بینی وقتی MAX_THINKING_TOKENS بالاتر از حدِ خروجیِ ارائه‌دهنده تنظیم شده، یا وقتی plan mode بودجه‌ی thinking را بالا می‌برد.

چه کار کنی:

MAX_THINKING_TOKENS را پایین بیاور، یا CLAUDE_CODE_MAX_OUTPUT_TOKENS را بالاتر از بودجه‌ی thinking ببر
برای اینکه بودجه چطور با طولِ خروجی تعامل می‌کند، extended thinking را ببین

Tool use or thinking block mismatch

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

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

هر سه گونه یک معنی دارند: دنباله‌ی بلوک‌های tool_use، tool_result و thinking در تاریخچه دیگر با آنچه API انتظار دارد نمی‌خواند.

چه کار کنی:

{/* max-version: 2.1.155 */}اگر از Opus 4.7 یا Opus 4.8 استفاده می‌کنی، اول claude update را اجرا کن. نسخه‌های قبل از v2.1.156 می‌توانند این خطا را حین استفاده‌ی عادی از ابزار راه بیندازند، و /rewind پاکش نمی‌کند.
/rewind را اجرا کن، یا Esc را دو بار بزن، تا به یک checkpoint پیش از نوبتِ خراب برگردی و از آنجا ادامه دهی. برای اینکه checkpointها چطور ساخته و بازگردانده می‌شوند، Checkpointing را ببین.

Usage Policy refusal

API از پاسخ‌دادن خودداری کرد چون محتوایی در مکالمه یک بررسیِ Usage Policy را راه انداخت. پیام شاملِ یک Request ID است که اگر باور داری خودداری اشتباه است می‌توانی به پشتیبانی نقل کنی.

API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

این بررسی کلِ مکالمه را ارزیابی می‌کند، نه فقط جدیدترین پرامپتت، پس فرستادنِ یک پیامِ جدید در همان نشست معمولاً همان خودداری را دوباره راه می‌اندازد. همین پس از خروج و بازکردنِ دوباره‌ی نشست با --continue یا --resume هم صدق می‌کند، چون رونوشتِ روی دیسک همچنان محتوای راه‌انداز را در بر دارد.

چه کار کنی:

Esc را دو بار بزن یا /rewind را اجرا کن تا به یک checkpoint پیش از نوبتی که خودداری را راه انداخت برگردی، سپس بازنویسی کن یا رویکردِ متفاوتی پیش بگیر. Checkpointing را ببین.
اگر نمی‌توانی تشخیص دهی کدام نوبت آن را ایجاد کرد، /clear را اجرا کن تا یک مکالمه‌ی تازه در همان پروژه شروع کنی. مکالمه‌ی قبلی‌ات روی دیسک حفظ می‌شود و در /resume در دسترس می‌ماند.
در حالتِ غیرتعاملی (-p)، که rewind در دسترس نیست، با یک پرامپتِ بازنویسی‌شده در یک نشستِ جدید بدونِ --continue retry کن. بررسی‌های سیاست بسته به مدل فرق می‌کنند، پس سوییچ به مدلِ دیگری با --model هم ممکن است در برخی موارد خودداری را حل کند.

پاسخ‌ها از حدِ معمول کم‌کیفیت‌تر به نظر می‌رسند

اگر جواب‌های Claude کمتر از آنچه انتظار داری توانمند به نظر می‌رسند اما هیچ خطایی نشان داده نمی‌شود، علت معمولاً وضعیتِ مکالمه است نه خودِ مدل. Claude Code بی‌صدا نسخه‌های مدل را عوض نمی‌کند. می‌تواند در سه موردِ مشخص به یک مدلِ fallback سوییچ کند:

یک --fallback-model پیکربندی‌شده پس از یک خطای در دسترس‌بودن، فقط برای آن نوبت، با یک اطلاعیه در رونوشت، به دست می‌گیرد
یک بررسیِ شروعِ Bedrock یا Vertex AI مدلِ پیش‌فرضت را غیرقابل‌دسترس می‌یابد
fallback خودکارِ مدل روی Fable 5 نشست را به مدلِ پیش‌فرضِ Opus منتقل می‌کند و یک اطلاعیه در رونوشت نشان می‌دهد

بررسیِ انتخابِ مدل در ادامه موردِ دوم و سوم را می‌گیرد؛ اولی به‌جای یک تغییرِ /model به‌صورت یک اطلاعیه در رونوشت ظاهر می‌شود. پیکربندیِ مدل توضیح می‌دهد هر fallback کِی اعمال می‌شود.

این‌ها را اول بررسی کن:

انتخابِ مدل: /model را اجرا کن تا تأیید کنی روی مدلی هستی که انتظار داری. یک انتخابِ /model قبلی یا یک متغیرِ محیطیِ ANTHROPIC_MODEL ممکن است تو را روی مدلی کوچک‌تر از آنچه قصد داشتی گذاشته باشد.
سطحِ effort: /effort را اجرا کن تا سطحِ استدلالِ فعلی را بررسی کنی و برای دیباگ یا کارِ طراحیِ سخت بالایش ببری. پیش‌فرض‌ها بسته به مدل فرق می‌کنند، پس پیش از فرضِ اینکه زیرِ بیشینه‌ای بررسی کن. برای پیش‌فرض‌های به‌ازای هر مدل و میان‌برِ ultrathink، تنظیمِ سطحِ effort را ببین.
فشارِ کانتکست: /context را اجرا کن تا ببینی پنجره چقدر پر است. اگر نزدیکِ ظرفیت است، در یک نقطه‌ی شکستِ طبیعی /compact یا /clear را اجرا کن تا از نو شروع کنی. برای اینکه auto-compact چطور نوبت‌های قبلی را تحتِ‌تأثیر می‌گذارد، کاوشِ پنجره‌ی کانتکست را ببین.
دستورالعمل‌های کهنه: فایل‌های CLAUDE.md بزرگ یا قدیمی و تعریف‌های ابزارِ MCP کانتکست را مصرف می‌کنند و می‌توانند پاسخ‌ها را هدایت کنند. /doctor فایل‌های حافظه‌ی بیش‌ازحد بزرگ و تعریف‌های ساب‌ایجنت را علامت می‌زند؛ /context مصرفِ توکنِ ابزارِ MCP را نشان می‌دهد.

وقتی یک پاسخ خراب می‌شود، rewind معمولاً بهتر از پاسخ‌دادن با اصلاحات کار می‌کند. Esc را دو بار بزن یا /rewind را اجرا کن تا به پیش از نوبتِ بد برگردی، سپس پرامپت را با جزئیاتِ بیشتر بازنویسی کن. اصلاح در همان رشته، تلاشِ اشتباه را در کانتکست نگه می‌دارد، که می‌تواند جواب‌های بعدی را به آن لنگر بزند. Checkpointing را ببین.

اگر کیفیت پس از بررسیِ موارد بالا همچنان نامناسب به نظر می‌رسد، /feedback را اجرا کن و توضیح بده چه انتظار داشتی در برابرِ آنچه گرفتی. بازخوردِ ارسال‌شده از این راه شاملِ رونوشتِ مکالمه است، که سریع‌ترین راه برای Anthropic در تشخیصِ یک پسرفتِ واقعی است. اگر /feedback در محیطت در دسترس نیست، گزارشِ خطا را ببین.

گزارشِ خطا

این صفحه خطاهای Claude API را پوشش می‌دهد. برای خطاهای سایر اجزای Claude Code، راهنمای مربوطه را ببین:

MCP server در اتصال یا احراز هویت شکست خورد: MCP
اسکریپتِ hook شکست خورد یا یک ابزار را مسدود کرد: دیباگِ hookها
دسترسیِ رد‌شده یا خطاهای فایل‌سیستم هنگامِ نصب: عیب‌یابیِ نصب و ورود

اگر یک خطا اینجا فهرست نشده یا اصلاحِ پیشنهادی کمک نمی‌کند:

/feedback را داخلِ Claude Code اجرا کن تا رونوشت و یک توضیح به Anthropic فرستاده شود. این دستور پیشنهادِ بازکردنِ یک issue از پیش پرشده در GitHub را هم می‌دهد. روی Bedrock، Vertex AI، Foundry و سایر ارائه‌دهنده‌های شخصِ ثالث، /feedback به‌جایش یک آرشیوِ محلی ذخیره می‌کند که می‌توانی به نماینده‌ی حسابِ Anthropic خود بفرستی.
/doctor را اجرا کن تا مشکل‌های پیکربندیِ محلی را بررسی کنی
status.claude.com را برای حادثه‌های فعال بررسی کن
issueهای موجود را در GitHub جست‌وجو کن