ما يعنيه 529 Overloaded فعليًا
اعتبارًا من 2026-10-20، يعني 529 Overloaded أن Claude API بلغ سعته مؤقتًا: يشير مرجع الأخطاء الرسمي إلى أن هذه حالة سعة لدى جميع المستخدمين، وليست حد الاستخدام الخاص بك، ولا تُحتسب على حصتك. تستكمل إعادة التحقق هذه أيضًا إعدادات إعادة المحاولة الافتراضية التي توثّقها الوثائق الرسمية: القيمة الافتراضية لـ CLAUDE_CODE_MAX_RETRIES هي 10 (بحد أقصى 15 منذ 2.1.186)، والتأخير الأساسي لإعادة محاولات 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 وأبرز النماذج الصينية، والفوترة حسب token، ويعمل خلال دقائق.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربع نقاط
ازدحام من جانب المزوّد
يُعاد عندما تكون سعة جانب الخادم محدودة. ولا علاقة له بحصة مفتاحك، أو معاملاتك، أو جسم طلبك. يشير مرجع الأخطاء الرسمي إلى أن 529 حالة سعة لدى جميع المستخدمين، لذا فهو يشير إلى جانب المزوّد لا إلى جانبك.
يتم تقييد معدل طلباتك
هذا هو الخطأ الذي يعني أنك تجاوزت حد معدل طلباتك أو حصتك. يحتاج 529 و429 إلى معالجة مختلفة — لا تستخدم مسار كود واحدًا لهما. ثمة تفصيل في الوثائق الرسمية يسهل تفويته: عندما يشير 429 إلى حد إنفاق أو إلى نفاد رصيد الاستخدام، يفشل Claude Code فورًا بدل إعادة المحاولة، وهو عكس طريقة معالجة 529.
الإجراء الفعّال الوحيد من جانب العميل
التراجع الأسي مع التذبذب العشوائي. تؤدي إعادة المحاولة فورًا إلى تفاقم الازدحام وتجعلك تُقيَّد بحد معدل الطلبات بشكل أسرع. تذكر الوثائق الرسمية أن التأخير الأساسي الافتراضي لإعادة محاولات 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 تظهر كل المكوّنات في الصفحة بحالة تشغيلية.
تحقق مما إذا كان منطق إعادة المحاولة لديك يضخم الازدحام: فغياب التذبذب العشوائي، وغياب السقف، وإعادة المحاولة الفورية كلها تضخم الازدحام. في 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 رفع سقف التراجع.
قبل إعادة المحاولة، حدّد أي رمز حصلت عليه فعليًا
ما هو مؤكد
يشير 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 (بحد أقصى 15 منذ 2.1.186)، والقيمة الافتراضية لـ 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. التراجع الأسي مع التذبذب العشوائي استجابة من جانب العميل مثبتة على نطاق واسع.
لا تتعامل معها كحقيقة
بالنسبة إلى 529، يقدم مرجع الأخطاء ثلاث خطوات قابلة للتنفيذ: راجع صفحة الحالة بحثًا عن إشعارات السعة، وأعد المحاولة بعد بضع دقائق، ونفّذ /model للتبديل إلى نموذج آخر؛ ويذكر أيضًا أن 529 حالة سعة تشمل جميع المستخدمين وأن السعة تُتابع لكل نموذج. افتراض أن 529 يعني أن المزوّد يحد من سرعة المستخدمين ذوي الاستخدام الكثيف بهدوء لا أساس له، والخلط بينه وبين 429 يوجهك إلى الحل الخاطئ.
استجابتان
التراجع من جانب العميل فقط
رخيص التنفيذ ويقلل الإخفاقات بشكل قابل للقياس. لكن ما دام المزوّد مزدحمًا، فكل ما يمكنك فعله هو الانتظار.
اجعل العمل يصل إلى عائلات نماذج متعددة
لم يعد المزوّد الواحد المزدحم يعني التوقف عن الخدمة. الثمن هو تقبّل عادات مختلفة للنماذج، ولكل مسار أنماط فشل خاصة به. تعدد المسارات تخفيف وليس إزالة: فآلية التبديل نفسها قد تفشل أيضًا.
كتابة إعادة المحاولات بشكل صحيح
ثلاث نقاط. أولًا، التراجع الأسي بدلًا من فاصل زمني ثابت: انتظر ثانية، ثم ضاعف المدة في كل مرة. ثانيًا، أضف اهتزازًا عشوائيًا — إذا تراجع كل عميل بالمقدار نفسه فستُعاد المحاولة في موجة متزامنة، مما يطيل الازدحام. ثالثًا، ضع سقوفًا لكل من عدد مرات إعادة المحاولة وإجمالي الانتظار، وإلا فإن حدث ازدحام واحد سيجعل قائمة مهامك تنمو بلا حدود. بشكل منفصل، عندما ينقطع طلب بث في منتصفه، لا تُعد المحاولة عمياء من البداية؛ تحقق أولًا مما إذا كان ما تلقّيته بالفعل قابلًا للمتابعة. إذا كنت تستخدم 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 (بحد أقصى 15 منذ 2.1.186)، والقيمة الافتراضية لـ 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 إلى ما لا نهاية.
ما يمكن أن يفعله QCode وما لا يمكنه فعله هنا
ما يمكنه فعله: يتيح لك مفتاح واحد التبديل إلى عائلة نماذج أخرى أثناء الازدحام بدلًا من انتظار تعافي نموذج واحد. وما لا يمكنه فعله: نحن لسنا مزوّد النموذج ولا يمكننا تغيير سعة خوادم المزوّد، كما أن الطلبات عبر QCode قد تفشل أيضًا. وما نقدمه هو خيار التبديل بين عائلات النماذج، وليس وعدًا بخدمة خالية من العيوب.
الأسئلة الشائعة
هل ينبغي أن أغيّر معاملات الطلب عندما أتلقى 529؟
لا. لا علاقة لـ529 بمحتوى الطلب؛ لن يؤدي تغيير max_tokens أو معاملات النموذج أو تقليم prompt إلى إزالته. غيّر استراتيجية إعادة المحاولة بدلًا من ذلك.
هل يمكنني استخدام منطق إعادة المحاولة نفسه مع 529 و429؟
غير مستحسن. يستدعي 529 التراجع وإعادة محاولة الطلب نفسه؛ أما 429 فيعني أنك تحتاج إلى خفض معدل الإرسال أو رفع حدودك، وإعادات المحاولة العمياء تظل تصطدم بمحدّد المعدل.
إلى متى ينبغي أن أتراجع؟
من الأنماط الشائعة استخدام ثانية واحدة، ثم مضاعفة المدة عند كل محاولة، مع تذبذب عشوائي وحدود عليا لكل من عدد المحاولات وإجمالي مدة الانتظار. تعتمد الأرقام الدقيقة على مقدار زمن الاستجابة الذي يمكن لمهمتك تحمّله. في Claude Code (المرجع الرسمي للأخطاء وCHANGELOG اعتبارًا من 2026-10-20): يضبط CLAUDE_CODE_MAX_RETRIES عدد محاولات إعادة المحاولة، والقيمة الافتراضية 10 (بحد أقصى 15 منذ 2.1.186)؛ وابتداءً من 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 والوثائق الرسمية، ولهما الأولوية. ولا شيء في هذه الصفحة يُعدّ التزامًا بالتوافر.