Zoo Code + JoinGonka Gateway: paglipat mula sa Roo Code patungo sa Gonka models

Hakbang 1: i-install ang extension. Sa VS Code, buksan ang panel ng extensions (Ctrl+Shift+X, sa macOS Cmd+Shift+X), hanapin ang «Zoo Code» at i-install ang extension ng publisher na Zoo Code Organization. Isang command din ito:

code --install-extension ZooCodeOrganization.zoo-code

Kailangan ng VS Code 1.100 o mas bago — iyon ang nakasaad sa manifest ng extension; para sa VSCodium, Windsurf at iba pang editor na walang Marketplace, na-publish ang extension sa Open VSX. Bukod sa stable channel (3.82.2 mula Setyembre 18, 2026) may preliminary 3.83.x — nightly builds ng pangunahing branch; gamitin ang stable para sa trabaho. Pagkatapos ng pag-install, lalabas ang icon ng Zoo Code sa activity bar.

Hakbang 2: kumuha ng key. Magrehistro sa gate.joingonka.ai/register, kumpirmahin ang address at gumawa ng key na may prefix na jg- sa seksyong «Mga API key». Maginhawang gumawa ng hiwalay na key para sa Zoo Code: makikita ang gastos nito sa statistics sa hiwalay na linya.

Hakbang 3: patakbuhin ang installer.

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

Tatanungin ng installer ang key — hindi ito ipinapasa sa command-line arguments para hindi ito manatili sa history ng shell. Wala siyang isusulat: itinatago ng Zoo Code ang mga profile ng provider kasama ang mga key sa secure na secret storage ng VS Code, hindi sa file. Kaya nagpi-print ang installer ng mga ready na value para sa form at ang tunay na limitasyon ng napiling modelo:

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.

Kasunod ang resulta ng live na kahilingan sa gateway — kapag nagtagumpay, ang linyang ✓ Verified: the gateway accepted the key, base URL and model. Na-verify agad ang key, address at modelo, hindi sa unang gawain. Buo ang key sa na-print na block para madaling kopyahin — huwag i-publish ang output na ito.

Kung walang --model flag, ilalagay ng installer ang MiniMax M2.7: kung saan manu-manong pumipili ng modelo, iminumungkahi nito ang modelong may pinakamalaking kapasidad sa network. Para sa Zoo Code, inirerekomenda naming magsimula sa DeepSeek V4 Flash: sa aming pagsusuri, natapos nito ang hakbang pagkatapos ng resulta ng tool sa unang kahilingan — nasa seksyon tungkol sa pagsusuri ang mga detalye; tumatanggap din ang flag ng mga daglat na glm (GLM-5.3 Flash) at minimax. Kung walang --tool flag, magpapakita ang installer ng menu ng 25 tools.

Isang detalye sa form: walang hiwalay na block na may pamagat na Model Configuration sa Zoo Code 3.82.2. Nasa parehong form sa ibaba ang mga field ng limitasyon, sa ilalim ng paliwanag na «Configure the capabilities and pricing for your custom OpenAI-compatible model», at nauuna ang Max Output Tokens sa Context Window Size.

Sa unang pagtakbo, ang Zoo Code ay nagpapakita ng pagbati na may button na Choose your provider: ito ay patungo sa isang form kung saan ang OpenRouter ay awtomatikong napili — palitan ang provider sa OpenAI Compatible at sa dulo ay i-click ang Finish. Sa susunod, ang parehong form ay mabubuksan sa pamamagitan ng gear icon sa header ng Zoo Code panel, sa ilalim ng section na Providers; ang mga pagbabago ay mase-save gamit ang button na Save.

Mga limitasyon ng mga model ng network:

Ang ibang settings ay hindi na kailangang galawin: iwanang naka-on ang Enable streaming at Include max output tokens, at iwanang naka-off ang Enable R1 model parameters at Use Azure (ito ay mga marka para sa mga model ng pamilyang R1 at para sa Azure OpenAI), at iwanang bakante ang mga field na Custom Headers at Extra Body.

Ang mga limitasyon ay naka-imbak sa profile, hindi sa mismong model: kung papalitan mo ang Model sa parehong profile, mananatiling pareho ang window at output limit. Kaya mas maginhawang gumawa ng sariling profile para sa bawat model — tatalakayin ito sa susunod na section.

Ang Zoo Code ay nagmula sa code base ng Roo Code, kaya ang paglipat ay tumatagal lamang ng ilang minuto, at hindi mo na kailangang galawin ang mga file ng proyekto. Ang opisyal na migration guide ay naglalarawan ng pag-export ng mga setting at pag-import; ang iba ay inililipat gamit ang isang hiwalay na button o binabasa mula sa mga lumang path:

Ang profile ng Roo Code na nakatutok na sa JoinGonka Gateway ay lilipat kasama ang address, key, model, at mga limit — i-verify lamang kung ang model ay nasa network ngayon: ang listahan ay ibinibigay ng GET https://gate.joingonka.ai/v1/models.

Mga Mode at profile. Mayroong limang built-in na mode: Code, Debug, Architect (nag-e-edit lang ng mga Markdown file), Ask (sumasagot nang walang pagbabago), at Orchestrator (nagbibigay ng subtask sa ibang mga mode). Maaari silang ilipat gamit ang listahan sa tabi ng input field, sa pamamagitan ng command na may pangalan ng mode sa simula ng mensahe, halimbawa /architect, o sa pamamagitan ng shortcut na Ctrl+. (Cmd+. sa macOS). Tandaan ng bawat mode ang profile na huli mong ginamit dito, at kapag nagpalit ng mode, awtomatikong ililipat ng Zoo Code ang profile.

Mula rito ay isang maginhawang scheme: bawat profile ay nakatali sa isang model na nakatalaga sa mga mode. Sa Settings → Providers, pindutin ang "+" sa tabi ng field na Configuration Profile, pangalanan ang profile, halimbawa Gonka DeepSeek, at punan ang form; ulitin ito para sa GLM-5.3 Flash at MiniMax M2.7 — ang address at key ay pare-pareho para sa lahat. Pagkatapos, sa bawat mode, piliin ang profile sa listahan ng mga profile malapit sa input field, at matatandaan ito ng mode. Ang icon ng padlock sa listahang ito, sa kabilang banda, ay nagtatakda ng iisang profile para sa lahat ng mode ng working folder.

Antas ng reasoning. Ang checkbox na Enable Reasoning Effort sa form ay nagbubukas ng listahan ng Low, Medium, High, Extra High, at Max; hangga't ito ay naka-off, ang antas ay hindi isasama sa request. Sa GLM-5.3 Flash, ang switch ay binary sa esensya: ang Low ay nag-o-off ng reasoning, anumang ibang antas ay iniiwan itong ganap — maginhawang magpanatili ng hiwalay na GLM profile na may Low para sa mga mabilisang tanong. Higit pang detalye sa GLM-5.3 Flash overview. Sa DeepSeek V4 Flash at MiniMax M2.7, hindi nire-rewrite ng gateway ang scale: kung paano gagana ang antas ay depende sa mismong model.

Buksan ang folder na may maliit na file kung saan may halatang error, halimbawa calc.py na may function para sa addition na nagsu-subtract, at sa mode na Code ay isulat: "Basahin ang calc.py at sabihin sa isang pangungusap kung may error ito." Hihingi ang Zoo Code ng pahintulot na basahin ang file — "Zoo wants to read this file", may mga button na Approve at Deny kung hindi pa pinapayagan ang pagbabasa nang maaga sa Auto-Approve. Pagkatapos, tatawagin ng model ang tool para sa pagkumpleto (completion tool), at matatapos ang gawain sa block na Task Completed na may kasamang sagot; ang mga reasoning, kung mayroon, ay ipapakita sa hiwalay na block na Thinking. Ang porsyento ng pagpuno sa context sa collapse na header ng gawain ay kinakalkula mula sa Context Window Size — isa pang dahilan upang itakda ito nang tama.

Ang prosesong ito ay ginaya namin sa pamamagitan ng request ayon sa pattern ng Zoo Code — stream, tools sa isang mahigpit na scheme, at sa history ay may resulta ng read_file. Ang DeepSeek V4 Flash ay sumagot gamit ang native call na attempt_completion na may tamang konklusyon: ang function ay nagsu-subtract sa halip na mag-add. Ang ikalawang bahagi ng pagsusuri ay ang gateway dashboard: sa seksyong "Usage", lalabas ang request na naka-breakdown ayon sa mga model, at ang key ay mag-a-update ng oras ng huling pag-access.

Kung walang Auto-Approve, ang error ay darating bilang block na API Request Failed na may mga button na Retry at Start New Task, kasama ang header na Provider Error na may code at countdown hanggang sa pag-retry. Ang text ng sagot ng gateway ay makikita sa mensahe o sa mga detalye nito:

Ang agent ay gumagastos ng tokens nang iba kaysa sa chat. Sa bawat request, inilalagay ng Zoo Code ang system prompt na may mga rule ng mode, description ng tools, at impormasyon tungkol sa working folder — libu-libong tokens na ito bago pa man ang iyong tanong — at ang task ay karaniwang tumatagal ng ilang hakbang. Kaya naman ang presyo bawat token dito ang nagdidikta.

Sa pamamagitan ng JoinGonka Gateway, ang tokens ay nagkakahalaga ng $0.0069 bawat milyon sa input at $0.021 bawat milyon sa output — ang presyo ay pare-pareho para sa lahat ng models sa network at kinukuha sa pahinang ito mula sa live source. Ang order ng halaga base sa presyo noong Setyembre 2026:

Para sa paghahambing — kung paano ka ba talaga makakapagbayad para sa models sa Zoo Code:

Dahil sa napunong Input Price at Output Price, makikita ang halaga ng task sa header nito, ngunit sa accuracy na hanggang sentimo — ang mga maikling task sa models ng network ay magpapakita ng $0.00 doon. Ang eksaktong gastos at natitirang balanse ay nasa dashboard, sa mga seksyong "Usage" at "Billing".

Mga kumpirmasyon at awtonomiya. Sa default, naka-off ang Auto-Approve, at humihingi ang Zoo Code ng permiso para sa pagbabasa, pagsusulat, at mga command; para sa mahahabang gawain, i-enable ang mga kailangang kategorya sa menu ng Auto-approve sa tabi ng input field. Para sa mga command, mayroong Destructive Command Guard (Settings → Auto-Approve): dina-download ng extension ang executable file nito, at pagkatapos nito, ang mga command na na-approve nito ay kusang gumagana, habang ang mga naka-block ay naghihintay ng kumpirmasyon. Sa Auto-Approve, kusa ring inuulit ng Zoo Code ang mga failed request: ang pause ay nagsisimula sa 5 segundo at nadodoble sa bawat subok, ngunit hindi hihigit sa 10 minuto.

Streaming response. Huwag i-off ang Enable streaming: sa stream, ibinibigay ng gateway ang teksto habang ginagawa ito at nililimitahan ang response hanggang sa limitasyon lang ng modelo, habang ang request na walang stream at walang malinaw na limitasyon ay pinuputol sa 1500 response tokens (sa GLM-5.3 Flash — sa 3000).

Code indexing. Ang semantic search sa project (Codebase Indexing) ay hiwalay na na-a-adjust mula sa modelo, sa pamamagitan ng embeddings provider; para dito, mayroong lokal na opsyon na Semble - Local.

Mga imahe. Ang mga modelo ng network ay text-based. Para sa mga screenshot at layout, gumawa ng hiwalay na profile na may modelong kayang magtrabaho sa mga imahe, at lumipat dito habang ginagawa ang ganoong gawain.

Privacy. Nagpapadala ang Zoo Code sa mga developer ng data tungkol sa mga error at usage na nakatali sa installation ID — nang walang code at prompts; maaari itong i-disable gamit ang switch na Allow error and usage reporting sa Settings → About Zoo Code. Ang gateway sa bahagi nito ay hindi nag-iimbak ng nilalaman ng mga prompt at response: sa dashboard, makikita lang ang mga counter ng request at token.