چرا کلود ارور می‌ده؟ راهنمای رفع ارورهای Claude، کلاد کد و API

وقتی کلود وسط کار ارور می‌ده، اول متن پیام رو بخون. پرشدن سهمیه، شلوغی سرویس و مشکل ورود، راه‌حل‌های متفاوتی دارن. مثلاً پاک‌کردن کش مرورگر سهمیه حسابت رو برنمی‌گردونه و خرید پلن بالاتر هم همه خطاها رو برطرف نمی‌کنه.

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

اگر هنوز با بخش‌های مختلف این ابزار آشنا نیستی، راهنمای کامل کلود کمک می‌کنه تفاوت چت، مدل‌ها و ابزارهاش رو بهتر بشناسی.

چرا کلود کار نمی‌کنه؟

اول از همه این سه مورد رو ببین:

۱. وضعیت سرویس کلاد رو بررسی کن

صفحه وضعیت کلود رو باز کن و ببین اختلالی ثبت شده یا نه. اگر موردی وجود داره، بررسی کن به همون بخشی مربوط باشه که استفاده می‌کنی؛ مثلاً ورود، سایت، API یا یک مدل مشخص.

اگر اختلال به کارت مربوطه، اطلاعیه همون بخش رو دنبال کن. البته سالم‌بودن صفحه وضعیت هم به‌تنهایی ثابت نمی‌کنه مشکل حتماً از دستگاه توئه.

۲. پیام خطا رو کامل بخون

اگر زمان ریست نوشته شده، احتمالاً سهمیه مصرفت پر شده. اگر پیام از شلوغی یا ظرفیت حرف می‌زنه، مشکل متفاوتی داری.

توی API هم فقط شماره خطا کافی نیست؛ متن و جزئیات پاسخ رو نگه دار.

۳. ببین مشکل دقیقاً کجا اتفاق می‌افته

فقط یک گفتگو باز نمی‌شه یا هیچ پیامی نمی‌تونی بفرستی؟ مشکل فقط توی مرورگره یا اپ هم همین وضعیت رو داره؟

همین چند بررسی ساده کمک می‌کنه بی‌دلیل همه تنظیمات رو پاک نکنی.

ارور «5-hour limit reached»؛ سهمیه پنج‌ساعته‌ات پر شده

این پیام یعنی به سقف مصرف بازه پنج‌ساعته رسیدی. اگر پیام You’ve reached your weekly limit رو می‌بینی، محدودیت مربوط به سهمیه هفتگیه. زمان بازگشت دسترسی معمولاً داخل همون پیام نوشته می‌شه.

برای ادامه، این گزینه‌ها رو بررسی کن:

• منتظر ریست بمون: زمان نوشته‌شده در پیام رو ملاک قرار بده.
• اعتبار اضافه رو بررسی کن: اگر حسابت این امکان رو داره، می‌تونی با فعال‌کردن usage credits و پرداخت هزینه مصرف ادامه بدی.
• نیازت رو با پلن مقایسه کن: اگر مرتب به سقف می‌رسی، ظرفیت پلن بالاتر رو بررسی کن.

بازکردن چت جدید یا عوض‌کردن مرورگر، سهمیه مصرف رو ریست نمی‌کنه.

استفاده از اعتبار اضافه هم تا وقتی ادامه پیدا می‌کنه که موجودی و سقف هزینه حسابت اجازه بدن. گاهی پیام «نزدیک سقف» هنوز نمایش داده می‌شه، ولی درخواست بعدی با اعتبار اضافه انجام می‌شه.

اگر از نسخه رایگان استفاده می‌کنی، قبل از ارتقا نگاهی به امکانات و محدودیت‌های Claude Pro بنداز. اگر هم Pro داری و ظرفیتش برای کارت کافی نیست، مطلب پلن Claude Max و تفاوت ظرفیت‌های اون به انتخابت کمک می‌کنه.

برای بررسی پلن‌های موجود و شرایط فعال‌سازی هم می‌تونی صفحه اکانت Claude رو ببینی.

ارور «Due to unexpected capacity constraints…»؛ سرویس موقتاً ظرفیت کافی نداره

این پیام معمولاً به معنی پرشدن سهمیه شخصی تو نیست. کلود در اون لحظه با تقاضای زیادی روبه‌رو شده و نمی‌تونه درخواستت رو پاسخ بده.

راهکار پیشنهادی اینه که چند دقیقه صبر کنی و دوباره امتحان کنی. برای خود این پیام، پاک‌کردن کش یا تغییر تنظیمات مرورگر راه‌حل اصلی نیست.

این نوع مدیریت ظرفیت با اختلال فنی فرق داره و در صفحه وضعیت نمایش داده نمی‌شه.

«Your message will exceed the length limit»؛ پیام یا فایل‌ها خیلی بزرگن

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

برای ادامه:

• فایل‌های اضافی رو بردار: فقط چیزهایی رو نگه دار که برای سؤال فعلی لازمن.
• متن رو بخش‌بندی کن: هر بخش رو جدا بررسی کن و در پایان جمع‌بندی بخواه.
• قسمت موردنیاز رو بفرست: برای بررسی یک بند، لازم نیست کل سند رو اضافه کنی.
• چت تازه بساز: اگر سابقه گفتگو لازم نیست، اطلاعات ضروری رو به یک گفتگوی جدید منتقل کن.

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

«There was an error logging you in»؛ چرا وارد کلود نمی‌شم؟

این پیام یعنی ورودت انجام نشده، اما از روی همین جمله نمی‌شه علت دقیق رو فهمید.

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

گاهی هم مشکل به روش ورود مربوطه:

1- رمز حساب کلودم چیه؟

کلود برای حساب معمولی رمز عبور جداگانه نداره. با «Continue with Google» وارد شو یا از طریق «Continue with email» لینک ورود بگیر.

اگر در صفحه ورود گوگل ازت رمز خواسته شد، منظور رمز حساب گوگلته، نه رمز کلود.

2- ایمیل ورود نمیاد

اول آدرس ایمیلت رو بررسی کن. بعد پوشه‌های Spam و Junk رو ببین و دریافت پیام از دامنه @mail.anthropic.com رو مجاز کن. چند دقیقه صبر کن و دوباره لینک بخواه.

3- لینک رو روی گوشی باز کردم، ولی می‌خوام با کامپیوتر وارد بشم

اگر لینک رو روی دستگاه دیگری باز کنی، کد تأیید می‌گیری. مثلاً اگر از کامپیوتر درخواست دادی و لینک رو روی گوشی باز کردی، کد نمایش‌داده‌شده رو در صفحه ورود کامپیوتر وارد کن.

4- با Apple Hide My Email ثبت‌نام کردم

اپل در این حالت یک آدرس واسط برای حسابت می‌سازه؛ مثلاً example@privaterelay.appleid.com.

برای ورود با ایمیل، آدرس کامل و مخصوص حساب خودت رو وارد کن و «Continue with email» رو بزن. لینک ورود به ایمیل متصل به حساب اپلت فرستاده می‌شه.

اگر آدرس واسط رو نمی‌دونی و هنوز در اپ کلود روی آیفون وارد حسابت هستی، اون رو از بخش Settings پیدا کن.

«Output blocked by content filtering policy»؛ چرا خروجی مسدود شد؟

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

اگر هدفت فهمیدن مطلب یا گرفتن خلاصه است، همون رو روشن بنویس. مثلاً:

نکات اصلی این موضوع رو با بیان خودت توضیح بده؛ نیازی به تکرار عین متن نیست.

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

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

کد تأیید شماره تلفن کلود نمیاد؛ چیکار کنم؟

برای تأیید شماره باید از شماره قابل قبول در منطقه پشتیبانی‌شده استفاده بشه.

اگر کد دریافت نمی‌کنی:

• شماره و پیش‌شماره کشور رو دوباره بررسی کن.
• اگر بیش از پنج دقیقه گذشته، Try again رو بزن.
• تازه‌ترین کد دریافتی رو وارد کن؛ کدها موقتی هستن.
• اگر پیام استفاده بیش از حد از شماره رو می‌بینی، ممکنه شماره به حساب‌های قبلی متصل باشه و نیاز به پیگیری داشته باشه.

داشتن شماره کشور پشتیبانی‌شده به‌تنهایی کافی نیست؛ راهنمای رسمی، حضور در منطقه پشتیبانی‌شده رو هم شرط استفاده معرفی می‌کنه.

«Your account is on hold»؛ حسابم محدود شده؟

اول توضیح صفحه رو بخون. ممکنه خود حسابت محدود شده باشه یا یکی از سازمان‌هایی که عضوش هستی متوقف شده باشه.

اگر گزینه Request a review رو می‌بینی، از همون مسیر درخواست بررسی بده. دلیل مشکل رو روشن توضیح بده، اما انتظار نتیجه تضمینی نداشته باش.

تغییر مرورگر یا پاک‌کردن کش، محدودیت حساب رو برطرف نمی‌کنه.

چرا کلود وسط گفتگو مدل رو عوض می‌کنه؟

تغییر مدل همیشه ارور نیست. بعضی مدل‌ها، از جمله نسخه‌هایی از Fable، Opus و Sonnet، ممکنه به‌دلیل بررسی‌های ایمنی، ادامه پاسخ رو به مدل دیگری منتقل کنن.

مدل مقصد به مدل اولیه و نوع درخواست بستگی داره. حتی فایل‌ها، منابع متصل و پیام‌های قبلی هم ممکنه روی این تصمیم اثر بذارن.

اگر تنظیم مربوط در حسابت وجود داشته باشه، از مسیر Settings > Capabilities می‌تونی گزینه Switch models when a message is flagged رو تغییر بدی.

خاموش‌کردن این گزینه، محدودیت ایمنی رو حذف نمی‌کنه؛ ممکنه درخواست به‌جای انتقال به مدل دیگر، متوقف بشه.

خطاهای رایج Claude Code

اگر با کلود روی فایل‌های پروژه کار می‌کنی، مهمه خطای کد برنامه رو از خطای خود سرویس جدا کنی. اینکه برنامه‌ات اجرا نمی‌شه با اینکه Claude Code به سرور وصل نمی‌شه، دو مشکل متفاوتن.

در مطلب مقایسه ChatGPT و Claude برای کدنویسی هم تفاوت کار داخل چت و ابزارهای متصل به پروژه رو توضیح دادیم.

«Repeated 529 Overloaded errors»؛ درخواست چند بار به شلوغی خورده

این پیام یعنی Claude Code چند بار تلاش کرده، اما درخواست‌ها همچنان با خطای شلوغی سرویس روبه‌رو شدن.

وضعیت سرویس رو ببین و کمی بعد دوباره امتحان کن. انتخاب یک مدل قابل دسترس دیگه با /model هم ممکنه کمک کنه، اما قطعی نیست.

«You’ve hit your session limit»؛ تغییر مدل کمکی می‌کنه؟

اگر سهمیه عمومی جلسه یا هفته پر شده باشه، تغییر مدل سهمیه رو برنمی‌گردونه.

اما اگر پیام مشخصاً بگه به سقف Opus یا Sonnet رسیدی، رفتن به مدل قابل دسترس خارج از اون خانواده ممکنه اجازه ادامه بده. متن دقیق خطا رو ملاک قرار بده.

«Credit balance is too low»؛ اعتبار کدوم حساب تموم شده؟

این پیام رو با پرشدن سهمیه اشتراک یکی ندون.

اگر قصدت استفاده از اشتراک کلوده، با /status ببین Claude Code از چه روشی وارد شده. تنظیماتی مثل ANTHROPIC_API_KEY ممکنه باعث بشن اتصال از مسیر API انجام بشه و باید بررسی بشن.

اگر عمداً با API کار می‌کنی، اعتبار و صورتحساب همون حساب رو ببین. حذف کلید API، مشکل کمبود اعتبار اون حساب رو حل نمی‌کنه.

خطاهای Claude API؛ معنی کدها چیه؟

اگر از API استفاده می‌کنی، کد HTTP رو همراه با error.type و متن خطا بخون. دو خطا با شماره یکسان، همیشه راه‌حل یکسانی ندارن.

برای خطای ۴۰۱، اول مطمئن شو برنامه کلید درست رو می‌خونه. اگر کلید لغو یا منقضی شده، کلید معتبر جایگزین کن. ساخت کلید جدید بدون اصلاح تنظیمات برنامه، لزوماً مشکل رو حل نمی‌کنه.

خطای ۴۲۹ همیشه با کمی صبر حل می‌شه؟

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

برای تشخیص این حالت در Messages API، این فیلد رو بررسی کن:

error.details.error_code

اگر مقدار زیر رو دیدی، خطا به سقف هزینه ماهانه tier مربوطه:

enforced_spend_limit_reached

این پاسخ هدر retry-after نداره. باید وضعیت هزینه و زمان بازگشت دسترسی رو بررسی کنی.

سقف هزینه‌ای که خودت تعیین کردی معمولاً خطای ۴۰۰ می‌ده؛ محدودیت Workspace مربوط به Claude Code می‌تونه استثنا باشه و ۴۲۹ برگردونه.

تلاش مجدد خودکار یعنی چی؟

SDK رسمی بعضی خطاهای موقت رو به‌صورت پیش‌فرض دو بار دوباره امتحان می‌کنه. فاصله بین تلاش‌ها بیشتر می‌شه تا درخواست‌ها پشت‌سرهم به سرویس فشار نیارن. این رفتار قابل تنظیمه.

در حالت Streaming هم ممکنه ابتدا HTTP 200 دریافت کنی، ولی خطا بعداً وسط جریان پاسخ اتفاق بیفته. پس فقط موفق‌بودن شروع درخواست رو بررسی نکن؛ رویدادهای خطای داخل پاسخ رو هم مدیریت کن.

شناسه request_id رو، اگر موجوده، برای پیگیری نگه دار.

سؤالات متداول درباره ارورهای کلود

توی این بخش قراره مهم‌ترین سوالاتی که ممکنه برات پیش اومده باشه رو بررسی کنیم:

خرید پلن بالاتر همه ارورهای کلود رو برطرف می‌کنه؟

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

بازکردن چت جدید، محدودیت مصرف کلود رو ریست می‌کنه؟

نه. چت جدید می‌تونه برای سبک‌کردن محتوای گفتگو مفید باشه، اما سهمیه پنج‌ساعته یا هفتگی رو برنمی‌گردونه.

چرا صفحه وضعیت سالمه ولی کلود جواب نمی‌ده؟

ممکنه با محدودیت ظرفیت، مشکل حساب، مرورگر یا اتصال روبه‌رو باشی. نبودن اطلاعیه در صفحه وضعیت، همه علت‌های احتمالی رو رد نمی‌کنه.

برای خطای ۵۲۹ کلود باید کلید API رو عوض کنم؟

معمولاً نه. این خطا به بار سرویس مربوطه و تغییر کلید راه‌حل اصلیش نیست.

خطای ۴۲۹ کلود یعنی بیش از حد درخواست فرستادم؟

ممکنه، اما همیشه نه. بعضی سقف‌های هزینه هم همین کد رو می‌دن. متن خطا، جزئیات پاسخ و هدرها رو بررسی کن.

تو کدوم ارور رو دیدی و چه راهی بهت کمک کرد؟ تجربه‌ات رو توی کامنت‌ها بنویس تا بقیه هم استفاده کنن.