SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

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

“tool ব্যবহারের সীমা” বার্তার অর্থ plan quota শেষ হওয়া নয়। Claude-এর এক turn-এর tool call cap শেষ হয়েছে। carry on পাঠিয়ে কাজটি শেষ করুন।

এই turn-এর tool use limit-এর অর্থ

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

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

আপনার প্ল্যানের ব্যবহারসীমা একটি পৃথক নিয়ন্ত্রণ

প্ল্যানের সীমা একটি নির্দিষ্ট সময়সীমায় আপনার মোট ব্যবহার গণনা করে। 9 November 2026 তারিখে দেখা Anthropic-এর error message সম্পর্কিত help centre পৃষ্ঠায় বলা আছে, সীমার কাছাকাছি থাকলে এটি Approaching session limit এবং সীমা অতিক্রম করলে 5-hour limit reached - resets [time] দেখায়। সাপ্তাহিক সীমার বার্তাগুলোতেও reset-এর দিন ও সময় উল্লেখ থাকে। উভয় ক্ষেত্রেই একটি নির্দিষ্ট সময় জানানো হয়। usage credits না থাকলে সেই সময় পর্যন্ত অপেক্ষা করলেই সমস্যাটি ঠিক হয়; এর মধ্যে আপনি যা টাইপ করবেন, তাতে কোনো পরিবর্তন হবে না। Paid plan-এ usage credits চালু থাকলে পৃষ্ঠাটি জানায় যে কাজটি credits ব্যবহার করে চলতে থাকবে, এবং বার্তাটি হবে 5-hour limit resets [time] - continuing with usage credits। মাসিক খরচের সীমায় পৌঁছালে, অথবা auto-reload বন্ধ থাকা অবস্থায় credit balance শেষ হলে এই ধারাবাহিকতা বন্ধ হবে। Verified Ultra account-এ পাঁচ ঘণ্টার session limit নেই, তবে সাপ্তাহিক সীমা এখনও প্রযোজ্য।

Tool use-এর বার্তা এর বিপরীতভাবে কাজ করে। এটি কোনো task চলার মাঝখানে আসে, এবং একটি follow-up message পাঠালেই কাজ সঙ্গে সঙ্গে চলতে থাকে। ইতিমধ্যে করা tool call-গুলো আপনার plan usage-এর হিসাবে গণনা হয়। কাজ চালিয়ে গেলে আপনার quota reset হয় না, এবং plan limit-এ পৌঁছানোর পরেও usage credits কাজ চালিয়ে যেতে পারে। Quota-সংক্রান্ত ক্ষেত্রে, Claude সীমায় পৌঁছেছে বললে কী করবেন বিভিন্ন বিকল্পের তালিকা দেয়, আর Claude-এর ব্যবহারসীমা কীভাবে গণনা করা হয় এই সীমাগুলোর পেছনের 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-তে এই limit কোথায় দেখা যায়

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

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

Server tools, যেমন web search, চালানোর সময় server-side sampling loop তার iteration limit-এ পৌঁছালে pause_turn return করা হয়। 25 October 2026 তারিখে stop reasons and fallback page-এ এই default প্রতি request-এ 10 iteration হিসেবে দেওয়া আছে। Documentation-এ বলা হয়েছে, response-টি assistant message হিসেবে অপরিবর্তিত অবস্থায় আবার পাঠাতে হবে। এতে Claude যেখানে থেমেছিল, সেখান থেকে কাজ চালিয়ে যাবে। চালিয়ে যেতে বলার জন্য নতুন user message যোগ করবেন না। Documentation-এর example-এ শুধু মূল user message এবং তার পরের paused assistant content পাঠানো হয়েছে।

max_tokens অর্থ হলো request-এ নির্ধারিত output token ceiling-এ response পৌঁছে গেছে। Incomplete tool use block-এর মাঝখানে truncation হলে tool call execute করা যায় না। Documentation-এ এর সমাধান হিসেবে বেশি মানের max_tokens দিয়ে retry করতে বলা হয়েছে।

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

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

  • যে প্রশ্নের স্বাভাবিক কোনো সমাপ্তি নেই। "Find everything written about X" বললে search শেষ হয়েছে কীভাবে বোঝা যাবে, তার কোনো নির্দেশ model পায় না।
  • একই material বারবার পড়া, কারণ model যে জায়গায় answer আশা করেছিল সেখানে তা নেই।
  • বড় tool result। একটি দীর্ঘ web page বা বড় file turn-এর বাকি অংশের জন্য প্রয়োজনীয় জায়গা দখল করে।
  • একটি message-এ কয়েকটি স্বাধীন কাজ দেওয়া। প্রতিটি কাজের জন্য আলাদা tool call দরকার, এবং সবগুলো একই budget থেকে খরচ হয়।
  • এই task-এ ব্যবহার করছেন না এমন connector এবং MCP (model context protocol) server। Load হওয়ার পর প্রতিটি conversation-এ জায়গা নেয় এবং turn-এ model-এর ব্যয় করার পথ বাড়ায়।

কীভাবে answer সম্পূর্ণ করবেন

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

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

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

এই মুহূর্তে প্রয়োজন নেই এমন connector বন্ধ করুন। Anthropic-এর help centre অনুযায়ী, প্রতিটি connector conversation-এ জায়গা নেয়। Default Auto setting-এ Claude কোন connector load করবে তা নির্ধারণ করে। Always available setting শুরুতেই সব connector load করে। প্রতিটি loaded connector context ব্যবহার করে এবং model যে কাজগুলো বেছে নিতে পারে তার পরিসর বাড়ায়। অনেক connector সক্রিয় রাখলে On demand setting ব্যবহার করুন। এতে Claude সঠিক connector খোঁজার পরেই সেটি load করে। একই যুক্তি দীর্ঘ coding session-এর ক্ষেত্রেও প্রযোজ্য, যেখানে Claude Code session-এর context ছোট রাখা এমন agent-এর সঙ্গে পার্থক্য তৈরি করে যে কাজ শেষ করে এবং এমন agent-এর সঙ্গে যে মাঝপথে থেমে যায়।

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

আপনি যদি নিজের code থেকে Claude চালান, তাহলে loop-এর turn budget আপনার নিয়ন্ত্রণে থাকা একটি setting। Claude Agent SDK (software development kit) Python-এ max_turns এবং TypeScript-এ maxTurns প্রকাশ করে। এগুলো tool call-সহ turn এবং শেষে দেওয়া text-only response গণনা করে। নথিভুক্ত default হলো কোনো limit না থাকা।

এই cap-এ পৌঁছালে SDK এমন একটি result ফেরত দেয় যার subtype হলো error_max_turns। একটি একক query() call তখন Reached maximum number of turns text-সহ error তৈরি করে। Agent SDK agent-loop page-এ ওই single shot error-এর জন্য underlying Claude Code process থেকে nonzero exit-এর কথাও উল্লেখ আছে। 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 অনুযায়ী default হিসেবে কোনো limit নেই। --input-format stream-json ব্যবহার করলে limit শেষ হওয়ার সময় queue-তে থাকা message queued অবস্থায় থাকে এবং নিজের limit-সহ নতুন turn-এ শুরু হয়। একই ধারণার cost-ভিত্তিক সংস্করণও আছে। Python-এ max_budget_usd এবং TypeScript-এ maxBudgetUsd turn count-এর বদলে নির্ধারিত spend threshold-এ পৌঁছালে loop বন্ধ করে। Subagent-এর spend-ও এই মোটের মধ্যে গণনা হয়। Model response আসার পরে budget যাচাই করা হয়। তাই যে response-এর মাধ্যমে cap-এ পৌঁছানো হয়, এবং বন্ধ হওয়ার আগে শেষ হওয়া background subagent-গুলোর কারণে spend cap ছাড়িয়ে যেতে পারে। মাসিক billing-এ চালানো server-এ agent ব্যবহার করলে, প্রথম দীর্ঘ run-এর আগে VPS-এ AI agent-এর খরচ নিয়ন্ত্রণ করা সেট up করা উচিত।

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

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

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

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

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

FAQ

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

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

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

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

"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" হিসেবে দেখা যায়। সব ভাষাতেই অর্থ একই: Claude একটি response-এর মধ্যে অনুমোদিত tool call-এর সংখ্যা শেষ করে ফেলেছে, এবং আপনার plan quota এতে জড়িত নয়। সমাধানও একই। Claude-কে continue করতে বলুন, অথবা request-টি ছোট ছোট ধাপে ভাগ করুন। Billing limit আলাদা একটি বার্তা। সেটিতে reset time উল্লেখ থাকে।

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

Plan level এবং প্রতি turn-এর tool budget আলাদা নিয়ন্ত্রণ। Upgrade করলে একটি সময়সীমায় আপনি কতটা ব্যবহার করতে পারবেন তা বাড়ে। এটিই সেই সীমা, যেখানে reset time উল্লেখ থাকে। একটি response কতটি tool call করতে পারবে, তা model চালানো loop-এর বৈশিষ্ট্য। Chat app-এর জন্য Anthropic এই সংখ্যা প্রকাশ করে না। তাই যেকোনো plan-এ task-টি ছোট ছোট 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 ফেরত দেয়। একটি single shot query() call তখন Reached maximum number of turns text-সহ error তৈরি করে। উভয় ক্ষেত্রেই default হিসেবে কোনো limit নেই। কিছু cap করা না থাকলেও run থেমে গেলে result-এর stop_reason পড়ুন। max_tokens অর্থ output ceiling-এ পৌঁছে গেছে। pause_turn অর্থ server tool loop তার iteration limit-এ পৌঁছেছে এবং response পাঠিয়ে দিতে বলছে, যাতে এটি continue করতে পারে।

এই লেখাটি কি কাজে লেগেছে?