529 Overloaded در واقع چه معنایی دارد
تا تاریخ 2026-10-20، 529 Overloaded یعنی Claude API به‌طور موقت به ظرفیت رسیده است: مرجع رسمی خطاها بیان میکند که این یک وضعیت ظرفیت برای همه کاربران است، نه محدودیت مصرف شما، و از سهمیه شما کسر نمیشود. این بازبینی همچنین پیش‌فرض‌های تلاش مجددی را که مستندات رسمی ثبت کرده‌اند تکمیل میکند: CLAUDE_CODE_MAX_RETRIES به‌طور پیش‌فرض 10 است (از 2.1.186 حداکثر 15)، تأخیر پایه برای تلاشهای مجدد 529 به‌طور پیش‌فرض 500 ms است (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS، قابل افزایش تا 32000)، و سقف عقب‌نشینی به‌طور پیش‌فرض 32000 ms است (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS، قابل افزایش تا 64000). تغییر کد شما کمکی نمیکند؛ تغییر راهبرد تلاش مجدد شما کمک میکند.
به‌روزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورت‌حساب به‌ازای توکن، آماده به کار در چند دقیقه.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته
ازدحام سمت ارائهدهنده
زمانی برگردانده میشود که ظرفیت سمت سرور محدود باشد. به سهمیه کلید شما، پارامترهای شما یا بدنه درخواست شما مربوط نیست. مرجع رسمی خطاها بیان میکند که 529 یک وضعیت ظرفیت برای همه کاربران است، بنابراین به سمت ارائهدهنده اشاره دارد، نه سمت شما.
نرخ درخواست شما محدود شده است
این همان موردی است که یعنی از نرخ یا سهمیه خودتان فراتر رفته‌اید. 529 و 429 به مدیریت متفاوتی نیاز دارند؛ از یک مسیر کد مشترک استفاده نکنید. یک جزئیات در مستندات رسمی به‌راحتی از نظر دور می‌ماند: وقتی 429 محدودیت هزینه یا اعتبار مصرفی تمام‌شده را گزارش میکند، Claude Code به‌جای تلاش مجدد بی‌درنگ شکست می‌خورد، برعکس نحوه برخورد با 529.
تنها اقدام مؤثر سمت کلاینت
عقب‌نشینی نمایی همراه با نوسان تصادفی (jitter). تلاش مجدد فوری ازدحام را بدتر میکند و باعث میشود زودتر محدودیت نرخ درخواست برای شما اعمال شود. مستندات رسمی تأخیر پایه پیش‌فرض برای تلاشهای مجدد 529 را 500 ms (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS) و سقف عقب‌نشینی پیش‌فرض را 32000 ms (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS) اعلام میکند.
کاهش ساختاری
وقتی همان کار میتواند روی خانواده مدل دیگری انجام شود، ازدحام یک ارائهدهنده، دیگر به معنای وقفه نیست. بهای آن، پذیرش تفاوت‌های مدل است.
تفاوت 529 با 429 و 503
تا تاریخ 2026-10-20، کد 529 یعنی سرور همین حالا بیش‌ازحد بارگذاری شده است — یک مشکل ظرفیت که معمولاً موقتی است؛ مرجع رسمی خطاها میگوید این یک وضعیت ظرفیت برای همه کاربران است، نه سقف مصرف شما، و از سهمیه شما کم نمیشود. کد 429 یعنی به سقف نرخ درخواست یا سهمیه خودتان رسیده‌اید — یک مشکل سهمیه؛ مستندات رسمی همچنین میگوید کد 429 که سقف هزینه یا اعتبار مصرف تمام‌شده را گزارش می‌دهد باعث میشود Claude Code بی‌درنگ شکست بخورد و دوباره تلاش نکند. کد 503 عموماً یعنی سرویس در دسترس نیست یا در حال نگهداری است. هیچ‌یک به این معنا نیست که درخواست شما بدشکل بوده است، اما نحوه برخورد متفاوت است: 529 نیازمند عقب‌نشینی و تلاش دوباره است، 429 نیازمند کند کردن یا بالا بردن سقف‌ها، و 503 نیازمند صبر کردن و زیر نظر گرفتن صفحه وضعیت. ادغام هر سه در یک بلوک catch رایج‌ترین اشتباه در مدیریت خطاست.
چرا بحث به‌طور دوره‌ای بالا می‌گیرد
هر زمان مدل جدیدی منتشر میشود یا مهاجرت بزرگی رخ می‌دهد، ظرفیت ارائهدهنده برای مدتی محدودتر میشود و بحث 529 هم با آن بالا می‌گیرد. این موج‌ها معمولاً با افزوده شدن ظرفیت فروکش میکنند — اما برای کسی که مهلت دارد، انتظار برای گسترش ظرفیت توسط ارائهدهنده پاسخ در دسترس نیست. صفحه وضعیت رسمی دو مورد قابل بررسی در 2026-10 ثبت کرد: در 2026-10-07، مشکلی در سقف‌های هزینه باعث شد برخی سازمان‌ها به‌اشتباه به دلیل رسیدن به سقف هزینه خود متوقف شوند، در نتیجه درخواست‌ها در Claude API، Claude Code و سایر رابط‌های Claude رد شدند، و ارائهدهنده آن را حل‌شده علامت زد؛ در 2026-10-13، رخدادی در platform.claude.com درباره داده‌های مصرف صریحاً اعلام کرد که درخواست‌های API تحت تأثیر قرار نگرفتند. هر دو مورد به سقف‌های هزینه و داده‌های مصرف مربوط‌اند، نه ظرفیت. Claude Code همچنین دو نسخه را با فاصله کوتاه در 2026-10-08 و 2026-10-09 منتشر کرد (2.1.295 و 2.1.296)، و سقفی برای مجموع انتظار در حالت تلاش دوباره بدون نظارت و یک سقف قابل‌تنظیم برای عقب‌نشینی 529 اضافه کرد؛ آخرین نسخه 2.1.304 است که در 2026-10-19 منتشر شد.
ترتیب عیب‌یابی
تأیید کنید که کد وضعیت واقعاً 529 است و نه 429. بدنه پاسخ‌ها متفاوت است؛ آن‌ها را در لاگ‌های خود جداگانه بشمارید.
صفحه وضعیت ارائهدهنده را بررسی کنید. اگر یک رخداد فراگیر باشد، هیچ تغییری در سمت کلاینت چیزی بیش از کاهش اثر نیست. صفحه وضعیت رسمی، Claude API (api.anthropic.com) و Claude Code را به‌عنوان دو مؤلفه جداگانه فهرست میکند، بنابراین بررسی کنید کدام یک تحت تأثیر است؛ تا تاریخ 2026-10-20، همه مؤلفه‌های صفحه وضعیت «عملیاتی» را نشان میدهند.
بررسی کنید آیا منطق تلاش مجدد خودتان ازدحام را تشدید میکند: نبود jitter، نبود سقف، و تلاش مجدد فوری همه تشدیدکننده‌اند. در Claude Code، از نسخه 2.1.292 (2026-10-06) میتوانید تأخیر پایه تلاشهای مجدد 529 را با CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS طولانی‌تر کنید؛ از 2.1.295 (2026-10-08) متغیر CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS کل زمان سپری‌شده در انتظار برای عبور از 429 و 529 را در حالت تلاش مجدد بدون نظارت محدود میکند؛ از 2.1.296 (2026-10-09) متغیر CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS به شما امکان می‌دهد سقف backoff را افزایش دهید.
پیش از تلاش مجدد، مشخص کنید واقعاً چه کدی دریافت کردهاید
آنچه تأیید شده است
یک 529 نشانه ازدحام ظرفیت در سمت سرور است و به محتوای درخواست مرتبط نیست — این معنا در مستندات ارائهدهنده بیان شده است. مرجع رسمی خطای Claude Code (بررسی‌شده در 2026-10-20) پیام «API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary.» را نشان می‌دهد و بیان میکند: «A 529 is not your usage limit and doesn't count against your quota.» همچنین اضافه میکند که ظرفیت به‌ازای هر مدل پایش میشود، بنابراین میتوانید /model را اجرا کنید و برای ادامه کار به مدل دیگری بروید، و اینکه 529 یک وضعیت ظرفیت در میان همه کاربران است. همان مرجع خطا پیش‌فرض‌های تلاش مجدد را می‌آورد: CLAUDE_CODE_MAX_RETRIES به‌طور پیش‌فرض 10 است (از 2.1.186 حداکثر 15)، CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS به‌طور پیش‌فرض 500 ms است (قابل افزایش تا 32000)، CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS به‌طور پیش‌فرض 32000 ms است (قابل افزایش تا 64000)، و CLAUDE_CODE_RETRY_WATCHDOG وقتی روی 1 تنظیم شود، خطاهای ظرفیت 429 و 529 را به‌طور نامحدود دوباره تلاش میکند. CHANGELOG مربوط به Claude Code ثبت میکند که از 2.1.286 یک فراخوانی مدلِ ناموفق با تنظیمات پیش‌فرض تلاش مجدد حداکثر 14 درخواست می‌فرستد، که 2.1.292 متغیر CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS را اضافه کرد، که 2.1.295 متغیر CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS را اضافه کرد، و که 2.1.296 متغیر CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS را اضافه کرد. backoff نمایی همراه با jitter پاسخی سمت کلاینت است که به‌طور گسترده اعتبارسنجی شده است.
آن را واقعیت ندانید
برای 529 مرجع خطا سه گام قابل اجرا ارائه می‌دهد: صفحه وضعیت را برای اطلاعیههای ظرفیت بررسی کنید، چند دقیقه بعد دوباره تلاش کنید، و /model را اجرا کنید تا به مدل دیگری بروید؛ همچنین بیان میکند که 529 یک وضعیت ظرفیت در میان همه کاربران است و ظرفیت به‌ازای هر مدل پایش میشود. تلقی کردن 529 به‌عنوان محدودسازی پنهانی کاربران پرمصرف توسط ارائهدهنده هیچ مبنایی ندارد، و اشتباه گرفتن آن با 429 شما را به راه‌حل نادرست می‌فرستد.
دو پاسخ
فقط backoff سمت کلاینت
پیاده‌سازی‌اش کم‌هزینه است و به‌طور قابل اندازه‌گیری از شکست‌ها می‌کاهد. اما تا زمانی که ارائهدهنده دچار ازدحام است، تنها کاری که میتوانید بکنید انتظار است.
کار را روی چند خانواده مدل توزیع کنید
ازدحام یک ارائهدهنده دیگر به معنای قطعی سرویس نیست. هزینه‌اش پذیرش عادت‌های متفاوت مدل‌هاست، و هر مسیر حالتهای شکست خودش را دارد. چند مسیر یعنی کاهش ریسک، نه حذف آن: خود سازوکار جابه‌جایی هم میتواند از کار بیفتد.
نوشتن صحیح تلاش دوباره
سه نکته. اول، عقب‌نشینی نمایی به‌جای فاصله ثابت: یک ثانیه صبر کنید، سپس هر بار آن را دو برابر کنید. دوم، لرزش تصادفی اضافه کنید — اگر هر کلاینت به یک اندازه عقب‌نشینی کند، همه در یک موج هم‌زمان دوباره تلاش میکنند و این ازدحام را طولانی‌تر میکند. سوم، برای هم تعداد تلاش دوباره و هم مجموع انتظار سقف بگذارید، وگرنه یک رخداد ازدحام واحد باعث میشود صف وظایف شما بی‌حد رشد کند. به‌طور جداگانه، وقتی یک درخواست جریانی در میانه قطع میشود، کورکورانه از ابتدا دوباره تلاش نکنید؛ ابتدا بررسی کنید آیا آنچه تاکنون دریافت کردهاید قابل ادامه است. اگر از Claude Code استفاده می‌کنید: مستندات آن میگوید خطاهای گذرا را تا 10 بار با عقب‌نشینی نمایی دوباره تلاش میکند و سپس خطا را نشان می‌دهد (بازبینی‌شده در 2026-10-20)؛ نسخه 2.1.286 (انتشار GitHub در 2026-09-30) نحوه شمارش تلاشهای دوباره را تغییر داد — تغییرات نشان می‌دهد که یک سقف اکنون کل یک فراخوانی مدل را پوشش می‌دهد، بنابراین با تنظیمات پیش‌فرض تلاش دوباره، یک فراخوانی ناموفق حداکثر 14 درخواست می‌فرستد؛ نسخه 2.1.292 (انتشار GitHub در 2026-10-06) متغیر محیطی CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS را اضافه کرد که تأخیر پایه طولانی‌تری برای عقب‌نشینی هنگام تلاش دوباره برای یک درخواست 529 بیش‌ازحد بارگذاری‌شده تعیین میکند؛ نسخه 2.1.295 (انتشار GitHub در 2026-10-08) CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS را اضافه کرد که مدت زمانی را که حالت تلاش دوباره بدون نظارت برای 429 و 529 انتظار می‌کشد محدود میکند؛ نسخه 2.1.296 (انتشار GitHub در 2026-10-09) CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS را برای بالا بردن سقف عقب‌نشینی 529 اضافه کرد. مرجع رسمی خطاها اکنون پیش‌فرض‌ها را بیان میکند: CLAUDE_CODE_MAX_RETRIES پیش‌فرض 10 است (از 2.1.186 به 15 محدود شده است)، CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS پیش‌فرض 500 میلی‌ثانیه است (قابل افزایش تا 32000)، CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS پیش‌فرض 32000 میلی‌ثانیه است (قابل افزایش تا 64000)، و CLAUDE_CODE_RETRY_WATCHDOG وقتی روی 1 تنظیم شود، خطاهای ظرفیت 429 و 529 را به‌طور نامحدود دوباره تلاش میکند.
QCode در اینجا چه کاری میتواند و چه کاری نمی‌تواند انجام دهد
آنچه میتواند انجام دهد: یک کلید به شما امکان می‌دهد هنگام ازدحام به خانواده مدل دیگری بروید، به‌جای اینکه منتظر بازیابی یک مدل واحد بمانید. آنچه نمی‌تواند انجام دهد: ما ارائهدهنده مدل نیستیم و نمی‌توانیم ظرفیت سرور ارائهدهنده را تغییر دهیم، و درخواست‌ها از طریق QCode هم می‌توانند شکست بخورند. آنچه ارائه می‌دهیم گزینه جابه‌جایی بین خانواده‌های مدل است، نه وعده سرویس بی‌عیب‌ونقص.
پرسش‌های متداول
آیا وقتی 529 دریافت میکنم باید پارامترهای درخواستم را تغییر دهم؟
خیر. 529 به محتوای درخواست مرتبط نیست؛ تغییر max_tokens، پارامترهای مدل، یا کوتاه کردن prompt آن را برطرف نمیکند. در عوض، راهبرد تلاش مجدد را تغییر دهید.
آیا میتوانم از همان منطق تلاش مجدد برای 529 و 429 استفاده کنم؟
توصیه نمیشود. 529 نیازمند backoff و تلاش مجدد برای همان درخواست است؛ 429 یعنی باید نرخ ارسال خود را کاهش دهید یا محدودیتهایتان را افزایش دهید، و تلاشهای مجدد کورکورانه مدام محدودکننده را فعال میکنند.
مدت backoff چقدر باید باشد؟
یک الگوی رایج این است: یک ثانیه، با دو برابر شدن در هر تلاش، همراه با نوسان تصادفی در زمان انتظار و سقف برای هم تعداد تلاش مجدد و هم کل زمان انتظار. اعداد دقیق به میزان تأخیری بستگی دارد که وظیفه شما تحمل میکند. در Claude Code (مرجع رسمی خطاها و CHANGELOG تا 2026-10-20): CLAUDE_CODE_MAX_RETRIES تعداد تلاشهای مجدد را تعیین میکند، پیش‌فرض 10 (از 2.1.186 حداکثر 15)؛ از 2.1.286، یک فراخوانی مدل ناموفق با تنظیمات پیش‌فرض تلاش مجدد حداکثر 14 درخواست ارسال میکند؛ از 2.1.292، CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS به شما اجازه می‌دهد تأخیر پایه بلندتری برای تلاشهای مجدد 529 تنظیم کنید، و مستندات رسمی 500 ms را پیش‌فرض اعلام میکنند که تا 32000 قابل افزایش است؛ از 2.1.295، CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS کل زمان صرف‌شده برای انتظار تا پایان 429 و 529 را در حالت تلاش مجدد بدون نظارت محدود میکند؛ از 2.1.296، CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS به شما اجازه می‌دهد سقف تأخیر افزایشی بین تلاش‌ها را بالا ببرید، و مستندات رسمی 32000 ms را پیش‌فرض اعلام میکنند که تا 64000 قابل افزایش است؛ تنظیم CLAUDE_CODE_RETRY_WATCHDOG روی 1 باعث میشود خطاهای ظرفیت 429 و 529 به‌طور نامحدود دوباره تلاش شوند.
اگر یک درخواست جریانی در میانه راه به 529 برخورد کند چه میشود؟
ابتدا بررسی کنید دادهای که تاکنون دریافت کردهاید قابل استفاده است یا نه. اگر میتوانید ادامه دهید؛ فقط اگر نمیتوانید، کل کار را دوباره تلاش کنید. راهاندازی مجدد کورکورانه هزینه را دو بار محاسبه میکند و ازدحام را بیشتر میکند.
آیا QCode هم خطای 529 دریافت میکند؟
ممکن است. ازدحام در سمت ارائهدهنده واقعی است و ما هم از آن مصون نیستیم. کاری که میتوانیم بکنیم این است که اجازه دهیم همان کار به خانواده مدل دیگری منتقل شود — نه اینکه وعده دهیم خطاها رخ نمیدهند.
529 Overloaded به چه معناست، و چرا وقتی سهمیه من تغییری نکرده است آن را دریافت میکنم؟
529 Overloaded یک وضعیت ظرفیت در سمت ارائهدهنده است: مرجع رسمی خطاها میگوید 529 یک وضعیت ظرفیتی برای همه کاربران است، نه محدودیت مصرف شما، و از سهمیه شما کم نمیشود؛ بنابراین بدون تغییر ماندن سهمیه قابل انتظار است. ظرفیت برای هر مدل جداگانه ردیابی میشود، بنابراین میتوانید /model را اجرا کنید و برای ادامه کار به مدل دیگری سوییچ کنید؛ توصیه رسمی این است که چند دقیقه بعد دوباره تلاش کنید و صفحه وضعیت ارائهدهنده را برای اطلاعیههای ظرفیت بررسی کنید. افزایش سهمیه یا تغییر پارامترها این مشکل را برطرف نمیکند. چند مسیر احتمال اینکه یک قطعی کار شما را متوقف کند کاهش میدهند، اما هر مسیر حالتهای خرابی خودش را دارد و سازوکار سوییچ کردن هم میتواند از کار بیفتد: این کاهش اثر است، نه حذف کامل.
منابع
معنای کدهای وضعیت از مستندات رسمی API هر ارائهدهنده پیروی میکند. رفتار تلاش مجدد Claude Code و متغیرهای CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS، CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS و CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS از CHANGELOG مربوط به Claude Code از Anthropic (ورودی‌های 2.1.286، 2.1.292، 2.1.295 و 2.1.296)، صفحه‌های انتشار GitHub آن نسخه‌ها، مرجع خطای Claude Code و مستندات متغیرهای محیطی، و صفحه وضعیت رسمی همراه با فهرست مؤلفه‌ها و سوابق رخداد می‌آیند؛ همه در 2026-10-20 دریافت و بررسی شده‌اند. این صفحه عمداً هیچ درصد دسترس‌پذیری شخص ثالثی را ذکر نمیکند — چنین ارقامی در طول زمان تغییر میکنند و ما هیچ اندازه‌گیری مستقل معتبری برای ارجاع نداریم.
وقتی یک مسیر دچار ازدحام است، مسیر دیگری را در پیش بگیرید.
یک کلید برای چندین خانواده مدل — وقتی یک مسیر تحت فشار است، سوییچ کنید و به کار ادامه دهید.
مطالب مرتبط
پرسش‌های متداول و مدیریت خطا در Claude Code
پاسخ به پرسش‌های متداول هنگام استفاده از Claude Code، شامل شروع به کار، سهمیه‌ها و قیمت‌گذاری، و عیب‌یابی.
محدودیت‌های مصرف Claude Code
تفاوت بازه 5 ساعته و سقف هفتگی را تشخیص دهید و بدانید پس از رسیدن به محدودیت مصرف چه باید بکنید.
مسیریابی چندمدلی
یک ماتریس تصمیم برای انتخاب و جابه‌جایی بین خانواده‌های مدل با یک کلید.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
معنای کدهای وضعیت در اینجا از مستندات رسمی هر ارائهدهنده پیروی میکند و ممکن است بین نسخه‌ها تغییر کند؛ جزئیات Claude Code در 2026-10-20 با CHANGELOG و مستندات رسمی بررسی شده است که اولویت دارند. هیچ‌چیز در این صفحه تعهدی نسبت به دسترس‌پذیری نیست.