ماذا تفعل عند بلوغ حد استخدام Claude؟

ما حدود استخدام Claude؟

تعمل حدود استخدام Claude عبر نظامين منفصلين، وأول مهمة هي تحديد النظام الذي أوقفك. يوفّر اشتراك Claude ‏(Pro أو Max أو Team أو Enterprise القائم على المقاعد) حصة استخدام متجددة تُشارك بين النماذج، باستثناء بعض الحدود الخاصة بعائلات النماذج، كما تُشارك مع محادثات Claude. لذلك يوقفك برسالة مثل You've hit your session limit · resets 3:45pm. وتُعد خطط Enterprise الحالية القائمة على الاستخدام استثناءً؛ إذ لا تتضمن حصة، وتُحتسب كل الاستخدامات وفق أسعار API منذ أول token. أما Claude API فيقيس شيئاً آخر: سرعة إرسال الطلبات والـtokens، محسوبة لكل دقيقة. ويوقفك بخطأ HTTP 429 من النوع rate_limit_error، وعادةً يتضمن ترويسة retry-after توضّح عدد الثواني التي يجب انتظارها.

لا علاقة للإصلاحات ببعضها. يتعلق حد الاشتراك بكمية الاستخدام داخل نافذة زمنية، لذلك تنتظر إعادة الضبط، أو تشتري استخداماً إضافياً، أو تستنفد إعادة ضبط مجانية للحد إذا كان plan الخاص بك قد أتاحها. أما حد معدل API فيتعلق بسرعتك الحالية، ويزول خلال ثوانٍ بمجرد أن تخفّض السرعة.

تتغير حصص الخطط وأرقام مستويات حدود المعدل كثيراً، والرقم الخاطئ أسوأ من عدم عرض أي رقم؛ لذلك لا نطبع أياً منها هنا. اعرض بياناتك باستخدام الأوامر الواردة أدناه.

ما الحد الذي تجاوزته؟ اقرأ الرسالة كاملة

يذكر Claude Code النظام في النص الذي يطبعه. طابِق الرسالة مع نظامك قبل أن تغيّر أي شيء.

• You've hit your session limit · resets 3:45pm هو حد للاشتراك. لقد استُهلكت الحصة المتجددة التي تتيحها خطتك لهذه الفترة.
• You've hit your weekly limit · resets Mon 12:00am هو النظام نفسه ضمن الفترة الأطول.
• You've hit your Opus limit · resets 3:45pm هو حد للاشتراك ينطبق على طلبات Opus فقط. يتيح لك التبديل إلى نموذج خارج عائلة Opus مواصلة العمل.
• You've hit your Sonnet limit · resets 3:45pm هو النوع نفسه من حدود عائلة النماذج، لكنه ينطبق على طلبات Sonnet فقط. يتيح لك التبديل إلى نموذج خارج عائلة Sonnet مواصلة العمل.
• تعني الرسالة التي تبدأ بـ Fable limit reached أنك استهلكت الحصة من بدلك الأسبوعي التي يمكن لنماذج Fable استخدامها. يؤدي الاستمرار باستخدام Fable إلى احتساب أرصدة الاستخدام، لذلك يطلب منك Claude Code التأكيد أولاً. اختر نموذجاً آخر باستخدام /model للبقاء ضمن خطتك.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. هو حد لمعدل طلبات API. عند استخدام مفتاح Anthropic API، يكون هذا هو حد معدل الطلبات لمؤسستك، أو حداً أقل مضبوطاً على مساحة العمل التي ينتمي إليها المفتاح. وعند استخدام Amazon Bedrock أو Google Cloud، تكون هذه حصة مشروعك السحابي. يعتمد تحديد الحالة المنطبقة على كيفية مصادقة العميل، لأن عميل Bedrock أو Vertex يُحتسب استخدامه ضمن حصة مشروعك السحابي، لا ضمن مؤسسة Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) هو تقييد قصير الأمد لا يرتبط بحصة خطتك. يعيد Claude Code المحاولة تلقائياً مع تطبيق تراجع تدريجي قبل أن يعرض لك هذا السطر.

حدود الاشتراك: الجلسة والأسبوع ونافذة Opus

تتضمن خطة Pro أو Max أو Team أو Enterprise القائمة على المقاعد حصة استخدام متجددة. عند استنفادها، يحظر Claude Code الطلبات الإضافية حتى وقت إعادة الضبط الظاهر في الرسالة. ويسبب عاملان من عوامل هذه الحصة معظم الالتباس.

• الحصة مشتركة مع Claude chat. يستهلك العمل الذي تنفذه على claude.ai الحصة نفسها التي يستهلكها العمل في الطرفية، لذلك تقلل فترة استخدام مكثف للدردشة بعد الظهر من وقت البرمجة مساءً. وكل واجهة تسجّل الدخول إليها بهذا الحساب تستهلك من المجموعة نفسها، لذلك يستهلك تطبيق سطح المكتب التجريبي وواجهة Claude Code CLI على Linux حصة واحدة بينهما، لا حصة لكل منهما.
• الحصة مشتركة بين النماذج. تمثل حدود الجلسة والأسبوع مجموعة واحدة لكل نموذج. والاستثناءات هي الحدود الخاصة بعائلات النماذج داخل هذه المجموعة: حدود Opus وSonnet، وتخصيص Fable في مقاعد Max وPremium، الذي يصل إلى 50% من حدودك الأسبوعية. أما في مقاعد Pro وStandard، فلا تُضمّن Fable في حدود الخطة إطلاقاً، وتُحتسب تكلفته من أرصدة الاستخدام بدءاً من الطلب الأول.

في Claude for Teams وEnterprise القائمة على المقاعد، يتمثل النموذج الموثق في حصة لكل مقعد تُعاد تهيئتها ضمن نافذة متجددة مدتها خمس ساعات ونافذة أسبوعية، وتكون مشتركة مع Claude chat وCowork، ويحدد حجمها مستوى المقعد (Standard أو Premium). أما خطط Enterprise الحالية القائمة على الاستخدام فتعمل بطريقة مختلفة: لا توجد حصة مضمنة يمكن استنفادها، وتُحتسب التكلفة وفق أسعار API، ويكون السقف هو حدود الإنفاق التي يحددها المسؤولون على مستوى المؤسسة وللمستخدمين الفرديين. في الخطة التي تتم بمساعدة فريق المبيعات، يُستأنف الاستخدام الذي أوقفه حد الإنفاق عند بدء فترة الفوترة التالية، ما لم يرفع أحد المالكين الحد أولاً. وفي الخطة ذاتية الخدمة، يتوقف الاستخدام أيضاً عند نفاد رصيد الائتمان المدفوع مسبقاً، إلى أن يشتري أحد المالكين رصيداً إضافياً. في Pro وMax، يكون وقت إعادة الضبط المطبوع في الرسالة وأشرطة /usage الخاصة بك هما الرقمان الموثوقان، وليس رقماً منقولاً من منشور في مدونة. إذا كنت لا تزال تختار مستوى، تقارن خطة Claude التي تحتاج إليها ما الذي تتيحه كل خطة وما الذي تقيّده.

لماذا لا يؤدي تبديل النموذج باستخدام /model إلى استعادة الجلسة أو الحد الأسبوعي

هذا هو الإجراء الخاطئ الأكثر شيوعاً، وتوضح الوثائق ذلك صراحة: تشترك جميع النماذج في حدود الجلسة والحدود الأسبوعية، لذلك لا يؤدي تبديل النموذج إلى استعادة الوصول. اختيار نموذج أصغر بعد استنفاد نافذة الجلسة يغيّر النموذج الذي سيجيب، لكنه لا يغيّر مقدار الحصة المتبقية، لأن حصة الجلسة والحصة الأسبوعية ليستا منفصلتين لكل نموذج، ولذلك لا يحرّر التبديل أي حصة.

الاستثناء هو الحدود القصوى الخاصة بعائلة النموذج. إذا ظهرت الرسالة You've hit your Opus limit أو You've hit your Sonnet limit، فإن /model هو الإصلاح الصحيح. بدّل إلى نموذج خارج تلك العائلة وتابع العمل، لأن الطلبات المحجوبة كانت تخص تلك العائلة وحدها. وينطبق الأمر نفسه على حد Fable في خطتي Max وPremium: بدّل إلى نموذج آخر لمتابعة العمل ضمن خطتك، أو واصل استخدام Fable بالاعتماد على أرصدة الاستخدام. لكن Fable يستهلك الحدود الأسبوعية العادية في خطتك أسرع من النماذج الأخرى، ولا يضيف التبديل أي حصة: إذ تعتمد النماذج الأخرى على الحد الأسبوعي الإجمالي نفسه، الذي يظل سارياً ويمكن بلوغه أيضاً.

اعتبار الحد مشكلة برمجية هو الإجراء الخاطئ الثاني. لا يغيّر إعادة التثبيت أو إعادة المصادقة شيئاً. تعود الحصة عند إعادة ضبط النافذة أو عند إنفاق إعادة ضبط مجانية للحد. ولا تؤدي شراء أرصدة الاستخدام إلى إعادة ملء الحصة: تتحول طلباتك إلى تسعير الدفع حسب الاستخدام بالاعتماد على الأرصدة وتستمر في العمل، بينما تُعاد ضبط الحدود المضمّنة وفق جدولها المعتاد.

ما يجب فعله عند بلوغ حد الاشتراك

1. اقرأ وقت إعادة الضبط. تكون نافذة الجلسة قصيرة. أما النافذة الأسبوعية فلا يمكنك انتظار انتهائها أمام مكتبك. في Claude Code v2.1.234 أو الإصدارات الأحدث، يمكن لـ/rate-limit-options انتظار إعادة الضبط ثم متابعة المهمة المتوقفة تلقائياً.
2. إذا كان الحد خاصاً بـOpus أو Sonnet أو Fable، فشغّل /model واختر نموذجاً من خارج هذه العائلة.
3. شغّل /usage لعرض حدود خطتك وأشرطة الاستخدام وموعد إعادة ضبطها. ويُعد /cost اسماً مستعاراً للشاشة نفسها.
4. تحقّق من Settings > Usage في claude.ai أو في Claude Desktop للعثور على قسم Resets. تُتاح للخطط المؤهلة أحياناً إعادة ضبط مجانية للحد. ويؤدي النقر على "Reset for free" إلى إعادة حد جلستك البالغ خمس ساعات أو حدك الأسبوعي، أيّاً كان الحد الذي يشمله العرض، إلى مستواه الكامل فوراً. لا يتوفر الزر في Claude Code عند استخدام terminal أو IDE، ولا في Claude Mobile، وتنتهي صلاحية كل عرض.
5. شغّل /usage-credits لمواصلة العمل بعد بلوغ الحد. يفتح هذا الأمر إعدادات الفوترة في Pro وMax. أما في Team وEnterprise، فيفتح إعدادات استخدام مؤسستك أو يرسل طلباً إلى المسؤولين إذا لم تكن تملك صلاحية الوصول إلى الفوترة.
6. إذا بلغت الحد نفسه كل أسبوع، فحجم الخطة لا يناسب طريقة عملك. لذلك يجدر بك موازنة الخيارات المتاحة لتجاوز حد الاستخدام مرة واحدة بدلاً من فعل ذلك عند كل إعادة ضبط.

يتطلب /usage-credits تسجيل الدخول إلى اشتراك claude.ai عبر /login. ولا يتوفر هذا الخيار عند استخدام مصادقة مفتاح API، لأن مفتاح API لا يتضمن حصة خطة يمكن تمديدها.

لاستخدام أرصدة الاستخدام أثر جانبي ينبغي معرفته أولاً. يمنح Claude Code، افتراضياً، محادثتك الرئيسية ذاكرة تخزين مؤقت للمطالبات مدتها ساعة واحدة ما دمت ضمن الاستخدام المشمول في الاشتراك. وعندما تبدأ في استخدام الأرصدة، يخفض المدة إلى خمس دقائق، فتبدأ جولات إضافية دون ذاكرة تخزين مؤقت وترتفع كمية الرموز التي يستخدمها Claude Code للعمل نفسه. أما الوكلاء الفرعيون فلا يدخلون في حصة المحادثة الرئيسية، ولذلك يحصلون على خمس دقائق حتى أثناء استخدامك لحصة الخطة. يتيح لك اختيار مدة TTL بنفسك باستخدام إعداد promptCacheTtl أو CLAUDE_CODE_PROMPT_CACHE_TTL في Claude Code v2.1.242 أو الإصدارات الأحدث، الاحتفاظ بمدة الساعة الواحدة أثناء استخدام الأرصدة.

الرسائل التي تبدو كأنها حدود استخدام وليست كذلك

تُبلّغ أربعة أخطاء في Claude Code على أنها حدود استخدام، لكنها ليست كذلك.

• تحذير السياق أو التحذير من الضغط التلقائي ليس حد استخدام. يطبع /context سطراً مثل Context exceeds the 200k-token limit by 94k tokens، يتبعه الأمر الذي يحرر مساحة، بعد أن تتجاوز المحادثة نافذة سياق النموذج. يلخّص الضغط السجل الأقدم لتحرير مساحة، لكنه ليس مجانياً: يقرأ /compact المحادثة التي يلخّصها، لذلك يكون ضغط سياق كبير بحد ذاته طلباً كبيراً يُحتسب من خطتك. عندما تريد بداية جديدة بدلاً من الاستمرارية، لا يكلّف /clear شيئاً.
• يعني Prompt is too long · automatic compaction failed: <the underlying error> أن الضغط التلقائي نفسه فشل بسبب الخطأ الذي يذكره. ويستمر /compact في الفشل بسبب الخطأ نفسه إلى أن تعالجه.
• يعني Credit balance is too low أن مؤسستك في Console استنفدت الأرصدة المدفوعة مسبقاً، أو أن Claude Code يرسل طلبات مشترك عبر مفتاح API خاص بـConsole؛ ويعرض /status بيانات الاعتماد النشطة. أضف أرصدة من platform.claude.com/settings/billing، حيث يتوفر أيضاً التحميل التلقائي.
• يمثّل API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context فحصاً للاستحقاق، وليس حصة مستنفدة. إذا اخترت إصدار [1m] من Opus 4.6 أو Sonnet 4.6، فاختر الإصدار الذي لا يحمل اللاحقة [1m]، أو اضبط CLAUDE_CODE_DISABLE_1M_CONTEXT=1. إذا ظهر ذلك في منتصف المحادثة لأن السياق تجاوز 200K رمز، يضغط Claude Code السياق تلقائياً ليعود إلى ما دون الحد القياسي. يعمل Sonnet 5 والإصدارات الأحدث، وOpus 4.7 والإصدارات الأحدث، وHaiku 5.5 ونماذج Fable بنافذة أصلية بحجم 1M، ولا تحمل لاحقة يمكن إزالتها؛ ذلك المتغير هو الذي يقيّدها إلى 200K.

ويأتي خطأ آخر من API. يشير 413 request_too_large إلى حد لحجم طلب واحد، وليس إلى حد لمعدل الطلبات.

حدود معدل API: ما الذي يحسبه الخطأ 429 فعلياً

تقيس Messages API ثلاثة أمور، كل واحد منها بصورة مستقلة لكل فئة من النماذج:

• الطلبات في الدقيقة (RPM)
• رموز الإدخال في الدقيقة (ITPM)
• رموز الإخراج في الدقيقة (OTPM)

لدى مؤسستك أيضاً حد إنفاق، وهو أمر مختلف: تكلفة شهرية قصوى لاستخدام API. عند بلوغ سقف الإنفاق الخاص بمستواك، يتوقف استخدام API حتى الشهر التالي، ما لم تطلب رفع الحد. يظهر ذلك أيضاً في صورة 429 rate_limit_error، لكن من دون ترويسة retry-after، ومع وجود enforced_spend_limit_reached في error.details.error_code. لا يمكن لأي حلقة إعادة محاولة معالجة ذلك. يظهر حد الإنفاق الأقل الذي تحدده بنفسك في Console، للمؤسسة أو لمساحة العمل، بطريقة مختلفة أيضاً: تعيد الطلبات HTTP 400 invalid_request_error مع رسالة تبدأ بـ You have reached your specified API usage limits، أو You have reached your specified workspace API usage limits لمساحة العمل. يؤدي رفع الحد أو إزالته إلى استعادة الوصول. والاستثناء هو مساحة عمل Claude Code: فقد تحصل طلبات Claude Code التي تتجاوز حد إنفاق مساحة العمل على 429 مع ترويسة retry-after بدلاً من ذلك.

تحدد أربع آليات وقت ظهور الخطأ 429:

• تُطبَّق الحدود لكل فئة نموذج. تُطبَّق الحدود بصورة مستقلة على كل نموذج، لذلك يمكنك استخدام نماذج مختلفة في الوقت نفسه حتى حدودها الخاصة. تشترك بعض العائلات في حصة واحدة: حد معدل Opus هو إجمالي Claude Opus 4.8 وOpus 4.7 وOpus 4.6 وOpus 4.5، بينما لدى Claude Sonnet 5 حصة خاصة به.
• تُعاد تعبئة السعة باستمرار. تستخدم API خوارزمية حاوية الرموز، لذلك تتجدد السعة باستمرار بدلاً من إعادة ضبطها في وقت ثابت. قد يُطبَّق حد قدره 60 طلباً في الدقيقة بواقع طلب واحد في الثانية، ولذلك قد تفشل 60 طلباً تُرسل دفعة واحدة.
• يُحتسب إدخال غير مخزّن مؤقتاً فقط ضمن ITPM في معظم النماذج. يُحتسب input_tokens وcache_creation_input_tokens. لا يُحتسب cache_read_input_tokens في معظم نماذج Claude، ويُعد Claude Haiku 3.5 الاستثناء الموثق. لذلك يوفر التخزين المؤقت هامشاً إضافياً ضمن حدود المعدل، إلى جانب الخصم. أما في جانب الإخراج، فلا يُحتسب ارتفاع max_tokens ضمن OTPM، لأن OTPM يحسب الرموز التي أُنتجت فعلياً فقط.
• تُدار الحدود على مستوى المؤسسة. يمكن منح مساحة العمل حداً أقل، وتظل الحدود على مستوى المؤسسة سارية دائماً حتى إذا تجاوز مجموع حدود مساحات العمل تلك الحدود. ويُورث الحد الذي لم تغيّره لمساحة عمل من المؤسسة، ولا يُترك بلا حدود.

تحدد المستويات المسماة Start وBuild وScale وCustom الأرقام الفعلية. وتُعيَّن هذه المستويات تلقائياً استناداً إلى سجل استخدامك وحالة حسابك. قد تبدأ المؤسسات الجديدة والمؤسسات ذات سجل الاستخدام المحدود في مستوى Evaluation، الذي يكون أدنى من الحدود القياسية المنشورة. لذلك قد يظهر أول خطأ 429 قبل الوقت الذي يتوقعه الجدول. تؤدي الزيادة الحادة في الاستخدام إلى تفعيل حدود التسارع، التي تعيد 429 حتى عندما تظل ضمن مستواك. لذلك ارفع معدل الحركة تدريجياً. كل رقم منشور هو سقف: فالحدود الموثقة تمثل الحد الأقصى المسموح للاستخدام، وليست حدوداً دنيا مضمونة. لطلب زيادة، استخدم "Request tier increase" في صفحة Rate limits داخل Claude Console.

قراءة الخطأ 429: retry-after والرؤوس وإعادات المحاولة في SDK

يعيد كل خطأ في API الغلاف نفسه: كائن error متداخل يحمل النوع والرسالة، إضافة إلى request_id في المستوى الأعلى.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

تحمل الرؤوس بقية المعلومات.

• يحدد retry-after عدد الثواني التي يجب انتظارها قبل إعادة محاولة الطلب. ستفشل المحاولات المبكرة. لا يتضمن كل خطأ 429 هذه القيمة، ولا يتضمنها خطأ 429 الناتج عن حد الإنفاق أبداً.
• يصف anthropic-ratelimit-requests-limit وanthropic-ratelimit-requests-remaining وanthropic-ratelimit-requests-reset ميزانية طلباتك.
• يؤدي anthropic-ratelimit-input-tokens-* وanthropic-ratelimit-output-tokens-* الوظيفة نفسها بالنسبة إلى ITPM وOTPM، مع اللاحقات نفسها الخاصة بالحد والقيمة المتبقية ووقت إعادة الضبط.
• يعرض anthropic-ratelimit-tokens-* قيم الحد الأكثر تقييداً والمطبّق حالياً.

تكون رؤوس إعادة الضبط طوابع زمنية بتنسيق RFC 3339. وتُقرَّب رؤوس الرموز المتبقية إلى أقرب ألف، لذلك اقرأها كمؤشر تقريبي. يملك الوضع السريع مجموعة مستقلة ورؤوس anthropic-fast-* مستقلة. اقرأها كلها من أي استدعاء ناجح:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

يتضمن كل رد أيضاً رأس request-id فريداً، مثل req_018EeWyXxfu5pfWkrYcMdjWG. ويظهر هذا الرأس كـrequest_id في أجسام الأخطاء، وكـ_request_id في ردود Python وTypeScript SDK. اذكره عند التواصل مع فريق الدعم.

تحقق من حاجتك إلى حلقة للتأخير قبل أن تكتبها. تعيد SDKs الرسمية المحاولة تلقائياً عند الإخفاقات المؤقتة، بما في ذلك أخطاء الاتصال، وتجاوزات معدل الطلبات، وأخطاء الخادم 5xx، مع استخدام تأخير أُسّي، ومرتين افتراضياً، مع احترام رأس retry-after عند وجوده. يقبل كل عميل خيار maximum-retries لتغيير هذا السلوك أو تعطيله.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 overloaded_error ليس خطأً من جانبك

تعني استجابة 429 أنك أرسلت الطلبات بسرعة كبيرة. أما استجابة 529 overloaded_error فتعني أن API تعاني حملاً زائداً مؤقتاً. وقد تحدث عندما تشهد API حركة مرور مرتفعة من جميع المستخدمين. لا يكون مفتاحك ولا التعليمات البرمجية لديك سبباً فيها. أعد المحاولة باستخدام التراجع الأسي، وهو ما تفعله SDKs مسبقاً مع استجابات 5xx. راجع status.claude.com إذا لم تُحل المشكلة. استجابة 500 api_error هي خطأ داخلي، وتعيد المحاولة معها بالطريقة نفسها. ولا تمثل أي من الاستجابتين حداً لمعدل الطلبات.

اقرأ حدودك الفعلية بدلاً من الاعتماد على جدول

في الاشتراك، تُعدّ /usage الشاشة المهمة. فهي تعرض أشرطة استخدام خطتك وتفصيلاً لما استهلكها، وتبدّل d أو w بين آخر 24 ساعة وآخر 7 أيام. انتبه إلى أمرين. يعرض قسم Session استخدام رموز API، وهو مخصص لمستخدمي API، لذلك يمكنك تجاهل القيمة بالدولار الظاهرة فيه إذا كنت مشتركاً. تأتي الأرقام من سجل الجلسات المحلي على ذلك الجهاز، لذلك لا يظهر الاستخدام من جهاز آخر أو من claude.ai.

في جانب API، تعرض صفحة Usage في Claude Console مخططين هما "Rate Limit - Input Tokens" و"Rate Limit - Output Tokens". يعرض مخطط الإدخال الحد الأقصى لكل ساعة من رموز الإدخال غير المخزنة مؤقتاً في الدقيقة، مقارنةً بحد ITPM الحالي، مع معدل التخزين المؤقت بجانبه. بذلك تراقب اقترابك من الحد بدلاً من بلوغه في بيئة الإنتاج.

لقراءة الحدود المُعدّة برمجياً:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

تحتاج إلى بيانات اعتماد Admin API: مفتاح Admin API، أو رمز OAuth يتضمن نطاق org:admin، أو مفتاحاً شخصياً أو مفتاح حساب خدمة غير مقيّد بمساحة عمل. لا تعمل مفاتيح API الخاصة بمساحة العمل. ينفّذ GET /v1/organizations/workspaces/{workspace_id}/rate_limits العملية نفسها لكل مساحة عمل. كلا الأمرين للقراءة فقط. لتغيير حد، استخدم صفحة Rate limits في Console.

استخدام أقل، لتواجه حدوداً أقل

يقيس النظامان الشيء نفسه في الخلفية، لذلك تعمل هذه الإجراءات على كليهما.

• استهلك رموزاً أقل في كل دورة. تحافظ الجلسات المتواصلة على سخونة ذاكرة التخزين المؤقت، ولا تكلّفك /clear بين المهام غير المرتبطة شيئاً. يشرح استهلاك الرموز في Claude Code هذه الإجراءات بالكامل.
• خفّض مستوى الجهد. المستويات هي low وmedium وhigh وxhigh وmax. وتوفّر قائمة /effort أيضاً الخيار ultracode، لكنه يزيد الاستهلاك بدلاً من خفضه. لا تحقق الاستدلالات العميقة أي فائدة عند إعادة تسمية ميكانيكية.
• خفّض التوازي بعد ظهور الخطأ 429. خفّض CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY وتجنّب تشغيل عدد كبير من الوكلاء الفرعيين بالتوازي. وشغّل /status أيضاً، لأن وجود ANTHROPIC_API_KEY غير مقصود يوجّه الطلبات عبر مفتاح من فئة أقل بدلاً من اشتراكك.
• انقل العمل غير التفاعلي إلى Message Batches API. تنفّذ هذه الواجهة كميات كبيرة من العمل بشكل غير متزامن، مع خصم 50% من رموز الإدخال والإخراج، وبحدود معدل خاصة بها. بذلك لا تعود مهمة ليلية تنافس جلستك.

يظهر أثر ذلك بوضوح أكبر في العمل الذي يضخ البيانات في السياق. فإذا كنت تحلل الأسهم والخيارات بالاعتماد على بيانات السوق المباشرة، فإن جلب الجزء المحدد الذي تحتاج إليه كل إجابة يكلّف جزءاً من تكلفة لصق جداول الأسعار وسلاسل الخيارات كاملة. أما العمل المتقطع الذي يقوده برنامج بدلاً من شخص، فينبغي أن يبدأ باستخدام مفتاح API. ويغيّر الانتقال إلى هذه الطريقة كيفية الدفع، إضافة إلى كيفية احتساب الاستخدام، لأن Claude API لا يوفّر فئة مجانية. وتتضمن خطتا Max وTeam أرصدة API شهرية لتشغيل تطبيقاتك ووكلائك، بعد ربط مؤسسة في Console. لا تغطي هذه الأرصدة Claude Code، ولا تغيّر حدود الاستخدام في خطتك. يشرح تطبيق Claude API الأول على VPS التعامل مع المفاتيح وإعادة المحاولات، ويمكن لتشغيل وكيل طويل أن يستمر بعد انقطاع الاتصال عندما تُبقي Claude Code قيد التشغيل على VPS داخل tmux.

FAQ

لماذا لا يؤدي التبديل بين النماذج إلى حل حد استخدام Claude؟

لأن الحدود الخاصة بالجلسة والأسبوع مشتركة بين جميع النماذج. يرتبط هذا الرصيد بالخطة وليس بنموذج معين، لذلك يغيّر /model النموذج الذي سيجيب، ولا يغيّر مقدار الرصيد المتبقي. الاستثناء هو حدود عائلة النماذج: ينطبق You've hit your Opus limit وYou've hit your Sonnet limit على تلك العائلة فقط، كما أن حد Fable في خطتي Max وPremium يقيّد Fable وحده. في هذه الحالة، يكون التبديل بين النماذج هو الحل الموثّق.

ماذا يعني الخطأ 429 rate_limit_error، وكم يجب أن أنتظر؟

يعني ذلك عادةً أن مؤسستك تجاوزت حداً للمعدل خاصاً بفئة النموذج، مثل عدد الطلبات في الدقيقة، أو عدد رموز الإدخال في الدقيقة، أو عدد رموز الإخراج في الدقيقة. تتضمن الاستجابة عادةً ترويسة retry-after التي تحدد عدد الثواني المطلوب انتظارها، وتفشل محاولات إعادة الطلب المبكرة. تعيد SDKs الرسمية محاولة الطلب تلقائياً عند تجاوز حدود المعدل وأخطاء 5xx، باستخدام تراجع أُسّي، ومرتين افتراضياً، مع احترام تلك الترويسة عند توفرها. يشير خطأ 429 الذي يظهر رغم بقائك ضمن حدود فئتك إلى حد تسارع ناتج عن زيادة مفاجئة في معدل الاستخدام. أما خطأ 429 الذي يتضمن enforced_spend_limit_reached في error.details.error_code ولا يحمل أبداً ترويسة retry-after، فيشير إلى حد الإنفاق الشهري، ولن يؤدي الانتظار بضع دقائق إلى إزالته. يمكن أن تتلقى طلبات Claude Code أيضاً خطأ 429 عند وصول مساحة عمل Claude Code إلى حد إنفاق محدد لها.

كيف أرى حدود استخدام Claude وموعد إعادة ضبطها؟

في Claude Code، شغّل /usage لعرض مؤشرات خطتك، وأوقات إعادة الضبط، وتفصيل الاستخدام؛ /cost اسم مستعار، بينما يبدّل d أو w العرض بين آخر 24 ساعة وآخر 7 أيام. تأتي هذه الأرقام من سجل الجلسة المحلي، لذلك لا تشمل الاستخدام من الأجهزة الأخرى أو من claude.ai. في API، تعرض Console مخططات حدود المعدل، ويعيد GET /v1/organizations/rate_limits الحدود المكوّنة لك باستخدام بيانات اعتماد Admin API، مثل Admin API key.

هل يمكنني مواصلة العمل بعد بلوغ حد خطة Claude؟

أحياناً. شغّل /usage-credits لشراء استخدام يتجاوز السقف في خطتي Pro وMax، أو لطلبه من مسؤول في خطتي Team وEnterprise؛ ويتطلب ذلك تسجيل الدخول إلى claude.ai عبر /login، ولا يتوفر مع المصادقة باستخدام API key. وإلا فانتظر موعد إعادة الضبط، أو استخدم إعادة ضبط مجانية للحد إذا عرضت Settings > Usage في claude.ai أو Claude Desktop هذا الخيار، أو بدّل النموذج إذا كان الحد خاصاً بـ Opus أو Sonnet أو Fable، أو انقل العمل إلى API key، حيث يُحتسب الاستخدام بالدقيقة بدلاً من احتسابه لكل نافذة زمنية.