ما هو حد استخدام الأدوات في Claude لهذه الجولة؟

ما الذي يعنيه حد استخدام الأدوات لهذه الجولة

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

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

حد استخدام خطتك هو عنصر تحكم منفصل

يحسب حد الخطة ما استخدمته خلال فترة زمنية محددة. وتدرج صفحة مركز مساعدة Anthropic الخاصة برسائل الخطأ، التي جرى التحقق منها في 18 August 2026، الحالة الأولى على أنها Approaching 5-hour limit. عندما تقترب من الحد، والحالة الثانية على أنها 5-hour limit reached - resets [time]. بعد تجاوزه. وتحدد الصفحة وقتاً معيناً. يحل الانتظار حتى ذلك الوقت المشكلة، ولا يفيد أي شيء تكتبه في أثناء ذلك.

تظهر رسالة استخدام الأداة بطريقة معاكسة. فهي تصل في منتصف المهمة، وتتيح رسالة متابعة واحدة مواصلة العمل فوراً. ولا تتأثر الحصة المتبقية لديك. هذا هو الاختبار الذي يجب إجراؤه: إذا لم يفد الانتظار، بينما تؤدي المتابعة إلى استمرار العمل، فلم تكن قد بلغت حصتك. في حالة الحصة، يوضح ما يجب فعله عندما يقول 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 عندما تصل حلقة أخذ العينات على جانب الخادم إلى حد التكرارات أثناء تشغيل أدوات الخادم، مثل البحث على الويب. واعتباراً من 18 August 2026، تعرض صفحة أسباب إيقاف المعالجة هذا الإعداد الافتراضي بوصفه 10 تكرارات لكل طلب. والإصلاح الموثّق هو إرسال الاستجابة مرة أخرى دون تغيير بوصفها رسالة assistant، لكي يواصل Claude من الموضع الذي توقّف عنده. وهذه هي النسخة الخاصة بـAPI من كتابة "continue" في نافذة محادثة.

تعني القيمة max_tokens أن الاستجابة بلغت الحد الأقصى لرموز الإخراج المحدد في الطلب. وإذا اقتُطعت الاستجابة داخل كتلة استخدام أداة غير مكتملة، فلا يمكن تنفيذ استدعاء الأداة، وتوصي الوثائق بإعادة المحاولة باستخدام قيمة أعلى للحقل max_tokens.

اقرأ القيم الحالية في صفحة أسباب إيقاف المعالجة بدلاً من الاعتماد على القيم المكتوبة هنا. تتغير القيم الافتراضية في تلك الصفحة، والرقم القديم أسوأ من عدم وجود رقم.

ما الذي يجعل جلسة المحادثة تستنفد استدعاءات الأدوات

• سؤال لا يملك نقطة توقف طبيعية. فعبارة مثل «ابحث عن كل ما كُتب حول X» لا تمنح النموذج ما يحدد اكتمال البحث.
• قراءة المادة نفسها مراراً، لأن الإجابة ليست في الموضع الذي توقعه النموذج.
• نتائج الأدوات الكبيرة. تستهلك صفحة ويب طويلة واحدة أو ملف كبير واحد المساحة التي يحتاج إليها باقي الدور.
• عدة مهام مستقلة في رسالة واحدة. تحتاج كل مهمة إلى استدعاءات أدوات خاصة بها، وتُحتسب جميعها من ميزانية واحدة.
• الموصلات وخوادم MCP (بروتوكول سياق النموذج) التي لا تستخدمها في هذه المهمة. تُحمَّل تعريفات أدواتها ضمن الطلب، فتمنح النموذج طرقاً إضافية لاستهلاك الدور.

كيفية إكمال الإجابة

أرسل continue، أو الأفضل من ذلك، أرسل تعليمة قصيرة توضّح ما ينقص. يفتح ذلك دوراً جديداً بميزانية جديدة. تظل المحادثة السابقة ضمن السياق، لذلك يواصل Claude العمل بدلاً من تكرار استدعاءات الأدوات التي نفّذها بالفعل.

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

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

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

حدّد ميزانية الجولات بنفسك عند تشغيل agent

إذا كنت تشغّل Claude من خلال كودك الخاص، فإن ميزانية كل جولة تكون إعداداً تتحكم فيه أنت. يوفّر Claude Agent SDK (حزمة تطوير البرامج) الخيار max_turns في Python والخيار maxTurns في TypeScript. وتوثّق الحزمة هذا الخيار باعتباره الحد الأقصى لعدد جولات استخدام الأدوات. القيمة الافتراضية الموثّقة هي عدم وجود حد.

عند بلوغ هذا الحد، يعرض SDK نتيجة تكون قيمة subtype فيها هي error_max_turns. ويؤدي استدعاء query() لمرة واحدة إلى ظهور خطأ يتضمن النص Reached maximum number of turns. وتظل النتيجة تحتوي على num_turns وsession_id، ولذلك يمكنك متابعة الجلسة نفسها باستخدام حد أعلى بدلاً من بدء المهمة من جديد.

من CLI (واجهة سطر الأوامر)، يكون عنصر التحكم نفسه على شكل flag، ولا ينطبق إلا على وضع الطباعة:

claude -p --max-turns 3 "summarise the failing tests"

يوضح مرجع الـflag أن الأمر يخرج بخطأ عند بلوغ الحد، وأنه لا يوجد حد افتراضياً. توجد صيغة أخرى للفكرة نفسها تعتمد على التكلفة: يوقف max_budget_usd في Python وmaxBudgetUsd في TypeScript الحلقة عند بلوغ حد إنفاق بدلاً من عدد جولات، ويُحتسب إنفاق الـsubagent ضمن ذلك الإجمالي. إذا كنت تشغّل agents على خادم تدفع تكلفته شهرياً، فمن المفيد إعداد التحكم في تكلفة AI agent على VPS قبل أول تشغيل طويل.

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

كيفية التحقق من السلوك الحالي بنفسك

يتغير السلوك هنا دون إعلان، لذلك تعامل مع كل رقم في هذا الدليل على أنه مؤرخ وليس ثابتاً. يوضح مصدران ما هو صحيح اليوم.

• توثيق API حول أسباب التوقف، وهو يذكر القيمة الافتراضية لتكرار أداة الخادم وطريقة المتابعة بعد بلوغها.
• صفحة مركز مساعدة Anthropic حول رسائل الخطأ، وهي تسرد صياغة حدود الاستخدام. في 18 August 2026، توثق تلك الصفحة رسائل الاستخدام لمدة خمس ساعات والاستخدام الأسبوعي، ولا تذكر حداً لأدوات كل دور. لذلك لا نورد هنا رقماً رسمياً لتطبيق الدردشة.

قِس عمليات التشغيل الخاصة بك بدلاً من ذلك. في Claude Code، تعرض /context الاستخدام الحالي للسياق على شكل شبكة ملوّنة، وتحدد الأدوات التي تستهلك الجزء الأكبر منه، بينما تلخّص /compact المحادثة حتى الآن لتحرير مساحة. في Agent SDK، تحتوي كل نتيجة على num_turns، لذا يمكنك معرفة عدد جولات الاتصال التي تحتاج إليها مهمة نموذجية فعلياً قبل اختيار حد أقصى. تكون القيمة المستخلصة من عبء العمل الخاص بك أكثر فائدة من قيمة واردة في منشور على أحد المنتديات.

FAQ

هل حد استخدام الأدوات هو نفسه حد استخدامي لـClaude؟

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

كيف أجعل Claude يكمل مهمة أوقفها في منتصفها؟

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

ماذا تعني عبارة "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، وخطأ يتضمن النص Reached maximum number of turns. الإعداد الافتراضي في الحالتين هو عدم وجود حد. إذا لم يكن هناك حد مضبوط واستمر التشغيل في التوقف، فاقرأ stop_reason في النتيجة: تعني max_tokens بلوغ سقف الإخراج، بينما تعني pause_turn بلوغ حلقة أدوات الخادم حد التكرارات، وأنها تريد إعادة إرسال الاستجابة كي تتابع.