MiniMax Code: Gonka के माध्यम से अपनी कुंजी पर MiniMax एजेंट

एजेंट के तीन एंट्री पॉइंट हैं, और तीनों BYOK प्रोवाइडर के साथ एक जैसे काम करते हैं:

आधिकारिक इंस्टॉलर ताज़ा वर्शन को ~/.minimax-code में इंस्टॉल करता है, ज़रूरत पड़ने पर उपयुक्त Node.js भी खींच लेता है और एडमिन अधिकारों की माँग नहीं करता:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

अगर Node.js पहले से है (22 लाइन में 22.19 और नया, 24 लाइन में 24.2 और नया, साथ ही 25 और 26), तो npm काम आएगा:

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

लंबा कमांड बेवजह नहीं है: एजेंट को SQLite का नेटिव बिल्ड चाहिए, इसलिए ऑप्शनल डिपेंडेंसीज़ और इंस्टॉल स्क्रिप्ट्स को चालू रहना ज़रूरी है। इंस्टॉल के बाद टर्मिनल फिर से खोलें और जाँचें: mcode --version।

TUI के अंदर Shift+Tab (प्लानिंग मोड), Alt+M (अनुमति मोड बदलना — Ask, Auto और Full access), फ़ाइल का हवाला देने के लिए @ और कमांड की सूची के लिए /help काम आएँगे। रुका हुआ काम mcode --continue आगे बढ़ाता है, और mcode init . प्रोजेक्ट में एजेंट के नियमों वाली AGENTS.md फ़ाइल बनाता है।

उपयोगकर्ता डेटा — config.yaml, सेशन्स, लॉगिन स्थिति — प्रोग्राम से अलग, ~/.minimax डायरेक्टरी में रहता है (नामित प्रोफ़ाइल के लिए — ~/.minimax-<profile>); MINIMAX_DATA_DIR वेरिएबल दूसरी जगह तय करता है।

JoinGonka कुंजी। gate.joingonka.ai/register पर रजिस्टर करें: पता सत्यापित होने के बाद खाते में 3M मुफ़्त टोकन आ जाएँगे। jg- प्रीफ़िक्स वाली कुंजी डैशबोर्ड के "API कुंजियाँ" सेक्शन में बनती है; एजेंट के लिए अलग कुंजी बनाना सुविधाजनक है — उसका ट्रैफ़िक अलग लाइन में दिखेगा।

अगर mcode चल रहा है तो उसे बंद करें और यह चलाएँ:

npx @joingonka/setup --tool minimax-code --model minimax

इंस्टॉलर की अनुरोध करेगा, पिछली config.yaml की एक कॉपी रखेगा, उसमें सिर्फ़ अपना ब्लॉक जोड़ेगा और गेटवे पर एक लाइव रिक्वेस्ट के साथ ख़त्म करेगा: की, पता और मॉडल तुरंत जाँचे जाते हैं, पहले टास्क पर नहीं। ~/.minimax/config.yaml में custom_provider ब्रांच के तहत joingonka प्रोवाइडर दिखेगा — mcode तीसरे पक्ष के endpoint वहीं रखता है:

custom_provider:\n  joingonka:\n    name: JoinGonka\n    kind: custom\n    enabled: true\n    api: openai-completions\n    options:\n      apiKey: jg-your-key\n      baseURL: https://gate.joingonka.ai/v1\n      authMode: api-key\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        name: MiniMax M2.7 (Gonka)\n        limit:\n          context: 200000\n          output: 8192\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        name: DeepSeek V4 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 380000\n          output: 32768\n      zai-org/GLM-5.3-Flash:\n        name: GLM 5.3 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 390000\n          output: 8192\ndefaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

इस ब्लॉक के बारे में जानने लायक बातें:

• API फ़ॉर्मैट साफ़ लिखा है। api फ़ील्ड के बिना mcode प्रोवाइडर को Anthropic-संगत मानता है; इंस्टॉलर openai-completions चुनता है — गेटवे का कैनोनिकल रास्ता।
• हर मॉडल की लिमिट अलग है। अनजान मॉडल को mcode 200,000 का कॉन्टेक्स्ट और 16,384 टोकन का जवाब मान लेता है; नेटवर्क के असली आँकड़े दूसरे हैं, इसलिए तीनों एंट्री पर limit दिया गया है।
• की फ़ाइल में सीधे लिखी है, और फ़ाइल को 600 परमिशन मिलती है। mcode भी की ऐसे ही रखता है: उसका --api-key-env फ़्लैग वेरिएबल पढ़ता है और कॉन्फ़िग में रेफ़रेंस नहीं, वैल्यू लिखता है।
• डिफ़ॉल्ट मॉडल। --model minimax फ़्लैग MiniMax M2.7 सेट करता है। फ़्लैग के बिना इंस्टॉलर कोड एजेंट के लिए DeepSeek V4 Flash चुनता है — उसका कॉन्टेक्स्ट और जवाब की सीमा बड़ी है — और --model glm GLM-5.3 Flash देता है। अगर कॉन्फ़िग में पहले से किसी और प्रोवाइडर का मॉडल चुना है, तो --model के बिना दोबारा चलाने पर वह नहीं छूआ जाएगा।
• प्रोफ़ाइल। नामित प्रोफ़ाइल के लिए इंस्टॉलर एनवायरनमेंट वेरिएबल के साथ चलाएँ, जैसे MINIMAX_DATA_DIR=~/.minimax-work।

इंस्टॉल के दौरान mcode बंद करने की गुज़ारिश औपचारिकता नहीं है: एजेंट अपनी सेव के वक़्त config.yaml को पूरा दोबारा लिखता है और उसके पीछे की गई तब्दीली मिटा सकता है।

यही नतीजा एजेंट की स्टैंडर्ड कमांड भी देती है। की एनवायरनमेंट वेरिएबल से जाती है — आर्ग्युमेंट्स और शेल हिस्ट्री में उसका कोई काम नहीं:

# read the key without echo
read -s JOINGONKA_API_KEY
export JOINGONKA_API_KEY

mcode provider add --name JoinGonka \\\
  --base-url https://gate.joingonka.ai/v1 \\\
  --api-format openai-completions \\\
  --model MiniMaxAI/MiniMax-M2.7 \\\
  --api-key-env JOINGONKA_API_KEY \\\
  --context-limit 200000 --output-limit 8192 --use

--use फ़्लैग पहले सूचीबद्ध मॉडल को लाइव रिक्वेस्ट से जाँचता है और उसके बाद ही प्रोवाइडर सेव करता है और मॉडल को डिफ़ॉल्ट बनाता है; नाकामी पर कुछ भी सेव नहीं होता। कामयाब रन Provider added and selected: JoinGonka लाइन पर ख़त्म होता है। mcode नाम से ही प्रोवाइडर की — joingonka — निकाल लेता है, इसलिए बाद में चलाया गया इंस्टॉलर उसी एंट्री को अपडेट करेगा, दूसरी नहीं बनाएगा।

--context-limit और --output-limit फ़्लैग कमांड में बताए सभी मॉडलों पर लागू होते हैं, और नेटवर्क के मॉडलों की लिमिट अलग-अलग हैं। इसलिए कमांड से एक मॉडल बनाना आसान है और बाक़ी फ़ाइल में लिख देना। mcode बंद करें और इस हिस्से को ~/.minimax/config.yaml में मौजूदा प्रोवाइडर ब्लॉक के साथ जोड़ें:

custom_provider:\n  joingonka:\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        limit: { context: 200000, output: 8192 }\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        limit: { context: 380000, output: 32768 }\n      zai-org/GLM-5.3-Flash:\n        limit: { context: 390000, output: 8192 }

तीसरा तरीक़ा इंटरैक्टिव है: TUI के अंदर /model कमांड मॉडल चुनने का विकल्प खोलती है जिसमें + Add 3rd-party provider… होता है, और /provider सेव किए कनेक्शन मैनेज करता है। मॉडल स्क्रीन पर पता Ctrl+E से ठीक होता है; नाकाम चेक कुछ सेव नहीं करता, ड्राफ़्ट एडिट के लिए रहता है।

कौन-सा API फ़ॉर्मैट चुनें। गेटवे तीनों लेता है, फ़र्क़ सिर्फ़ बेस पते का है:

हमारे रन में कनेक्शन चेक तीनों फ़ॉर्मैट ने पास किया।

तीन कमांड यह दिखाते हैं कि यह जोड़ी काम कर रही है। पहली प्रोवाइडर की सूची दिखाती है — सक्रिय प्रोवाइडर पर तारा लगा होता है, और कुंजी छिपी रहती है:

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

दूसरी एक लाइव अनुरोध भेजती है और सफल होने पर Provider available: custom_provider:joingonka लौटाती है; --model फ़्लैग किसी विशेष मॉडल की जाँच करता है:

mcode provider test custom_provider:joingonka

तीसरी सबसे ज़रूरी चीज़ जाँचती है — फ़ाइलों के साथ काम। अपनी डायरेक्टरी में एक छोटी फ़ाइल रखें जिसमें कोई स्पष्ट बग हो, और उससे उसे ढूँढने को कहें:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

एजेंट को खुद रीडिंग टूल को कॉल करना चाहिए और सारगर्भित जवाब देना चाहिए। हमारे टेस्ट रन में नेटवर्क के तीनों मॉडलों ने ऐसा ही किया; किसी एक रन के लिए दूसरा मॉडल --model custom_provider:joingonka/<model-id> जैसे फ़्लैग से सेट किया जाता है। --output-format json फ़्लैग के साथ जवाब में usage फ़ील्ड आता है जिसमें इनपुट और आउटपुट टोकनों की संख्या होती है — इसे गेटवे के डैशबोर्ड से मिलाना आसान है: «उपयोग» सेक्शन में घंटे और दिन के अनुसार अनुरोध, मॉडल और कुंजी के अनुसार ब्रेकडाउन दिखता है।

अगर जाँच फेल होती है, तो mcode अपने संदेश में सीधे कारण बताता है:

नेटवर्क के सभी मॉडलों की क़ीमत एक ही है, इसलिए चुनाव व्यवहार का है। नीचे — लिमिट और यह कि उसी काम पर हमारे mcode exec रन में मॉडलों ने कैसा व्यवहार किया (21 सितंबर 2026 को मिलान किया गया):

व्यावहारिक नियम सरल है। छोटे कामों और तेज़ बदलावों के लिए MiniMax M2.7 लें: अभी नेटवर्क की सबसे ज़्यादा क्षमता इसी पर है। अगर दिखने वाली रीज़निंग बाधा डाले — जैसे कोई स्क्रिप्ट exec के आउटपुट को पार्स करती हो — या बड़ा रिपॉज़िटरी पढ़कर लंबा बदलाव चाहिए, तो DeepSeek V4 Flash पर स्विच करें। उलझी लॉजिक पर GLM-5.3 Flash बेहतर सोचता है।

स्विच करने के लिए फ़ाइल बदलने की ज़रूरत नहीं: TUI में यह /model कमांड है, एक सेशन के लिए — mcode -m custom_provider:joingonka/<model-id>, एक रन के लिए — उसी मान के साथ mcode exec --model। स्थायी चुनाव defaultModel पंक्ति में रखा जाता है। नेटवर्क की संरचना समय के साथ बदलती है; लिमिट के साथ ताज़ा सूची हमेशा GET https://gate.joingonka.ai/v1/models लौटाता है।

एजेंट टूल्स चैट की तुलना में टोकन का उपयोग अलग तरह से करते हैं: प्रत्येक वाक्यांश के साथ mcode सिस्टम प्रॉम्प्ट और सभी टूल्स के विवरण जोड़ता है, और फिर मॉडल के साथ बहु-चरणीय संवाद करता है। हमारे रन में "फ़ाइल पढ़ें और त्रुटि ढूँढें" कार्य में लगभग 40 हजार टोकन खर्च हुए, और लगभग सारा डेटा इनपुट था। इसीलिए यहाँ टोकन की कीमत मायने रखती है।

JoinGonka Gateway के माध्यम से टोकन की कीमत इनपुट पर $0.0069 प्रति मिलियन और आउटपुट पर $0.021 प्रति मिलियन है — कीमत नेटवर्क के सभी मॉडल्स के लिए समान है और इस पेज पर लाइव स्रोत से ली जाती है। सितंबर 2026 के लिए कीमतों का स्तर: एक बार का कार्य — सेंट का सौवां हिस्सा, 3-7 मिलियन टोकन पर सक्रिय काम का एक दिन — कुछ सेंट।

BYOK क्या कवर करता है। अपना प्रदाता मॉडल के अनुरोधों को संभालता है: कोड पढ़ना और सुधारना, कमांड्स, सब-एजेंट, सत्र। इन-बिल्ट सर्च, मीडिया-टूल्स mcode-tools और प्रबंधित कनेक्टर वेंडर की अपनी सेवाएं हैं, उन्हें अकाउंट लॉगिन और क्रेडिट की आवश्यकता होती है। अपने टूल्स इससे स्वतंत्र रूप से, प्रोजेक्ट की .mcp.json फ़ाइल में MCP-सर्वरों के माध्यम से जुड़ते हैं।

अनुमतियाँ। TUI में Ask, Auto और Full access मोड Alt+M या /permission कमांड से स्विच होते हैं; mcode exec के लिए इसके लिए --permission फ्लैग जिम्मेदार है।

टेलीमेट्री। mcode में सांख्यिकी, मेट्रिक्स और डायग्नोस्टिक्स चैनल डिफ़ॉल्ट रूप से बंद होते हैं और उन्हें अलग से चालू किया जा सकता है; MCODE_DISABLE_TELEMETRY और DO_NOT_TRACK वेरिएबल उन्हें एक साथ बंद कर देते हैं। गेटवे, अपनी ओर से, प्रॉम्प्ट और उत्तरों की सामग्री को संग्रहीत नहीं करता है — सांख्यिकी में केवल खपत के एग्रीगेट्स रहते हैं।

यदि आपको चित्रों के साथ काम करने की आवश्यकता है — इंटरफ़ेस का स्क्रीनशॉट, मॉकअप — तो पास में विज़न क्षमता वाले मॉडल के साथ दूसरा प्रदाता सेट करें, जोड़ते समय --support-image फ्लैग निर्दिष्ट करें: Gonka नेटवर्क के मॉडल टेक्स्ट-आधारित हैं, और mcode में कई प्रदाता हो सकते हैं।

लैब के अपने एजेंट नेटवर्क के तीनों मॉडल परिवारों के लिए उपलब्ध हैं: MiniMax Code के साथ DeepSeek Harness और GLM के लेखकों Z.ai का ZCode है। तीनों एक ही कुंजी के साथ एक ही गेटवे से जुड़ते हैं।