SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-26

رفع خطای محدودیت استفاده از ابزار در Claude

خطای محدودیت استفاده از ابزار در یک نوبت به معنای اتمام سهمیه حساب نیست. این محدودیت مربوط به تعداد فراخوانی‌ها در یک چرخه است. با ارسال دستور ادامه، نوبت جدیدی باز می‌شود.

محدودیت استفاده از ابزار در این نوبت به چه معناست

محدودیت استفاده از ابزار در این نوبت به این معناست که Claude در میانه‌ی یک پاسخ متوقف شده است، زیرا آن پاسخ با محدودیت تعداد فراخوانی ابزار مواجه شده است، نه به این دلیل که سهمیه استفاده حساب کاربری شما تمام شده باشد. تمام اطلاعاتی که Claude تا پیش از توقف پیدا کرده است، همچنان در گفتگو موجود است. کافی است یک پیام دیگر ارسال کنید و از او بخواهید ادامه دهد؛ با این کار، یک نوبت جدید با بودجه‌ی جدید باز می‌شود.

هر نوبت (turn) یک رفت‌وبرگشت کامل در حلقه‌ی عامل (agent loop) است. Claude خروجی شامل فراخوانی ابزارها را تولید می‌کند، کلاینت آن ابزارها را اجرا می‌کند و نتایج برای تصمیم‌گیری بعدی به Claude بازگردانده می‌شوند. این چرخه بدون بازگرداندن کنترل به شما تکرار می‌شود. نوبت زمانی پایان می‌یابد که Claude پاسخی بدون هیچ فراخوانی ابزار تولید کند. سقف نوبت، در واقع محدودیتی برای تعداد دفعات این رفت‌وبرگشت‌ها در یک پاسخ واحد است.

محدودیت استفاده از طرح شما یک کنترل جداگانه است

محدودیت طرح، میزان استفاده شما را در یک بازه زمانی محاسبه می‌کند. صفحه مرکز راهنمایی Anthropic درباره پیام‌های خطا، که در تاریخ 25 October 2026 بررسی شد، آن مورد را هنگام نزدیک شدن به محدودیت با Approaching session limit و پس از عبور از آن با 5-hour limit reached - resets [time] فهرست می‌کند. محدودیت هفتگی پیام‌های مشابهی دارد که روز و ساعت بازنشانی را اعلام می‌کنند. در هر صورت، یک زمان مشخص ذکر می‌شود. بدون اعتبار استفاده (usage credits)، صبر کردن تا آن زمان مشکل را حل می‌کند و هیچ متنی که در این فاصله تایپ کنید، کمکی نخواهد کرد. اگر اعتبار استفاده را برای یک طرح پولی فعال کرده باشید، طبق آن صفحه، کار شما با استفاده از اعتبار ادامه می‌یابد و پیام به 5-hour limit resets [time] - continuing with usage credits تغییر می‌کند.

پیام استفاده از ابزار (tool use) رفتار متضادی دارد. این پیام در میانه یک وظیفه ظاهر می‌شود و یک پیام پیگیری ساده اجازه می‌دهد کار بلافاصله ادامه یابد. سهمیه باقی‌مانده شما دست‌نخورده باقی می‌ماند. این آزمایشی است که باید انجام دهید: اگر صبر کردن تأثیری ندارد و ادامه دادن کارساز است، شما هرگز به سهمیه خود نرسیده بودید. برای مورد سهمیه، اقدامات لازم هنگام رسیدن Claude به محدودیت گزینه‌ها را فهرست کرده و نحوه محاسبه محدودیت‌های استفاده Claude بازه‌های زمانی پشت آن‌ها را توضیح می‌دهد.

چرا هر نوبت (turn) دارای بودجه ابزار است

هر فراخوانی ابزار، بخشی از context را مصرف می‌کند. درخواست ارسال می‌شود، ابزار اجرا می‌گردد و کل نتیجه به گفتگو بازمی‌گردد. خواندن یک فایل حجیم یا اجرای یک دستور با خروجی طولانی می‌تواند هزاران توکن را در یک مرحله مصرف کند و آن متن تا پایان نشست (session) در context باقی می‌ماند. مستندات حلقه عامل (agent loop) در Anthropic پیامد این موضوع را به‌وضوح بیان می‌کند: context در طول نوبت‌ها انباشته می‌شود، بنابراین نشستی که شامل فراخوانی‌های ابزار متعددی است، بسیار سنگین‌تر از یک نشست کوتاه خواهد بود.

بودجه در نظر گرفته شده برای هر نوبت، عاملی است که از ادامه حلقه‌ای که دیگر پیشرفتی ندارد، جلوگیری می‌کند. عاملی که جستجو می‌کند، می‌خواند، دوباره جستجو می‌کند و همچنان نتیجه‌ای نمی‌یابد، تا زمانی که چیزی آن را متوقف نکند به این کار ادامه خواهد داد. این بودجه همان نقطه توقف است. بودجه، کنترل را در نقطه‌ای به شما بازمی‌گرداند که می‌توانید مسیر کار را تغییر دهید؛ این کار هزینه بسیار کمتری نسبت به اجازه دادن به حلقه برای رسیدن به انتهای پنجره context دارد.

این محدودیت در 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، صفحه دلایل توقف و بازگشت (fallback)، آن مقدار پیش‌فرض را 10 تکرار در هر درخواست اعلام کرده است. راه حل مستند شده این است که پاسخ را بدون تغییر به عنوان پیام دستیار بازگردانید تا Claude از جایی که متوقف شده ادامه دهد. شما نباید پیام کاربری جدیدی برای درخواست ادامه ارسال کنید: مثال مستند شده فقط پیام اصلی کاربر و به دنبال آن محتوای دستیار متوقف شده را ارسال می‌کند.

max_tokens به این معنی است که پاسخ به سقف توکن خروجی تعیین شده در درخواست رسیده است. اگر این پاسخ در داخل یک بلوک ناقص استفاده از ابزار قطع شود، فراخوانی ابزار قابل اجرا نیست و پاسخ مستند شده، تلاش مجدد با یک max_tokens بالاتر است.

مقادیر فعلی را در صفحه دلایل توقف و بازگشت بخوانید و به مقادیر نوشته شده در اینجا اعتماد نکنید. مقادیر پیش‌فرض در آن صفحه تغییر می‌کنند و یک عدد قدیمی از نبود عدد بدتر است.

چه چیزی باعث می‌شود یک چت با کمبود فراخوانی ابزار مواجه شود

  • پرسشی که نقطه توقف طبیعی ندارد. "هر چیزی که درباره X نوشته شده را پیدا کن" هیچ چیزی به مدل نمی‌گوید که نشان دهد جستجو تمام شده است.
  • خواندن مکرر همان مطالب، زیرا پاسخ در جایی که مدل انتظار داشت، نیست.
  • نتایج بزرگ ابزارها. یک صفحه وب طولانی یا یک فایل بزرگ، فضایی که بقیه نوبت به آن نیاز داشتند را اشغال می‌کند.
  • چندین وظیفه مستقل در یک پیام. هر وظیفه به فراخوانی‌های ابزار خاص خود نیاز دارد و همه آن‌ها از یک بودجه مشترک مصرف می‌کنند.
  • کانکتورها و سرورهای MCP (پروتکل زمینه مدل) که برای این وظیفه از آن‌ها استفاده نمی‌کنید. پس از بارگذاری، هر کدام فضایی را در گفتگو اشغال می‌کنند و به مدل راه‌های بیشتری برای صرف بودجه نوبت می‌دهند.

چگونه پاسخ را به پایان برسانیم

با "continue" پاسخ دهید، یا بهتر است، یک دستور کوتاه بنویسید که مشخص کند چه چیزی هنوز باقی مانده است. این کار یک نوبت جدید با بودجه جدید باز می‌کند. گفتگوی قبلی همچنان در زمینه (context) باقی است، بنابراین 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 ایجاد می‌کند. نتیجه همچنان شامل num_turns و session_id است، بنابراین می‌توانید همان نشست را با محدودیتی بالاتر از سر بگیرید و نیازی به شروع مجدد وظیفه نیست.

در CLI (رابط خط فرمان)، همین کنترل به صورت یک flag اعمال می‌شود و فقط در حالت print کار می‌کند:

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

در راهنمای این flag ذکر شده است که هنگام رسیدن به محدودیت، با خطا خارج می‌شود و به‌طور پیش‌فرض محدودیتی وجود ندارد. نسخه مشابهی از این ایده بر اساس هزینه وجود دارد: max_budget_usd در Python و maxBudgetUsd در TypeScript که حلقه را به جای تعداد نوبت‌ها، در یک آستانه هزینه متوقف می‌کنند و هزینه subagent نیز در آن مجموع محاسبه می‌شود. اگر عامل‌ها را روی سروری اجرا می‌کنید که هزینه ماهانه برای آن می‌پردازید، کنترل هزینه‌های عامل هوش مصنوعی روی VPS موضوعی است که ارزش دارد پیش از اولین اجرای طولانی‌مدت، تنظیم شود.

وقفه برای انتظار جهت تأیید، موضوع متفاوتی است. اگر عامل شما متوقف شده و هزینه‌ای مصرف نمی‌شود، به جای تعداد نوبت‌ها، permission_mode را بررسی کنید، زیرا یک ابزار در انتظار پاسخ انسانی است که هرگز دریافت نمی‌شود. حالت خودکار و تنظیمات مجوز Claude Code توضیح می‌دهد که کدام حالت‌ها درخواست تأیید می‌کنند و کدام حالت‌ها بدون پرسش اجرا می‌شوند.

چگونه رفتار فعلی را خودتان بررسی کنید

رفتار در اینجا بدون اطلاع قبلی تغییر می‌کند، بنابراین با هر عددی در این راهنما به عنوان یک داده قدیمی برخورد کنید، نه یک عدد ثابت. دو مکان نشان می‌دهند که امروز چه چیزی درست است.

  • مستندات API درباره دلایل توقف، که پیش‌فرض تکرار ابزار سرور و روش ادامه دادن پس از آن را نام می‌برد.
  • صفحه مرکز راهنمایی Anthropic درباره پیام‌های خطا، که متن محدودیت استفاده را فهرست می‌کند. آن صفحه که در تاریخ 25 October 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 این رقم را برای اپلیکیشن چت منتشر نمی‌کند. تقسیم کار به نوبت‌های کوچک‌تر، در هر طرحی، همان چیزی است که واقعاً کمک می‌کند.

چرا عامل (agent) شخصی من پس از تنها چند فراخوانی ابزار متوقف می‌شود؟

بررسی کنید که آیا محدودیتی (cap) تعیین کرده‌اید یا خیر. Claude Agent SDK از max_turns در Python و maxTurns در TypeScript استفاده می‌کند و رابط خط فرمان از --max-turns در حالت print استفاده می‌کند. هنگامی که یکی از این‌ها به حد نصاب برسد، SDK نتیجه‌ای با subtype برابر با error_max_turns و خطایی حاوی متن Reached maximum number of turns برمی‌گرداند. مقدار پیش‌فرض در هر دو، بدون محدودیت است. اگر هیچ محدودیتی اعمال نشده و اجرا همچنان متوقف می‌شود، stop_reason را در نتیجه بخوانید: max_tokens به این معنی است که سقف خروجی پر شده است و pause_turn به این معنی است که حلقه ابزار سرور به حد مجاز تکرار خود رسیده و می‌خواهد پاسخ برای ادامه کار به عقب فرستاده شود.

آیا این مقاله مفید بود؟