حدود استخدام كلود: ماذا تفعل عندما تتجاوزها

ما حدود استخدام كلود؟

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

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

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

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

يُسمّي 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.
• API Error: Server is temporarily limiting requests (not your usage limit) هو اختناق مؤقت لا علاقة له بحصة خطتك. يُعيد Claude Code المحاولة تلقائياً مع تراجع زمني قبل أن يُظهر لك هذا السطر.

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

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

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

على Claude للفرق والمؤسسات، الشكل الموثق هو حصة لكل مقعد تعيد التعيين على نافذة دورية مدتها خمس ساعات ونافذة أسبوعية، وهي مشتركة مع محادثة Claude و Cowork، ويحدد حجمها فئة المقعد (قياسية أو ممتازة). على 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 هو حد حجم للطلب الواحد، وليس حدًا لمعدل الطلبات.

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

تقيس واجهة برمجة تطبيقات الرسائل ثلاثة أشياء، بشكل منفصل لكل فئة نموذج.

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

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

تقرر أربع آليات متى يصل الخطأ 429.

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

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

قراءة الخطأ 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، مع نفس اللواحق limit و remaining و reset.
• anthropic-ratelimit-tokens-* تعرض القيم الخاصة بالحد الأكثر تقييداً الساري حالياً.

رأسيات reset هي طوابع زمنية بصيغة RFC 3339. رأسيات remaining token تُقرّب إلى أقرب ألف، لذا تعامل معها كمؤشر تقريبي. وضع Fast له مجموعته الخاصة ورأسيات 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. اذكرها عند التواصل مع الدعم.

تحقق مما إذا كنت بحاجة إلى حلقة تراجع من الأساس قبل أن تكتب واحدة. حزم SDK الرسمية تعيد تلقائياً محاولة الإخفاقات العابرة، بما في ذلك أخطاء الاتصال وحدود المعدل وأخطاء الخادم 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 خطأ التحميل الزائد ليس خطأك

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

اقرأ حدودك بنفسك بدلاً من جدول

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

في جانب API، ترسم صفحة الاستهلاك في Claude Console رسمين بيانيين، "حد المعدل - رموز الإدخال" و "حد المعدل - رموز الإخراج". يرسم الرسم البياني للإدخال الحد الأقصى لكل ساعة من رموز الإدخال غير المخزنة مؤقتاً في الدقيقة مقابل حد 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 بالأمر نفسه لكل مساحة عمل. كلاهما للقراءة فقط: لتغيير حد، استخدم تبويب الحدود في الـ Console.

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

كلا النظامين يقيسان الشيء نفسه في الأساس، لذا تعمل هذه الأدوات على أي منهما.

• أنفق رموزًا أقل في كل دورة. المهام المتواصلة تبقي الذاكرة المؤقتة دافئة، و/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 Code يعمل على خادم افتراضي خاص داخل tmux.

FAQ

لماذا لا يحل تغيير النموذج مشكلة حد استخدام Claude لدي؟

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

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

يعني أن حسابك وصل إلى حد معدل لفئة النموذج تلك: طلبات في الدقيقة، أو رموز إدخال في الدقيقة، أو رموز إخراج في الدقيقة. يحمل الرد ترويسة retry-after تتضمن الثواني المطلوب انتظارها، وتفشل محاولات إعادة الإرسال المبكرة. تقوم مكتبات SDK الرسمية بإعادة محاولة حدود المعدل وأخطاء 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، والذي يقيس الاستخدام بالدقيقة بدلاً من النافذة الزمنية.