Zoo Code + JoinGonka Gateway: переїзд з Roo Code на моделі Gonka

Крок 1: встановити розширення. У VS Code відкрийте панель розширень (Ctrl+Shift+X, на macOS Cmd+Shift+X), знайдіть «Zoo Code» і встановіть розширення від видавця Zoo Code Organization. Те саме однією командою:

code --install-extension ZooCodeOrganization.zoo-code

Потрібен VS Code 1.100 або новіший — так зазначено в маніфесті розширення; для VSCodium, Windsurf та інших редакторів без Marketplace розширення опубліковано в Open VSX. Крім стабільного каналу (3.82.2 від 18 вересня 2026) є попередній 3.83.x — нічні збірки основної гілки; для роботи беріть стабільний. Після встановлення на панелі дій з'явиться значок Zoo Code.

Крок 2: отримати ключ. Зареєструйтеся на gate.joingonka.ai/register, підтвердьте адресу та створіть ключ із префіксом jg- у розділі «API-ключі». Зручно завести для Zoo Code окремий ключ: його витрати буде видно в статистиці окремим рядком.

Крок 3: запустити інсталятор.

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

Інсталятор запитає ключ — в аргументах командного рядка він не передається, щоб не осісти в історії оболонки. Записувати йому нічого: профілі провайдерів разом із ключами Zoo Code тримає в захищеному сховищі секретів VS Code, а не у файлі. Тому інсталятор друкує готові значення для форми та реальні ліміти вибраної моделі:

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.

Далі йде підсумок живого запиту до шлюзу — у разі успіху рядок ✓ Verified: the gateway accepted the key, base URL and model. Ключ, адресу та модель перевірено одразу, а не на першому завданні. Ключ у надрукованому блоці стоїть повністю, щоб його було зручно скопіювати, — не публікуйте цей вивід.

Без прапорця --model інсталятор підставить MiniMax M2.7: там, де модель вибирають вручну, він пропонує модель із найбільшою ємністю в мережі. Для Zoo Code радимо почати з DeepSeek V4 Flash: у нашій перевірці хід після результату інструмента вона завершила з першого запиту — подробиці в розділі про перевірку; прапорець приймає й скорочення glm (GLM-5.3 Flash) та minimax. Без прапорця --tool інсталятор покаже меню з 25 інструментів.

Одна деталь форми: окремого блоку із заголовком Model Configuration у Zoo Code 3.82.2 немає. Поля лімітів стоять у тій самій формі нижче, під поясненням «Configure the capabilities and pricing for your custom OpenAI-compatible model», причому Max Output Tokens іде раніше за Context Window Size.

При першому запуску Zoo Code показує привітання з кнопкою Choose your provider: вона веде до форми, де заздалегідь вибрано OpenRouter, — змініть провайдера на OpenAI Compatible і в кінці натисніть Finish. Пізніше та ж форма відкривається значком шестерні в заголовку панелі Zoo Code, розділ Providers; зміни зберігає кнопка Save.

Ліміти моделей мережі:

Решту можна не чіпати: Enable streaming та Include max output tokens залиште увімкненими, Enable R1 model parameters та Use Azure — вимкненими (це позначки для моделей сімейства R1 та для Azure OpenAI), поля Custom Headers та Extra Body — порожніми.

Ліміти зберігаються у профілі, а не при моделі: якщо в тому ж профілі змінити Model, вікно та стеля відповіді залишаться колишніми. Тому під кожну модель зручніше завести свій профіль — про це наступний розділ.

Zoo Code виріс із кодової бази Roo Code, тому переїзд займає кілька хвилин, а файли проєкту чіпати не доведеться. Офіційний посібник з міграції описує експорт налаштувань та імпорт; решта переноситься окремою кнопкою або читається за старими шляхами:

Профіль Roo Code, який вже дивився на JoinGonka Gateway, переїде з адресою, ключем, моделлю та лімітами — перевірте лише, що модель є в мережі зараз: список віддає GET https://gate.joingonka.ai/v1/models.

Режими та профілі. Вбудованих режимів п'ять: Code, Debug, Architect (править тільки Markdown-файли), Ask (відповідає без правок) та Orchestrator (роздає підзавдання іншим режимам). Перемикаються вони списком біля поля введення, командою з іменем режиму на початку повідомлення, наприклад /architect, або поєднанням Ctrl+. (Cmd+. на macOS). Кожен режим запам'ятовує профіль, з яким ви працювали в ньому останнім, і при зміні режиму Zoo Code сам перемикає профіль.

Звідси зручна схема: по профілю на модель, закріпленому за режимами. У Settings → Providers натисніть «+» поруч із полем Configuration Profile, назвіть профіль, наприклад Gonka DeepSeek, і заповніть форму; повторіть для GLM-5.3 Flash та MiniMax M2.7 — адреса і ключ у всіх одні. Потім у кожному режимі виберіть профіль у списку профілів біля поля введення, і режим його запам'ятає. Значок замка в цьому списку, навпаки, закріплює один профіль за всіма режимами робочої папки.

Рівень розмірковування. Позначка Enable Reasoning Effort у формі відкриває список Low, Medium, High, Extra High та Max; поки вона вимкнена, рівень у запит не потрапляє. У GLM-5.3 Flash перемикач по суті двійковий: Low вимикає розмірковування, будь-який інший рівень залишає його повним — зручно тримати окремий профіль GLM з Low для швидких питань. Докладніше — в огляді GLM-5.3 Flash. У DeepSeek V4 Flash та MiniMax M2.7 шлюз шкалу не переписує: як спрацює рівень, залежить від самої моделі.

Відкрийте папку з невеликим файлом, де є очевидна помилка, наприклад calc.py з функцією додавання, яка віднімає, і в режимі Code напишіть: «Прочитай calc.py і скажи однією фразою, чи є в ньому помилка». Zoo Code попросить дозволу прочитати файл — «Zoo wants to read this file», кнопки Approve і Deny, якщо читання не дозволено заздалегідь в Auto-Approve. Потім модель викличе інструмент завершення, і завдання закінчиться блоком Task Completed з відповіддю по суті; міркування, якщо вони є, показуються окремим блоком Thinking. Відсоток заповнення контексту в згорнутому заголовку завдання рахується від Context Window Size — ще одна причина задати його правильно.

Цей хід ми відтворили запитом за зразком Zoo Code — потік, інструменти в суворій схемі, в історії результат read_file. DeepSeek V4 Flash відповіла нативним викликом attempt_completion з правильним висновком: функція віднімає замість додавання. Друга половина перевірки — кабінет шлюзу: у розділі «Використання» запит з'явиться в розбивці за моделями, а у ключа оновиться час останнього звернення.

Без Auto-Approve помилка приходить блоком API Request Failed з кнопками Retry і Start New Task, з ним — заголовком Provider Error з кодом і відліком до повтору. Текст відповіді шлюзу видно в повідомленні або в його деталях:

Агент витрачає токени інакше, ніж чат. У кожен запит Zoo Code кладе системний промпт з правилами режиму, описи інструментів і відомості про робочу папку — це тисячі токенів ще до вашого запитання, — а завдання зазвичай займає кілька ходів. Тому ціна за токен тут вирішує.

Через JoinGonka Gateway токени коштують $0.0069 за мільйон на вході та $0.021 за мільйон на виході — ціна однакова для всіх моделей мережі і підставляється на цій сторінці з живого джерела. Порядок сум за цінами на вересень 2026:

Для порівняння — як взагалі можна платити за моделі в Zoo Code:

Із заповненими Input Price та Output Price вартість завдання видно в його заголовку, але з точністю до цента — короткі завдання на моделях мережі покажуть там $0.00. Точна витрата і залишок — в кабінеті, у розділах «Використання» та «Білінг».

Підтвердження та автономність. За замовчуванням Auto-Approve вимкнено, і Zoo Code запитує дозвіл на читання, запис та команди; для довгих завдань увімкніть потрібні категорії в меню Auto-approve біля поля введення. Для команд є Destructive Command Guard (Settings → Auto-Approve): розширення завантажує його виконуваний файл, і далі пропущені ним команди виконуються самі, а заблоковані чекають на підтвердження. З Auto-Approve Zoo Code і невдалі запити повторює сам: пауза починається з 5 секунд і подвоюється з кожною спробою, але не перевищує 10 хвилин.

Потокова відповідь. Не вимикайте Enable streaming: у потоці шлюз віддає текст у міру генерації та обмежує відповідь лише стелею моделі, а запит без потоку і без явного ліміту обрізається на 1500 токенах відповіді (у GLM-5.3 Flash — на 3000).

Індексація коду. Семантичний пошук по проєкту (Codebase Indexing) налаштовується окремо від моделі, через провайдера ембеддингів; для нього є локальний варіант Semble - Local.

Картинки. Моделі мережі текстові. Для скриншотів та макетів заведіть окремий профіль із моделлю, яка працює із зображеннями, і перемикайтеся на нього на час такого завдання.

Приватність. Zoo Code надсилає розробникам дані про помилки та використання, прив'язані до ідентифікатора установки, — без коду та промптів; вимикається це перемикачем Allow error and usage reporting в Settings → About Zoo Code. Шлюз зі свого боку не зберігає вміст промптів та відповідей: у кабінеті видно лише лічильники запитів та токенів.