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.19 ও তার পরের, ২৪ লাইনে 24.2 ও তার পরের, এবং ২৫ ও ২৬), 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 ফরম্যাট বেছে নেবেন। গেটওয়ে তিনটিই গ্রহণ করে, কেবল বেস ঠিকানা আলাদা:

আমাদের রানে তিনটি ফরম্যাটই সংযোগ পরীক্ষায় উত্তীর্ণ হয়েছে।

তিনটি কমান্ড দেখায় যে সংযোগটি সচল। প্রথমটি প্রোভাইডারদের তালিকা দেখায় — সক্রিয়টি তারকাচিহ্ন দিয়ে চিহ্নিত, কীটি মাস্ক করা:

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 রানে মডেলগুলো কেমন আচরণ করেছে তা দেওয়া হলো (২১ সেপ্টেম্বর ২০২৬-এ যাচাইকৃত):

ব্যবহারিক নিয়ম সহজ। ছোট কাজ ও দ্রুত সম্পাদনার জন্য 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 একটি সিস্টেম প্রম্পট এবং সমস্ত টুলের বিবরণ যোগ করে, তারপর মডেলের সাথে মাল্টি-স্টেপ ডায়ালগ চালায়। আমাদের রান-এ "ফাইলটি পড়ে ভুল খুঁজে বের করো" টাস্কটিতে প্রায় ৪০ হাজার টোকেন খরচ হয়েছে, যার বেশিরভাগই ইনপুট। তাই এখানে টোকেনের দাম খুবই গুরুত্বপূর্ণ।

JoinGonka Gateway-এর মাধ্যমে টোকেনের দাম প্রতি মিলিয়নে ইনপুটে $0.0069 এবং আউটপুটে $0.021—নেটওয়ার্কের সব মডেলের জন্য দাম একই এবং এই পেজে লাইভ সোর্স থেকে দেখানো হয়। সেপ্টেম্বর ২০২৬ অনুযায়ী দামের হিসাব: একবারের ছোট টাস্কের জন্য সেন্টের ভগ্নাংশ, আর ৩-৭ মিলিয়ন টোকেনসহ একদিনের কাজের জন্য কয়েক সেন্ট।

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। তিনটিই একই গেটওয়েতে একই কী দিয়ে কানেক্ট করা যায়।