خطأ Claude Code overloaded (529): أصلحه بسرعة
ما يعنيه خطأ 529 Overloaded فعليًا — سعة من جهة Anthropic وليس مشكلة في حسابك — إضافة إلى فحص الحالة، والتبديل عبر /model، ومتغير البيئة لضبط التراجع (backoff) المضاف في Claude Code 2.1.296، والفرق بين 529 و429 و500 — كل ذلك بلقطات شاشة حقيقية.
529 في لمحة
- 529 Overloaded يعني أن واجهة Anthropic البرمجية بلغت سعتها القصوى مؤقتًا لجميع المستخدمين — تقول الوثائق الرسمية حرفيًا إنه "ليس حد استخدام ولا يُحسب من حصتك". هو ليس حظرًا أبدًا.
- الخطوة الأولى لا تتغير أبدًا: افحص status.claude.com (أو عبر curl -I) لترى هل Claude نفسه متدهور — دليلنا المباشر للحالة يعلّمك قراءة الصفحة.
- الحلول الفورية بالترتيب: دع إعادة المحاولة التلقائية في Claude Code تُكمل، وشغّل /model وانتقل إلى طراز أخف (السعة تُدار لكل نموذج)، واخفض تزامن الأدوات.
- منذ Claude Code 2.1.296 يمكنك ضبط CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS لإطالة سقف التراجع في إعادة محاولات 529 خلال الجلسات الطويلة.
- 529 ≠ 429: فالـ429 مفتاحك صطدم بحد المعدل الخاص به (مشكلتك أنت)، والـ529 سعة الجميع ممتلئة (مشكلة Anthropic)، والـ500 عطل داخلي غير متوقع في الـAPI (انتظر دقيقة وأعد الإرسال).
How to Fix Claude API "Overloaded" Error (529 Status Code)
القناةNexustech4:32
Claude errors reference — 529, 429, 500 & retry tuning
الوثائقcode.claude.com/docs
الإطارات مستخرجة من تسجيل نظيف واحد — لافتة "currently unavailable" للسعة، وفحص الحالة عبر curl داخل VS Code، ومنتقي النماذج والنموذج المحمّل رماديًا، ومخطط التحويل عند 529، ودعم الدردشة داخل التطبيق (Nexustech، JGlrcRDtdls). ثلاثة فيديوهات أخرى — عرض Extreme Guides للسطر الأوامر (_oEU-6xbcWs، أوامر غير موجودة أصلًا في Claude Code)، ومقال Izoate المقروء صوتيًا (fHlvs5evSi0، أزرار محفورة وشعار قناة)، وإصلاح 400 من Last Error Fixer (vHEi32hIh1I، ترجمة محفورة) — قدّمت معلومات لكنها استُبعدت كمصدر للإطارات. صياغات الأخطاء تتبع وثائق الأخطاء الرسمية وسجل تغييرات Claude Code 2.1.296 (2026-10-09). كل خطوة مرتبطة بثانيتها الدقيقة في الفيديو المصدر.
تبقى حقوق إطارات الفيديو لأصحابها، وقد أُدرجت هنا كتوثيق خطوة بخطوة مع نسب المصدر وروابط عميقة.
إصلاح خطأ Claude Code overloaded (529) خطوة بخطوة
الخطوة 1 — تأكد أن المشكلة من Anthropic وليست منك
- 1
تعرّف على شكل حالة الحمل الزائد
529 ضغط سعة على مستوى Claude كله، لذا تظهر علاماته على كل الأسطح معًا: يضع تطبيق Claude لافتة "currently unavailable" فوق صندوق الكتابة، وتعود استدعاءات الـAPI المباشرة بـHTTP 529 وجسم overloaded_error، ويتحول دوّار Claude Code إلى "Retrying… attempt x/y". إن فشل طرفيتك وحدها بينما التطبيق يعمل، فاشتبه في بيئتك المحلية — دليلنا لجلسات التعليق يتولى ذلك.
الصفحة الرئيسية لتطبيق Claude باللافتة "Claude Fable 5 is currently unavailable" — نفس ضغط السعة الذي يبلّغ عنه 529 لطرفيتك.شاهد عند 0:02 - 2
افحص صفحة الحالة الرسمية أولًا
افتح status.claude.com قبل تعديل أي إعداد — فهي المصدر الوحيد الموثوق للتدهورات والأعطال. ومن الطرفية يقودك curl -I https://status.anthropic.com/ مباشرة إلى صفحة الحالة. لوحة خضراء مع 529 تعني أن الحمل الزائد خاص بنموذج واحد وأن الحلول أدناه تصح كما هي؛ لوحة حمراء تعني اتباع الحادث لا دفترك. قراءة الصفحة وأي الأقسام تتنبأ بأخطاء الطرفية تجدها في دليل الحالة المباشر.
curl -I إلى status.anthropic.com في طرفية VS Code — إعادة التوجيه 307 في ترويسة location تهبط على status.claude.com: تعرف فورًا هل الـ529 رسمي.شاهد عند 1:00 - 3
استبعد المشتبه بهم المحليين
شغّل /status داخل Claude Code: يعرض النموذج النشط وحسابك وحالة الاتصال. الـ529 لا يكلفك شيئًا — الوثائق تصرح بأنه "لا يُحسب من حصتك" — فلا سطر استخدام يقلقك هنا. إن أظهر /status الحساب الصحيح واتصالًا سليمًا فالخطأ من جهة الخادم حقًا؛ وكل ما عدا ذلك (401 و403 وأخطاء الفوترة) لدلائل أخرى.
الخطوة 2 — حلول فورية تخرجك من الانسداد
- 4
دع إعادة المحاولة المدمجة تُكمل عملها
يعيد Claude Code محاولة الأعطال العابرة حتى 10 مرات بتراجع أسي قبل إظهار خطأ، والدوّار يعد تنازليًا ("Retrying in 8s · attempt 2/7"). في ذروة 529 يكون الأذكى عادة انتظار انتهاء تلك المحاولات بدل الضغط المتكرر على Enter — فكل طلب إضافي يقف في طابور السعة نفسه. إن استُنفدت المحاولات وبقي الخطأ، فانتقل للخطوة التالية.
- 5
انتقل إلى نموذج أخف عبر /model
السعة تُدار لكل نموذج، ولهذا فإن أول نصيحة رسمية عند الحمل الزائد هي: "Run /model and switch to a different model to keep working." اكتب /model في موجّه Claude Code واختر درجة أدنى — نماذج فئة Sonnet وHaiku تواصل الاستجابة بينما يخنق النموذج الرئيسي. والمنتقي نفسه في تطبيق Claude يوسم النموذج المحمّل بـ"Currently unavailable" فترى أي المسارات مغلقة قبل أن تختار.
منتقي النماذج وFable 5 موسومة "Currently unavailable" بينما تبقى علامة Sonnet 4.6 وHaiku 4.5 قابلًا للاختيار.شاهد عند 1:36 - 6
اخفض التزامن من جهتك
استدعاءات الأدوات المتوازية والمهام الخلفية تضاعف نصيبك من ضيق السعة. أنزل CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY إلى 2-3، وأوقف الجلسات أو فرق الوكلاء العاملة الأخرى، وتجنب إطلاق نسخة Claude Code ثانية على المستودع نفسه أثناء الحادث. قلة الطلبات المتزامنة تعني أيضًا تفريغ طابور إعادة المحاولة أسرع عند عودة السعة.
- 7
إن طال الأمر بعد الحادث فتواصل مع الدعم
إن استمرت رسائل 529 بعد صفاء صفحة الحالة، فسلّم الأمر إلى Anthropic: في تطبيق Claude افتح قائمة الملف الشخصي أسفل اليسار واختر Get help. المساعد داخل التطبيق يستقبل تقرير الخطأ مباشرة — الصق رمز الحالة وتوقيته دون البحث عن بريد دعم.
قائمة الملف الشخصي وGet help مباشرة تحت Settings وLanguage — مدخل الإبلاغ عن 529 عنيد.شاهد عند 2:20 - 8
صف الـ529 لمساعد الدعم
في دردشة الدعم اذكر رمز الحالة والنموذج والفترة الزمنية: "I've received a 529 status code on claude-opus-4-8 since 14:00". يمنحك المساعد معرّف محادثة للسجلات — احتفظ به للمراسلة لاحقًا. يستطيع الدعم أن يخبرك هل أصاب حسابك عنقود عنيد نادر أم أن الطراز بأكمله كان يهبط للجميع.
دردشة الدعم بعد كتابة "I've received a 529 status code can you help…" ومنح معرّف محادثة.شاهد عند 3:06
الخطوة 3 — اضبط تراجع إعادة محاولة 529 (Claude Code 2.1.296+)
- 9
أطل سقف التراجع (2.1.296+)
أضاف Claude Code 2.1.296 المتغير CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — نص سجل التغييرات حرفيًا: "Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request." صدّره قبل الإطلاق، مثل CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=30000 لفاصل يصل إلى 30 ثانية بين المحاولات. لم تنشر Anthropic القيمة الافتراضية المدمجة، فكل رقم محدد تقتبسه من مكان آخر اعتبره غير موثّق — ما يضمنه المتغير هو أن سلاسل إعادة المحاولة الطويلة تنتظر أطول بدل الاستسلام مبكرًا.
- 10
اقرنها بمفاتيح إعادة المحاولة الأخرى
يكتمل الإعداد بمتغيرين جارين: CLAUDE_CODE_MAX_RETRIES (الافتراضي 10) يرفع عدد المحاولات للعطل العابر، وCLAUDE_CODE_RETRY_WATCHDOG=1 يعيد محاولة 429/529 بلا نهاية — توصي به الوثائق للجلسات غير المراقَبة حيث يهدر الانسحاب المبكر المهمة كلها. المراقب مع مهلة قصوى كريمة يحوّل ذروة 529 إلى توقف مؤقت لا انهيار.
الخطوة 4 — امنع الازدحام التالي
- 11
امنع الازدحام التالي: أوقات الهدوء، تقسيم المهام، التحويل
ثلاث عادات تخفض تعرضك لـ529: شغّل المهام الثقيلة خارج ساعات الذروة الأمريكية (تقريبًا 11:00-20:00 بتوقيت المحيط الهادئ أيام الأسبوع)، وقسّم الـprompts الضخمة إلى مهام صغيرة — worktree لكل مهمة يبقي الجلسات مستقلة — وإن كنت تستدعي Messages API مباشرة فاكتب تحويلًا: اقبض على 529 وبدّل ساخنًا إلى نموذج أخف وأعد المحاولة بتراجع أسي. حدود الخطة تجدها في دليل حدود الاستخدام؛ الـ529 نفسه لا يمس حصتك أبدًا.
مخطط تحويل للطلبات الخام: الهدف الأساسي claude-sonnet-4-5، وعند استجابة 529 يتم التبديل الساخن إلى مسار claude-haiku-4-5 الاحتياطي.شاهد عند 2:08
529 مقابل 429 مقابل 500: أيّ خطأ أيّها
أخطاء Claude تأتي بأرقام، والرقم يحدد مشكلة مَن هي. يفصلها المرجع الرسمي بدقة — راجع هذه القائمة قبل أن تبدأ بحذف ملفات الإعدادات.
- 1429 حد المعدل — مفتاحك أو مشروعك أو خطتك صدمت حدًا مُعدًا في جانبك. أكّد بيانات الاعتماد النشطة بـ/status، وافحص لوحة مزوّدك، وأنزل CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY. التقييد القصير يعاد تلقائيًا؛ أما 429 من بوابة بحد إنفاق فلا.
- 2529 Overloaded — الـAPI بلغ سعته القصوى مؤقتًا لجميع المستخدمين. من جهة الخادم بحكم التعريف: لا كودك ولا مفتاحك ولا إعداداتك يمكن أن تكون السبب، ولا يُحسب من حصتك أبدًا. انتظر أو بدّل النموذج أو أطل التراجع.
- 3500 خطأ داخلي في الخادم — عطل غير متوقع داخل الـAPI، وعادة عابر. انتظر دقيقة وأعد إرسال الرسالة نفسها؛ والـprompt الطويل تستأنفه بكلمة "try again" من نقطة التوقف.
- 4"Server is temporarily limiting requests" — تقييد قصير لا علاقة له بحصة خطتك. انتظر قليلًا وأعد المحاولة؛ لا تغيير إعدادات يرفعه أسرع.
- 5الفرز في 60 ثانية: صفحة حالة خضراء + 529 يعني انتظر؛ خضراء + 429 يعني افحص حدودك بـ/status؛ لوحة حمراء يعني كل خطأ ممكن — اتبع الحادث ولا تُكرر المحاولات بعمى.
- 6متى تقلق فعلًا: تراكم 529 لساعات على نموذج واحد مع بقاء صفحة الحالة خضراء يستحق تقرير دعم بطوابع زمنية (الخطوة 8). وكل ما عداه عابر بحكم التصميم — الوثائق الرسمية تتعامل مع الرموز الثلاثة بأنها "تستحق إعادة المحاولة" لا بأنها "مشكلة حساب".
تقسيم العمل نفسه في هذا الموقع: دليل جلسات التعليق يتولى التجمّد والعلوق، وهذه الصفحة أخطاء السعة 529/500، ودليل حدود الاستخدام السقوف من نوع 429. إن تجمّدت جلستك بدل أن تُخطئ، فبدّل الدليل — الحلول لا تتقاطع.