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

Крок 1: встановити Kimi Code. Офіційні способи з документації:

# macOS and Linux: prebuilt binary, no Node.js needed
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell); Git for Windows is required before the first run
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# npm (Node.js 22.19 or newer)
npm install -g @moonshot-ai/kimi-code

Скрипт кладе бінарник у ~/.kimi-code/bin/kimi і дописує цей каталог у PATH через файл налаштувань оболонки. Збірки в нього лише під glibc: на Alpine та інших системах із musl він зупиниться й запропонує npm. Відкрийте термінал заново й перевірте: kimi --version.

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

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

npx @joingonka/setup --tool kimi-code

Інсталятор запитає ключ (в аргументах командного рядка він не передається) і допише в ~/.kimi-code/config.toml лише свої таблиці:

• провайдера [providers.joingonka] з типом openai — це протокол Chat Completions, — адресою шлюзу та ключем у полі api_key; файл отримає права 600;
• по таблиці [models."joingonka/…"] на кожну модель мережі — зі справжнім вікном контексту й стелею відповіді та явними можливостями: виклик інструментів усім, міркування — DeepSeek V4 Flash і GLM-5.3 Flash, у MiniMax M2.7 лише інструменти;
• default_model — DeepSeek V4 Flash, якщо модель за замовчуванням ще не вибрано або вона вказує на модель шлюзу, що пішла з мережі; вибір іншого провайдера без флага --model не чіпає, а підказує команду для разового запуску;
• збереже копію попереднього файлу, чужих провайдерів і ваші поля в таблицях шлюзу не зачепить, а наприкінці надішле живий запит на шлюз і скаже, чи прийнято ключ, адресу та модель.

Так виглядав вивід у нашому прогоні (скорочено):

Configured provider "joingonka" in ~/.kimi-code/config.toml
Base URL: https://gate.joingonka.ai/v1 (provider type "openai" — Chat Completions)
Models: joingonka/MiniMaxAI/MiniMax-M2.7, joingonka/deepseek-ai/DeepSeek-V4-Flash-0731, joingonka/zai-org/GLM-5.3-Flash
Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
…
✓ Verified: the gateway accepted the key, base URL and model.

Іншу модель за замовчуванням задає флаг --model (glm, minimax або повний ідентифікатор); режим без запитань бере ключ зі змінної середовища:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool kimi-code --model glm --non-interactive

Каталог даних, перенесений змінною KIMI_CODE_HOME, інсталятор враховує сам. А ось ~/.kimi — каталог колишнього Python-клієнта kimi-cli: Kimi Code 2.x його не читає, а під час першого запуску пропонує перенести звідти налаштування (те саме робить kimi migrate).

Все, що робить інсталятор, можна написати й руками. Kimi Code зберігає налаштування в TOML; ключі таблиць з точкою або слешем беруться в лапки. Повний фрагмент для мережі Gonka:

default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[providers.joingonka]
type = "openai"
base_url = "https://gate.joingonka.ai/v1"
api_key = "jg-your-key"

[models."joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"]
provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"
max_context_size = 380000
max_output_size = 32768
capabilities = ["thinking", "tool_use"]
display_name = "DeepSeek V4 Flash (Gonka)"

[models."joingonka/zai-org/GLM-5.3-Flash"]
provider = "joingonka"
model = "zai-org/GLM-5.3-Flash"
max_context_size = 390000
max_output_size = 8192
capabilities = ["thinking", "tool_use"]
display_name = "GLM 5.3 Flash (Gonka)"

# MiniMax M2.7, unlike DeepSeek and GLM, is declared without thinking
[models."joingonka/MiniMaxAI/MiniMax-M2.7"]
provider = "joingonka"
model = "MiniMaxAI/MiniMax-M2.7"
max_context_size = 200000
max_output_size = 8192
capabilities = ["tool_use"]
display_name = "MiniMax M2.7 (Gonka)"

Де тримати ключ. З оточення оболонки Kimi Code ключів не бере: export OPENAI_API_KEY=… на нього не діє. Способів два, і одночасно їх використовувати не можна:

Обидва поля в одній таблиці Kimi Code відкине при запуску: has both apiKey and apiKeyEnv set in config.toml - they are mutually exclusive. Зважте, що kimi doctor такого конфлікту не ловить — він перевіряє лише форму файлу.

Який тип провайдера вибрати. Kimi Code вміє кілька протоколів, шлюз теж:

Один провайдер у Kimi Code говорить однією мовою, тому другий протокол — це другий провайдер під іншим ім'ям. Інтерактивно провайдерів додає й видаляє команда /provider усередині агента.

Модель у Kimi Code — це аліас, назва таблиці [models."…"]. Інсталятор називає їх за схемою joingonka/<model-id>, як і сам Kimi Code називає свої (kimi-code/k3), і саме аліас потрібен усюди, де обирається модель. Ідентифікатор без префікса, наприклад MiniMaxAI/MiniMax-M2.7, Kimi Code не знайде.

У нашому прогоні /model виглядав так:

Select a model  (type to search)
Tab toggle provider · ↑↓ navigate · Enter select · Alt+S session-only · Esc cancel

 All   joingonka

   MiniMax M2.7 (Gonka)       joingonka
 ❯ DeepSeek V4 Flash (Gonka)  joingonka ← current
   GLM 5.3 Flash (Gonka)      joingonka

 Thinking  (←→ to switch)
  [ On ]    Off

Перемикач Thinking. Тумблер міркування під списком на моделях мережі сам собою нічого не змінює: рівень міркування Kimi Code надсилає лише моделям, у яких оголошено рівні. Для GLM-5.3 Flash це варто зробити — у неї міркування вимикається значенням low (докладніше — в огляді моделі). Допишіть у таблицю моделі три поля:

[models."joingonka/zai-org/GLM-5.3-Flash"]
# … fields written by the installer …
support_efforts = ["low", "high"]
default_effort = "high"
off_effort = "low"

Ми перевірили, що йде на шлюз: з увімкненим Thinking Kimi Code шле reasoning_effort: "high", і модель міркує; з вимкненим — "low", і відповідь приходить без блоку міркувань. Повторний запуск інсталятора цих полів не зачепить: він править лише свої ключі.

Модель для субагентів. Вбудовані субагенти (coder, explore, plan) за замовчуванням працюють на моделі основного агента. Розділ [secondary_model] дає їм пул, з якого основний агент обирає сам, орієнтуючись на підказки. У пул годиться будь-який аліас — DeepSeek V4 Flash, GLM-5.3 Flash або MiniMax M2.7:

[secondary_model]
default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[secondary_model.models]
"joingonka/deepseek-ai/DeepSeek-V4-Flash-0731" = "Long context and long output: big reads and edits."
"joingonka/zai-org/GLM-5.3-Flash" = "Reasoning model for tricky logic and debugging."

Ключі пулу мусять збігатися з аліасами з [models]: за документацією висяче посилання не дає створити сесію. Рядок для MiniMax M2.7 додається так само; посилання на моделі, що пішли з мережі, інсталятор під час повторного запуску вичистить сам.

Яку модель обрати. Ціна в усіх моделей мережі одна, тож вибір — про поведінку. Так вони поводилися в Kimi Code 2.0.2 на задачі «прочитай файл і знайди помилку» (звірено 23 вересня 2026):

Спочатку переконайтеся, що Kimi Code бачить провайдера й файл розбирається без помилок:

$ kimi provider list
joingonka  type=openai  models=3  source=inline

Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

$ kimi doctor
OK config.toml  ~/.kimi-code/config.toml

Вивід kimi provider list --json нікуди не публікуйте: ключ у ньому стоїть відкритим текстом.

Далі — разовий прогон. Покладіть у каталог calc.py з функцією додавання, яка насправді віднімає, і попросіть знайти помилку:

kimi -p "Read calc.py and tell me in one sentence whether it has a bug."

У режимі -p відповідь іде в stdout, а міркування й хід інструментів — у stderr, тож вивід зручно розбирати скриптом. Ось як відповіла GLM-5.3 Flash:

• Yes: the `add` function in calc.py:2 returns `a - b` instead of `a + b`, so `add(2, 3)` prints `-1`.

Зважте: у -p Kimi Code нічого не запитує й сам виконує команди — у нашому прогоні модель без дозволу спробувала запустити python3, щоб перевірити здогад. Перший запуск інтерфейсу в новому каталозі починається із запитання Trust this folder? — воно стосується MCP-серверів проєкту, — а на екрані привітання видно модель: Model: DeepSeek V4 Flash (Gonka). Друга половина перевірки — кабінет шлюзу: у розділі «Використання» запит з'явиться в розбивці за моделями та за ключами.

Якщо щось пішло не так, діагноз зазвичай читається прямо з повідомлення:

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

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

Оцінки в правій колонці — за цінами на вересень 2026. Для порівняння — як взагалі можна платити за моделі в Kimi Code:

Точні витрати та залишок — у кабінеті, у розділах «Використання» та «Білінг». За довжиною розмови стежить сам Kimi Code: рядок стану показує, яка частка контексту зайнята, а команда /compact стискає історію вручну.

Режими дозволів. В інтерфейсі Kimi Code за замовчуванням працює в режимі Always Ask: читання виконується відразу, правки та команди — після вашого підтвердження. Ask When Needed (/yolo або прапорець --yolo) пропускає рутинні правки та команди, але запитує про чутливі файли та небезпечні команди; Never Ask (/auto, --auto) не запитує нічого. Режим планування вмикається через Shift-Tab. Разовий прогін kimi -p завжди йде без запитань, тому запускайте його в контейнері або окремій робочій копії.

Що працює без облікового запису Moonshot. Власний провайдер обслуговує все, що робить модель: читання та правку коду, команди, субагентів, сесії, MCP-сервери. Веб-пошук — сервіс Moonshot: без входу в обліковий запис інструменту WebSearch у наборі агента немає, а завантаження сторінки за адресою (FetchURL) залишається. Моделі мережі текстові, тому введення зображень та відео на них не працює.

Телеметрія та оновлення. Анонімна телеметрія за замовчуванням увімкнена: вимикає її рядок telemetry = false у config.toml або змінна KIMI_DISABLE_TELEMETRY=1. Оновлення ставляться автоматично ([upgrade] auto_install = true у ~/.kimi-code/tui.toml); якщо потрібна передбачуваність — вимкніть і оновлюйтеся командою kimi upgrade. Шлюз не зберігає вміст промптів і відповідей — у статистиці залишаються тільки агрегати витрат.

Кілька оточень. Налаштувань провайдерів на рівні проєкту у Kimi Code немає. Розділити робочі та особисті ключі можна змінною KIMI_CODE_HOME: з нею в інший каталог переїжджають налаштування, сесії та логи, а інсталятор, запущений з тією ж змінною, пише туди ж.

В редакторі. Kimi Code працює всередині Zed, JetBrains та інших клієнтів ACP через команду kimi acp — з тим самим каталогом даних і тими самими провайдерами.

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