Claude tool limit: এই turn-এ কেন থেমেছে?

এই পর্বের tool ব্যবহারের সীমার অর্থ

এই পর্বের tool ব্যবহারের সীমা বলতে বোঝায়, একটি response-এর সময় tool call-এর সংখ্যা শেষ হয়ে যাওয়ায় Claude মাঝপথে থেমেছে; আপনার account-এর usage limit শেষ হয়ে যাওয়ায় নয়। থামার আগে Claude যা পেয়েছে, তা conversation-এ এখনও আছে। Claude-কে carry on করতে বলে আরও একটি message পাঠান। এতে নতুন turn এবং নতুন budget চালু হবে।

একটি turn হলো agent loop-এর ভেতরের এক round trip। Claude tool call-সহ output তৈরি করে, client সেই tool চালায়, এবং ফলাফল পরবর্তী সিদ্ধান্তের জন্য Claude-এর কাছে পাঠানো হয়। আপনার কাছে নিয়ন্ত্রণ ফিরে না আসা পর্যন্ত এই cycle পুনরাবৃত্ত হয়। Claude কোনো tool call ছাড়া response তৈরি করলে turn শেষ হয়। একটি turn-এর cap নির্ধারণ করে, একটি answer সর্বোচ্চ কতগুলো এমন round trip করতে পারবে।

আপনার plan usage limit একটি আলাদা নিয়ন্ত্রণ

Plan limit একটি নির্দিষ্ট time window-এ আপনি মোট কতটা ব্যবহার করেছেন, তা গণনা করে। 18 August 2026 তারিখে দেখা Anthropic-এর error message-সংক্রান্ত help centre page-এ বলা হয়েছে, limit-এর কাছাকাছি থাকলে এটি Approaching 5-hour limit. এবং limit অতিক্রম করলে 5-hour limit reached - resets [time]. হিসেবে দেখা যায়। সেখানে একটি time উল্লেখ থাকে। সেই time পর্যন্ত অপেক্ষা করলে সমস্যা সমাধান হয়। এর মধ্যে আপনি যা-ই type করুন, তাতে কোনো কাজ হয় না।

Tool use message-এর আচরণ বিপরীত। এটি কোনো task চলার মাঝখানে আসে, এবং একটি follow-up message পাঠালেই কাজ সঙ্গে সঙ্গে চলতে পারে। আপনার remaining quota অপরিবর্তিত থাকে। পরীক্ষা করার পদ্ধতি হলো: অপেক্ষা করেও যদি কোনো পরিবর্তন না হয়, কিন্তু কাজ চালিয়ে গেলে কাজ হয়, তাহলে আপনি কখনোই quota-তে পৌঁছাননি। Quota সংক্রান্ত ক্ষেত্রে Claude limit reached বললে কী করবেন-এ বিভিন্ন option দেওয়া আছে, আর Claude usage limit কীভাবে গণনা করা হয়-এ এই limit-এর পেছনের time window ব্যাখ্যা করা হয়েছে।

একটি turn-এর tool budget থাকার কারণ

প্রতিটি tool call-এর জন্য context ব্যবহার হয়। Call পাঠানো হয়, tool চলে, এবং সম্পূর্ণ ফলাফল conversation-এ ফিরে আসে। একটি বড় file পড়া বা দীর্ঘ output-সহ একটি command চালানোতেই এক ধাপে হাজার হাজার token ব্যবহার হতে পারে। এই text session-এর বাকি সময়জুড়ে context-এ থেকে যায়। Anthropic-এর agent loop documentation বিষয়টি স্পষ্টভাবে জানায়: turn বাড়ার সঙ্গে context জমতে থাকে। তাই অনেক tool call-সহ একটি session ছোট session-এর তুলনায় অনেক বেশি context ব্যবহার করে।

Turn-এ budget নির্ধারণ করলে এমন loop থামানো যায়, যেটি আর অগ্রগতি করছে না। কোনো agent search করে, পড়ে, আবার search করে এবং তবুও কিছু না পেলে, সেটি কোনো বাধা না আসা পর্যন্ত একই কাজ চালিয়ে যাবে। Budget সেই বাধা হিসেবে কাজ করে। এটি এমন একটি পর্যায়ে আপনার কাছে নিয়ন্ত্রণ ফিরিয়ে দেয়, যখন আপনি কাজের দিক পরিবর্তন করতে পারেন। context window শেষ হওয়া পর্যন্ত loop চলতে দেওয়ার তুলনায় এতে অনেক কম খরচ হয়।

API-এ এই সীমা কোথায় দেখা যায়

Anthropic-এর সর্বজনীন error documentation-এ Claude chat app-এর প্রতি turn-এ tool call-এর কোনো সংখ্যা দেওয়া নেই। তাই এর জন্য আপনি যে নির্দিষ্ট সংখ্যাই পড়ুন, সেটি কারও অনুমান। API (application programming interface)-এর জন্য একই ধরনের সীমা নথিভুক্ত আছে। প্রকৃত আচরণ API documentation-এই দেখা যায়।

Messages API response-এর stop_reason field generation কেন থেমেছে তা জানায়। নথিভুক্ত মানগুলো হলো end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal এবং model_context_window_exceeded। এর মধ্যে দুটি এই নির্দেশিকায় বর্ণিত পরিস্থিতি বোঝায়।

Server-side sampling loop web search-এর মতো server tool চালানোর সময় iteration limit-এ পৌঁছালে pause_turn ফেরত দেওয়া হয়। 18 August 2026 অনুযায়ী, handling stop reasons page-এ প্রতি request-এর জন্য default 10 iterations বলা আছে। নথিভুক্ত সমাধান হলো response-টি assistant message হিসেবে অপরিবর্তিত অবস্থায় ফেরত পাঠানো। এতে Claude যেখানে থেমেছিল, সেখান থেকে চালিয়ে যায়। Chat window-তে "continue" লেখার API সংস্করণ এটিই।

Request-এ নির্ধারিত output token ceiling-এ response পৌঁছালে max_tokens বোঝায়। কোনো অসম্পূর্ণ tool use block-এর মধ্যে response truncate হলে tool call চালানো যায় না। নথিভুক্ত সমাধান হলো বেশি max_tokens দিয়ে retry করা।

এখানে লেখা মানের ওপর নির্ভর না করে handling stop reasons page-এ বর্তমান মান দেখুন। ওই page-এর default পরিবর্তিত হতে পারে। পুরোনো সংখ্যা না থাকার চেয়েও বেশি বিভ্রান্তিকর।

কোন কারণে chat-এর tool call শেষ হয়ে যায়

• যে প্রশ্নের স্বাভাবিক সমাপ্তি নেই। “X সম্পর্কে লেখা সবকিছু খুঁজে বের করুন” বললে অনুসন্ধান শেষ হয়েছে কি না বোঝার মতো কোনো নির্দেশনা model পায় না।
• একই তথ্য বারবার পড়া। কারণ model যে জায়গায় উত্তরটি থাকবে বলে আশা করেছিল, সেখানে তা থাকে না।
• বড় tool result। একটি দীর্ঘ web page বা বড় file turn-এর বাকি অংশের প্রয়োজনীয় context space দখল করে ফেলে।
• একই message-এ একাধিক স্বতন্ত্র কাজ থাকা। প্রতিটি কাজের জন্য আলাদা tool call দরকার হয়, কিন্তু সবগুলো একই budget থেকে আসে।
• এই কাজের জন্য ব্যবহার না করা connector এবং MCP (model context protocol) server। এগুলোর tool definition request-এ load হয় এবং model-এর turn ব্যয় করার আরও সুযোগ তৈরি করে।

উত্তর সম্পূর্ণ করার উপায়

"continue" লিখে উত্তর দিন। আরও ভালো হয়, কী বাকি আছে তা উল্লেখ করে একটি সংক্ষিপ্ত নির্দেশনা লিখলে। এতে নতুন turn শুরু হয় এবং নতুন budget পাওয়া যায়। আগের conversation context-এ থাকে। তাই Claude আগের tool call পুনরাবৃত্তি না করে কাজ চালিয়ে যেতে পারে।

একই জায়গায় দুবার থেমে গেলে বুঝতে হবে, একটি turn-এর জন্য কাজটি অতিরিক্ত বড়। তখন কাজটি ভাগ করুন। পুরো repository audit করতে বলার পরিবর্তে প্রথমে file list চাইুন। এরপর প্রতি message-এ একটি করে file সম্পর্কে জিজ্ঞাসা করুন। চারটি ছোট turn-এ এমন কাজ শেষ করা যায়, যা একটি বড় turn-এ শেষ হয় না।

Model-কে যে বিষয় খুঁজতে হবে, সেটি নির্দিষ্ট করুন। সঠিক file path বা সঠিক error string দিন। Log আগে থেকেই থাকলে সেটি paste করুন। একটি pasted log-এর জন্য একটি message লাগে। Model-কে সেই log খুঁজতে দিলে কয়েকটি tool call লাগতে পারে। তাছাড়া এটি ভুল log-ও খুঁজে পেতে পারে।

এই মুহূর্তে প্রয়োজন নেই এমন connector বন্ধ করুন। প্রতিটি সংযুক্ত tool-এর definition প্রতিটি request-এর সঙ্গে যুক্ত হয়। এতে context ব্যবহৃত হয় এবং model যে কাজের ধাপ বেছে নিতে পারে, তার পরিসর বড় হয়। একই যুক্তি দীর্ঘ coding session-এর ক্ষেত্রেও প্রযোজ্য। Claude Code session-এর context ছোট রাখা এমন agent-এর মধ্যে পার্থক্য তৈরি করে, যে কাজ শেষ করে, এবং এমন agent-এর মধ্যে, যে মাঝপথে থেমে যায়।

এজেন্ট চালানোর সময় turn budget নিজেই নির্ধারণ করুন

আপনি যদি নিজের code থেকে Claude চালান, প্রতি turn-এর budget আপনার নিয়ন্ত্রণে থাকে। Claude Agent SDK (software development kit) Python-এ max_turns এবং TypeScript-এ maxTurns প্রকাশ করে। ডকুমেন্টেশনে এগুলোকে tool use round trip-এর সর্বোচ্চ সংখ্যা হিসেবে বর্ণনা করা হয়েছে। ডিফল্ট হিসেবে কোনো সীমা নেই।

সেই সীমায় পৌঁছালে SDK এমন একটি result ফেরত দেয় যার subtype হলো error_max_turns। আর single shot query() call করলে Reached maximum number of turns text-সহ error তৈরি হয়। Result-এ num_turns এবং session_id-ও থাকে। তাই task আবার শুরু না করে higher limit দিয়ে একই session resume করতে পারেন।

CLI (command line interface) থেকে একই নিয়ন্ত্রণ একটি flag হিসেবে দেওয়া হয়। এটি শুধু print mode-এ প্রযোজ্য:

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

Flag reference অনুযায়ী limit-এ পৌঁছালে এটি error-সহ exit করে। ডিফল্ট হিসেবে কোনো limit নেই। একই ধারণার cost-based version-ও আছে: Python-এ max_budget_usd এবং TypeScript-এ maxBudgetUsd turn count-এর বদলে নির্ধারিত spend threshold-এ loop থামায়। Subagent-এর spend-ও সেই মোটের মধ্যে গণনা হয়। আপনি যদি মাসিক খরচের ভিত্তিতে server-এ agent চালান, প্রথম দীর্ঘ run-এর আগে VPS-এ AI agent-এর খরচ নিয়ন্ত্রণ করা সেট up করা উপযোগী।

Approval-এর জন্য অপেক্ষা করে pause হওয়া ভিন্ন বিষয়। Agent থেমে গেলে এবং কোনো খরচ না হলে turn count-এর বদলে permission_mode দেখুন। কারণ tool এমন একটি human answer-এর জন্য অপেক্ষা করছে, যা আসছে না। Claude Code-এর auto mode এবং permission settings কোন mode-এ অনুমতি চাওয়া হয় এবং কোন mode-এ অনুমতি না চেয়ে চালানো হয়, তা ব্যাখ্যা করে।

নিজে বর্তমান আচরণ কীভাবে পরীক্ষা করবেন

এখানকার আচরণ কোনো ঘোষণা ছাড়াই পরিবর্তিত হয়। তাই এই নির্দেশিকার প্রতিটি সংখ্যাকে স্থায়ী সীমা না ধরে নির্দিষ্ট সময়ের তথ্য হিসেবে দেখুন। বর্তমানে কী সত্য, তা দুটি জায়গায় দেখা যায়।

• stop reason সম্পর্কিত API documentation, যেখানে server tool iteration-এর default এবং সেটি অতিক্রম করে কীভাবে কাজ চালিয়ে যেতে হয় তা উল্লেখ থাকে।
• error message সম্পর্কিত Anthropic-এর help centre page, যেখানে usage limit-এর ভাষা দেওয়া আছে। 18 August 2026-এ পরীক্ষা করে দেখা গেছে, ওই page-এ five hour এবং weekly usage message নথিভুক্ত আছে; per turn tool cap সম্পর্কে কিছু বলা নেই। এই কারণেই chat app-এর জন্য এখানে কোনো official figure উল্লেখ করা হয়নি।

তার পরিবর্তে নিজের run-এর পরিমাপ নিন। Claude Code-এ /context রঙিন grid দিয়ে বর্তমান context usage দেখায় এবং কোন tool সবচেয়ে বেশি context ব্যবহার করছে তা নির্দেশ করে। /compact এখন পর্যন্ত conversation-এর সারাংশ তৈরি করে, যাতে খালি জায়গা পাওয়া যায়। Agent SDK-তে প্রতিটি result-এর সঙ্গে num_turns থাকে। তাই cap নির্ধারণের আগে একটি সাধারণ task-এর বাস্তবে কতগুলি round trip প্রয়োজন, তা দেখতে পারবেন। নিজের workload থেকে পাওয়া একটি সংখ্যা forum post-এর সংখ্যার চেয়ে বেশি নির্ভরযোগ্য।

FAQ

টুল ব্যবহারের সীমা কি আমার Claude ব্যবহারের সীমার মতোই?

না। ব্যবহারসীমা একটি নির্দিষ্ট সময়সীমায় আপনি কতটা ব্যবহার করেছেন তা গণনা করে এবং কখন তা reset হবে জানায়। তাই অপেক্ষা করাই সমাধান। টুল ব্যবহারের বার্তাটি একটি response মাঝপথে থামিয়ে দেয়, কারণ ওই response তার অনুমোদিত tool call শেষ করে ফেলেছে। আরেকটি message পাঠালে নতুন turn শুরু হয় এবং সঙ্গে সঙ্গে নতুন budget পাওয়া যায়। সঙ্গে সঙ্গে কাজ চালিয়ে যেতে পারলে আপনার quota কখনোই সমস্যা ছিল না। Claude ব্যবহারের সীমা কীভাবে গণনা করা হয়-এ quota-সংক্রান্ত বিষয়টি সম্পূর্ণ ব্যাখ্যা করা হয়েছে।

মাঝপথে থেমে যাওয়া কোনো কাজ Claude-কে কীভাবে শেষ করাব?

আরেকটি message পাঠান। “Continue” কাজ করে। তবে কী বাকি আছে তা উল্লেখ করে instruction দিলে আরও ভালো ফল পাওয়া যায়, কারণ এতে model-এর আগে থাকা context নতুন করে তৈরি করার প্রয়োজন হয় না। দ্বিতীয়বারও একই জায়গায় থেমে গেলে কাজটি ছোট ছোট অংশে ভাগ করুন এবং প্রতি message-এ একটি করে অংশ দিন। সঠিক file path দেওয়া বা content সরাসরি paste করে দেওয়া প্রথমবার budget শেষ করে দেওয়া searching কমিয়ে দেয়।

“límite de uso de herramientas” বা “limite de uso de ferramentas” বলতে কী বোঝায়?

এগুলো একই বার্তার Spanish এবং Portuguese রূপ। সাধারণত এগুলো “límite de uso de herramientas en este turno” বা “limite de uso de ferramentas neste turno” হিসেবে দেখা যায়। প্রতিটি ভাষায় এর অর্থ একই: একটি response-এর মধ্যে অনুমোদিত tool call Claude শেষ করে ফেলেছে, এবং আপনার plan quota এর সঙ্গে এর কোনো সম্পর্ক নেই। সমাধানও একই। Claude-কে continue করতে বলে reply দিন, অথবা request-টি ছোট ছোট ধাপে ভাগ করুন। Billing limit আলাদা একটি message, এবং সেটিতে reset time উল্লেখ থাকে।

আমার plan upgrade করলে কি একটি turn-এর tool use limit বাড়বে?

Plan level এবং প্রতি turn-এর tool budget আলাদা নিয়ন্ত্রণ। Upgrade করলে একটি সময়সীমায় আপনি কতটা ব্যবহার করতে পারবেন তা বাড়ে। এটিই সেই limit, যেখানে reset time উল্লেখ থাকে। একটি response কতগুলো tool call করতে পারবে, তা model চালানো loop-এর একটি বৈশিষ্ট্য। Chat app-এর জন্য Anthropic এই সংখ্যা প্রকাশ করে না। যেকোনো plan-এ কাজকে ছোট ছোট turn-এ ভাগ করাই কার্যকর সমাধান।

আমার নিজের agent মাত্র কয়েকটি tool call-এর পর থেমে যায় কেন?

আপনি কোনো cap সেট করেছেন কি না পরীক্ষা করুন। Claude Agent SDK Python-এ max_turns এবং TypeScript-এ maxTurns গ্রহণ করে। Command line interface print mode-এ --max-turns গ্রহণ করে। এগুলোর কোনো একটি সীমায় পৌঁছালে SDK subtype-এর মান error_max_turns-সহ একটি result ফেরত দেয় এবং এমন একটি error দেয় যাতে Reached maximum number of turns লেখা থাকে। উভয় ক্ষেত্রেই default হলো কোনো limit না থাকা। কোনো cap সেট করা না থাকলেও run থেমে গেলে result-এর stop_reason পড়ুন: max_tokens বোঝায় output ceiling-এ পৌঁছে গেছে, আর pause_turn বোঝায় server tool loop তার iteration limit-এ পৌঁছেছে এবং response পাঠিয়ে দিতে বলছে, যাতে এটি continue করতে পারে।