Claude 529 در برابر 429 در برابر سقف هفتگی
سه خطا، سه علت، سه راهحل
همه آن‌ها حس «سهمیه‌ام تمام شده» را می‌دهند، اما 529، 429 و سقف هفتگی علت‌های کاملاً متفاوتی دارند — تا 2026-10-20: 529 اضافهبار سمت سرور (overloaded_error) است و با backoff نمایی برطرف میشود؛ 429 یا محدودیت نرخ درخواست است که با کاهش سرعت برطرف میشود، یا سقف هزینه ماهانه شما که هدر retry-after ندارد و فقط ماه بعد بازنشانی میشود؛ سقف هفتگی هم سهمیه مصرف پلن Pro/Max است که تلاش مجدد در آن هیچ کاری نمی‌کند و باید منتظر بازنشانی بمانید یا پلن خود را ارتقا دهید. اگر این‌ها را با هم اشتباه بگیرید، ساعت‌ها را با تلاش مجدد به روش اشتباه هدر می‌دهید.
به‌روزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورتحساب بهازای توکن، آماده به کار در چند دقیقه.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
سه خطا، سه مسیر بازیابی
اضافهبار (ظرفیت سمت سرور)
سرورهای Anthropic تحت بار کلی هستند — بی‌ربط به درخواست شما. تلاش مجدد با backoff نمایی بی‌خطر است.
rate_limit_error (شما محدود شده‌اید)
429 رسمی دو حالت را پوشش می‌دهد: محدودیت نرخ یا هم‌زمانی که با کاهش سرعت برطرف میشود، یا سقف هزینه ماهانه سطح مصرف که هدر retry-after ندارد و ماه بعد بازنشانی میشود.
«به سقف هفتگی خود رسیده‌اید»
محدودیت HTTP نیست، بلکه سقف مصرف پلن Pro/Max است: سقف 5 ساعته به‌همراه سقف هفتگی که بین Claude و Claude Code مشترک است. تلاش مجدد کمکی نمی‌کند — صبر کنید یا ارتقا دهید.
زمان‌های بازیابی تفاوت بسیار زیادی دارند
529 در چند ثانیه تا چند دقیقه برطرف میشود؛ 429 مربوط به محدودیت نرخ پس از چند ده ثانیه backoff برطرف میشود، اما 429 مربوط به سقف هزینه تا 00:00 UTC روز اول ماه بعد منتظر می‌ماند؛ سقف هفتگی نیز تا بازنشانی هفتگی بعدی منتظر می‌ماند.
هر خطا در واقع چه می‌گوید
تا تاریخ 2026-10-20، مستندات رسمی خطاهای Anthropic این سه حالت را به‌روشنی از هم جدا میکند. خطای 529 دارای type با مقدار overloaded_error است — متن رسمی این است: «API بهطور موقت بیش از حد بارگذاری شده است.» — و مستندات اشاره می‌کنند که این خطا میتواند زمانی رخ دهد که API ترافیک بالایی در میان همه کاربران تجربه کند: این موضوع هیچ ارتباطی با محتوای درخواست، تعداد توکن یا انتخاب مدل شما ندارد، بنابراین تلاش مجدد معمولاً کار میکند، اما به‌جای تکرار بی‌وقفه و فوری از عقبنشینی نمایی استفاده کنید، وگرنه بر ازدحام می‌افزایید. خطای 429 دارای type با مقدار rate_limit_error است، و متن رسمی سه وضعیت را پوشش می‌دهد: سازمان شما به محدودیت نرخ درخواست رسیده است، به سقف هزینه ماهانه سطح مصرف خود رسیده است، یا به سقف هزینه در فضای کاری Claude Code رسیده است. خطای 429 مربوط به محدودیت نرخ درخواست چیزی است که می‌توانید مستقیماً روی آن اقدام کنید: هم‌زمانی را کاهش دهید، فاصله بین polling را بیشتر کنید، یا درخواست محدودیت بالاتر بدهید؛ جهش شدید در مصرف نیز میتواند محدودیت‌های شتاب مصرف را فعال کند، بنابراین به‌تدریج افزایش دهید. خطای 429 مربوط به سقف هزینه حالت متفاوتی است (سقف‌های رسمی: Start $500، Build $1,000، Scale $200,000): تلاش مجدد کمکی نمی‌کند — بررسی سه‌مرحله‌ای و راه‌حل‌های زیر را ببینید. سقف هفتگی سیستم متفاوتی است: سهمیه‌ای در سطح حساب کاربری برای پلن Claude Code / اشتراک شما. مرکز راهنمایی اعلام میکند که پلن‌های پرداختی سقف جلسه‌ای دارند که هر پنج ساعت بازنشانی میشود و سقف‌های هفتگی که هر هفته یک‌بار بازنشانی می‌شوند و میان Claude و Claude Code مشترک‌اند. وقتی پیام «You've hit your weekly limit» نمایش داده میشود، سهمیه کل چرخه صورتحساب مصرف شده است: هیچ تلاش مجددی کمکی نمی‌کند، و یا باید منتظر بازنشانی رسمی بمانید یا ظرفیت اضافی را فعال کنید.
چرا این تمایز اکنون بیشتر اهمیت دارد
بررسی‌شده در 2026-10-20: مستندات رسمی خطاهای Anthropic می‌گوید 429 نه‌تنها محدودیت‌های نرخ درخواست، بلکه رسیدن به سقف هزینه ماهانه سطح مصرف شما را نیز پوشش می‌دهد. مرکز راهنمایی اعلام میکند که پلن‌های پرداختی سقف جلسه‌ای دارند که هر پنج ساعت بازنشانی میشود و سقف‌های هفتگی که هر هفته یک‌بار بازنشانی می‌شوند، بنابراین پیش از بازنشانی تنها کاری که می‌توانید بکنید انتظار است. سپس تاریخچه پیشنهاد ترویجی: @ClaudeDevs در 2026-08-29 نوشت «+50% تا 14 سپتامبر»؛ مرکز راهنمایی که در 2026-09-20 دریافت شده، به زمان گذشته نوشته شده است، و این پیشنهاد از 13 مه تا 13 سپتامبر 2026 اجرا شد. از 2026-09-14 سقف‌های هفتگی استاندارد 25% بیشتر از پیش از پیشنهاد ترویجی هستند؛ بر اساس محاسبه ما این حدود 17% پایین‌تر از سطح پیشنهاد ترویجی است. حساب‌هایی که به‌ندرت به سقف هفتگی می‌رسند ممکن است از 2026-09-14 آن را برای نخستین‌بار ببینند. اشتباه گرفتن آن با 529/429 معمولاً به‌معنای تکرار بی‌وقفه تلاش‌های مجدد در برابر سهمیه‌ای در سطح حساب کاربری است — بی‌فایده است، و تلاش‌های مجدد تهاجمی می‌توانند شبیه ترافیک غیرعادی به نظر برسند.
خط زمانی
529/429 کدهای وضعیت استاندارد API شرکت Anthropic هستند که از ابتدای وجود API تاکنون وجود داشته‌اند؛ مستندات عمومی و بحث توسعه‌دهندگان بهطور یکدست معنای آن‌ها را بیان می‌کنند.
نسخه 2026-08-18 مرکز راهنمایی افزایش هفتگی +50% را تا 2026-08-31 داشت؛ مقاله‌ای که در 2026-09-20 دریافت شد با زمان گذشته نوشته شده و پایان آن 2026-09-13 است.
@ClaudeDevs در 2026-08-29: «+50% تا 14 سپتامبر»؛ مرکز راهنمایی پایان را 2026-09-13 اعلام میکند. از 2026-09-14 سقف‌های هفتگی استاندارد 25% بالاتر از سطح پیش از طرح تشویقی هستند — بر اساس محاسبه ما حدود 17% پایین‌تر از سطح طرح تشویقی.
تأییدشده در برابر برداشت‌های نادرست رایج
تأییدشده
فیلد type در بدنه خطا (overloaded_error / rate_limit_error) عیناً در مستندات رسمی خطاهای Anthropic آمده است، و خطای 429 که به‌دلیل سقف هزینه ماهانه سطح مصرف رخ می‌دهد، علاوه بر آن error_code enforced_spend_limit_reached را دارد و هدر retry-after ندارد (تا تاریخ 2026-10-20). ساختار دوسطحی سقف هفتگی — سقف جلسه‌ای که هر پنج ساعت بازنشانی میشود به‌همراه سقف هفتگی که هر هفته یک‌بار بازنشانی میشود و میان Claude و Claude Code مشترک است — از مرکز راهنمایی می‌آید. فیلدهای بدنه خطا و قواعد محدودیت در این اسناد رسمی قابل‌اعتمادترین نشانه‌ها برای تفکیک این موارد از یکدیگرند.
برداشت نادرست رایج
یک ادعا که در فضای آنلاین دست‌به‌دست میشود این است که اگر به‌اندازه کافی روی 529 تلاش مجدد کنید، بهطور بی‌صدا به مدلی کوچکتر یا کوانتیزه‌شده هدایت می‌شوید. ما هیچ بیانیه رسمی یا شواهد معتبر دست‌اولی برای این موضوع پیدا نکردیم. 529 فقط فشار ظرفیت را نشان می‌دهد — به این معنا نیست که درخواست شما به مدل دیگری هدایت شده است؛ بنابراین برخورد با تعداد تلاش مجدد بهعنوان راهی برای «تغییر مدل» قابل‌اعتماد نیست.
در عمل چه باید کرد: سه مسیر کاملاً متفاوت
529 / 429ِ ناشی از محدودیت نرخ درخواست: کلاینت شما میتواند آن را برطرف کند
یک 529 را با عقبنشینی نمایی دوباره امتحان کنید (1s → 2s → 4s… به‌همراه jitter)؛ SDK رسمی از قبل بهطور پیشفرض چنین خطاهای گذرا را دو بار تلاش مجدد میکند و در صورت وجود، هدر retry-after را رعایت میکند. برای 429، ابتدا محدودیت نرخ درخواست را از سقف هزینه ماهانه تشخیص دهید: اولی پس از چند ده ثانیه عقبنشینی و کاهش درخواست‌های هم‌زمان برطرف میشود، دومی هدر retry-after ندارد، بنابراین تلاش مجدد بی‌نتیجه است و باید تا 00:00 UTC اولین روز ماه بعد صبر کنید یا درخواست افزایش سقف بدهید. هیچ‌کدام به پشتیبانی انسانی نیاز ندارند.
سقف هفتگی: کلاینت شما نمی‌تواند آن را برطرف کند
سقف هفتگی یک خطای سطح HTTP نیست، بنابراین تلاش مجدد بی‌فایده است. ابتدا نوارهای پیشرفت را در تنظیمات > مصرف بررسی کنید تا ببینید چه مقدار از دوره جاری مصرف شده و چه زمانی بازنشانی میشود، سپس یکی از چهار اقدام را انتخاب کنید: صبر برای بازنشانی هفتگی بعدی حساب کاربری‌تان؛ ارتقا به پلنی با فضای بیشتر؛ فعال‌سازی اعتبار مصرف (بهطور رسمی، پس از اتمام سقف‌های شامل‌شده، مصرف با قیمت مبتنی بر مصرف ادامه می‌یابد)؛ یا استفاده موقت از مدل/ارائه‌دهنده‌ای که سهمیه آن تمام نشده است.
روشی 3 مرحله‌ای برای تشخیص آن‌ها از یکدیگر
مرحله 1: وضعیت HTTP را بررسی کنید — 529، 429، یا اصلاً هیچ کد وضعیت استانداردی وجود ندارد و فقط متن ساده است. مرحله 2: بدنه خطا را بررسی کنید — یک 429 نوع rate_limit_error را دارد، و اگر error_code برابر enforced_spend_limit_reached باشد، به سقف هزینه ماهانه برخورده‌اید؛ یک 429 بدون هدر retry-after که تلاش مجدد نمی‌تواند آن را برطرف کند؛ سقف هفتگی معمولاً اصلاً بدنه خطای استاندارد HTTP نیست؛ پیامی است که CLI یا داشبورد نشان می‌دهد. مرحله 3: پیشرفت مصرف خود را بررسی کنید — نوارهای پیشرفت در تنظیمات > مصرف نشان می‌دهند چه مقدار از سقف نشست پنج‌ساعته و سقف هفتگی را مصرف کرده‌اید، و اگر این بازه صفر باشد و تا بازنشانی چند روز مانده باشد، آن سقف هفتگی است، نه یک اختلال گذرای سرور.
در QCode چه باید بکنید
هر کدام را که دریافت کنید، یک کلید QCode میتواند بهعنوان راهحل موقت، درخواست‌ها را به خانوادههای مدلی خارج از Claude — GPT، GLM، Kimi، DeepSeek، Qwen و موارد بیشتر — هدایت کند تا بدون انتظار برای رفع 529 یا بازنشانی سقف هفتگی، به انتشار ادامه دهید. QCode بر اساس توکن صورتحساب میکند، با نرخ هر مدل در /models. وقتی سهمیه رو به اتمام است: اگر پلن شخصی فعال دارید، نمی‌توانید بستههای پرداخت بهازای مصرف بخرید، پس برای سهمیه پلن خود یک بسته تقویتی بخرید؛ بدون پلن، بستههای پرداخت بهازای مصرف را از $4 به بالا بخرید برای یک سهمیه یک‌باره که طی 7 روز مصرف میکنید (شارژ حساب از $5 به بالا).
پرسش‌های متداول
آیا 529 و 503 یک چیز هستند؟
کاملاً اینطور نیست. 529 وضعیت «اضافهبار» مخصوص API خود Anthropic است؛ 503 بیشتر در لایه عمومی درگاه/متعادلکننده بار بهصورت «سرویس در دسترس نیست» ظاهر میشود. هر دو ارزش تلاش مجدد دارند، اما 529 بهطور خاص به ظرفیت خود سرویس مدل اشاره دارد.
429 و سقف هفتگی هر دو «محدودیت» هستند؛ تفاوت واقعی چیست؟
هر دو «محدودیت» هستند، اما به دو سازوکار متفاوت تعلق دارند. یک 429 در سمت API قرار دارد: یا نرخ درخواست یا هم‌زمانی شما از حد گذشته است — یک محدودسازی لحظه‌ای درون یک بازه غلتان که معمولاً پس از چند ده ثانیه تا چند دقیقه عقبنشینی برطرف میشود — یا به سقف هزینه ماهانه سطح مصرف خود برخورده‌اید، که هدر retry-after ندارد و فقط در 00:00 UTC روز اول ماه بعد برطرف میشود. سقف هفتگی در سمت اشتراک قرار دارد: سقف نشست پنج‌ساعته و سقف هفتگی پلن‌های Pro/Max. وقتی آن‌ها مصرف شوند، منتظر زمان بازنشانی رسمی می‌مانید، و کاهش نرخ درخواست شما آن را زودتر بازنمی‌گرداند.
529 overloaded به چه معناست؟
529 وضعیت اضافهبار سرور در مستندات رسمی خطاهای Anthropic است؛ فیلد type در بدنه خطا برابر overloaded_error است، و مستندات میگویند این وضعیت میتواند زمانی رخ دهد که API تحت ترافیک بالای همه کاربران باشد. هیچ ارتباطی با محتوای درخواست، تعداد توکن یا اندازه مدل شما ندارد — استفاده از مدل کوچکتر فقط بهطور تصادفی در استخر ظرفیتی با بار کمتر قرار میگیرد، که راهحل قابلاتکایی نیست؛ آنچه کار میکند عقبنشینی نمایی است، و SDK رسمی از قبل بهطور پیشفرض چنین خطاهای 5xx و خطاهای محدودیت نرخ درخواست را دوباره تلاش میکند.
چگونه می‌توانید تشخیص دهید به 429 یا سقف هفتگی برخورده‌اید؟
به بدنه خطا و متن پیام نگاه کنید. یک 429 همراه با بدنه خطای استاندارد HTTP می‌آید که type آن rate_limit_error است؛ اگر error_code در آن بدنه enforced_spend_limit_reached باشد، به سقف هزینه ماهانه رسیده‌اید، تلاش دوباره بی‌فایده است و باید تا بازنشانی ماه بعد صبر کنید یا به پلن بالاتر ارتقا دهید. سقف هفتگی معمولاً اصلاً بدنه خطای HTTP نیست، بلکه جمله‌ای از پلن اشتراک شماست، و Claude و Claude Code یک سهمیه مشترک دارند — نوارهای پیشرفت در تنظیمات > مصرف حساب کاربری شما محدودیت جلسه پنج‌ساعته و سقف هفتگی را نشان می‌دهند، و وقتی دوره فعلی صفر است و روزهای بازنشانی دور هستند، همان محدودیتی است که به آن برمی‌خورید.
مدت انتظار در backoff چقدر باید باشد؟
یک الگوی رایج این است که از 1 ثانیه شروع کنید و پس از هر شکست آن را دو برابر کنید (1s، 2s، 4s، 8s…) همراه با کمی jitter تصادفی تا چندین تلاش دوباره روی هم انباشته نشوند و یک جهش جدید ایجاد نکنند. بیشتر SDKهای رسمی این را از پیش پیاده‌سازی کرده‌اند — اگر خودتان آن را از صفر می‌سازید، همان الگو را کپی کنید.
آیا میتوان پیش از رسیدن به سقف هفتگی کاری انجام داد؟
روند سهمیه باقیمانده را در داشبورد حساب کاربری خود (نوارهای پیشرفت در تنظیمات > مصرف) زیر نظر بگیرید تا بتوانید زمان تمام شدن آن را پیشبینی کنید. وقتی سهمیه کم میشود: اگر پلن شخصی فعال دارید، یک بسته تقویتی برای سهمیه پلن خود بخرید؛ بدون پلن، بستههای پرداخت بهازای مصرف را از $4 به بالا بخرید برای سهمیه یکبارهای که ظرف 7 روز مصرف میکنید (شارژ حساب از $5). بهعنوان راهحل موقت، کارهای غیرحیاتی را از طریق QCode به خانوادههای مدل دیگر بفرستید و سهمیه باقیمانده Claude را برای کاری نگه دارید که واقعاً به آن نیاز دارد.
منابع
کدهای وضعیت و فیلدهای بدنه خطا (overloaded_error / rate_limit_error / enforced_spend_limit_reached) از مستندات رسمی خطاها و محدودیت‌های نرخ درخواست API شرکت Anthropic آمده‌اند (بازیابی‌شده در 2026-10-20)؛ جزئیات محدودیت نشست، سقف هفتگی و پیشرفت مصرف از سه مقاله مرکز راهنما درباره محدودیت‌های مصرف و طول، درباره استفاده از Claude Code با پلن Pro یا Max، و درباره بهترین شیوه‌های محدودیت مصرف آمده است (بازیابی‌شده در 2026-10-20). درباره +50%: مسیر articles/15910845 در مرکز راهنما (بازیابی‌شده در 2026-09-20، با زمان گذشته: «از 13 مه تا 13 سپتامبر 2026 اجرا شد.»)؛ پست @ClaudeDevs به تاریخ 2026-08-29، با شناسه 2093742321473065266 («تا 14 سپتامبر»). بازبینی مجدد در 2026-10-20.
نگذارید یک حساب کاربری مانع تحویل شما شود
با یک کلید QCode می‌توانید به GPT، GLM، Kimi، DeepSeek و موارد بیشتر سوییچ کنید — بدون انتظار برای رفع 529 یا بازنشانی سقف هفتگی. QCode بهازای هر توکن صورتحساب میکند، با نرخ‌های هر مدل در /models.
مطالب مرتبط
منظور از 529 Overloaded واقعاً چیست
نگاهی مستقل و عمیق‌تر به 529، از جمله اینکه چگونه با 503 تفاوت دارد.
در مورد «Claude usage limit reached» چه باید کرد
چگونه بازه غلتان 5 ساعته را از سقف هفتگی تشخیص دهیم و برای هر یک چه باید کرد.
Claude Code روی API شخص ثالث: دسترس‌پذیری قابلیت‌ها
تا تاریخ 2026-10-08: CLI محلی، MCP، subagentها، auto و 1M کار می‌کنند؛ Remote Control، نشست‌های ابری و سایر قابلیت‌های سمت حساب کاربری کار نمی‌کنند.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
این صفحه یک توضیح فنی است، نه بیانیه رسمی Anthropic. متن رسمی نقل‌شده تا تاریخ 2026-10-20 از مستندات خطاها و محدودیت‌های نرخ درخواست Anthropic و از مرکز راهنما آمده است؛ قواعد مشخص سهمیه و زمان‌های بازنشانی تابع تنظیمات > مصرف حساب کاربری شما و مستندات رسمی Anthropic هستند.