MiniMax Code: MiniMax agent gamit ang sariling key via Gonka

Tatlo ang entry point ng agent, at ang tatlo ay pareho ang paggana sa BYOK provider:

Inilalagay ng opisyal na installer ang pinakabagong bersyon sa ~/.minimax-code, hinihila ang angkop na Node.js kung kailangan, at hindi nangangailangan ng admin rights:

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

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

Kung may Node.js na (22.19 at mas bago sa 22 line, 24.2 at mas bago sa 24 line, pati 25 at 26), gagana ang 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

Hindi sinasadya ang mahabang command: kailangan ng agent ang native build ng SQLite, kaya dapat manatiling bukas ang mga opsyonal na dependency at install script. Pagkatapos ng install, buksan muli ang terminal at suriin: mcode --version.

Sa loob ng TUI, makakatulong ang Shift+Tab (planning mode), Alt+M (pagpalit ng permission mode — Ask, Auto, at Full access), @ para sumangguni sa file, at /help na may listahan ng command. Ang naputol na trabaho ay ipinagpapatuloy ng mcode --continue, at ang mcode init . ay gumagawa ng file na AGENTS.md sa project na may mga patakaran para sa agent.

Ang user data — config.yaml, mga session, estado ng login — ay hiwalay sa program, sa direktoryong ~/.minimax (para sa named profile — ~/.minimax-<profile>); ang MINIMAX_DATA_DIR variable ay nagtatakda ng ibang lokasyon.

JoinGonka key. Magrehistro sa gate.joingonka.ai/register: pagkatapos makumpirma ang address, makakatanggap ang account ng 3M libreng token. Ang key na may prefix na jg- ay ginagawa sa dashboard, sa seksyong "Mga API key"; maginhawang gumawa ng hiwalay para sa agent — makikita ang trapiko nito sa hiwalay na linya.

Isara ang mcode kung ito ay tumatakbo, at patakbuhin ang:

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

Tatanungin ng installer ang key, magse-save ng kopya ng dating config.yaml, idadagdag lamang dito ang sarili nitong block, at magtatapos sa isang live na request sa gateway: ang key, address, at model ay agad na sinusuri, hindi sa unang gawain. Sa ~/.minimax/config.yaml lalabas ang provider na joingonka sa branch na custom_provider — diyan mismo itinatago ng mcode ang mga third-party 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

Mga dapat mong malaman tungkol sa block na ito:

• Malinaw na nakasaad ang API format. Kung walang field na api, itinuturing ng mcode na Anthropic-compatible ang provider; pinipili ng installer ang openai-completions — ang canonical na ruta ng gateway.
• May sariling limit ang bawat model. Sa hindi pamilyar na model, naglalagay ang mcode ng 200,000 na window at 16,384 na token na sagot; iba ang tunay na halaga sa network, kaya't ang limit ay itinakda sa lahat ng tatlong entry.
• Literal na nakaimbak ang key sa file, at ang file mismo ay nakakakuha ng 600 na pahintulot. Ganoon din ang pag-iimbak ng key ng mcode: binabasa ng flag nitong --api-key-env ang variable at isinusulat sa config ang halaga, hindi ang reference.
• Default na model. Ang flag na --model minimax ay nagtatakda ng MiniMax M2.7. Kung walang flag, pinipili ng installer para sa mga code agent ang DeepSeek V4 Flash — mas malaki ang window at response ceiling nito, — at ang --model glm ay nagbibigay ng GLM-5.3 Flash. Kung may napiling model ng ibang provider sa config, hindi ito gagalawin ng muling pagpapatakbo nang walang --model.
• Mga profile. Para sa pinangalanang profile, patakbuhin ang installer na may environment variable, halimbawa MINIMAX_DATA_DIR=~/.minimax-work.

Ang kahilingang isara ang mcode habang nag-i-install ay hindi pormalidad: ganap na nirerewrite ng agent ang config.yaml tuwing nagse-save ito at maaaring matakpan ang pagbabagong ginawa sa likod nito.

Pareho ring resulta ang ibinibigay ng standard na command ng agent. Ang key ay ipinapasa sa pamamagitan ng environment variable — wala itong dapat gawin sa mga argumento at kasaysayan ng shell:

# 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

Ang flag na --use ay sinusuri muna ang una sa mga nakalistang model gamit ang live na request, at pagkatapos lamang nito sine-save ang provider at ginagawang default na model ang model; kung mabigo, walang nase-save. Ang matagumpay na pagpapatakbo ay nagtatapos sa linyang Provider added and selected: JoinGonka. Mula sa pangalan, awtomatikong hinihinuha ng mcode ang provider key — joingonka, — kaya't ang installer na patakbuhin mamaya ay mag-a-update ng parehong entry, hindi gagawa ng pangalawa.

Ang mga flag na --context-limit at --output-limit ay may bisa sa lahat ng model na nakalista sa command, ngunit magkakaiba ang limit ng mga model sa network. Kaya't maginhawang mag-set up ng isang model gamit ang command, at idagdag na lang sa file ang iba pa. Isara ang mcode at pagsamahin ang fragment na ito sa umiiral nang provider block sa ~/.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 }

Ang ikatlong paraan ay interactive: sa loob ng TUI, binubuksan ng command na /model ang pagpili ng model na may item na + Add 3rd-party provider…, at ang /provider ay namamahala sa mga naka-save na koneksyon. Ang address sa screen ng model ay ine-edit sa Ctrl+E; ang nabigong pagsusuri ay walang iniimbak, nananatili ang draft para sa pag-edit.

Anong API format ang pipiliin. Tinatanggap ng gateway ang lahat ng tatlo, ang base address lamang ang nagkakaiba:

Sa aming pagpapatakbo, lahat ng tatlong format ay nakapasa sa pagsusuri ng koneksyon.

Ipinapakita ng tatlong command na buhay ang koneksyon. Ang una ay naglilista ng mga provider — may tala ang aktibo, nakatago ang key:

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

Ang pangalawa ay gumagawa ng live na request at kapag nagtagumpay ay sumasagot ng Provider available: custom_provider:joingonka; sinusuri ng --model flag ang isang partikular na modelo:

mcode provider test custom_provider:joingonka

Sinusuri ng pangatlo ang pinakamahalaga — ang paggawa sa mga file. Maglagay ng maliit na file na may malinaw na bug sa direktoryo at ipahanap ito:

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

Dapat mismo tawagin ng agent ang reading tool at sumagot nang tumpak. Sa aming test run, ganoon ang ginawa ng lahat ng tatlong modelo ng network; para sa isang run, ang ibang modelo ay itinakda ng flag na tulad ng --model custom_provider:joingonka/<model-id>. Sa --output-format json flag, may lumalabas na usage field sa sagot na may bilang ng input at output tokens — madaling ihambing ito sa dashboard ng gateway: sa seksyong «Paggamit» makikita ang mga request kada oras at araw, pati ang breakdown ayon sa modelo at key.

Kung hindi pumasa ang check, direktang sinasabi ng mcode ang dahilan sa mensahe nito:

Isang presyo lang ang lahat ng modelo ng network, kaya ang pagpili ay tungkol sa pag-uugali. Nasa ibaba ang mga limit at kung paano kumilos ang mga modelo sa aming pagtakbo ng mcode exec sa parehong gawain (na-verify noong Setyembre 21, 2026):

Simple lang ang praktikal na tuntunin. Para sa maiikling gawain at mabilis na pag-edit, gamitin ang MiniMax M2.7: ngayon, ito ang may pinakamalaking bahagi ng kapasidad ng network. Kung nakakasagabal ang nakikitang reasoning — halimbawa, sinusuri ng script ang exec output — o kailangang basahin ang malaking repository at makakuha ng mahabang edit, lumipat sa DeepSeek V4 Flash. Sa masalimuot na logic, mas mahusay mag-isip ang GLM-5.3 Flash.

Ang paglipat ay hindi nangangailangan ng pag-edit ng file: sa TUI ito ay /model command, para sa isang session — mcode -m custom_provider:joingonka/<model-id>, para sa isang run — mcode exec --model na may parehong value. Ang permanenteng pagpili ay nakaimbak sa defaultModel line. Nagbabago ang komposisyon ng network sa paglipas ng panahon; ang aktwal na listahan na may mga limit ay laging ibinibigay ng GET https://gate.joingonka.ai/v1/models.

Ang mga tool na agentic ay gumagamit ng tokens nang iba kaysa sa chat: sa bawat parirala mo, nagdaragdag ang mcode ng system prompt at deskripsyon ng lahat ng tool, at pagkatapos ay nagsasagawa ng multi-step na dialogue sa modelo. Sa aming test run, ang gawaing "basahin ang file at hanapin ang error" ay umabot ng humigit-kumulang 40 libong tokens, at halos lahat ng ito ay input. Kaya ang presyo bawat token ay mahalaga rito.

Sa pamamagitan ng JoinGonka Gateway, ang mga token ay nagkakahalaga ng $0.0069 bawat milyon para sa input at $0.021 bawat milyon para sa output — ang presyo ay pareho para sa lahat ng modelo sa network at kinukuha sa pahinang ito mula sa live source. Ang magnitude ng mga presyo noong Setyembre 2026: ang isang simpleng task ay nagkakahalaga ng maliit na bahagi ng isang sentimo, ang isang araw ng aktibong pagtatrabaho sa 3-7 milyong tokens ay nagkakahalaga ng ilang sentimo.

Ano ang sakop ng BYOK. Ang sariling provider ang nagse-serve ng mga request sa modelo: pagbabasa at pag-edit ng code, mga command, sub-agents, at sessions. Ang built-in search, mcode-tools media tools, at managed connectors ay mga serbisyo mismo ng vendor, kaya kailangan nila ng login at credits. Ang sarili mong mga tool ay konektado nang hiwalay, sa pamamagitan ng MCP-servers sa loob ng .mcp.json file ng proyekto.

Mga Pahintulot (Permissions). Sa TUI, ang mga mode na Ask, Auto, at Full access ay mapapalitan gamit ang Alt+M o ang command na /permission; para sa mcode exec, ito ay kontrolado ng flag na --permission.

Telemetry. Ang mga channel para sa statistics, metrics, at diagnostics sa mcode ay naka-off by default at kailangang i-activate nang hiwalay; ang mga variable na MCODE_DISABLE_TELEMETRY at DO_NOT_TRACK ay mag-o-off sa lahat ng ito nang sabay-sabay. Ang gateway, sa panig nito, ay hindi nagtatabi ng content ng mga prompt at response — sa statistics, tanging ang aggregate ng konsumo lamang ang natitira.

Kung kailangan ng pagtatrabaho sa mga larawan — screenshot ng interface, mockup — mag-set up ng pangalawang provider sa tabi nito gamit ang isang modelo na may kakayahang tumingin (vision), at ilagay ang flag na --support-image habang idinaragdag ito: ang mga modelo sa network ng Gonka ay text-based, at maaaring magkaroon ng maraming provider sa mcode.

Ang mga agent mula sa mismong mga laboratoryo ay available sa lahat ng tatlong pamilya ng modelo sa network: sa tabi ng MiniMax Code ay ang DeepSeek Harness at ZCode mula sa Z.ai, ang mga author ng GLM. Lahat ng tatlo ay kumokonekta sa parehong gateway gamit ang iisang key.