ما هو حد استخدام الأدوات في Claude لهذه الجولة؟
تعني الرسالة أن Claude استنفد استدعاءات الأدوات المسموح بها في جولة واحدة، لا حصة خطتك. أرسل رسالة متابعة لبدء جولة جديدة وإكمال المهمة.
ما الذي يعنيه حد استخدام الأدوات لهذه الجولة
يعني حد استخدام الأدوات لهذه الجولة أن Claude توقف في منتصف الاستجابة لأن الاستجابة استنفدت عدد استدعاءات الأدوات المسموح بها، وليس لأن حسابك استنفد حد الاستخدام. كل ما توصّل إليه قبل التوقف ما يزال موجوداً في المحادثة. أرسل رسالة أخرى تطلب منه المتابعة، وسيبدأ جولة جديدة بميزانية جديدة.
في Agent SDK، الجولة هي دورة واحدة ضمن حلقة الوكيل. يُنتج Claude مخرجات تتضمن استدعاءات للأدوات، ثم يشغّل العميل هذه الأدوات، وتعود النتائج إلى Claude لاتخاذ القرار التالي. تتكرر هذه الدورة من دون إعادة التحكم إليك. تنتهي الحلقة عندما يُنتج Claude استجابة لا تتضمن أي استدعاءات للأدوات. ويحتسب حد الجولة في SDK كل دورة، بما في ذلك الاستجابة النهائية التي لا تتضمن استدعاءات للأدوات.
حد استخدام الخطة هو عنصر تحكم منفصل
يحسب حد الخطة ما استخدمته خلال فترة زمنية محددة. تعرض صفحة مركز مساعدة Anthropic الخاصة برسائل الخطأ، التي جرى الاطلاع عليها في 9 November 2026، الرسالة Approaching session limit عندما تقترب من الحد، والرسالة 5-hour limit reached - resets [time] بعد تجاوزه. ويعرض الحد الأسبوعي رسائل مماثلة تحدد يوم ووقت إعادة الضبط. في كلتا الحالتين، تحدد الرسالة وقتاً معيناً. من دون أرصدة استخدام، يؤدي الانتظار حتى ذلك الوقت إلى حل المشكلة، ولن يفيدك أي شيء تكتبه في أثناء ذلك. إذا فعّلت أرصدة الاستخدام في خطة مدفوعة، توضح الصفحة أن عملك يستمر باستخدام الأرصدة بدلاً من ذلك، وتظهر الرسالة 5-hour limit resets [time] - continuing with usage credits. وينتهي هذا الاستمرار عند بلوغ حد الإنفاق الشهري أو نفاد رصيدك مع تعطيل إعادة التحميل التلقائي. لا تفرض حسابات Ultra الموثقة حداً للجلسة مدته خمس ساعات، لكن الحدود الأسبوعية تظل سارية.
تعمل رسالة استخدام الأداة بطريقة معاكسة. تظهر في أثناء تنفيذ مهمة، وتسمح رسالة متابعة واحدة بمتابعة العمل فوراً. تظل استدعاءات الأداة التي أُجريت محسوبة ضمن استخدام خطتك. لا تؤدي المتابعة إلى إعادة ضبط حصتك، كما يمكن لأرصدة الاستخدام أن تتيح استمرار العمل بعد بلوغ حد الخطة. في حالة الحصة، تعرض ما يجب فعله عندما يقول Claude إن الحد قد تم بلوغه الخيارات المتاحة، وتشرح كيفية احتساب حدود استخدام Claude الفترات الزمنية التي تستند إليها هذه الحدود.
لماذا توجد ميزانية لاستدعاءات الأدوات في الدور
يستهلك كل استدعاء لأداة جزءاً من سياق المحادثة. يُرسل الاستدعاء، وتعمل الأداة، ثم تعود النتيجة كاملة إلى المحادثة. يمكن لقراءة ملف كبير أو تشغيل أمر ذي مخرجات طويلة أن يستهلك آلاف الرموز في خطوة واحدة، وتبقى تلك النصوص في السياق طوال بقية الجلسة. توضّح وثائق حلقة الوكيل لدى Anthropic النتيجة بوضوح: يتراكم السياق عبر الأدوار، ولذلك تحتوي الجلسة التي تتضمن استدعاءات كثيرة للأدوات على محتوى أكبر بكثير من جلسة قصيرة.
تمنع الميزانية المحددة للدور استمرار حلقة لم تعد تحقق تقدماً. فإذا بحث الوكيل، وقرأ، ثم بحث مرة أخرى، ولم يجد شيئاً، فسيواصل ذلك إلى أن يوقفه شيء ما. الميزانية هي آلية الإيقاف. وتعيد إليك التحكم عند نقطة يمكنك فيها إعادة توجيه العمل، وتكلفة ذلك أقل بكثير من السماح للحلقة بالاستمرار حتى نهاية نافذة السياق.
مكان ظهور هذا الحد في API
لا تقدّم وثائق Anthropic العامة الخاصة بالأخطاء رقماً لعدد استدعاءات الأدوات في كل دورة ضمن تطبيق Claude للمحادثة، ولذلك فإن أي رقم دقيق تقرؤه عن ذلك هو مجرد تخمين. ويُوثَّق النوع نفسه من الحدود في API (واجهة برمجة التطبيقات)، حيث يظهر السلوك الفعلي في تلك الوثائق.
يوضح الحقل stop_reason في استجابة Messages API سبب توقف التوليد. والقيم الموثقة هي end_turn وmax_tokens وstop_sequence وtool_use وpause_turn وrefusal وmodel_context_window_exceeded. وتصف اثنتان منها الحالة الواردة في هذا الدليل.
تُعاد pause_turn عندما تصل حلقة أخذ العينات على الخادم إلى حد التكرارات أثناء تشغيل أدوات الخادم، مثل البحث على الويب. واعتباراً من 25 October 2026، تعرض صفحة أسباب التوقف والبديل قيمة هذا الإعداد الافتراضية، وهي 10 تكرارات لكل طلب. ويقضي الإصلاح الموثق بإعادة إرسال الاستجابة دون تغيير باعتبارها رسالة المساعد، ليواصل Claude من الموضع الذي توقف عنده. لا تضف رسالة مستخدم جديدة تطلب منه المتابعة؛ فالمثال الموثق يرسل رسالة المستخدم الأصلية فقط، متبوعة بمحتوى المساعد المتوقف.
تعني max_tokens أن الاستجابة بلغت الحد الأقصى لرموز الإخراج المحدد في الطلب. إذا حدث الاقتطاع داخل كتلة استخدام أداة غير مكتملة، فلا يمكن تنفيذ استدعاء الأداة، وتتمثل الإجابة الموثقة في إعادة المحاولة باستخدام max_tokens أعلى.
اقرأ القيم الحالية في صفحة أسباب التوقف والبديل، بدلاً من الاعتماد على القيم المكتوبة هنا. تتغير القيم الافتراضية في تلك الصفحة، والرقم القديم أسوأ من عدم وجود رقم.
ما الذي يجعل الدردشة تنفد من استدعاءات الأدوات
- سؤال ليس له نقطة توقف طبيعية. "اعثر على كل ما كُتب عن X" لا يعطي النموذج أي شيء يخبره بأن البحث قد انتهى.
- القراءات المتكررة لنفس المادة، لأن الإجابة ليست حيث توقع النموذج أن تكون.
- نتائج الأدوات الكبيرة. صفحة ويب طويلة واحدة أو ملف كبير واحد يستهلك المساحة التي تحتاجها بقية الدورة.
- عدة مهام مستقلة في رسالة واحدة. كل مهمة تحتاج إلى استدعاءات الأدوات الخاصة بها، وجميعها تخرج من ميزانية واحدة.
- الموصلات وخوادم MCP (بروتوكول سياق النموذج) التي لا تستخدمها لهذه المهمة. بمجرد تحميلها، يشغل كل منها مساحة في المحادثة ويمنح النموذج طرقاً أكثر لإنفاق الدورة.
كيفية إتمام الإجابة
رد بـ "continue"، أو الأفضل من ذلك، تعليمات قصيرة تحدد ما لا يزال مفقوداً. هذا يفتح دورة جديدة بميزانية جديدة. تظل المحادثة السابقة في السياق، لذا يكمل Claude من حيث توقف بدلاً من تكرار استدعاءات الأدوات التي قام بها بالفعل.
إذا توقف في نفس المكان مرتين، فالمهمة واسعة جداً بالنسبة لدورة واحدة، لذا قم بتقسيمها. بدلاً من طلب تدقيق كامل للمستودع، اطلب قائمة الملفات أولاً، ثم اسأل عن ملف واحد في كل رسالة. أربع دورات صغيرة تنهي عملاً لا تستطيع دورة واحدة كبيرة إنجازه.
ضيّق نطاق ما يجب على النموذج البحث عنه. أعطِ مسار الملف الدقيق، أو سلسلة الخطأ الدقيقة، وألصق السجل عندما يكون لديك بالفعل. السجل الملصق يكلف رسالة واحدة. جعل النموذج يذهب ويعثر على ذلك السجل يكلف عدة استدعاءات أدوات، وقد يعثر على السجل الخطأ.
أوقف تشغيل الموصلات التي لا تحتاجها الآن. يقول مركز مساعدة Anthropic إن كل موصل يشغل مساحة في المحادثة. في إعداد Auto الافتراضي، يقرر Claude أي الموصلات سيتم تحميلها، بينما يقوم Always available بتحميل كل منها في البداية، ويستهلك كل موصل محمل السياق ويوسع مجموعة الحركات التي يمكن للنموذج الاختيار من بينها. إذا احتفظت بمجموعة كبيرة من الموصلات، فإن إعداد On demand يحملها فقط بعد أن يبحث Claude عن الموصل المناسب. ينطبق نفس المنطق على جلسة برمجة طويلة، حيث يعد الحفاظ على سياق جلسة Claude Code صغيراً هو الفرق بين وكيل ينهي عمله ووكيل يتوقف في منتصف الطريق.
حدِّد ميزانية عدد الدورات بنفسك عند تشغيل وكيل
إذا كنت تشغّل Claude من خلال برمجتك الخاصة، فأنت تتحكم في إعداد ميزانية الدورات للحلقة. توفّر Claude Agent SDK (مجموعة تطوير البرمجيات) الخيار max_turns في Python والخيار maxTurns في TypeScript. وتحسب هذه الخيارات الدورات التي تتضمن استدعاءات الأدوات، إضافة إلى الاستجابة النهائية النصية فقط. القيمة الافتراضية الموثقة هي عدم وجود حد.
عند بلوغ هذا الحد، تُرجع SDK نتيجة تكون قيمة subtype فيها هي error_max_turns. أما استدعاء query() المنفّذ مرة واحدة، فيرفع خطأً يتضمن النص Reached maximum number of turns. وتوثّق صفحة حلقة الوكيل في Agent SDK أيضاً خروج عملية Claude Code الأساسية برمز غير صفري عند حدوث هذا الخطأ في الاستدعاء المنفّذ مرة واحدة. وتظل النتيجة تتضمن num_turns وsession_id، لذلك يمكنك استئناف الجلسة نفسها بحد أعلى بدلاً من بدء المهمة من جديد.
من خلال CLI (واجهة سطر الأوامر)، يكون عنصر التحكم نفسه راية، ولا يعمل إلا في وضع الطباعة:
claude -p --max-turns 3 "summarise the failing tests"يوضح مرجع الرايات أنه لا يوجد حد افتراضيًا. عند استخدام --input-format stream-json، تبقى الرسالة التي لا تزال في قائمة الانتظار عند انتهاء الحد في قائمة الانتظار، وتبدأ في دورة جديدة بحد خاص بها. توجد صيغة مماثلة تعتمد على التكلفة: يوقف max_budget_usd في Python وmaxBudgetUsd في TypeScript الحلقة عند بلوغ حد للإنفاق بدلاً من عدد الدورات، ويُحتسب إنفاق الوكلاء الفرعيين ضمن الإجمالي. يُفحص الحد بعد وصول استجابات النموذج، لذلك قد يتجاوز الإنفاق الحد بسبب الاستجابة التي بلغ عندها الحد، وبسبب الوكلاء الفرعيين الذين يعملون في الخلفية وينتهون قبل إيقافهم. إذا كنت تشغّل وكلاء على خادم تدفع تكلفته شهرياً، فمن المفيد إعداد التحكم في تكلفة وكيل الذكاء الاصطناعي على VPS قبل أول تشغيل طويل.
التوقف المؤقت في انتظار الموافقة أمر مختلف. إذا توقف وكيلك ولم يعد هناك إنفاق، فاقرأ permission_mode بدلاً من عدد الدورات، لأن أداة ما تنتظر إجابة بشرية لا تصل. يوضح الوضع التلقائي وإعدادات الأذونات في Claude Code الأوضاع التي تطلب الموافقة وتلك التي تعمل دون طلبها.
كيفية التحقق من السلوك الحالي بنفسك
يتغير السلوك هنا من دون إعلان، لذلك تعامل مع كل رقم في هذا الدليل على أنه مؤرّخ وليس ثابتاً. يوضح مصدران ما هو صحيح اليوم.
- توثيق API بشأن أسباب التوقف، وهو يذكر القيمة الافتراضية لتكرار أداة الخادم وكيفية متابعة التنفيذ بعدها.
- صفحة مركز مساعدة Anthropic بشأن رسائل الخطأ، وهي تسرد صياغة حدود الاستخدام. وفقاً للتحقق في 9 نوفمبر 2026، توثّق الصفحة رسائل الاستخدام لمدة خمس ساعات والاستخدام الأسبوعي، بما في ذلك الإصدارات التي تظهر عند استخدام أرصدة الاستخدام، ولا تذكر أي حد لأدوات كل دور. لذلك لا نورد هنا رقماً رسمياً لتطبيق الدردشة.
قِس عمليات التشغيل الخاصة بك بدلاً من ذلك. في Claude Code، يرسم /context استخدام السياق الحالي في شبكة ملوّنة، ويشير إلى الأدوات التي تستهلك معظمه، بينما يلخّص /compact المحادثة حتى الآن لتوفير مساحة. في Agent SDK، تحمل كل نتيجة num_turns، لذلك يمكنك معرفة عدد الأدوار التي تحتاج إليها مهمة نموذجية فعلياً قبل اختيار حد أقصى. الرقم المستخلص من عبء العمل الخاص بك أهم من رقم منشور في مشاركة على أحد المنتديات.
FAQ
هل حد استخدام الأدوات هو نفسه حد استخدام Claude؟
لا. يحسب حد الاستخدام ما أنفقته خلال فترة زمنية، ويخبرك بموعد إعادة ضبطه، لذلك يكون الانتظار هو الحل. أما رسالة استخدام الأدوات فتوقف جزءاً من الاستجابة لأن الاستجابة استنفدت استدعاءات الأدوات المسموح بها، ويؤدي إرسال رسالة أخرى إلى بدء دورة جديدة بميزانية جديدة فوراً. يظل استخدام الأدوات محسوباً ضمن استخدام خطتك. يشرح كيفية احتساب حدود استخدام Claude حالة الحصة بالتفصيل.
كيف أجعل Claude يكمل مهمة توقف عنها في منتصفها؟
أرسل رسالة أخرى. تنجح عبارة «تابع»، لكن توجيهاً يحدد ما لم يكتمل بعد يكون أفضل، لأنه يمنع النموذج من إعادة بناء السياق الموجود لديه. إذا توقف عند النقطة نفسها مرة ثانية، فقسّم المهمة إلى أجزاء أصغر وأرسل جزءاً واحداً في كل رسالة. يؤدي تحديد مسارات الملفات بدقة، أو لصق المحتوى مباشرة، إلى إلغاء البحث الذي استنفد الميزانية في الأصل.
ماذا تعني عبارة "límite de uso de herramientas" أو "limite de uso de ferramentas"؟
هاتان صيغتان بالإسبانية والبرتغالية للرسالة نفسها، وتظهران عادةً بصيغة "límite de uso de herramientas en este turno" أو "limite de uso de ferramentas neste turno". المعنى متطابق في كل اللغات: استنفد Claude استدعاءات الأدوات المسموح بها داخل استجابة واحدة، ولا علاقة لذلك بحصة خطتك. والحل نفسه أيضاً. اطلب منه في ردك أن يتابع، أو قسّم الطلب إلى خطوات أصغر. حد الفوترة رسالة منفصلة، وتذكر تلك الرسالة وقت إعادة الضبط.
هل تؤدي ترقية خطتي إلى رفع حد استخدام الأدوات في الدورة الواحدة؟
مستوى الخطة وميزانية الأدوات لكل دورة هما إعدادان مختلفان. تؤدي الترقية إلى زيادة مقدار الاستخدام المتاح لك خلال فترة زمنية، وهي الفترة التي تذكر وقت إعادة الضبط. أما عدد استدعاءات الأدوات التي يمكن للاستجابة الواحدة إجراؤها، فهو خاصية للحلقة التي تشغّل النموذج، ولا تنشر Anthropic هذا الرقم لتطبيق الدردشة. تقسيم المهمة إلى دورات أصغر هو ما يساعد فعلياً، بصرف النظر عن الخطة.
لماذا يتوقف الوكيل الذي أنشأته بعد بضعة استدعاءات للأدوات فقط؟
تحقق مما إذا كنت قد عيّنت حداً أقصى. يأخذ Claude Agent SDK القيمة max_turns في Python والقيمة maxTurns في TypeScript، وتأخذها واجهة سطر الأوامر بالقيمة --max-turns في وضع الطباعة. عند الوصول إلى أحد هذه الحدود، يعيد SDK نتيجة تحتوي على subtype بقيمة error_max_turns؛ ويؤدي استدعاء query() المنفّذ مرة واحدة إلى رفع خطأ يتضمن النص Reached maximum number of turns. القيمة الافتراضية في الحالتين هي عدم وجود حد. إذا لم يكن هناك حد معيّن واستمر التشغيل في التوقف، فاقرأ stop_reason في النتيجة: تعني max_tokens بلوغ سقف الإخراج، وتعني pause_turn بلوغ حلقة أدوات الخادم حد التكرارات وأنها تريد إرسال الاستجابة إليها كي تتابع.