MiniMax Code: агент MiniMax на своєму ключі через Gonka

У агента три точки входу, і всі три працюють з BYOK-провайдером однаково:

Офіційний інсталятор ставить свіжу версію в ~/.minimax-code, за потреби підтягує відповідний Node.js і не потребує прав адміністратора:

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

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

Якщо Node.js уже є (22.19 і новіше в лінійці 22, 24.2 і новіше в лінійці 24, а також 25 і 26), підійде 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

Довга команда не випадкова: агенту потрібна нативна збірка SQLite, тому необов'язкові залежності та інсталяційні скрипти мають залишитися увімкненими. Після встановлення відкрийте термінал заново й перевірте: mcode --version.

Усередині TUI стануть у пригоді Shift+Tab (режим планування), Alt+M (перемикання режимів дозволів — Ask, Auto і Full access), @ для посилання на файл і /help зі списком команд. Перервану роботу продовжує mcode --continue, а mcode init . створює в проєкті файл AGENTS.md з правилами для агента.

Користувацькі дані — config.yaml, сесії, стан входу — лежать окремо від програми, в каталозі ~/.minimax (у іменованого профілю — ~/.minimax-<profile>); змінна MINIMAX_DATA_DIR задає інше місце.

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

Закрийте mcode, якщо він запущений, і виконайте:

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

Інсталятор запитає ключ, збереже копію попереднього config.yaml, допише в нього лише свій блок і завершить живим запитом до шлюзу: ключ, адреса та модель перевіряються одразу, а не на першому завданні. У ~/.minimax/config.yaml з'явиться провайдер joingonka у гілці custom_provider — саме там mcode тримає сторонні 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

Що варто знати про цей блок:

• Формат API вказано явно. Без поля api mcode вважає провайдера Anthropic-сумісним; інсталятор обирає openai-completions — канонічний шлях шлюзу.
• Ліміти в кожної моделі свої. Незнайомій моделі mcode приписує вікно 200 000 і відповідь 16 384 токени; реальні значення мережі інші, тому limit задано в усіх трьох записах.
• Ключ лежить у файлі літералом, а сам файл отримує права 600. Так само зберігає ключі й mcode: його прапорець --api-key-env читає змінну й записує в конфіг значення, а не посилання.
• Модель за замовчуванням. Прапорець --model minimax ставить MiniMax M2.7. Без прапорця інсталятор обирає для кодових агентів DeepSeek V4 Flash — у неї більше вікно й стеля відповіді, — а --model glm дає GLM-5.3 Flash. Якщо в конфізі вже вибрано модель іншого провайдера, повторний запуск без --model її не зачепить.
• Профілі. Для іменованого профілю запустіть інсталятор зі змінною середовища, наприклад MINIMAX_DATA_DIR=~/.minimax-work.

Прохання закрити mcode на час встановлення не формальність: агент переписує config.yaml цілком при власних збереженнях і може затерти правку, зроблену в нього за спиною.

Той самий результат дає штатна команда агента. Ключ передається через змінну середовища — в аргументах і історії оболонки йому робити нічого:

# 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

Прапорець --use спершу перевіряє першу з перелічених моделей живим запитом і лише потім зберігає провайдера й робить модель моделлю за замовчуванням; у разі невдачі не зберігається нічого. Успішний прогін завершується рядком Provider added and selected: JoinGonka. З імені mcode сам виводить ключ провайдера — joingonka, — тож інсталятор, запущений пізніше, оновить цей самий запис, а не заведе другий.

Прапорці --context-limit і --output-limit діють на всі моделі, перелічені в команді, а ліміти в моделей мережі різні. Тому командою зручно завести одну модель, а решту дописати у файл. Закрийте mcode та об'єднайте цей фрагмент із уже наявним блоком провайдера в ~/.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 }

Третій спосіб — інтерактивний: усередині TUI команда /model відкриває вибір моделі з пунктом + Add 3rd-party provider…, а /provider керує збереженими підключеннями. Адреса на екрані моделі редагується за Ctrl+E; невдала перевірка нічого не зберігає, чернетка залишається для правки.

Який формат API вибрати. Шлюз приймає всі три, різниться лише базова адреса:

У нашому прогоні перевірку з'єднання пройшли всі три формати.

Три команди показують, що зв’язка жива. Перша виводить список провайдерів — активний позначено зірочкою, ключ замасковано:

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

Друга робить живий запит і в разі успіху відповідає Provider available: custom_provider:joingonka; прапорець --model перевіряє конкретну модель:

mcode provider test custom_provider:joingonka

Третя перевіряє головне — роботу з файлами. Покладіть у каталог невеликий файл з очевидною помилкою й попросіть її знайти:

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

Агент має сам викликати інструмент читання й відповісти по суті. У нашому прогоні так відпрацювали всі три моделі мережі; іншу модель на один запуск задає прапорець виду --model custom_provider:joingonka/<model-id>. З прапорцем --output-format json у відповіді з’являється поле usage з числом вхідних і вихідних токенів — його зручно звірити з кабінетом шлюзу: у розділі «Використання» видно запити по годинах і днях, розбивку за моделями та за ключами.

Якщо перевірка не проходить, mcode називає причину прямо в повідомленні:

Ціна в усіх моделей мережі одна, тому вибір — про поведінку. Нижче — ліміти й те, як моделі поводилися в нашому прогоні mcode exec на одній і тій самій задачі (звірено 21 вересня 2026):

Практичне правило просте. Для коротких задач і швидких правок беріть MiniMax M2.7: зараз на неї припадає найбільше ємності мережі. Якщо видимі міркування заважають — наприклад, вивід exec розбирає скрипт — або потрібно прочитати великий репозиторій і отримати довгу правку, переключайтеся на DeepSeek V4 Flash. Над заплутаною логікою краще думає GLM-5.3 Flash.

Переключення не потребує правки файлу: у TUI це команда /model, для однієї сесії — mcode -m custom_provider:joingonka/<model-id>, для одного прогону — mcode exec --model з тим самим значенням. Постійний вибір зберігається в рядку defaultModel. Склад мережі з часом змінюється; актуальний список з лімітами завжди віддає GET https://gate.joingonka.ai/v1/models.

Агентні інструменти витрачають токени інакше, ніж чат: до кожної вашої фрази mcode додає системний промпт і описи всіх інструментів, а потім веде багатоходовий діалог з моделлю. У нашому прогоні завдання «прочитай файл і знайди помилку» обійшлося приблизно в 40 тисяч токенів, і майже все це вхід. Тому ціна за токен тут вирішує.

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

Що покриває BYOK. Свій провайдер обслуговує запити до моделі: читання та правку коду, команди, субагентів, сесії. Вбудований пошук, медіа-інструменти mcode-tools і керовані коннектори — сервіси самого вендора, їм потрібні вхід в акаунт і кредити. Свої інструменти підключаються незалежно від цього, через MCP-сервери у файлі .mcp.json проєкту.

Дозволи. В TUI режими Ask, Auto та Full access перемикаються по Alt+M або командою /permission; у mcode exec за це відповідає прапор --permission.

Телеметрія. Канали статистики, метрик і діагностики в mcode за замовчуванням вимкнені та вмикаються окремо; змінні MCODE_DISABLE_TELEMETRY і DO_NOT_TRACK вимикають їх усі разом. Шлюз, зі свого боку, не зберігає вміст промптів і відповідей — у статистиці залишаються тільки агрегати витрат.

Якщо потрібна робота з картинками — скріншот інтерфейсу, макет — заведіть поруч другого провайдера з моделлю, що вміє зір, вказавши при додаванні прапор --support-image: моделі мережі Gonka текстові, а провайдерів у mcode може бути кілька.

Агенти від самих лабораторій є у всіх трьох сімейств моделей мережі: поруч з MiniMax Code стоять DeepSeek Harness та ZCode від Z.ai, авторів GLM. Усі три підключаються до одного шлюзу з одним і тим же ключем.