---
title: "أصلح خطأ Claude overloaded 529 وخطأ rate limit 429"
description: "يعني الخطأ 529 overloaded_error أن Claude API مشغول لدى الجميع. ويعني الخطأ 429 rate_limit_error أن مؤسستك بلغت حدًا. أعد المحاولة في الحالتين مع تراجع تدريجي."
canonical: "https://logbrew.co/ar/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# أصلح خطأ Claude overloaded 529 وخطأ rate limit 429

يعني الخطأ 529 `overloaded_error` أن Claude API مشغول لدى الجميع. ويعني الخطأ 429 `rate_limit_error` أن مؤسستك بلغت حدًا. أعد المحاولة في الحالتين مع تراجع تدريجي.

اختُبر في 10 نوفمبر 2026 باستخدام Claude Code 2.1.319 و@anthropic-ai/sdk 1.7.0

بقلم [Furkan Erday](https://github.com/furkanerday). Furkan Erday مؤسس LogBrew، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

Canonical: https://logbrew.co/ar/guides/claude-overloaded-rate-limit-error

## كم انتظر كل عميل قبل إعادة المحاولة

|  | الثواني قبل كل إعادة محاولة | مرات إعادة المحاولة | الوقت الإجمالي |
| --- | --- | --- | --- |
| Claude Code، كل الردود 529 | 0.6 · 1.1 | 2 | 2.4 ث |
| Claude Code، كل الردود 429 | 0.5 · 1.2 · 2.5 · 4.1 · 8.8 · 18.8 · 34.2 · 35.4 · 36 · 39.9 | 10 | 182 ث |
| TypeScript SDK مع `maxRetries: 5`، كل الردود 529 | 0.4 · 1 · 1.9 · 3.5 · 7.4 | 5 | 14.3 ث |

## أصلحه في Claude Code

### راجع صفحة حالة Claude

إذا ظهر إشعار عن السعة على status.claude.com، فالمشكلة من جهة Anthropic، ولا يحلها إلا الوقت.

### انتظر ثم حاول مرة أخرى

تعني الرسالة `API Error: Repeated 529 Overloaded errors` أن Claude Code أعاد المحاولة بالفعل. ولا يُحتسب الخطأ 529 من حد الاستخدام.

### انتقل إلى نموذج آخر

تتابع Anthropic السعة لكل نموذج على حدة. اختر نموذجًا آخر، مثل Sonnet عندما يكون Opus مشغولًا.

```bash
/model
```

### حدّد نموذجًا احتياطيًا للسكربتات

في وضع print، ينتقل `--fallback-model` إلى نموذج ثانٍ بعد تكرار أخطاء 529. وفي اختبارنا انتقل بعد 3 طلبات.

```bash
claude -p "Run the tests" --fallback-model sonnet
```

### أبقِ التشغيل غير المراقَب مستمرًا

في CI وغيرها من عمليات التشغيل التي لا يراقبها أحد، يعيد هذا الإعداد محاولة أخطاء 529 و429 حتى تعود السعة.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## أصلحه في تطبيقك

### أعد المحاولة مع تراجع تدريجي

تعيد حزم SDK الرسمية من Claude محاولة أخطاء 429 و529 وغيرها من أخطاء 5xx مرتين افتراضيًا، مع تراجع أسّي، وتلتزم بالترويسة `retry-after`. ارفع `maxRetries` إذا كان تطبيقك يستطيع الانتظار أطول.

```bash
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 5 });
```

### سجّل الخطأ ومعرّف الطلب

عندما تنفد المحاولات، ترمي SDK الخطأ `OverloadedError` أو `RateLimitError`. احفظ `error.requestID` ليتمكن دعم Anthropic من العثور على الطلب.

```bash
try {
  await client.messages.create(request);
} catch (error) {
  if (
    error instanceof Anthropic.OverloadedError ||
    error instanceof Anthropic.RateLimitError
  ) {
    console.warn("Claude API busy", error.status, error.requestID);
  }
  throw error;
}
```

### زِد حركة المرور ببطء

قد تؤدي قفزة حادة في حركة المرور لديك إلى حدود التسارع 429. زِد حركة المرور خطوة بخطوة وحافظ على ثباتها.

## ما رأيناه في الاختبار

لا يمكن لأحد أن يفرض خطأ 529 حقيقيًا، لذلك وجّهنا Claude Code وTypeScript SDK إلى خادم اختبار محلي يرد على كل طلب بالرمز 529 أو 429. ويعامل Claude Code مثل هذا الخادم كبوابة، لذلك قد تختلف الجلسة على API الحقيقي.

أرسل Claude Code 3 طلبات تلقّت 529، ثم توقّف بعد 2.4 ثانية وعرض `Repeated 529 Overloaded errors`. ومع `--fallback-model sonnet`، انتقل إلى Sonnet بعد تلك الطلبات الثلاثة وأعاد المحاولة 10 مرات أخرى خلال 3 دقائق تقريبًا. أما الخطأ 429 فأُعيدت محاولته 10 مرات خلال 182 ثانية، مع فترات انتظار ازدادت من 0.5 إلى 40 ثانية، قبل ظهور `Request rejected (429)`. ومع `CLAUDE_CODE_RETRY_WATCHDOG=1`، كان Claude Code ما زال يعيد محاولة الخطأ 529 عندما أوقفنا التشغيل بعد 150 ثانية.

مع الإعدادات الافتراضية، أرسلت SDK إجمالًا 3 طلبات، الطلب الأول ثم إعادتي محاولة، ورمت `OverloadedError` بعد 1.3 ثانية. ومع `maxRetries: 5` أرسلت 6 طلبات خلال 14.3 ثانية. وعندما حمل الخطأ 429 الترويسة `retry-after: 3`، انتظرت SDK مدة 3 ثوانٍ قبل كل إعادة محاولة، وانتظر Claude Code مدة 3 ثوانٍ قبل كل واحدة من أول 3 إعادات محاولة.

## 529 و429 خطآن مختلفان

يعني الخطأ 529 `overloaded_error` أن API مشغول لدى جميع المستخدمين. هذا ليس حدك، ولا يُحتسب من حصتك.

أما الخطأ 429 `rate_limit_error` فيخص مؤسستك. فقد بلغت حدًا للمعدل، أو سقف الإنفاق الشهري لمستوى استخدامك، أو حد إنفاق على مساحة العمل في Claude Code. والخطأ 429 الناتج عن سقف الإنفاق لا يحمل الترويسة `retry-after` ويستمر في الفشل حتى يعود الوصول، لذلك لا تفيد إعادة المحاولة هنا.

## حدود خطة Claude Code ليست أخطاء API

الرسالتان `You've hit your session limit` و`You've hit your weekly limit` تأتيان من خطة Claude الخاصة بك. حد الجلسة هو النافذة المتجددة التي يسميها الناس حد 5 ساعات. شغّل `/usage` لترى الحدين وموعد إعادة ضبطهما.

أما `Server is temporarily limiting requests (not your usage limit)` فهو تقييد قصير على الخادم، ويعيد Claude Code المحاولة تلقائيًا. وتعني `Request rejected (429)` أن مفتاح API أو مشروع Amazon Bedrock أو مشروع Google Cloud بلغ حد المعدل الخاص به.

يتقدّم `ANTHROPIC_API_KEY` في الطرفية على خطتك، لذلك قد يصل Claude Code إلى الحد الأقل لهذا المفتاح. شغّل `/status` لترى أي تسجيل دخول هو النشط.

يرصد البلاغ #16157، وفيه 1,499 تعليقًا، مستخدمي Max الذين بلغوا الحد فورًا تقريبًا. وفي يناير 2026 كتب مهندس من Anthropic أن الفريق لا يملك بعد تفسيرًا مقنعًا. ويرصد #29579 ظهور `Rate limit reached` عند استخدام 16% فقط، ويرصد #6457 بلوغ حد 5 ساعات في أقل من 90 دقيقة. وما زالت البلاغات الثلاثة مفتوحة.

## أسئلة شائعة

### هل يُحتسب الخطأ 529 من حد استخدام Claude؟

لا. تقول مستندات Claude Code إن الخطأ 529 ليس حد استخدامك ولا يُحتسب من حصتك.

### كم يستمر خطأ Claude overloaded؟

تقول Anthropic إنه مؤقت عادةً. راجع status.claude.com لترى إن كان هناك حادث مفتوح وآخر تحديثاته.

### لماذا يعرض Claude Code رسالة rate limit reached؟

إما أن حد خطتك نفد، أو أن الخادم قيّد الطلبات لوقت قصير، أو أن مفتاح API بلغ حد المعدل. يوضح لك `/usage` و`/status` أي سبب منها.

### متى يُعاد ضبط حد Claude Code؟

تذكر الرسالة الوقت، مثل `resets 3:45pm`. ويعرضه `/usage` أيضًا.

### هل يجب أن يعيد تطبيقي محاولة الخطأ 529؟

نعم، مع تراجع أسّي. تعيد حزم SDK الرسمية المحاولة مرتين افتراضيًا، وفي اختبارنا انتظرت TypeScript SDK المدة التي طلبتها `retry-after` بالضبط.

## شاهد كل خطأ من Claude API في تطبيقك

إذا كان تطبيقك يستدعي Claude API، يجمع LogBrew أخطاء 529 و429 المتكررة في مشكلة واحدة ويعرض عدد مرات حدوث كل منها. ابدأ بخطة مجانية سخية دون بطاقة.

[ابدأ مجانًا](https://logbrew.co/ar)

## المصادر

- [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors)
- [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits)
- [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors)
- [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157)
- [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579)
- [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457)

## أدلة أخرى لوكلاء البرمجة بالذكاء الاصطناعي

- [أضف خادم MCP إلى Claude Code وCodex](https://logbrew.co/ar/guides/mcp-server-claude-code-codex)
- [استخدم AGENTS.md في Claude Code وCodex](https://logbrew.co/ar/guides/agents-md)
- [كيف تصلح الأخطاء في Claude Code وCodex وJavaScript في المتصفح](https://logbrew.co/ar/guides)