API और इंटीग्रेशन

OpenCode Claude Agent: सेटअप, सदस्यता की सीमाएँ और नियम

OpenCode V2 को स्थानीय Claude Code से जोड़ें, सक्रिय खाते की जाँच करें और छोटा परीक्षण अनुरोध भेजें। जानें कि टूल कौन चलाता है, सदस्यता की साझा सीमाएँ और API बिलिंग कैसे अलग हैं, अनुमति पर आधिकारिक स्रोत क्या कहते हैं और API कुंजी कब चुननी चाहिए।

BetterToken

संपादकीय टीम

5 नव॰ 202610 मिनट पढ़ने में

विषय-सूची

OpenCode Claude Agent: सेटअप, सदस्यता की सीमाएँ और नियम

OpenCode Claude Agent प्रोवाइडर को अपने कंप्यूटर पर स्थापित Claude Code के ज़रिए इस्तेमाल करें। दोनों टूल स्थापित करें, claude auth login चलाएँ और /connect में Claude Agent चुनें। अगर आपकी टीम को तीसरे पक्ष के उत्पाद के लिए दस्तावेज़ों में स्पष्ट रूप से बताया गया प्रमाणीकरण तरीका चाहिए, तो API कुंजी चुनें।

2026-11-05 तक OpenCode ने अलग Claude Agent सेटअप गाइड उपलब्ध कराई है। यह प्रोवाइडर Claude Code के सक्रिय प्रमाणीकरण का इस्तेमाल करता है। इसलिए इसे चुनने से बिलिंग अपने-आप सदस्यता पर नहीं जाती।

Claude Agent से क्या बदलता है?

Claude Agent में इंटरफ़ेस और टूल का संचालन OpenCode करता है, जबकि मॉडल से संवाद Claude Code संभालता है। OpenCode, Anthropic के Claude Agent SDK से आपके स्थापित claude को चलाता है।

यह अंतर्निहित प्रोवाइडर OpenCode v2.2.3 में आया था। v2.2.4 ने डेस्कटॉप ऐप के प्रोवाइडर चयन में निर्देशित सेटअप जोड़ा। अलग सदस्यता प्लगइन की ज़रूरत नहीं है।

प्रोवाइडर के डिज़ाइन के अनुसार फ़ाइल संचालन, शेल कमांड और अनुमतियाँ OpenCode संभालता है। Claude Code के अंतर्निहित टूल बंद रहते हैं।

संदर्भ को संक्षिप्त करना (compaction) और सहायक एजेंट चलाना भी OpenCode का काम है। मौजूदा Claude Agent गाइड यह स्पष्ट करती है। यह एकीकरण आपके मूल Claude Code की सेटिंग, हुक, MCP सर्वर, स्किल या मेमोरी लोड नहीं करता। हुक घटनाओं पर चलने वाले हैंडलर होते हैं।

इसलिए प्रोजेक्ट पर काम आपके OpenCode निर्देशों और टूल के अनुसार होता है। फ़ाइल बदलने या कमांड चलाने की अनुमति देने से पहले उन्हें जाँचें। यदि आपका काम Claude Code के मूल हुक या एजेंट टीमों पर निर्भर है, तो समान व्यवस्था तैयार होने तक Claude Code इस्तेमाल करें।

इस प्रोवाइडर को आज़माने की मुख्य वजह OpenCode का इंटरफ़ेस और मॉडल बदलने की प्रक्रिया बनाए रखना है। इसे स्थापित करने से Claude Code की सभी सुविधाएँ नहीं मिलतीं।

Claude Agent स्थापित करके कैसे जोड़ें?

OpenCode V2 और Claude Code को उसी मशीन पर रखें जहाँ OpenCode सर्वर चलता है। यह प्रोवाइडर OpenCode के दूरस्थ कार्यक्षेत्रों में उपलब्ध नहीं है।

सदस्यता वाले तरीके के लिए सक्रिय व्यक्तिगत Pro, Max या Ultra प्लान चाहिए।

सही संस्करण स्थापित करें

OpenCode V2 स्थापित करें; इस सुविधा के लिए न्यूनतम संस्करण v2.2.3 है। ऐप में निर्देशित सेटअप के लिए v2.2.4 या नया संस्करण इस्तेमाल करें।

ये कमांड macOS, Linux या WSL पर Bash के लिए हैं। वे OpenCode V2 के स्थापना निर्देशों और Claude Code के स्थापना निर्देशों पर आधारित हैं:

curl -fsSL https://opencode.ai/v2/install | bash
curl -fsSL https://claude.ai/install.sh | bash

नया टर्मिनल खोलें और दोनों संस्करण जाँचें:

opencode --version
claude --version

Claude Code का संस्करण 2.1.248 या नया होना चाहिए। प्रोवाइडर की संस्करण जाँच यही माँगती है। पुराने नेटिव इंस्टॉलेशन को claude update से अपडेट करें। पैकेज मैनेजर से स्थापित संस्करण को उसी पैकेज मैनेजर से अपडेट करें।

यदि आप पहले से V1 इस्तेमाल करते हैं, तो पहले V2 में जाने की गाइड पढ़ें। दोनों संस्करण opencode कमांड इस्तेमाल करते हैं और कॉन्फ़िगरेशन फ़ाइलें उन्हीं स्थानों से पढ़ते हैं।

स्थापना में मॉडल उपयोग का खर्च शामिल नहीं है। अगर आपने अभी पहुँच का तरीका नहीं चुना है, तो Claude Code की स्थापना, सदस्यता और API पहुँच देखें।

लॉगिन करें और खाता जाँचें

Claude Code की अपनी लॉगिन प्रक्रिया से प्रमाणीकरण करें। यदि सदस्यता की सीमा इस्तेमाल करनी है, तो उसी सदस्यता वाला खाता चुनें:

claude auth login
claude auth status --text

पुष्टि करें कि स्थिति में इच्छित खाता और प्रमाणीकरण तरीका दिख रहा है। CLI संदर्भ इसे claude auth login --console से अलग बताता है। वह विकल्प Console API बिलिंग चुनता है।

सदस्यता आज़माने से पहले परिवेश से मिली लॉगिन जानकारी जाँचें। Anthropic के अनुसार परिवेश में मौजूद API कुंजी को सदस्यता प्रमाणीकरण पर प्राथमिकता मिल सकती है। यदि निजी शेल में अनजाने में पुरानी कुंजी सेट है, तो उसे हटाएँ:

unset ANTHROPIC_API_KEY
claude auth status --text

अनचाहे ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL और क्लाउड प्रोवाइडर की सेटिंग भी जाँचें। उन्हें Anthropic के प्रमाणीकरण प्राथमिकता क्रम से मिलाएँ। सदस्यता से लॉगिन करने पर भी दूसरी लॉगिन जानकारी को प्राथमिकता मिल सकती है।

OpenCode कॉन्फ़िगरेशन में providers.claude-agent.settings के भीतर apiKey, authToken या baseURL देखें। मॉडल स्तर पर बदली गई सेटिंग भी असर डालती हैं। कनेक्शन का कोड ये सेटिंग सर्वर के परिवेश के बाद लागू करता है।

जोड़ें और वास्तविक अनुरोध जाँचें

पहली जाँच के लिए अलग OpenCode सर्वर शुरू करें:

opencode --standalone

स्टैंडअलोन मोड अलग सर्वर चलाता है। इससे मौजूदा शेल का परिवेश लागू होता है; पहले से चल रही साझा सेवा पर निर्भर नहीं रहना पड़ता। कॉन्फ़िगरेशन में बदली गई सेटिंग फिर भी लागू रहती हैं।

OpenCode के भीतर /connect चलाएँ और Claude Agent चुनें। फिर /models चलाकर Claude Code से मिली सूची में कोई मॉडल चुनें। प्रोवाइडर मॉडल के लिए claude-agent/opus जैसे उपनाम इस्तेमाल कर सकता है। इन्हें सीधे API के मॉडल पहचानकर्ताओं जैसा न मानें।

डेस्कटॉप ऐप में निर्देशित सेटअप स्थापना, लॉगिन, कनेक्शन जाँच और समस्या से उबरने के विकल्प देता है। जाँच सफल होने पर मॉडल चयन खुलता है। ऐप के ये नियंत्रण ऊपर दिए टर्मिनल निर्देशों से अलग हैं।

ऐसा रिपॉज़िटरी चुनें जिसमें README.md हो, फिर यह अनुरोध भेजें:

Read README.md and summarize the project in three sentences. Do not modify files or run shell commands.

यह अनुरोध फ़ाइल पढ़कर तीन वाक्यों में प्रोजेक्ट समझाने को कहता है। इसमें फ़ाइल बदलने और शेल कमांड चलाने की मनाही है। देखें कि OpenCode फ़ाइल पढ़ने वाले टूल का कॉल और प्रासंगिक उत्तर दिखाता है।

इससे मॉडल तक पहुँच और टूल का परिणाम वापस मिलने की जाँच होती है। सिर्फ़ मॉडल सूची दिखना पर्याप्त नहीं है: कनेक्शन जाँच मॉडल को कोई प्रॉम्प्ट नहीं भेजती।

खोज विफल होने पर OPENCODE_CLAUDE_PATH सेट करें

यदि सर्वर का PATH सही इंस्टॉलेशन नहीं ढूँढ़ता, तो उसे Claude Code की वास्तविक निष्पादन योग्य फ़ाइल का पता दें। पहले सुनिश्चित करें कि टर्मिनल में command -v claude सही निष्पादन योग्य फ़ाइल का पथ दिखाता है।

अलग सर्वर से दोबारा जाँचने के लिए:

export OPENCODE_CLAUDE_PATH="$(command -v claude)"
opencode --standalone

साझा पृष्ठभूमि सेवा के लिए उसका प्रबंधित परिवेश इस्तेमाल करें:

opencode service set env OPENCODE_CLAUDE_PATH "$(command -v claude)"

सेवा का परिवेश बदलने से चल रही सेवा रुक जाती है। अगली कमांड, जिसे स्थानीय सर्वर चाहिए, उसे नए मान के साथ शुरू करती है। Claude Agent फिर जोड़ें और छोटा अनुरोध दोहराएँ।

सर्वर परिवेश के निर्देश समझाते हैं कि सिर्फ़ क्लाइंट के टर्मिनल में बदलाव करना पर्याप्त क्यों नहीं हो सकता।

Claude Agent किस खाते की उपयोग सीमा लेता है?

Claude Code में इस्तेमाल हो रही लॉगिन जानकारी के अनुसार अनुरोधों का बजट तय करें। सदस्यता प्रमाणीकरण होने पर Claude Agent के अनुरोध आपकी मौजूदा Claude सीमा में गिने जाते हैं।

OpenCode इस तरीके में सदस्यता से उपयोग मिलने की पुष्टि करता है। Anthropic बताता है कि Claude और Claude Code प्लान की उपयोग सीमाएँ साझा करते हैं। इन दोनों नियमों से स्पष्ट है कि इंटरफ़ेस बदलने पर अलग उपयोग सीमा नहीं मिलती।

इन तीन स्थितियों को अलग रखें:

Claude Code का प्रमाणीकरण	उपयोग का भुगतान कैसे होता है
Claude सदस्यता	प्लान में शामिल उपयोग, उसकी सीमाओं और चालू किए गए अतिरिक्त सशुल्क उपयोग क्रेडिट के अनुसार
Anthropic API खाता या समर्थित क्लाउड खाता	उस खाते की API बिलिंग और सीमाओं के अनुसार
कस्टम गेटवे	गेटवे खाते के बिलिंग नियमों के अनुसार

लागत का अनुमान न दिखने को मुफ़्त उपयोग का प्रमाण न मानें। प्रोवाइडर की लागत गणना कस्टम बेस URL के लिए भी अनुमान नहीं दिखाती।

उपयोग और सीमा रीसेट होने का समय Claude Settings > Usage में देखें। Claude Code का मूल /usage दृश्य OpenCode में उपलब्ध नहीं है। अतिरिक्त सशुल्क उपयोग क्रेडिट भी जाँचें। इन्हें चालू करने पर शामिल उपयोग सीमा समाप्त होने के बाद अतिरिक्त शुल्क लग सकता है।

खाते का तरीका चुनने के लिए Claude सदस्यता और API बिलिंग की तुलना देखें।

नीति संबंधी दस्तावेज़ क्या स्पष्ट करते हैं?

अनुमति को खास कार्यान्वयन और उपयोग की व्यवस्था तक सीमित समझें। सिर्फ़ आधिकारिक SDK इस्तेमाल करने से हर तीसरे पक्ष के ऐप को सदस्यता की लॉगिन जानकारी इस्तेमाल करने का अधिकार नहीं मिलता।

ये तीन दस्तावेज़ अलग स्थितियों पर बात करते हैं:

आधिकारिक स्रोत	उसमें क्या लिखा है	इस सेटअप के लिए अर्थ
OpenCode का पुराना प्रोवाइडर पेज	यह Pro/Max सदस्यता प्लगइन पर Anthropic की रोक बताता है। OpenCode ने 1.3.0 से उन्हें साथ देना बंद कर दिया।	पुराने प्लगइन की यह चेतावनी नए V2 प्रोवाइडर का कार्यान्वयन नहीं बताती।
Anthropic Agent SDK का परिचय	तीसरे पक्ष के डेवलपर को अपने उत्पाद में Claude खाता लॉगिन या उसकी उपयोग सीमाएँ देने के लिए पहले अनुमति चाहिए।	SDK का इस्तेमाल अपने-आप अनुमति का प्रमाण नहीं है।
Claude Code के कानूनी और अनुपालन नियम	यह तीसरे पक्ष द्वारा Claude खाते की लॉगिन जानकारी लेने, सहेजने या उसके ज़रिए सेवा देने पर पाबंदियाँ बताता है। उपयोगकर्ता अपनी सदस्यता से अपरिवर्तित Claude Code बाइनरी में लॉगिन कर सकते हैं।	मूल लॉगिन प्रक्रिया रखें। इस छूट को साझा लॉगिन जानकारी या नए व्यावसायिक उत्पाद पर लागू न मानें।

इस कार्यान्वयन के बारे में अलग बयान भी है। 2026-10-30 को PR लेखक Tarquinen ने कहा कि Anthropic से अनुमति मिली थी। उन्होंने एकीकरण को उपयोग की शर्तों के अनुरूप बताया।

यह OpenCode के योगदानकर्ता का बयान है। यह अनुमति का दायरा तय करने वाला Anthropic का जारी किया हुआ दस्तावेज़ नहीं है।

निजी इस्तेमाल के लिए अपनी लॉगिन जानकारी अपरिवर्तित Claude Code इंस्टॉलेशन में ही रखें। सत्र के टोकन किसी दूसरे प्लगइन में निर्यात न करें। कंपनी में तैनाती या उत्पाद एकीकरण के लिए उस व्यवस्था की पुष्टि लें, या दस्तावेज़ित API कुंजी वाला तरीका चुनें।

सफल प्रमाणीकरण से अनुरोध चलने की पुष्टि होती है। यह हर तरह की तैनाती के लिए शर्तों के तहत अनुमति साबित नहीं करता।

दिख रही समस्या के अनुसार सुधार करें

लक्षण के अनुसार कारण जाँचें, फिर फ़ाइल पढ़ने वाला छोटा अनुरोध दोहराएँ।

लक्षण	जाँच और अगला कदम
`Claude Code is not installed`	इसे OpenCode सर्वर की मशीन पर स्थापित करें, या उस सर्वर पर `OPENCODE_CLAUDE_PATH` सेट करें। फिर जोड़ें।
`Claude Code is not logged in`	उसी मशीन पर उसी उपयोगकर्ता से `claude auth login` चलाएँ। स्थिति जाँचकर फिर जोड़ें।
त्रुटि में `2.1.248 or later is required` लिखा है	Claude Code अपडेट करें। दोबारा कोशिश से पहले निष्पादन योग्य फ़ाइल का संस्करण जाँचें।
कनेक्शन बन गया, लेकिन मॉडल नहीं दिखते या उत्तर नहीं आता	सर्वर पर निष्पादन योग्य फ़ाइल और लॉगिन जाँचें। फिर जोड़ें; मॉडल मिलना अनुरोध सफल होने का प्रमाण नहीं है।

कनेक्शन त्रुटियों के दस्तावेज़ स्थापना और लॉगिन न होने की स्थितियाँ समझाते हैं। यदि अनुरोध प्लान की सीमा तक पहुँच गया है, तो खाते का उपयोग पेज देखें। फिर से जोड़ने से उपयोग सीमा वापस नहीं मिलती।

API कुंजी कब इस्तेमाल करें?

अलग बिलिंग, स्थानीय Claude Code के बिना सर्वर या तीसरे पक्ष के उत्पाद के लिए दस्तावेज़ित प्रमाणीकरण चाहिए, तो API कुंजी चुनें। इसका बजट और सीमाएँ Claude सदस्यता से अलग रखें।

सीधे Anthropic API से जुड़ें

Claude Console में अपनी कुंजी बनाएँ। OpenCode में /connect से Anthropic चुनें और API कुंजी से प्रमाणीकरण करें।

यही काम करने वाली V2 प्रमाणीकरण कमांड आपसे कुंजी इंटरैक्टिव तरीके से माँगती है:

opencode auth login anthropic --method key
opencode run --standalone --model anthropic/claude-sonnet-5-5 "Reply with only: OK"

OK उत्तर देखें और इच्छित API खाते में उपयोग की पुष्टि करें। यदि चुना गया खाता या मॉडल गलत है, तो /connect या /models से सही करें। फिर जाँच दोहराएँ।

OpenAI-संगत API से जुड़ें

2026-11-05 तक BetterToken की सूची में claude-sonnet-5-5 और claude-opus-5-5 भी हैं। इसका दस्तावेज़ित OpenCode एकीकरण OpenAI-संगत API और आपकी अपनी BetterToken कुंजी इस्तेमाल करता है। इस API उपयोग की बिलिंग अलग होती है।

अपने कार्यस्थान में कुंजी बनाएँ। नई नेटिव V2 कॉन्फ़िगरेशन के लिए प्रोजेक्ट की opencode.jsonc में यह प्रोवाइडर जोड़ें:

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "bettertoken": {
      "name": "BetterToken",
      "env": ["BETTERTOKEN_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5"
        }
      }
    }
  }
}

यह OpenCode के नेटिव V2 कस्टम प्रोवाइडर प्रारूप का पालन करता है। इसमें providers, package और settings हैं। इस प्रोवाइडर प्रविष्टि में V1 के फ़ील्ड नाम न मिलाएँ।

कुंजी को स्क्रीन पर दिखाए बिना दर्ज करें। फिर उसी Bash टर्मिनल में जाँच चलाएँ:

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
opencode run --standalone --model bettertoken/claude-sonnet-5-5 "Reply with only: OK"

अपेक्षित परिणाम OK वाला सामान्य उत्तर है। इसके बाद कार्यस्थान में अनुरोध और शुल्क जाँचें। यदि OpenCode में BetterToken खाता पहले से सहेजा हुआ है, तो उसका सक्रिय खाता जाँचें। सहेजे हुए खातों को परिवेश से मिलने वाले कनेक्शन पर प्राथमिकता मिलती है।

बड़े काम से पहले मौजूदा कीमतें देखें। इस API तरीके में Claude सदस्यता शामिल नहीं है। यह सदस्यता लॉगिन इस्तेमाल करने वाले दूसरे एकीकरणों को अनुमति भी नहीं देता।