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:
  joingonka:
    name: JoinGonka
    kind: custom
    enabled: true
    api: openai-completions
    options:
      apiKey: jg-your-key
      baseURL: https://gate.joingonka.ai/v1
      authMode: api-key
    models:
      MiniMaxAI/MiniMax-M2.7:
        name: MiniMax M2.7 (Gonka)
        limit:
          context: 200000
          output: 8192
      deepseek-ai/DeepSeek-V4-Flash-0731:
        name: DeepSeek V4 Flash (Gonka)
        reasoning: true
        limit:
          context: 380000
          output: 32768
      zai-org/GLM-5.3-Flash:
        name: GLM 5.3 Flash (Gonka)
        reasoning: true
        limit:
          context: 390000
          output: 8192
defaultModel: 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:
  joingonka:
    models:
      MiniMaxAI/MiniMax-M2.7:
        limit: { context: 200000, output: 8192 }
      deepseek-ai/DeepSeek-V4-Flash-0731:
        limit: { context: 380000, output: 32768 }
      zai-org/GLM-5.3-Flash:
        limit: { context: 390000, output: 8192 }

تیسرا طریقہ انٹرایکٹو ہے: TUI کے اندر /model کمانڈ ماڈل کے انتخاب کو کھولتی ہے جس میں + Add 3rd-party provider… آئٹم ہوتا ہے، جبکہ /provider محفوظ کنکشنز کا انتظام کرتا ہے۔ ماڈل اسکرین پر پتہ Ctrl+E سے درست کیا جاتا ہے؛ ناکام جانچ کچھ محفوظ نہیں کرتی، ڈرافٹ ترمیم کے لیے موجود رہتا ہے۔

کون سا API فارمیٹ منتخب کریں۔ گیٹ وے تینوں قبول کرتا ہے، فرق صرف بیس پتے کا ہے:

ہماری رن میں تینوں فارمیٹس کنکشن ٹیسٹ میں کامیاب رہے۔

تین کمانڈز ثابت کرتی ہیں کہ یہ جوڑ کام کر رہا ہے۔ پہلی پرووائیڈرز کی فہرست دکھاتی ہے — فعال پرووائیڈر ستارے سے نشان زد ہے، اور کلید masked ہے:

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

دوسری ایک لائیو درخواست بھیجتی ہے اور کامیابی پر Provider available: custom_provider:joingonka کے ساتھ جواب دیتی ہے؛ --model فلیگ کسی مخصوص ماڈل کی جانچ کرتا ہے:

mcode provider test custom_provider:joingonka

تیسری سب سے اہم چیز کی جانچ کرتی ہے — فائلوں کے ساتھ کام۔ ڈائریکٹری میں ایک چھوٹی سی فائل رکھیں جس میں واضح bug ہو اور اسے ڈھونڈنے کو کہیں:

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 لیں: اب نیٹ ورک کی سب سے زیادہ گنجائش اسی پر ہے۔ اگر نظر آنے والی reasoning رکاوٹ ہو — مثلاً اسکرپٹ 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 اور Z.ai (GLM کے خالقین) کا ZCode موجود ہے۔ تینوں ایک ہی گیٹ وے سے ایک ہی کلید کے ذریعے جڑتے ہیں۔