Claude Agent SDK: 5 घंटे की सीमा की खपत कैसे जाँचें

अगर Claude Agent SDK ऐप या claude -p आपकी पाँच घंटे की सीमा जल्दी खर्च करते हैं, तो वही काम इंटरैक्टिव Claude Code में जाँचें। समुदाय के परीक्षणों में दूसरे क्लाइंट के मुकाबले लगभग 1.6×–2.97× खपत मिली, लेकिन कोई सार्वभौमिक गुणक साबित नहीं हुआ। नियमित ऑटोमेशन के लिए दस्तावेज़ित API बिलिंग का तरीका अलग बैलेंस देता है, जहाँ टोकन के हिसाब से खर्च मापा जा सकता है।

2026-10-27 तक Anthropic की समस्या रिपोर्ट #97074 खुली है। रिपोर्टों में क्लाइंट के अलग एंट्रीपॉइंट के बीच उपयोग सीमा की खपत का अंतर दिखता है। उनसे यह तय नहीं होता कि Anthropic ने यह अंतर जानबूझकर रखा है या इसे दोष मानता है।

नियंत्रित तुलनाओं में क्या मापा गया

कई लेखकों ने बताया कि समान काम के लिए claude -p या Agent SDK ऐप ने पाँच घंटे की सीमा का अधिक हिस्सा खर्च किया। ये अलग प्रयोग हैं। इनके संस्करण, मॉडल, टोकन के प्रकारों का अनुपात और तुलना वाले क्लाइंट अलग थे।

रिपोर्ट	परीक्षण की शर्तें	रिपोर्ट किया गया परिणाम
qvarker, 25 सितंबर	Max; Claude Code 2.1.282; claude-opus-5; high effort	हेडलेस मोड में इंटरैक्टिव टर्मिनल के मुकाबले लगभग 1.8× खपत
kler, 17 अक्टूबर	Team; Claude Code 2.1.300; claude-opus-5-5; high effort	claude-vscode लेबल वाले परीक्षण प्रोग्राम की तुलना में sdk-ts: 2.97×; sdk-cli: 2.83×
Theo की T3 Code रिपोर्ट, 25 अक्टूबर	एक Max खाता; समान काम; इंटरैक्टिव टर्मिनल, T3 Code और claude -p	रिपोर्ट में कैश की तुलना के बाद SDK और हेडलेस मोड की खपत इंटरैक्टिव टर्मिनल की लगभग 1.6×–1.7× थी
frostfire575, 26 अक्टूबर	Windows 11; Claude Code 2.1.310; claude-opus-5-5; low effort	claude -p से प्रति भारित टोकन खपत इंटरैक्टिव टर्मिनल के मुकाबले लगभग 2.4×

हेडलेस मोड में प्रोग्राम इंटरैक्टिव इंटरफ़ेस के बिना चलता है। सबसे बड़े परिणाम की एक अहम शर्त है: kler के परीक्षण प्रोग्राम ने VS Code एक्सटेंशन के लेबल की नकल की थी। उसने असली एक्सटेंशन इंटरफ़ेस नहीं चलाया। उस प्रयोग में परिणाम लेबल से जुड़ा अंतर दिखाता है।

qvarker की रिपोर्ट में डॉलर की रकम काम को एक ही पैमाने पर रखने के लिए API के बराबर लागत का अनुमान है। वह सदस्यता पर लगा अतिरिक्त शुल्क नहीं है। “प्रति 1% सीमा में डॉलर के हिसाब से कितना काम हुआ” घटने का मतलब है कि सीमा जल्दी खर्च हुई।

साप्ताहिक सीमा को अलग देखें। Theo के हर रन में साप्ताहिक खपत दो प्रतिशत अंक बढ़ी। Frostfire575 का साप्ताहिक मीटर केवल 0% से 1% हुआ, जो निष्कर्ष निकालने के लिए पर्याप्त सटीक नहीं था। साक्ष्य Theo के प्रयोग में समान साप्ताहिक खपत दिखाता है; यह हर खाते की गारंटी नहीं है।

sdk-cli और sdk-ts से क्या पता चलता है

एंट्रीपॉइंट कॉल करने वाले क्लाइंट का दर्ज नाम बताता है। इससे Anthropic के सर्वर पर उपयोग की गणना का फ़ॉर्मूला नहीं मिलता।

प्रकाशित @anthropic-ai/claude-agent-sdk 0.3.311 पैकेज की sdk.mjs फ़ाइल में यह डिफ़ॉल्ट मान है:

if(!c.CLAUDE_CODE_ENTRYPOINT)c.CLAUDE_CODE_ENTRYPOINT="sdk-ts"

इसलिए परिवेश में यह मान न होने पर SDK sdk-ts सेट करता है। समुदाय के सेशन लॉग में सामान्य claude -p रन के लिए sdk-cli और इंटरैक्टिव टर्मिनल के लिए cli दर्ज है।

qvarker की नेटवर्क तुलना में अनुरोधों के x-anthropic-billing-header सिस्टम ब्लॉक के अंदर cc_entrypoint अलग था। लेखक ने User-Agent और एक बीटा फ़्लैग में भी अंतर देखा।

यह अनुरोधों की सामग्री के बारे में समुदाय का अवलोकन है। यह आधिकारिक रूप से दस्तावेज़ित बिलिंग-हेडर इंटरफ़ेस नहीं है। इससे यह भी साबित नहीं होता कि हर अंतर का कारण यही एक फ़ील्ड है।

Claude Code 2.1.311 के बदलावों की सूची उपयोग सीमा के इस अंतर का समाधान घोषित नहीं करती। वहाँ उल्लेख न होने से यह तय नहीं होता कि सर्वर का व्यवहार बदला है या नहीं।

अपने वर्कफ़्लो की खपत कैसे जाँचें

सेटिंग बदलने से पहले वास्तविक क्लाइंट, ऑथेंटिकेशन के तरीके और काम की मात्रा को जाँचें।

ऑथेंटिकेशन और तुलना की शर्तें जाँचें

उस परिवेश को देखें जिसमें ऐप की Claude प्रक्रिया चलती है। ऑथेंटिकेशन संदर्भ के अनुसार, -p मोड में API कुंजी को सदस्यता वाले ऑथेंटिकेशन पर प्राथमिकता मिल सकती है।

प्रोग्राम फ़ाइल, CLI संस्करण, SDK पैकेज संस्करण, खाते का प्लान, सटीक मॉडल ID और effort सेटिंग दर्ज करें। यह सेटिंग मॉडल के तर्क करने के प्रयास को नियंत्रित करती है। कोई फ़्रंटएंड आपके टर्मिनल से अलग बाइनरी चला सकता है।

तुलना करते समय:

• वही खाता, परियोजना की वही प्रति, प्रॉम्प्ट की सूची, टूल और कैश सेटिंग रखें।
• उस खाते पर बाकी गतिविधि रोकें।
• नए सेशन शुरू करें और दोनों रन एक ही पाँच घंटे की अवधि में रखें।
• अवधि रीसेट हो जाए या भुगतान वाला अतिरिक्त उपयोग शुरू हो जाए, तो तुलना रोक दें।

ऐसा काम चुनें जो आपके सामान्य उपयोग का प्रतिनिधित्व करे, जैसे उन्हीं सोर्स फ़ाइलों का सार बनाना। इनपुट, आउटपुट, कैश से पढ़े गए और कैश में लिखे गए टोकन के कुल आँकड़े अलग रखें। केवल जवाब की लंबाई समान होने से काम बराबर साबित नहीं होता।

मीटर की रीडिंग और दर्ज एंट्रीपॉइंट निकालें

रेट लिमिट वाले इवेंट का पूरा डेटा सुरक्षित रखें, क्योंकि उसमें उपलब्ध फ़ील्ड संस्करण के साथ बदलते हैं।

नीचे दिए Bash परीक्षण के लिए jq और सदस्यता से किया हुआ मौजूदा लॉगिन चाहिए। यह उपयोग सीमा खर्च करता है। इससे टेलीमेट्री और ऑथेंटिकेशन जाँचे जाते हैं; एक शब्द का जवाब खपत का गुणक नहीं मापता।

set -o pipefail
claude --version
claude auth status | jq '{authMethod}'
claude -p "Reply with exactly OK." \
  --model claude-sonnet-5-5 \
  --max-turns 1 \
  --disallowedTools "*" \
  --output-format stream-json --verbose |
jq -c '
  if .type == "rate_limit_event" then
    {type, session_id, rate_limit_info}
  elif .type == "result" then
    {type, subtype, is_error, session_id,
     usage, modelUsage, total_cost_usd, result}
  else empty end
'

CLI संदर्भ में इन फ़्लैग और ऑथेंटिकेशन की स्थिति जाँचने वाले कमांड का विवरण है। सफल जवाब में result रिकॉर्ड होना चाहिए, जिसमें subtype: "success" और is_error: false हों।

समस्या रिपोर्ट में अतिरिक्त मापन वाले बिल्ड ने इस पथ का उपयोग किया:

rate_limit_event.rate_limit_info.unifiedWindows.five_hour.utilization

लेकिन सार्वजनिक 0.3.311 SDK के इवेंट प्रकार में unifiedWindows नहीं है। उसमें rateLimitType और utilization जैसे फ़ील्ड घोषित हैं। किसी फ़ील्ड या इवेंट के न मिलने को शून्य खपत न मानें। स्ट्रीम से उपयोगी रीडिंग न मिले तो खाते का Usage पेज देखें।

मापन के लिए एक ही इंटरफ़ेस और पैमाना रखें। इवेंट में उपयोग का आँकड़ा और SDK का अलग उपयोग-नियंत्रण जवाब अलग डेटा संरचनाएँ इस्तेमाल करते हैं। उनकी संख्याओं को एक-दूसरे की जगह इस्तेमाल नहीं कर सकते।

लौटे हुए session_id से उसका सेशन लॉग खोजें। सेशन के दस्तावेज़ के अनुसार, ये लॉग ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl में होते हैं। CLAUDE_CONFIG_DIR का अपना मान सेट करने पर यह मूल डायरेक्टरी बदलती है।

Bash में केवल दर्ज एंट्रीपॉइंट देखें:

read -r -p "Transcript path: " CLAUDE_TRANSCRIPT
jq -r 'select(.entrypoint? | type == "string") | .entrypoint' \
  "$CLAUDE_TRANSCRIPT" | sort -u

खाली परिणाम का मतलब है कि फ़ील्ड उपलब्ध नहीं था। इससे सेशन के इंटरैक्टिव होने की पुष्टि नहीं होती।

टर्मिनल वाली तुलना के लिए साफ़ परिवेश वाले शेल से असली इंटरैक्टिव Claude Code शुरू करें। qvarker ने बताया कि tmux सर्वर को विरासत में मिला CLAUDE_CODE_ENTRYPOINT बाद के टर्मिनल सेशन में भी गया। यह मानने के बजाय कि इंटरफ़ेस ही लेबल तय करता है, बने हुए सेशन लॉग को जाँचें।

समान काम पर सीमा की खपत की तुलना करें

काम की समान इकाई पर उपयोग सीमा की खपत को प्रतिशत अंकों में मापकर तुलना करें। बिताए हुए मिनट या प्रॉम्प्ट की संख्या इसके विकल्प नहीं हैं।

Frostfire575 ने टर्मिनल में 1.43 million भारित टोकन पर पाँच प्रतिशत अंक की वृद्धि दर्ज की। हेडलेस रन में 1.32 million भारित टोकन पर ग्यारह प्रतिशत अंक की वृद्धि हुई। रिपोर्ट की इन संख्याओं से:

Headless / terminal = (11 / 1.32) / (5 / 1.43) = 2.38

यह गणना रिपोर्ट के 2.4× परिणाम को समझाती है। इसमें लेखक की भारित-टोकन गणना इस्तेमाल हुई है, जहाँ टोकन को वज़न देकर गिना गया। यह परिणाम केवल उसी तुलना पर लागू होता है।

एक प्रतिशत अंक का बदलाव छोटे रन की उपयोगी तुलना के लिए बहुत मोटा पैमाना है। जरूरत हो तो दोनों क्लाइंट का क्रम उलटकर सामान्य काम दोहराएँ। इस दौरान अवधि रीसेट होने या खाते पर दूसरी गतिविधि चलने से बचें।

लागत के अनुमान के लिए नए सेशन के अंतिम परिणाम लें। दोबारा शुरू किए गए सेशन के संचयी परिणाम रिकॉर्ड को जोड़ें नहीं। लागत मापने के दस्तावेज़ टोकन की गणना और वास्तविक बिलिंग में अंतर करते हैं। न total_cost_usd, न modelUsage सदस्यता की उपयोग सीमा का मीटर है।

कैश का व्यवहार समान करने या दूसरी गतिविधि हटाने पर अंतर मिट जाए, तो पहले उन्हीं कारणों की जाँच करें।

क्या CLAUDE_CODE_ENTRYPOINT बदलना चाहिए?

क्लाइंट का लेबल बदलने को ऐसा प्रयोग मानें जिसे आधिकारिक समर्थन नहीं मिला है।

26 अक्टूबर को qvarker और oviano ने अपने टूल के नाम वाले लेबल से कम खपत की रिपोर्ट दी। उनकी तुलनाओं में डिफ़ॉल्ट sdk-cli से खपत अपने लेबल से हुई खपत की लगभग 1.9×–2.4× थी।

इन रिपोर्टों से अलग उपयोग सीमा पाने का स्वीकृत तरीका स्थापित नहीं होता। अपना लेबल क्लाइंट की दर्ज पहचान बदलता है, जिसका उपयोग की गणना से संबंध दिखता है। उसके साथ होने वाला व्यवहार बदल सकता है। नीतियों के अनुसार उसकी स्थिति भी अभी स्पष्ट नहीं है।

दूसरे क्लाइंट जैसा व्यवहार पाने के लिए अपने ऐप को cli या claude-vscode नाम न दें। ये नाम अलग क्लाइंट की पहचान हैं।

इससे जुड़ी T3 Code पुल रिक्वेस्ट #25597 की स्थिति 2026-10-27 को जाँची गई थी। वह खुली थी और मर्ज नहीं हुई थी। उसका मौजूद होना T3 Code में जारी किए गए समाधान या Anthropic की मंजूरी का प्रमाण नहीं है।

इंटरैक्टिव काम के लिए असली टर्मिनल क्लाइंट जाँचें। जिस ऑटोमेशन में संरचित इनपुट और आउटपुट बनाए रखना जरूरी है, उसके लिए API बिलिंग पर विचार करें।

Agent SDK ऑटोमेशन किस बैलेंस से चलता है?

ऑथेंटिकेशन तय करता है कि काम सदस्यता की उपयोग सीमा खर्च करेगा या API क्रेडिट।

Anthropic का 7 अक्टूबर का बिलिंग अपडेट Agent SDK, claude -p और तृतीय-पक्ष ऐप के लिए सदस्यता का उपयोग जारी रखता है। अपने नियंत्रण में चलाए गए SDK और claude -p काम पात्र Max और Team API क्रेडिट भी इस्तेमाल कर सकते हैं। इसके लिए लिंक किए गए Console संगठन की API कुंजी से ऑथेंटिकेशन होना चाहिए।

इन सीमाओं और बैलेंस को अलग रखें:

बिलिंग का तरीका	काम क्या खर्च करता है
Claude सदस्यता से लॉगिन	सदस्यता की उपयोग सीमाएँ, जिनमें पाँच घंटे की अवधि शामिल है
चालू किया गया अतिरिक्त उपयोग, जिसे usage credits भी कहते हैं	शामिल उपयोग सीमा के बाद अलग भुगतान से जारी उपयोग
Anthropic API कुंजी	Console संगठन के पात्र API क्रेडिट या भुगतान वाला API बैलेंस
स्वतंत्र API गेटवे	उस प्रदाता का बैलेंस और उसके बिलिंग नियम

API बिलिंग अपनाने पर काम सदस्यता की पाँच घंटे की सीमा पर निर्भर नहीं रहता। API की रेट लिमिट और खर्च की सीमाएँ फिर भी लागू रहती हैं। उपलब्ध धन भी पर्याप्त होना चाहिए।

2026-10-27 तक मासिक API क्रेडिट कार्यक्रम में ये रकम दी गई हैं:

पात्र प्लान	मासिक API क्रेडिट
Max 5x	$100 USD
Max 20x	$200 USD
Team Standard	$20 USD प्रति सीट
Team Premium	$100 USD प्रति सीट

Team क्रेडिट एक साझा पूल बनाते हैं, जिसकी अधिकतम सीमा $500 USD है। Pro पात्र नहीं है। नए सदस्यों को पात्र प्लान पर सात दिन पूरे करने होंगे।

क्रेडिट पाने के लिए Max में Settings > Billing या Team में Organization settings > Billing खोलें। API क्रेडिट के नीचे Link organization चुनें। आपके पास जरूरी सदस्य या मालिक की भूमिका और Console में बिलिंग की अनुमतियाँ होनी चाहिए। API कुंजी उसी लिंक किए गए संगठन में बनाएँ।

कार्यक्रम में इंटरैक्टिव Claude Code और अतिरिक्त उपयोग शामिल नहीं हैं। Claude Code GitHub Action, IDE एक्सटेंशन या Claude डेस्कटॉप ऐप से शुरू किए गए रन भी बाहर हैं। -p जोड़ने से ये अपवाद नहीं हटते।

Platform के क्रेडिट दस्तावेज़ बताते हैं कि बचे हुए क्रेडिट की अवधि खत्म हो जाती है। वे अगली अवधि में नहीं जुड़ते। शामिल क्रेडिट पहले खर्च होते हैं, फिर खरीदे गए क्रेडिट।

क्रेडिट खत्म होने पर खरीदा हुआ बैलेंस या खाते पर लागू इनवॉइस बिलिंग सेवा जारी रख सकती है। इनके न होने पर अनुरोध रुक जाते हैं। उपयोग अपने आप सदस्यता की सीमा से कटने नहीं लगता।

नियमित काम स्थानांतरित करने से पहले API बिलिंग जाँचें

काम की कतार स्थानांतरित करने से पहले सीधे API कुंजी से एक रन करें और Console में उसका उपयोग देखें।

सीधे Anthropic से जुड़ने के लिए सेट किया गया Bash टर्मिनल इस्तेमाल करें। पहले मौजूदा ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN और क्लाउड प्रदाता की सेटिंग जाँचें। ये कोई दूसरा एंडपॉइंट या क्रेडेंशियल का स्रोत चुन सकती हैं।

चुने हुए Console संगठन में API कुंजी बनाएँ। उसे स्क्रीन पर दिखाए बिना दर्ज करें:

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
claude --bare -p \
  --model claude-sonnet-5-5 \
  --tools "" \
  --max-turns 1 \
  --max-budget-usd 1.00 \
  --output-format json \
  "Reply with exactly OK."

प्रोग्राम से उपयोग करने के दस्तावेज़ के अनुसार, --bare सदस्यता के OAuth क्रेडेंशियल और अपने आप मिले कस्टमाइज़ेशन छोड़ देता है। इसलिए वह API की इस जाँच के लिए उपयुक्त है। सदस्यता की तुलना में इसे लगाने से ऑथेंटिकेशन का तरीका बदल जाएगा।

सफल JSON परिणाम में जवाब मिलना चाहिए। उसके बाद Console में सही संगठन का उपयोग और बैलेंस जाँचें। केवल CLI का लागत अनुमान यह साबित नहीं करता कि अनुरोध का भुगतान प्रमोशनल क्रेडिट से हुआ।

ऑथेंटिकेशन विफल हो तो कुंजी और चुना हुआ प्रदाता जाँचें। बैलेंस खत्म हो तो Console में बिलिंग देखें। API की रेट लिमिट या खर्च की सीमा से जुड़ी त्रुटि आए तो उन्हीं सीमाओं को जाँचें, भले सदस्यता में उपयोग बाकी हो।

CLI का $1.00 बजट रुकने की अनुमानित सीमा है। एक अनुरोध इस रकम से आगे जा सकता है, इसलिए Console में भी उपयुक्त खर्च सीमा सेट करें।

बजट के उदाहरण के लिए, Anthropic की वर्तमान कीमतों में claude-sonnet-5-5 के बिना कैश वाले इनपुट टोकन की दर $2 प्रति million है। आउटपुट टोकन की दर $10 प्रति million है। 2026-10-27 तक इन दरों पर एक million इनपुट टोकन और 100,000 आउटपुट टोकन का अनुमानित शुल्क होगा:

(1 × $2) + (0.1 × $10) = $3

इस अनुमान में मानक सिंक्रोनस वैश्विक रूटिंग है। इसमें कैश या अलग शुल्क वाले सर्वर टूल का उपयोग नहीं है। लागू कर शामिल नहीं हैं। संदर्भ दोबारा इस्तेमाल करने पर कैश में लिखने और पढ़ने की गणना उनकी अलग दरों से करें।

स्वतंत्र गेटवे भी एक विकल्प है। BetterToken के वर्तमान कैटलॉग में 2026-10-27 को claude-sonnet-5-5 और claude-opus-5-5 मौजूद थे। उसकी Claude Code मार्गदर्शिका में अपनी BetterToken कुंजी और बेस URL https://bettertoken.ai इस्तेमाल करने का तरीका दिया गया है। इस बेस URL में /v1 नहीं है। अपने काम के हिसाब से उसकी वर्तमान कीमतें और जरूरी टूल के साथ अनुकूलता जाँचें। Anthropic के शामिल API क्रेडिट इस अलग बिलिंग व्यवस्था में स्थानांतरित नहीं होते।