Zoo Code + JoinGonka Gateway: Roo Code से Gonka मॉडल पर माइग्रेशन

चरण 1: एक्सटेंशन इंस्टॉल करें। VS Code में एक्सटेंशन पैनल खोलें (Ctrl+Shift+X, macOS पर Cmd+Shift+X), «Zoo Code» खोजें और Zoo Code Organization पब्लिशर का एक्सटेंशन इंस्टॉल करें। एक ही कमांड से भी:

code --install-extension ZooCodeOrganization.zoo-code

VS Code 1.100 या नया चाहिए — एक्सटेंशन के मैनिफ़ेस्ट में यही लिखा है; VSCodium, Windsurf और Marketplace रहित अन्य एडिटर के लिए एक्सटेंशन Open VSX पर प्रकाशित है। स्थिर चैनल (18 सितंबर 2026 का 3.82.2) के अलावा प्रारंभिक 3.83.x भी है — मुख्य ब्रांच की नाइटली बिल्ड; काम के लिए स्थिर वाला लें। इंस्टॉल के बाद एक्टिविटी बार पर Zoo Code का आइकन दिखेगा।

चरण 2: कुंजी लें। gate.joingonka.ai/register पर रजिस्टर करें, पता सत्यापित करें और «API कुंजियाँ» अनुभाग में jg- प्रीफ़िक्स वाली कुंजी बनाएँ। Zoo Code के लिए अलग कुंजी रखना सुविधाजनक है: उसका खर्च आँकड़ों में अलग पंक्ति में दिखेगा।

चरण 3: इंस्टॉलर चलाएँ।

npx @joingonka/setup --tool zoo --model deepseek

इंस्टॉलर कुंजी माँगेगा — कमांड-लाइन आर्ग्युमेंट में यह नहीं दी जाती, ताकि शेल के इतिहास में न रह जाए। उसे लिखने के लिए कुछ नहीं है: प्रोवाइडर प्रोफ़ाइल और कुंजियाँ Zoo Code फ़ाइल में नहीं, बल्कि VS Code के सुरक्षित सीक्रेट स्टोर में रखता है। इसलिए इंस्टॉलर फ़ॉर्म के लिए तैयार मान और चुने गए मॉडल की वास्तविक सीमाएँ प्रिंट करता है:

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

इसके बाद गेटवे को लाइव अनुरोध का नतीजा आता है — सफलता पर पंक्ति ✓ Verified: the gateway accepted the key, base URL and model. कुंजी, पता और मॉडल तुरंत जाँचे जाते हैं, पहले काम पर नहीं। प्रिंट हुए ब्लॉक में कुंजी पूरी होती है ताकि कॉपी करना आसान हो — यह आउटपुट सार्वजनिक न करें।

--model फ़्लैग के बिना इंस्टॉलर MiniMax M2.7 डाल देगा: जहाँ मॉडल हाथ से चुना जाता है, वह नेटवर्क में सबसे बड़ी क्षमता वाला मॉडल सुझाता है। Zoo Code के लिए DeepSeek V4 Flash से शुरू करने की सलाह है: हमारी जाँच में उसने टूल परिणाम के बाद का चरण पहले ही अनुरोध में पूरा किया — विवरण जाँच वाले अनुभाग में; फ़्लैग संक्षेप glm (GLM-5.3 Flash) और minimax भी स्वीकार करता है। --tool फ़्लैग के बिना इंस्टॉलर 25 टूल का मेन्यू दिखाएगा।

फ़ॉर्म की एक बारीकी: Zoo Code 3.82.2 में Model Configuration शीर्षक वाला अलग ब्लॉक नहीं है। सीमा वाले फ़ील्ड उसी फ़ॉर्म में नीचे हैं, «Configure the capabilities and pricing for your custom OpenAI-compatible model» स्पष्टीकरण के नीचे, और Max Output Tokens, Context Window Size से पहले आता है।

पहली बार शुरू करने पर, Zoo Code एक स्वागत संदेश और Choose your provider बटन दिखाता है: यह एक फॉर्म पर ले जाता है जहाँ OpenRouter पहले से चुना होता है — प्रदाता को OpenAI Compatible में बदलें और अंत में Finish पर क्लिक करें। बाद में, वही फॉर्म Zoo Code पैनल के हेडर में गियर आइकन के माध्यम से खुलता है, अनुभाग Providers; परिवर्तनों को Save बटन द्वारा सुरक्षित किया जाता है।

नेटवर्क मॉडल की सीमाएं:

बाकी चीजों को बदलने की आवश्यकता नहीं है: Enable streaming और Include max output tokens को चालू रखें, Enable R1 model parameters और Use Azure को बंद रखें (ये R1 परिवार के मॉडल और Azure OpenAI के लिए सेटिंग्स हैं), और Custom Headers व Extra Body फ़ील्ड को खाली रखें।

सीमाएं मॉडल के साथ नहीं, प्रोफाइल में संग्रहीत की जाती हैं: यदि आप उसी प्रोफाइल में Model बदलते हैं, तो विंडो और उत्तर की सीमा समान रहती है। इसलिए, प्रत्येक मॉडल के लिए अपना प्रोफाइल बनाना अधिक सुविधाजनक है — अगले अनुभाग में इसके बारे में और बताया गया है।

Zoo Code का विकास Roo Code के कोड बेस से हुआ है, इसलिए इसे माइग्रेट करने में केवल कुछ मिनट लगते हैं और प्रोजेक्ट फ़ाइलों को छूने की ज़रूरत नहीं पड़ती। आधिकारिक माइग्रेशन गाइड सेटिंग्स निर्यात और आयात के बारे में बताता है; बाकी चीज़ें एक अलग बटन द्वारा ट्रांसफर हो जाती हैं या पुराने पथों से पढ़ी जाती हैं:

Roo Code प्रोफाइल जो पहले से ही JoinGonka Gateway का उपयोग कर रहा था, वह अपने पते, की, मॉडल और लिमिट्स के साथ माइग्रेट हो जाएगा — बस यह जांच लें कि मॉडल अभी नेटवर्क में मौजूद है या नहीं: लिस्ट GET https://gate.joingonka.ai/v1/models लौटाती है।

मोड और प्रोफाइल। इसमें पांच इनबिल्ट मोड हैं: Code, Debug, Architect (केवल Markdown फ़ाइलों को संपादित करता है), Ask (बिना संपादन के उत्तर देता है) और Orchestrator (अन्य मोड को उप-कार्य देता है)। इन्हें इनपुट फ़ील्ड के पास की सूची से, संदेश की शुरुआत में मोड के नाम वाले कमांड से (उदाहरण के लिए /architect), या Ctrl+. (macOS पर Cmd+.) कॉम्बिनेशन से स्विच किया जा सकता है। प्रत्येक मोड उस प्रोफाइल को याद रखता है जिसके साथ आपने आखिरी बार काम किया था, और मोड बदलने पर Zoo Code अपने आप प्रोफाइल भी स्विच कर देता है।

यहाँ से एक सुविधाजनक योजना है: प्रत्येक मॉडल के लिए एक प्रोफाइल, जो मोड के साथ जुड़ा हो। Settings → Providers में Configuration Profile फ़ील्ड के पास „+” पर क्लिक करें, प्रोफाइल को नाम दें, जैसे Gonka DeepSeek, और फ़ॉर्म भरें; GLM-5.3 Flash और MiniMax M2.7 के लिए दोहराएं — सभी का पता और की समान है। फिर प्रत्येक मोड में इनपुट फ़ील्ड के पास की प्रोफाइल सूची से प्रोफाइल चुनें, और मोड उसे याद रखेगा। इस सूची में लॉक आइकन, इसके विपरीत, वर्किंग फोल्डर के सभी मोड के लिए एक ही प्रोफाइल को फिक्स कर देता है।

तर्क का स्तर। फ़ॉर्म में Enable Reasoning Effort टिक Low, Medium, High, Extra High और Max की सूची खोलता है; जब तक यह बंद है, स्तर क्वेरी में नहीं जाता। GLM-5.3 Flash के लिए स्विच मूल रूप से बाइनरी है: Low तर्क को बंद कर देता है, कोई भी अन्य स्तर इसे पूर्ण रखता है — त्वरित प्रश्नों के लिए Low के साथ एक अलग GLM प्रोफाइल रखना सुविधाजनक है। अधिक जानकारी — GLM-5.3 Flash ओवरव्यू में। DeepSeek V4 Flash और MiniMax M2.7 के लिए गेटवे स्केल को दोबारा नहीं लिखता: स्तर कैसे काम करेगा, यह मॉडल पर ही निर्भर करता है।

एक छोटी फाइल वाले फोल्डर को खोलें जिसमें स्पष्ट त्रुटि हो, उदाहरण के लिए calc.py जिसमें जोड़ने का फंक्शन है जो घटा रहा है, और Code मोड में लिखें: «calc.py पढ़ें और एक वाक्य में बताएं कि क्या इसमें कोई त्रुटि है». Zoo Code फाइल पढ़ने की अनुमति मांगेगा — «Zoo wants to read this file», Approve और Deny बटन, यदि Auto-Approve में पहले से अनुमति नहीं दी गई है। फिर मॉडल समापन टूल को कॉल करेगा, और कार्य एक Task Completed ब्लॉक के साथ समाप्त होगा जिसमें सटीक उत्तर होगा; तर्क, यदि कोई है, तो उसे एक अलग Thinking ब्लॉक में दिखाया जाता है। कार्य के संक्षिप्त हेडर में संदर्भ भरने का प्रतिशत Context Window Size से गिना जाता है — इसे सही ढंग से सेट करने का एक और कारण।

इस प्रक्रिया को हमने Zoo Code के नमूना अनुरोध द्वारा दोहराया — स्ट्रीम, सख्त योजना में टूल, इतिहास में read_file का परिणाम। DeepSeek V4 Flash ने सही निष्कर्ष के साथ attempt_completion के नेटिव कॉल का जवाब दिया: फंक्शन जोड़ने के बजाय घटा रहा है। जांच का दूसरा भाग गेटवे डैशबोर्ड है: «उपयोग» (Usage) अनुभाग में, अनुरोध मॉडल द्वारा विभाजित दिखाई देगा, और की (key) के लिए अंतिम एक्सेस समय अपडेट हो जाएगा।

Auto-Approve के बिना, त्रुटि API Request Failed ब्लॉक के साथ आती है जिसमें Retry और Start New Task बटन होते हैं, इसके साथ Provider Error हेडर होता है जिसमें कोड और पुन: प्रयास तक की उलटी गिनती होती है। गेटवे उत्तर का टेक्स्ट संदेश या इसके विवरण में दिखाई देता है:

एजेंट टोकन को चैट की तुलना में अलग तरह से खर्च करता है। प्रत्येक अनुरोध में Zoo Code मोड के नियमों, टूल के विवरण और वर्किंग फोल्डर के बारे में जानकारी वाला एक सिस्टम प्रॉम्प्ट डालता है — यह आपके प्रश्न से पहले ही हजारों टोकन हैं — और कार्य में आमतौर पर कई चरण लगते हैं। इसलिए यहाँ प्रति टोकन की कीमत मायने रखती है।

JoinGonka Gateway के माध्यम से टोकन इनपुट पर $0.0069 प्रति मिलियन और आउटपुट पर $0.021 प्रति मिलियन खर्च होते हैं — कीमत नेटवर्क के सभी मॉडलों के लिए समान है और इस पेज पर लाइव स्रोत से ली जाती है। सितंबर 2026 की कीमतों के अनुसार राशि का क्रम:

तुलना के लिए — Zoo Code में मॉडलों के लिए भुगतान कैसे किया जा सकता है:

Input Price और Output Price भरने के साथ, कार्य की लागत उसके हेडर में दिखाई देती है, लेकिन सेंट तक सटीकता के साथ — नेटवर्क मॉडलों पर छोटे कार्य वहां $0.00 दिखाएंगे। सटीक खपत और बैलेंस — कैबिनेट में, «उपयोग» (Usage) और «बिलिंग» अनुभागों में।

पुष्टि और स्वायत्तता। डिफ़ॉल्ट रूप से Auto-Approve बंद रहता है, और Zoo Code पढ़ने, लिखने और कमांड निष्पादित करने के लिए अनुमति मांगता है; लंबे कार्यों के लिए इनपुट फ़ील्ड के बगल में Auto-approve मेनू में आवश्यक श्रेणियां चालू करें। कमांड के लिए Destructive Command Guard (Settings → Auto-Approve) उपलब्ध है: एक्सटेंशन इसकी निष्पादन योग्य फ़ाइल डाउनलोड करता है, जिसके बाद इसके द्वारा स्वीकृत कमांड अपने आप निष्पादित हो जाते हैं, जबकि अवरुद्ध कमांड पुष्टि की प्रतीक्षा करते हैं। Auto-Approve के साथ, Zoo Code असफल अनुरोधों को भी स्वयं दोहराता है: विराम 5 सेकंड से शुरू होता है और प्रत्येक प्रयास के साथ दोगुना हो जाता है, लेकिन 10 मिनट से अधिक नहीं होता है।

स्ट्रीमिंग रिस्पॉन्स। Enable streaming को बंद न करें: स्ट्रीमिंग मोड में गेटवे टेक्स्ट को उत्पन्न होते ही भेज देता है और रिस्पॉन्स को केवल मॉडल की सीमा तक ही सीमित करता है, जबकि बिना स्ट्रीमिंग और बिना स्पष्ट सीमा के अनुरोध रिस्पॉन्स के 1500 टोकन पर कट जाते हैं (GLM-5.3 Flash के मामले में — 3000 पर)।

कोड इंडेक्सिंग। प्रोजेक्ट में सिमेंटिक सर्च (Codebase Indexing) को मॉडल से अलग, एम्बेडिंग प्रदाता के माध्यम से कॉन्फ़िगर किया जाता है; इसके लिए स्थानीय विकल्प Semble - Local उपलब्ध है।

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

गोपनीयता। Zoo Code डेवलपर्स को त्रुटियों और उपयोग के बारे में डेटा भेजता है जो इंस्टॉलेशन पहचानकर्ता से जुड़ा होता है — बिना कोड या प्रॉम्प्ट के; इसे Allow error and usage reporting स्विच (Settings → About Zoo Code) के माध्यम से बंद किया जा सकता है। गेटवे अपनी तरफ से प्रॉम्प्ट और रिस्पॉन्स की सामग्री संग्रहीत नहीं करता है: डैशबोर्ड में केवल अनुरोधों और टोकन के काउंटर दिखाई देते हैं।