Claude usage limit অতিক্রম করলে কী করবেন?

Claude-এর ব্যবহারসীমা কী?

Claude-এর ব্যবহারসীমা 2টি আলাদা ব্যবস্থায় পরিচালিত হয়। প্রথমে কোন ব্যবস্থাটি আপনাকে থামিয়েছে তা নির্ধারণ করতে হবে। Claude subscription (Pro, Max, Team বা seat-based Enterprise) মডেলগুলোর মধ্যে ভাগ করা একটি rolling usage allowance দেয়। কয়েকটি model family-র জন্য আলাদা ceiling থাকতে পারে। এই allowance Claude chat-এর সঙ্গেও ভাগ করা হয়। সীমা শেষ হলে You've hit your session limit · resets 3:45pm-এর মতো একটি message দেখানো হয়। Current usage-based Enterprise plan ব্যতিক্রম। এতে কোনো included allowance থাকে না এবং প্রথম token থেকেই সমস্ত usage API rate অনুযায়ী billed হয়। Claude API অন্য বিষয় পরিমাপ করে: প্রতি মিনিটে আপনি কত দ্রুত request ও token পাঠাচ্ছেন। সীমা অতিক্রম করলে এটি rate_limit_error type-এর HTTP 429 error দিয়ে request থামায়। সাধারণত retry-after header-এ কত seconds অপেক্ষা করতে হবে তা জানানো হয়।

এই সমস্যাগুলোর সমাধান এক নয়। Subscription limit নির্ভর করে একটি window-এর মধ্যে আপনি কতটা usage করেছেন তার ওপর। তাই reset হওয়া পর্যন্ত অপেক্ষা করুন, অতিরিক্ত usage কিনুন, অথবা আপনার plan-এ free limit reset দেওয়া থাকলে সেটি ব্যবহার করুন। API rate limit নির্ভর করে এই মুহূর্তে আপনার request পাঠানোর গতির ওপর। গতি কমালে কয়েক seconds-এর মধ্যেই এটি সরে যায়।

Plan allowance এবং rate-limit tier number প্রায়ই পরিবর্তিত হয়। তাই ভুল number দেওয়ার চেয়ে কোনো number না দেওয়া ভালো। এখানে কোনো number দেওয়া হয়নি। নিচের command ব্যবহার করে আপনার নিজের তথ্য দেখুন।

আপনি কোন লিমিটটি অতিক্রম করেছেন? সঠিক বার্তাটি পড়ুন

Claude Code তার প্রিন্ট করা টেক্সটে সিস্টেমের নাম উল্লেখ করে। কোনো কিছু পরিবর্তন করার আগে আপনার সিস্টেমের সাথে মিলিয়ে নিন।

• You've hit your session limit · resets 3:45pm হলো একটি সাবস্ক্রিপশন লিমিট। এই উইন্ডোর জন্য আপনার প্ল্যানের নির্ধারিত ব্যবহারের সীমা শেষ হয়ে গেছে।
• You've hit your weekly limit · resets Mon 12:00am হলো দীর্ঘতর উইন্ডোর ক্ষেত্রে একই সিস্টেমের লিমিট।
• You've hit your Opus limit · resets 3:45pm হলো একটি সাবস্ক্রিপশন লিমিট যা শুধুমাত্র Opus রিকোয়েস্টের ক্ষেত্রে প্রযোজ্য। Opus ফ্যামিলির বাইরের কোনো মডেলে সুইচ করলে আপনি কাজ চালিয়ে যেতে পারবেন।
• You've hit your Sonnet limit · resets 3:45pm হলো একই ধরনের মডেল-ফ্যামিলি লিমিট, যা শুধুমাত্র Sonnet রিকোয়েস্টের জন্য প্রযোজ্য। Sonnet ফ্যামিলির বাইরের কোনো মডেলে সুইচ করলে আপনি কাজ চালিয়ে যেতে পারবেন।
• যে বার্তাটি Fable limit reached দিয়ে শুরু হয়, তার অর্থ হলো আপনি আপনার সাপ্তাহিক অ্যালাউন্সের যে অংশ Fable মডেলের জন্য বরাদ্দ ছিল, তা ব্যবহার করে ফেলেছেন। Fable মডেলে কাজ চালিয়ে যেতে চাইলে তা আপনার ইউসেজ ক্রেডিট থেকে কাটা হবে, তাই Claude Code আপনাকে আগে নিশ্চিত করতে বলবে। আপনার প্ল্যানের ভেতরে থাকতে /model ব্যবহার করে অন্য কোনো মডেল বেছে নিন।
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. হলো একটি API রেট লিমিট। আপনি আপনার API key, অথবা Amazon Bedrock বা Google Cloud প্রজেক্টের জন্য নির্ধারিত লিমিট অতিক্রম করেছেন। এর মধ্যে কোনটি প্রযোজ্য তা নির্ভর করে ক্লায়েন্ট কীভাবে অথেন্টিকেট করে তার ওপর, কারণ একটি Bedrock বা Vertex ক্লায়েন্ট Anthropic অর্গানাইজেশনের পরিবর্তে আপনার ক্লাউড প্রজেক্টের কোটার বিপরীতে পরিমাপ করা হয়।
• API Error: Server is temporarily limiting requests (not your usage limit) হলো একটি স্বল্পস্থায়ী থ্রোটল যা আপনার প্ল্যান কোটার সাথে সম্পর্কিত নয়। Claude Code আপনাকে এই লাইনটি দেখানোর আগেই স্বয়ংক্রিয়ভাবে ব্যাকঅফ (backoff) ব্যবহার করে পুনরায় চেষ্টা করে।

Subscription limits: session, weekly, and the Opus window

একটি Pro, Max, Team বা seat-ভিত্তিক Enterprise plan-এ rolling usage allowance থাকে। এই allowance শেষ হয়ে গেলে বার্তায় দেখানো reset time পর্যন্ত Claude Code আর অনুরোধ গ্রহণ করে না। এই allowance-এর দুটি বৈশিষ্ট্য সবচেয়ে বেশি বিভ্রান্তি তৈরি করে।

• এটি Claude chat-এর সঙ্গে shared। claude.ai-তে করা কাজ terminal-এর কাজের মতো একই allowance থেকে usage কমায়। তাই chat-এ বিকেলজুড়ে বেশি কাজ করলে coding-এর জন্য সন্ধ্যার allowance কমে যায়। ওই account দিয়ে sign in করা প্রতিটি surface একই pool থেকে usage কমায়। তাই Linux-এ beta desktop app এবং Claude Code CLI মিলে একটি allowance ব্যবহার করে, আলাদা দুটি allowance নয়।
• এটি model-গুলোর মধ্যেও shared। Session এবং weekly limit সব model-এর জন্য একটি pool। এই pool-এর মধ্যে model family অনুযায়ী কিছু ceiling আছে: Opus ও Sonnet limit, এবং Max ও Premium seat-এ weekly limit-এর সর্বোচ্চ 50% পর্যন্ত Fable allocation। Pro ও Standard seat-এ Fable plan limit-এর অন্তর্ভুক্ত নয় এবং প্রথম request থেকেই usage credit থেকে bill হয়।

Claude for Teams এবং seat-ভিত্তিক Enterprise-এ নথিভুক্ত কাঠামো হলো প্রতি seat-এর একটি allowance। এটি rolling পাঁচ ঘণ্টার window এবং weekly window-এ reset হয়, Claude chat ও Cowork-এর সঙ্গে shared থাকে, এবং seat tier (Standard বা Premium) অনুযায়ী নির্ধারিত হয়। বর্তমান usage-based Enterprise plan ভিন্নভাবে কাজ করে। সেখানে শেষ হয়ে যাওয়ার মতো কোনো included allowance নেই। Usage API rate-এ bill হয়। Ceiling নির্ধারিত হয় organization level এবং individual user-এর জন্য admin-রা যে spend limit সেট করেন, তার ভিত্তিতে। Sales-assisted plan-এ spend limit-এর কারণে usage বন্ধ হলে owner আগে limit না বাড়ালে পরবর্তী billing period শুরু হলে usage আবার চালু হয়। Self-serve plan-এ prepaid credit balance শেষ হয়ে গেলেও usage বন্ধ হয়, যতক্ষণ না owner আরও credit কেনেন। Pro ও Max-এ বার্তায় দেখানো reset time এবং আপনার নিজের /usage bar-ই নির্ভরযোগ্য সংখ্যা। কোনো blog post থেকে কপি করা সংখ্যা নির্ভরযোগ্য নয়। আপনি যদি এখনও tier নির্বাচন করে থাকেন, আপনার কোন Claude plan প্রয়োজন প্রতিটি plan-এ কী কী সুবিধা সীমাবদ্ধ থাকে তা তুলনা করে।

কেন /model দিয়ে মডেল পরিবর্তন করলে সেশন বা সাপ্তাহিক লিমিট রিস্টোর হয় না

এটি সবচেয়ে সাধারণ ভুল পদক্ষেপ এবং ডকুমেন্টেশনে এ বিষয়ে সরাসরি বলা হয়েছে: সেশন এবং সাপ্তাহিক লিমিট সব মডেলের জন্য শেয়ার করা থাকে, তাই মডেল পরিবর্তন করলে অ্যাক্সেস ফিরে পাওয়া যায় না। আপনার সেশন উইন্ডো শেষ হয়ে যাওয়ার পর ছোট কোনো মডেল বেছে নিলে কেবল উত্তর দেওয়ার মডেলটি পরিবর্তিত হয়। এতে আপনার অবশিষ্ট ব্যবহারের সীমা পরিবর্তিত হয় না, কারণ সেশন এবং সাপ্তাহিক ব্যবহারের সীমা প্রতি মডেলের জন্য আলাদাভাবে রাখা হয় না; তাই মডেল পরিবর্তন করলে নতুন করে ব্যবহারের সুযোগ তৈরি হয় না।

ব্যতিক্রম হলো মডেল-ফ্যামিলি সিলিং বা সর্বোচ্চ সীমা। যদি মেসেজে You've hit your Opus limit অথবা You've hit your Sonnet limit লেখা থাকে, তবে /model হলো সঠিক সমাধান। সেই ফ্যামিলির বাইরের কোনো মডেলে সুইচ করুন এবং কাজ চালিয়ে যান, কারণ শুধুমাত্র সেই নির্দিষ্ট ফ্যামিলির অনুরোধগুলো ব্লক করা হয়েছিল। Max এবং Premium সিটের ক্ষেত্রে Fable লিমিট একইভাবে কাজ করে: আপনার প্ল্যানের মধ্যে কাজ চালিয়ে যেতে অন্য মডেলে সুইচ করুন, অথবা usage credits ব্যবহার করে Fable-এর মাধ্যমে কাজ চালিয়ে যান। তবে মনে রাখবেন, Fable অন্যান্য মডেলের তুলনায় শেয়ার করা সাপ্তাহিক পুল থেকে দ্রুত ক্রেডিট খরচ করে, তাই Fable লিমিট শেষ হওয়ার পর সুইচ করলে তা আপনার সামগ্রিক সাপ্তাহিক লিমিট অতিক্রম করতে সাহায্য করবে না।

লিমিটকে বাগ বা ত্রুটি মনে করা দ্বিতীয় ভুল পদক্ষেপ। পুনরায় ইনস্টল করা বা পুনরায় অথেন্টিকেট (re-authenticate) করলে কোনো লাভ হয় না। উইন্ডো রিসেট হলে, ফ্রি লিমিট রিসেট ব্যবহার করলে অথবা usage credits কিনলে ব্যবহারের সুযোগ পুনরায় ফিরে আসে।

সাবস্ক্রিপশন সীমায় পৌঁছালে কী করবেন

1. Reset-এর সময় দেখুন। একটি session window স্বল্প সময়ের হয়। একটি weekly window শেষ হওয়ার জন্য ডেস্কে বসে অপেক্ষা করার বিষয় নয়। Claude Code v2.1.234 বা পরবর্তী সংস্করণে, /rate-limit-options reset হওয়া পর্যন্ত অপেক্ষা করে বাধাপ্রাপ্ত কাজ স্বয়ংক্রিয়ভাবে চালিয়ে যেতে পারে।
2. সীমাটি যদি Opus, Sonnet বা Fable-এর হয়, /model চালিয়ে ওই family-এর বাইরে থাকা একটি model বেছে নিন।
3. আপনার plan-এর limit, bar এবং সেগুলো কখন reset হবে তা দেখতে /usage চালান। একই screen-এ যাওয়ার জন্য /cost alias হিসেবে কাজ করে।
4. claude.ai-তে অথবা Claude Desktop-এ Settings > Usage খুলে Resets section দেখুন। যোগ্য plan-এ মাঝে মাঝে বিনামূল্যে limit reset-এর প্রস্তাব দেওয়া হয়। "Reset for free" চাপলে প্রস্তাবটি যে five-hour session limit বা weekly limit-এর জন্য প্রযোজ্য, সেটি সঙ্গে সঙ্গে পূর্ণ সীমায় ফিরে যায়। Terminal বা IDE-তে Claude Code-এ এবং Claude Mobile-এ এই button থাকে না। প্রতিটি offer-এর মেয়াদও শেষ হয়।
5. সীমা পেরিয়েও কাজ চালিয়ে যেতে /usage-credits চালান। Pro এবং Max plan-এ এটি আপনার billing settings খোলে। Team এবং Enterprise plan-এ এটি আপনার organization-এর usage settings খোলে। আপনার billing access না থাকলে administrator-দের কাছে request পাঠায়।
6. প্রতি সপ্তাহে একই সীমায় পৌঁছালে, আপনার কাজের ধরন অনুযায়ী plan-এর আকার সঠিক নয়। প্রতিটি reset-এর সময় বিবেচনা করার বদলে usage limit অতিক্রম করার উপায়গুলো একবার ভালোভাবে মূল্যায়ন করা উচিত।

/usage-credits ব্যবহার করতে /login-এর মাধ্যমে sign in করা একটি claude.ai subscription প্রয়োজন। API key authentication-এর সঙ্গে এটি ব্যবহার করা যায় না, কারণ API key-এর সঙ্গে বাড়ানোর মতো কোনো plan allowance থাকে না।

Usage credit-এর একটি প্রভাব আগে জানা দরকার। ডিফল্টভাবে, subscription-এর অন্তর্ভুক্ত usage-এর মধ্যে থাকলে Claude Code আপনার main conversation-এর জন্য one-hour prompt cache দেয়। Credits ব্যবহার শুরু করলে এটি five minutes-এ নেমে যায়। ফলে বেশি turn শুরুতে cache ছাড়া চলে এবং একই কাজের জন্য Claude Code token usage বেড়ে যায়। Subagent-গুলো main conversation-এর bucket-এর বাইরে থাকে। তাই plan usage-এর মধ্যেও তারা five minutes পায়। promptCacheTtl setting ব্যবহার করে অথবা Claude Code v2.1.242 বা পরবর্তী সংস্করণে CLAUDE_CODE_PROMPT_CACHE_TTL দিয়ে নিজে TTL নির্ধারণ করলে credits ব্যবহার করার সময়ও one-hour lifetime বজায় থাকে।

যে বার্তাগুলো ব্যবহারের সীমা মনে হয় কিন্তু আসলে তা নয়

Claude Code-এর চারটি ত্রুটিকে ব্যবহারের সীমা (usage limits) হিসেবে ভুল করা হয়, কিন্তু সেগুলোর কোনোটিই তা নয়।

• কনটেক্সট বা অটো-কম্প্যাক্ট সতর্কবার্তা কোনো ব্যবহারের সীমা নয়। /context একটি লাইন প্রিন্ট করে, যেমন Context exceeds the 200k-token limit by 94k tokens, এবং এর পরে সেই কমান্ডটি দেখায় যা জায়গা খালি করে, যখন কথোপকথন মডেলের কনটেক্সট উইন্ডোর চেয়ে বড় হয়ে যায়। কম্প্যাক্টিং পুরনো ইতিহাসকে সংক্ষেপ করে জায়গা খালি করে, কিন্তু এটি বিনামূল্যে হয় না: /compact সেই কথোপকথনটি পড়ে যা সে সংক্ষেপ করছে, তাই বড় কনটেক্সট কম্প্যাক্ট করা নিজেই আপনার প্ল্যানের বিপরীতে একটি বড় অনুরোধ হিসেবে গণ্য হয়। আপনি যদি ধারাবাহিকতার পরিবর্তে নতুন করে শুরু করতে চান, তবে /clear-এর কোনো খরচ নেই।
• Prompt is too long · automatic compaction failed: <the underlying error> মানে হলো স্বয়ংক্রিয় কম্প্যাকশন নিজেই ব্যর্থ হয়েছে, যে ত্রুটির নাম সেখানে উল্লেখ আছে তার কারণে। /compact সেই একই ত্রুটির কারণে বারবার ব্যর্থ হতে থাকে যতক্ষণ না আপনি তা সমাধান করেন।
• Credit balance is too low মানে হলো আপনার Console অর্গানাইজেশনের প্রিপেইড ক্রেডিট শেষ হয়ে গেছে, অথবা Claude Code একজন সাবস্ক্রাইবারের অনুরোধগুলো একটি Console API key-এর মাধ্যমে পাঠাচ্ছে; /status দেখায় কোন ক্রেডেনশিয়ালটি বর্তমানে সক্রিয় আছে। platform.claude.com/settings/billing-এ গিয়ে ক্রেডিট যোগ করুন, সেখানে অটো-রিলোডের সুবিধাও রয়েছে।
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context হলো একটি এনটাইটেলমেন্ট চেক, কোনো কোটা শেষ হয়ে যাওয়া নয়। আপনি যদি Opus 4.6 বা Sonnet 4.6-এর কোনো [1m] ভেরিয়েন্ট নির্বাচন করে থাকেন, তবে [1m] সাফিক্স ছাড়া ভেরিয়েন্টটি বেছে নিন, অথবা CLAUDE_CODE_DISABLE_1M_CONTEXT=1 সেট করুন। যদি কথোপকথনের মাঝখানে এটি দেখা দেয় কারণ কনটেক্সট 200K টোকেন ছাড়িয়ে গেছে, তবে Claude Code নিজে থেকেই স্ট্যান্ডার্ড সীমার নিচে কম্প্যাক্ট করে নেয়। Sonnet 5 এবং পরবর্তী সংস্করণ, Opus 4.7 এবং পরবর্তী সংস্করণ, Haiku 5.5 এবং Fable মডেলগুলো 1M উইন্ডোর সাথে চলে এবং এগুলোর কোনো সাফিক্স সরানোর প্রয়োজন নেই; ওই ভেরিয়েবলটিই সেগুলোকে 200K-তে আটকে রাখে।

API থেকে আরও একটি ত্রুটি আসে। একটি 413 request_too_large হলো একটি একক অনুরোধের আকারের সীমা, কোনো রেট লিমিট নয়।

API rate limit: 429 আসলে কী গণনা করে

Messages API প্রতিটি model class-এর জন্য আলাদাভাবে 3টি বিষয় মাপে।

• প্রতি মিনিটে request (RPM)
• প্রতি মিনিটে input token (ITPM)
• প্রতি মিনিটে output token (OTPM)

আপনার organization-এর একটি spend limit-ও আছে। এটি আলাদা বিষয়: API ব্যবহারের জন্য প্রতি মাসের সর্বোচ্চ খরচ। আপনার tier-এর spend cap-এ পৌঁছে গেলে পরের মাস পর্যন্ত API ব্যবহার স্থগিত থাকে, যদি না আপনি বেশি limit-এর অনুরোধ করেন। তখনও 429 rate_limit_error আসে, কিন্তু কোনো retry-after header থাকে না এবং enforced_spend_limit_reached থাকে error.details.error_code-এ। কোনো retry loop এটি সমাধান করতে পারে না। Console-এ আপনি নিজে সেট করা কম spend limit আবার ভিন্নভাবে দেখা যায়: request-এ HTTP 400 invalid_request_error ফেরত আসে এবং message শুরু হয় You have reached your specified API usage limits দিয়ে। Limit বাড়ালে বা সরিয়ে দিলে access পুনরায় চালু হয়।

429 কখন আসে, তা 4টি প্রক্রিয়া নির্ধারণ করে।

• Limit প্রতি model class-এর জন্য আলাদা। প্রতিটি model-এর ক্ষেত্রে limit আলাদাভাবে প্রযোজ্য। তাই একই সময়ে প্রতিটি model-এর নিজস্ব limit পর্যন্ত ভিন্ন model ব্যবহার করা যায়। কিছু family একই bucket ভাগ করে: Opus rate limit হলো Claude Opus 4.8, Opus 4.7, Opus 4.6 এবং Opus 4.5-এর সম্মিলিত limit, আর Claude Sonnet 5-এর নিজস্ব limit আছে।
• Capacity ধারাবাহিকভাবে পুনরায় পূরণ হয়। API token bucket algorithm ব্যবহার করে। তাই capacity নির্দিষ্ট সময়ে reset না হয়ে ধারাবাহিকভাবে বাড়ে। প্রতি মিনিটে 60 request-এর limit কার্যকরভাবে প্রতি সেকেন্ডে 1টি request হিসেবে প্রয়োগ হতে পারে। তাই একসঙ্গে পাঠানো 60টি request ব্যর্থ হতে পারে।
• বেশিরভাগ model-এ শুধু cache না হওয়া input ITPM-এ গণনা হয়। input_tokens এবং cache_creation_input_tokens গণনা হয়। বেশিরভাগ Claude model-এ cache_read_input_tokens গণনা হয় না; Claude Haiku 3.5 নথিভুক্ত ব্যতিক্রম। তাই caching rate limit-এর অতিরিক্ত capacity দেওয়ার পাশাপাশি discount-ও দেয়। Output-এর ক্ষেত্রে, বড় max_tokens OTPM-এর বিরুদ্ধে গণনা হয় না, কারণ OTPM-এ শুধু বাস্তবে তৈরি হওয়া token গণনা করা হয়।
• Limit organization level-এ প্রযোজ্য। কোনো workspace-কে কম limit দেওয়া যেতে পারে। তবে organization-wide limit সবসময় কার্যকর থাকে, এমনকি workspace-গুলোর limit যোগ করলে মোট পরিমাণ বেশি হলেও। কোনো workspace-এ আপনি limit override না করলে সেটি unlimited থাকে না; organization থেকে limit উত্তরাধিকারসূত্রে পায়।

Start, Build, Scale এবং Custom নামে tier-গুলো প্রকৃত সংখ্যাগুলো নির্ধারণ করে। আপনার usage history এবং account standing অনুযায়ী এগুলো স্বয়ংক্রিয়ভাবে নির্ধারিত হয়। নতুন organization এবং যাদের usage history কম, তারা Evaluation tier-এ শুরু করতে পারে। এই tier standard প্রকাশিত limit-এর নিচে থাকতে পারে। তাই table-এর পূর্বাভাসের চেয়ে আগেই প্রথম 429 আসতে পারে। Usage দ্রুত বেড়ে গেলে acceleration limit সক্রিয় হয়। তখন আপনি নিজের tier-এর সীমার মধ্যে থাকলেও 429 ফেরত আসে। তাই traffic ধীরে ধীরে বাড়ান। প্রকাশিত প্রতিটি সংখ্যা একটি ceiling: নথিভুক্ত limit সর্বোচ্চ অনুমোদিত usage, নিশ্চিত minimum নয়। বেশি limit চাইতে Claude Console-এর Rate limits page-এ "Request tier increase" ব্যবহার করুন।

429 পড়া: retry-after, header এবং SDK retry

প্রতিটি API error একই envelope ফেরত দেয়: একটি nested error object, যাতে type ও message থাকে, এবং একটি top-level request_id।

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

বাকি তথ্য header-গুলোতে থাকে।

• retry-after হলো request আবার retry করার আগে অপেক্ষার সময়, সেকেন্ডে প্রকাশিত। এর আগে retry করলে তা ব্যর্থ হবে। প্রতিটি 429 response-এ এটি থাকে না, এবং spend-cap 429 response-এ এটি কখনও থাকে না।
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining এবং anthropic-ratelimit-requests-reset আপনার request budget বর্ণনা করে।
• anthropic-ratelimit-input-tokens-* এবং anthropic-ratelimit-output-tokens-* ITPM ও OTPM-এর জন্য একই তথ্য দেয়; এখানেও limit, remaining এবং reset suffix ব্যবহৃত হয়।
• বর্তমানে কার্যকর সবচেয়ে সীমাবদ্ধ limit-এর মান anthropic-ratelimit-tokens-* দেখায়।

Reset header-গুলো RFC 3339 timestamp। Remaining token header-গুলোর মান নিকটতম হাজারে round করা থাকে, তাই এগুলোকে আনুমানিক সূচক হিসেবে পড়ুন। Fast mode-এর নিজস্ব pool এবং নিজস্ব anthropic-fast-* header আছে। যেকোনো সফল call থেকে সবগুলো পড়ুন:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

প্রতিটি response-এ একটি unique request-id header-ও থাকে, যেমন req_018EeWyXxfu5pfWkrYcMdjWG। Error body-তে এটি request_id হিসেবে এবং Python ও TypeScript SDK response-এ _request_id হিসেবে দেখা যায়। Support-এ যোগাযোগ করার সময় এটি উল্লেখ করুন।

নিজে backoff loop লেখার আগে যাচাই করুন, সত্যিই তা প্রয়োজন কি না। Official SDK-গুলো connection error, rate limit এবং 5xx server error-সহ transient failure স্বয়ংক্রিয়ভাবে retry করে। এ ক্ষেত্রে exponential backoff ব্যবহৃত হয়, এবং default হিসেবে 2 বার retry করা হয়। retry-after header থাকলে SDK সেটিও মেনে চলে। প্রতিটি client-এ maximum-retries option থাকে, যার মাধ্যমে এই আচরণ পরিবর্তন বা বন্ধ করা যায়।

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 overloaded_error আপনার ত্রুটি নয়

429 status code বোঝায় যে আপনি খুব দ্রুত অনুরোধ পাঠিয়েছেন। 529 overloaded_error status code বোঝায় যে API সাময়িকভাবে অতিরিক্ত লোডে রয়েছে। সব ব্যবহারকারীর মিলিত network traffic বেড়ে গেলে এটি ঘটতে পারে। এর জন্য আপনার key বা code দায়ী নয়। Exponential backoff ব্যবহার করে আবার চেষ্টা করুন। 5xx response-এর ক্ষেত্রে SDK-গুলো ইতিমধ্যে এটি করে। সমস্যা না কাটলে status.claude.com দেখুন। 500 api_error একটি internal error। একইভাবে আবার চেষ্টা করুন। কোনোটিই rate limit নয়।

টেবিলের পরিবর্তে আপনার নিজস্ব লিমিটগুলো দেখুন

সাবস্ক্রিপশনের ক্ষেত্রে, /usage হলো গুরুত্বপূর্ণ স্ক্রিন। এটি আপনার প্ল্যান ব্যবহারের বার এবং কী কী কারণে তা খরচ হয়েছে তার একটি বিশ্লেষণ দেখায়, এবং d বা w ব্যবহার করে গত 24 ঘণ্টা এবং গত 7 দিনের তথ্যের মধ্যে পরিবর্তন করা যায়। দুটি বিষয় মনে রাখবেন। Session ব্লকটি API টোকেন ব্যবহার দেখায় এবং এটি API ব্যবহারকারীদের জন্য, তাই সাবস্ক্রাইবাররা এর ডলারের হিসাব উপেক্ষা করতে পারেন। এই সংখ্যাগুলো সেই মেশিনের লোকাল সেশন হিস্ট্রি থেকে আসে, তাই অন্য কোনো ডিভাইস বা claude.ai থেকে করা ব্যবহার এখানে দেখা যাবে না।

API-এর ক্ষেত্রে, Claude Console-এর Usage পেজটি দুটি চার্ট তৈরি করে: "Rate Limit - Input Tokens" এবং "Rate Limit - Output Tokens"। ইনপুট চার্টটি আপনার বর্তমান ITPM লিমিটের বিপরীতে প্রতি মিনিটে আনক্যাশড (uncached) ইনপুট টোকেনের সর্বোচ্চ ঘণ্টার হার প্লট করে এবং পাশে আপনার ক্যাশ রেট দেখায়, যাতে আপনি প্রোডাকশনে লিমিট অতিক্রম করার আগেই তা বুঝতে পারেন।

আপনার কনফিগার করা লিমিটগুলো প্রোগ্রাম্যাটিকভাবে পড়তে:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

এর জন্য Admin API ক্রেডেনশিয়াল প্রয়োজন: একটি Admin API key, org:admin স্কোপসহ একটি OAuth token, অথবা এমন একটি পার্সোনাল বা সার্ভিস অ্যাকাউন্ট কি (key) যা কোনো ওয়ার্কস্পেসের মধ্যে সীমাবদ্ধ নয়। ওয়ার্কস্পেস API কি এখানে কাজ করবে না। GET /v1/organizations/workspaces/{workspace_id}/rate_limits প্রতিটি ওয়ার্কস্পেসের জন্য একই কাজ করে। উভয়ই শুধুমাত্র পড়ার জন্য (read-only): লিমিট পরিবর্তন করতে কনসোলের Rate limits পেজ ব্যবহার করুন।

less ব্যবহার করে সীমাবদ্ধতা এড়ানো

উভয় সিস্টেমই মূলত একই জিনিসের পরিমাপ করে, তাই এই কৌশলগুলো দুটিতেই কার্যকর।

• প্রতি টার্নে কম টোকেন খরচ করুন। একটানা কাজ করলে ক্যাশ সচল থাকে এবং অসংলগ্ন কাজের মাঝে /clear ব্যবহারের কোনো খরচ নেই। Claude Code token usage-এ এই কৌশলগুলো বিস্তারিত আলোচনা করা হয়েছে।
• প্রচেষ্টা কমান। লেভেলগুলো হলো low, medium, high, xhigh এবং max। /effort মেনুতে ultracode-এর অপশনও আছে, যা খরচ কমানোর পরিবর্তে বাড়িয়ে দেয়। যান্ত্রিক কোনো রিনেমের (rename) জন্য গভীর চিন্তার (reasoning) প্রয়োজন নেই।
• 429 error-এর পর কনকারেন্সি কমান। CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY কমিয়ে আনুন এবং অনেকগুলো সমান্তরাল সাব-এজেন্ট চালানো থেকে বিরত থাকুন। /status-ও চালান: একটি ভুল ANTHROPIC_API_KEY আপনার সাবস্ক্রিপশনের পরিবর্তে লো-টায়ার কি (key) দিয়ে রিকোয়েস্ট পাঠাতে পারে।
• নন-ইন্টারেক্টিভ কাজ Message Batches API-তে সরিয়ে নিন। এটি ইনপুট এবং আউটপুট টোকেনে 50% ডিসকাউন্টে বড় ভলিউমের কাজ অ্যাসিঙ্ক্রোনাসভাবে সম্পন্ন করে। এর নিজস্ব রেট লিমিট থাকায় রাতের বেলার কাজগুলো আপনার সেশনের সাথে প্রতিযোগিতায় লিপ্ত হয় না।

যেসব কাজে প্রচুর ডেটা কনটেক্সটে ঢালতে হয়, সেখানে এই সীমাবদ্ধতা সবচেয়ে বেশি অনুভূত হয়: আপনি যদি লাইভ মার্কেট ডেটার বিপরীতে স্টক এবং অপশন বিশ্লেষণ করেন, তবে প্রতিটি প্রশ্নের জন্য প্রয়োজনীয় ছোট অংশটুকু নেওয়া পুরো টেবিল বা কোট পেস্ট করার তুলনায় অনেক সাশ্রয়ী। মানুষের পরিবর্তে প্রোগ্রাম দ্বারা চালিত কাজগুলো শুরু থেকেই একটি API key-তে রাখা উচিত। সেখানে স্থানান্তর করলে আপনার পেমেন্ট এবং মিটারিং পদ্ধতি পরিবর্তিত হয়, কারণ Claude API-তে কোনো ফ্রি টায়ার নেই। Max এবং Team প্ল্যানে নিজস্ব অ্যাপ এবং এজেন্ট চালানোর জন্য মাসিক API ক্রেডিট অন্তর্ভুক্ত থাকে, যদি আপনি একটি Console organization লিঙ্ক করেন। এই ক্রেডিটগুলো Claude Code-এর ক্ষেত্রে প্রযোজ্য নয় এবং এগুলো আপনার প্ল্যানের ব্যবহারের সীমাবদ্ধতা পরিবর্তন করে না। Your first Claude API app on a VPS-এ কি হ্যান্ডলিং এবং রিট্রাই সম্পর্কে আলোচনা করা হয়েছে, এবং আপনি যদি Claude Code running on a VPS inside tmux ব্যবহার করেন, তবে কানেকশন বিচ্ছিন্ন হলেও দীর্ঘ এজেন্ট রান সচল থাকে।

FAQ

মডেল পরিবর্তন করলে Claude-এর usage limit কেন ঠিক হয় না?

কারণ session limit এবং weekly limit সব মডেলের জন্য অভিন্ন। এই allowance কোনো নির্দিষ্ট মডেলের নয়, plan-এর অংশ। তাই /model কোন মডেল উত্তর দেবে তা পরিবর্তন করে, অবশিষ্ট allowance-এর পরিমাণ নয়। ব্যতিক্রম হলো model-family limit: You've hit your Opus limit এবং You've hit your Sonnet limit শুধু সংশ্লিষ্ট family-এর ক্ষেত্রে প্রযোজ্য। Max ও Premium seat-এ Fable limit শুধু Fable-কে সীমাবদ্ধ করে। এই ক্ষেত্রে মডেল পরিবর্তন করাই নথিভুক্ত সমাধান।

429 rate_limit_error-এর অর্থ কী, এবং কতক্ষণ অপেক্ষা করা উচিত?

এর অর্থ, আপনার account ওই model class-এর rate limit-এ পৌঁছেছে: প্রতি মিনিটে requests, প্রতি মিনিটে input tokens অথবা প্রতি মিনিটে output tokens। Response-এ সাধারণত retry-after header থাকে, যেখানে কত সেকেন্ড অপেক্ষা করতে হবে তা উল্লেখ থাকে। তার আগে retry করলে তা ব্যর্থ হবে। Official SDK-গুলো rate limit এবং 5xx error-এর জন্য exponential backoff সহ স্বয়ংক্রিয়ভাবে retry করে। Default হিসেবে এটি দুইবার retry করে এবং header উপস্থিত থাকলে সেটি অনুসরণ করে। আপনার tier-এর limit-এর মধ্যে থাকা অবস্থায় 429 এলে তা হঠাৎ request বৃদ্ধির কারণে acceleration limit নির্দেশ করে। error.details.error_code-এ enforced_spend_limit_reached-সহ 429 response-এ কখনো retry-after header থাকে না। এটি monthly spend cap, এবং কয়েক মিনিট অপেক্ষা করলে তা উঠে যাবে না।

Claude-এর usage limit এবং reset হওয়ার সময় কীভাবে দেখব?

Claude Code-এ আপনার plan bar, reset time এবং usage breakdown দেখতে /usage চালান। /cost একই command-এর alias। d অথবা w ব্যবহার করে শেষ 24 ঘণ্টা এবং শেষ 7 দিনের মধ্যে পরিবর্তন করা যায়। এই পরিসংখ্যান local session history থেকে নেওয়া হয়। তাই অন্য device এবং claude.ai থেকে হওয়া usage এতে অন্তর্ভুক্ত থাকে না। API-এর ক্ষেত্রে Console আপনার rate limit-এর chart দেখায়। Admin API credential, যেমন একটি Admin API key, ব্যবহার করে GET /v1/organizations/rate_limits আপনার configured limit ফেরত দেয়।

Claude-এর plan limit-এ পৌঁছানোর পরও কি কাজ চালিয়ে যেতে পারি?

কখনো কখনো। Pro এবং Max-এ ceiling অতিক্রম করে usage কেনার জন্য /usage-credits চালান। Team এবং Enterprise-এ admin-এর কাছে usage চাওয়ার জন্যও এটি ব্যবহার করা যায়। এর জন্য /login-এর মাধ্যমে claude.ai login প্রয়োজন। API key authentication ব্যবহার করলে এটি উপলভ্য নয়। অন্যথায় reset time পর্যন্ত অপেক্ষা করুন। claude.ai অথবা Claude Desktop-এর Settings > Usage-এ free limit reset-এর option থাকলে সেটি ব্যবহার করুন। Limit যদি Opus, Sonnet অথবা Fable-এর হয়, মডেল পরিবর্তন করুন। অথবা কাজটি API key-তে স্থানান্তর করুন, যেখানে usage প্রতি window নয়, প্রতি মিনিট হিসেবে মাপা হয়।