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. Шлюз со своей стороны не хранит содержимое промптов и ответов: в кабинете видны только счётчики запросов и токенов.