Розділи бази знань ▾

Навігація

▸ Почніть тут За ролями

Категорії

Інструменти 54
Глосарій 12

Інструменти

Roo Code + Gonka AI — автономний AI-агент у VS Code

Важливо: розширення Roo Code закрито 15 травня 2026 року. Репозиторій переведено в архів, оновлень більше не буде. Розробку продовжує Zoo Code — форк, започаткований спільнотою Roo Code: провайдер у ньому налаштовується так само, а для переїзду є посібник з міграції та наш гайд по Zoo Code. Інші відкриті агенти для VS Code — Kilo Code та Cline, від якого Roo Code колись відгалузився. Вже встановлене розширення продовжує працювати, і інструкція нижче для нього актуальна.

Roo Code — автономний AI-агент для VS Code: читає та редагує файли, запускає команди в терміналі, працює з браузером і доводить до кінця багатоетапні завдання з розробки. Це форк Cline, який пішов далі: настроювані режими роботи (Architect, Code, Ask, Debug та власні), кастомні інструкції на проєкт та гнучка панель налаштування моделі. По суті — ціла команда AI-спеціалістів всередині редактора.

Головна проблема таких агентів — витрата токенів. На одне завдання Roo Code проганяє контекст файлів, вивід команд, результати інструментів — це десятки мільйонів токенів. На цінах Anthropic ($3-15 за 1M) одна повноцінна сесія перетворюється на $30-1500. Для щоденної роботи це нереально.

JoinGonka Gateway знижує вартість у тисячі разів: та сама сесія обійдеться в $0.01-1.00. Gateway перепродає інференс децентралізованої мережі Gonka і підтримує як OpenAI-формат (провайдер «OpenAI Compatible»), так і Anthropic-формат (endpoint /v1/messages) — Roo Code підключається через будь-який із двох. Це перетворює Roo Code з дорогої демонстрації на робочий інструмент на кожен день.

Крок 1: Встановити Roo Code та отримати ключ

Встановлення Roo Code: у VS Code відкрийте Extensions (Ctrl/Cmd+Shift+X), знайдіть «Roo Code» і натисніть Install. Після встановлення в бічній панелі з'явиться іконка-кенгуру Roo Code. Розширення, як і раніше, лежить у Marketplace, але його остання версія — 3.54.0 від 15 травня 2026 — залишиться останньою.

API-ключ JoinGonka: якщо ключа ще немає — зареєструйтеся на gate.joingonka.ai/register, отримайте 3M безкоштовних токенів і створіть ключ із префіксом jg- у Dashboard.

Крок 2: Налаштувати Roo Code (OpenAI Compatible)

Найпростіше — налаштувати інсталятором в одну команду. Для CLI/файлових інструментів він сам пропише провайдера JoinGonka (baseUrl, моделі), для UI-інструментів покаже готові значення для вставки:

npx @joingonka/setup --tool roo

Команда спершу нагадає закрити Roo Code і назве, куди перейти (--tool zoo, --tool cline, --tool kilo), а потім надрукує значення для тих, у кого розширення ще встановлено, — разом із реальним вікном контексту й стелею відповіді моделі. Інсталятор запитає ключ jg-… і завершить live-перевіркою запитом до gateway. Нижче — ручний спосіб, якщо волієте налаштувати самі.

Налаштувати вручну (план Б)

Відкрийте панель Roo Code і зайдіть у налаштування (іконка шестерні). У розділі провайдера задайте:

  1. API Provider — виберіть OpenAI Compatible.
  2. Base URL — https://gate.joingonka.ai/v1
  3. API Key — jg-your-key
  4. Model (Model ID) — MiniMaxAI/MiniMax-M2.7

Нижче, у блоці Model Configuration, можна уточнити параметри моделі вручну:

  • Context Window — 180000 (180K токенів; у DeepSeek V4 Flash — 380000).
  • Max Output Tokens — 8192 для MiniMax M2.7 і GLM-5.3 Flash, 32768 для DeepSeek V4 Flash.
  • Input Price / Output Price — можна проставити реальні ставки (≈$0.0062 за 1M на вхід, вихід ×3), щоб Roo Code коректно рахував вартість задач просто в інтерфейсі.

Важливо про tool calling: Roo Code використовує лише нативний tool calling — XML-фолбеку, як у старих агентах, тут немає. Тому модель зобов'язана вміти function calling. Моделі мережі через наш Gateway підтримують нативний tool calling — Roo Code працює з ними з коробки.

Перевірка: у чаті Roo Code напишіть «Створи файл hello.py з функцією, що друкує Hello World». Агент запропонує створити файл і покаже diff на схвалення.

Порівняння вартості агентських сесій

Roo Code — агентський інструмент: він не відповідає одним повідомленням, а виконує завдання — читає файли, пише код, запускає тести, виправляє помилки. Кожна дія — це виклик моделі (inference). Порівняємо вартість типових сесій:

ЗавданняТокенівAnthropic ClaudeOpenAI GPTJoinGonka Gonka
Простий баг-фікс~5M$15 — $75$12 — $50$0.048
Нова фіча (2-3 файли)~20M$60 — $300$50 — $200$0.19
Рефакторинг модуля~50M$150 — $750$125 — $500$0.48
Повна сесія розробки (4год)~100M$300 — $1,500$250 — $1,000$0.96

З JoinGonka Gateway Roo Code стає повсякденним інструментом — його можна запускати на кожен тікет, кожен баг, кожну фічу, не озираючись на рахунок. 3M безкоштовних токенів на старті дають спробувати зв'язку без картки.

Параметри моделей: MiniMax M2.7 — вікно 180K і до 8192 токенів відповіді, DeepSeek V4 Flash — 380K і до 32768, GLM-5.3 Flash — 390K і до 8192. Якщо max_tokens для non-stream-запиту не вказано, Gateway за замовчуванням поверне до 1500 токенів (у GLM-5.3 Flash — до 3000). Довгі генерації Roo Code автоматично розбиває на кроки.

Чим Roo Code відрізняється від Cline: режими та Anthropic-формат

Roo Code — форк Cline, але з помітними відмінностями, які змінюють робочий процес:

  • Режими (Modes): перемикайте роль агента під задачу — Architect для планування, Code для написання коду, Ask для запитань щодо проєкту, Debug для пошуку помилок. Можна створювати власні режими з окремими інструкціями та набором дозволених інструментів.
  • Лише нативний tool calling: на відміну від агентів із текстовим/XML-парсингом, Roo Code надсилає інструменти за нативною OpenAI-схемою tools і отримує виклики як окремі події — нижча затримка й надійніший результат. Зворотний бік: модель зобов'язана підтримувати function calling (моделі мережі через наш Gateway — підтримують).
  • Кастомні інструкції та профілі: правила на проєкт (наприклад, через файл правил у репозиторії) і кілька збережених конфігурацій провайдера, між якими зручно перемикатися.

Підключення через Anthropic-формат. Якщо хочете використовувати наш /v1/messages endpoint замість OpenAI-формату: у налаштуваннях виберіть API Provider → Anthropic, позначте «Use custom base URL» і вкажіть https://gate.joingonka.ai, у поле Anthropic API Key вставте той самий ключ jg-your-key, потім задайте ім'я моделі (наприклад MiniMaxAI/MiniMax-M2.7). Ключ і баланс — спільні для обох форматів, нативний tool_use в Anthropic-режимі також проходить через Gateway.

Roo Code + Gonka = автономний AI-агент у VS Code з режимами та нативним tool calling за копійки. Сесія розробки коштує $0.10 замість $300-1,500 у Anthropic, а стартові токени дають змогу спробувати без картки. Саме розширення закрито 15 травня 2026: для нових інсталяцій беріть Zoo Code — форк спільноти — або Kilo Code чи Cline.

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати безкоштовні токени →