SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

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

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

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

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

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

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

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

پیام استفاده از ابزار (tool use) رفتار متفاوتی دارد. این پیام در میانهٔ یک وظیفه ظاهر می‌شود و با ارسال یک پیام پیگیری (follow-up)، کار بلافاصله ادامه می‌یابد. فراخوانی‌های ابزاری که قبلاً انجام شده‌اند، همچنان در محاسبهٔ میزان استفاده از طرح شما لحاظ می‌شوند. ادامه دادن کار، سهمیهٔ شما را بازنشانی نمی‌کند و اعتبار استفاده نیز می‌تواند پس از رسیدن به محدودیت طرح، امکان ادامهٔ کار را فراهم کند. برای موارد مربوط به سهمیه، اقدامات لازم هنگام رسیدن به محدودیت 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 را از طریق کد خود اجرا می‌کنید، بودجه نوبت‌های حلقه (loop) تنظیمی است که در اختیار شماست. 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 (رابط خط فرمان)، همین کنترل به‌صورت یک flag است و فقط برای حالت print اعمال می‌شود:

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

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

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

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

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

  • مستندات API در مورد دلایل توقف، که مقدار پیش‌فرض تکرار ابزار سرور و روش ادامه دادن پس از آن را مشخص می‌کند.
  • صفحهٔ مرکز راهنمایی Anthropic در مورد پیام‌های خطا، که متن محدودیت استفاده را فهرست کرده است. این صفحه در تاریخ 9 November 2026 بررسی شد و پیام‌های استفادهٔ پنج‌ساعته و هفتگی، از جمله نسخه‌هایی که هنگام جایگزینی با اعتبار استفاده (usage credits) نمایش داده می‌شوند را مستند کرده است، اما هیچ اشاره‌ای به سقف ابزار در هر نوبت (per turn) نکرده است. به همین دلیل است که هیچ عدد رسمی برای اپلیکیشن چت در اینجا ذکر نشده است.

اجراهای خود را شخصاً اندازه‌گیری کنید. در Claude Code، دستور /context میزان استفاده از کانتکست فعلی را به صورت یک شبکهٔ رنگی ترسیم می‌کند و ابزارهایی که بیشترین سهم را مصرف می‌کنند نشان می‌دهد، و دستور /compact برای آزاد کردن فضا، مکالمه تا این لحظه را خلاصه می‌کند. در Agent SDK، هر نتیجه شامل num_turns است، بنابراین می‌توانید قبل از انتخاب سقف، ببینید یک وظیفهٔ معمول واقعاً به چند نوبت نیاز دارد. عددی که از حجم کاری خودتان به دست آمده، ارزشمندتر از عددی است که در یک پست انجمن نوشته شده باشد.

FAQ

آیا محدودیت استفاده از ابزار با محدودیت استفاده من از Claude یکسان است؟

خیر. محدودیت استفاده، میزان مصرف شما در یک بازهٔ زمانی را محاسبه می‌کند و زمان بازنشانی آن را اعلام می‌نماید، بنابراین راهکار آن صبر کردن است. پیام محدودیت استفاده از ابزار، پاسخ را در میانهٔ راه متوقف می‌کند زیرا آن پاسخ سقف فراخوانی‌های ابزار خود را پر کرده است؛ ارسال یک پیام جدید، بلافاصله یک نوبت (turn) تازه با بودجهٔ جدید آغاز می‌کند. استفاده از ابزار همچنان در سهمیهٔ طرح (plan) شما محاسبه می‌شود. نحوه محاسبه محدودیت‌های استفاده از Claude این موضوع سهمیه را به‌طور کامل پوشش می‌دهد.

چگونه Claude را وادار کنم کاری را که نیمه‌کاره رها کرده، تمام کند؟

یک پیام دیگر ارسال کنید. نوشتن "Continue" کارساز است، اما دستورالعملی که مشخص کند چه چیزی باقی مانده، بهتر عمل می‌کند؛ زیرا مانع از آن می‌شود که مدل دوباره به بازسازی متنی بپردازد که از قبل در اختیار دارد. اگر برای بار دوم در همان نقطه متوقف شد، کار را به بخش‌های کوچک‌تر تقسیم کنید و در هر پیام، یک بخش را ارائه دهید. ارائه مسیرهای دقیق فایل (file paths) یا چسباندن مستقیم محتوا، نیاز به جستجویی که بودجه را در وهلهٔ اول مصرف کرده بود، از بین می‌برد.

عبارت "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 سقف فراخوانی‌های ابزار مجاز در یک پاسخ واحد را پر کرده است و سهمیهٔ طرح شما در این مورد دخیل نیست. راهکار نیز همان است؛ با درخواست ادامه دادن پاسخ دهید یا درخواست را به مراحل کوچک‌تر تقسیم کنید. محدودیت صورت‌حساب (billing limit) یک پیام جداگانه است که زمان بازنشانی را اعلام می‌کند.

آیا ارتقای طرح من، محدودیت استفاده از ابزار در هر نوبت را افزایش می‌دهد؟

سطح طرح و بودجهٔ ابزار در هر نوبت، دو کنترل متفاوت هستند. ارتقا باعث افزایش میزان استفادهٔ شما در یک بازهٔ زمانی می‌شود که همان محدودیتی است که زمان بازنشانی دارد. تعداد فراخوانی‌های ابزاری که یک پاسخ واحد می‌تواند انجام دهد، ویژگی حلقه‌ای است که مدل را اجرا می‌کند و Anthropic این عدد را برای اپلیکیشن چت منتشر نمی‌کند. تقسیم کار به نوبت‌های کوچک‌تر، در هر طرحی، تنها راهی است که واقعاً کمک می‌کند.

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

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

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