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

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

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

لا توجد علاقة بين طريقتي المعالجة. يتعلق حد الاشتراك بكمية الاستخدام داخل نافذة زمنية. لذلك انتظر إعادة ضبط الحصة أو اشترِ استخداماً إضافياً. أما حد معدل 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 فقط. هذه هي الحالة الوحيدة التي يفيد فيها تبديل النموذج.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. هو حد لمعدل طلبات API. لقد بلغت الحد المهيّأ لمفتاح API الخاص بك، أو لمشروع Amazon Bedrock أو Google Cloud الخاص بك. يعتمد تحديد الحد المنطبق على طريقة مصادقة العميل، لأن عميل Bedrock أو Vertex يُحتسب مقابل حصة مشروعك السحابي، لا مقابل مؤسسة Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) هو خنق مؤقت قصير الأمد لا يرتبط بحصة خطتك. يعيد Claude Code محاولة الطلب تلقائياً مع تطبيق backoff قبل أن يعرض لك هذا السطر.

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

تتضمن خطة الاشتراك حصة استخدام متجددة. عند استنفادها، يحظر Claude Code الطلبات الإضافية حتى وقت إعادة التعيين الظاهر في الرسالة. وتسبب خاصيتان لهذه الحصة معظم الالتباس.

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

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

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

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

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

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

ماذا تفعل عند بلوغ حد الاشتراك

1. اقرأ وقت إعادة الضبط. نافذة الجلسة قصيرة. أما النافذة الأسبوعية فلا يمكنك انتظار انتهائها أمام مكتبك.
2. إذا كان الحد خاصاً بـOpus، فنفّذ /model واختر نموذجاً آخر.
3. نفّذ /usage لعرض حدود خطتك، والأشرطة الخاصة بك، وموعد إعادة ضبطها. /cost هو اسم مستعار للشاشة نفسها.
4. نفّذ /usage-credits لمواصلة العمل بعد بلوغ الحد. في خطتي Pro وMax، يفتح ذلك إعدادات الفوترة. وفي خطتي Team وEnterprise، يفتح إعدادات الاستخدام في مؤسستك، أو يرسل طلباً إلى المسؤولين إذا لم يكن لديك وصول إلى الفوترة.
5. إذا بلغت الحد نفسه كل أسبوع، فحجم الخطة لا يناسب طريقة عملك، ومن المفيد موازنة الخيارات المتاحة لتجاوز حد الاستخدام مرة واحدة بدلاً من فعل ذلك عند كل إعادة ضبط.

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

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

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

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

• تحذير السياق أو الضغط التلقائي ليس حد استخدام. يطبع /context سطراً مثل Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. بعد أن تتجاوز المحادثة نافذة سياق النموذج. يُلخَّص السجل الأقدم لتوفير مساحة، ولا يتأثر رصيد خطتك.
• يعني Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. أن /compact نفسه فشل، لأن مساحة السياق الحرة المتبقية لا تكفي لاحتواء الملخص الذي سينشئه.
• يعني Credit balance is too low أن مؤسستك في Console استنفدت الأرصدة المدفوعة مسبقاً. أضف أرصدة من platform.claude.com/settings/billing، حيث يتوفر أيضاً خيار إعادة التحميل التلقائي.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context هو فحص للاستحقاق، وليس حصة مستنفدة. اختر إصدار النموذج من دون اللاحقة [1m]، أو اضبط CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

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

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

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

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

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

تحدد أربع آليات وقت وصول الخطأ 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 الأرقام الفعلية. ويُعيَّن المستوى تلقائياً استناداً إلى سجل استخدامك وحالة حسابك. قد تبدأ المؤسسات الجديدة بحدود أدنى من الحدود القياسية المنشورة، لذلك قد يصل أول خطأ 429 قبل الوقت الذي يتوقعه الجدول. تؤدي الزيادة الحادة في الاستخدام إلى تفعيل حدود التسارع، التي تعيد الخطأ 429 بينما لا تزال ضمن مستواك، لذلك ارفع معدل الحركة تدريجياً. كل رقم منشور هو سقف: فالحدود الموثقة تمثل الحد الأقصى للاستخدام المسموح، وليست حداً أدنى مضموناً. لطلب حد أعلى، استخدم عنصر التحكم "طلب زيادة حد معدل الطلبات" في صفحة 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 عدد الثواني التي يجب انتظارها قبل إعادة محاولة الطلب. وستفشل المحاولات المبكرة.
• تصف 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. وتُقرَّب رؤوس الرموز المتبقية إلى أقرب ألف، لذلك اقرأها كمؤشر تقريبي. يملك Fast mode مجموعة مستقلة ورؤوس 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 في ردود SDK الخاصة بـPython وTypeScript. اذكره عند التواصل مع فريق الدعم.

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

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، ويعرض GET /v1/organizations/workspaces/{workspace_id}/rate_limits المعلومات نفسها لكل مساحة عمل. كلاهما للقراءة فقط. لتغيير حد، استخدم علامة 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 لا يوفّر مستوى مجانياً بعد الرصيد الصغير الممنوح عند التسجيل. يشرح تطبيق Claude API الأول على VPS كيفية التعامل مع المفاتيح وإعادة المحاولة، كما تستمر جلسة وكيل طويلة بعد انقطاع الاتصال إذا أبقيت Claude Code قيد التشغيل على VPS داخل tmux.

FAQ

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

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

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

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

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

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

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

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