Kilo Code: настройка своего API в VS Code, JetBrains и CLI

Коротко: в Kilo Code откройте настройки (шестерёнка) → вкладка Providers → Custom provider, выберите OpenAI Compatible, вставьте Base URL и ключ — Kilo сам подтянет список моделей. Ниже — каждое поле, тот же провайдер в файле kilo.jsonc для CLI и JetBrains, выбор модели и разбор ошибок 401, 403 и 404.

Что такое Kilo Code

Kilo Code — агент для программирования с открытым кодом: читает проект, правит файлы, запускает команды и показывает каждый шаг. Он работает как расширение VS Code, как плагин для IDE JetBrains (PyCharm, IntelliJ IDEA и другие) и как CLI в терминале — и все три читают один и тот же файл настроек. Провайдер моделей не зашит: кроме встроенного шлюза Kilo можно подключить любой OpenAI-совместимый API — свой, локальный или облачный.

Свой провайдер нужен, когда встроенный не подходит: оплата иностранной картой, нужные модели недоступны из вашего региона или хочется платить напрямую по ставкам провайдера. Само расширение бесплатное.

Шаг 1. Установите Kilo Code

• VS Code: «Расширения» (Ctrl+Shift+X, на macOS Cmd+Shift+X) → найдите Kilo Code → установить. Панель агента появится на боковой панели.
• PyCharm, IntelliJ IDEA и другие JetBrains: Settings → Plugins → Marketplace → Kilo Code.
• Терминал: CLI ставится по инструкции на сайте Kilo и читает те же настройки, что и расширение.

Шаг 2. Получите Base URL и ключ

Кнопка ниже создаёт Base URL вида https://twelver.ru/api/ai/<config-id>/v1 и ключ вида sk-…. Регистрация и карта не нужны. Ключ показывается один раз — скопируйте сразу.

Шаг 3. Добавьте провайдера в VS Code

1. Откройте панель Kilo Code и нажмите шестерёнку — откроются настройки.
2. Перейдите на вкладку Providers, прокрутите вниз и нажмите Custom provider.
3. Заполните поля значениями из блока выше:

После Submit модели провайдера появятся в выборе модели — внизу панели агента. Отправьте короткое «привет»: если пришёл ответ, подключение работает.

Шаг 3, вариант для CLI и JetBrains: файл kilo.jsonc

Тот же провайдер можно прописать в файле — так он сразу появится и в CLI, и в JetBrains, и в VS Code. Где лежат настройки:

Ключ лучше не держать в файле открытым текстом — вынесите его в переменную окружения:

export TWELVER_API_KEY="sk-<ваш-ключ>"

{
  "provider": {
    "twelver": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Twelver",
      "options": {
        "baseURL": "https://twelver.ru/api/ai/<ваш-config-id>/v1",
        "apiKey": "{env:TWELVER_API_KEY}"
      },
      "models": {
        "auto": { "name": "Qwen3.7-Plus" },
        "qwen-flash": { "name": "Qwen3.8-Flash" },
        "zai": { "name": "GLM-5.3" },
        "grok": { "name": "Grok 4.7" }
      }
    }
  },
  "model": "twelver/auto",
  "small_model": "twelver/qwen-flash"
}

model — основная модель агента в формате провайдер/серия. small_model — дешёвая модель для служебных запросов вроде заголовков сессий. Если задать модели поле limit с окном контекста и максимумом ответа, агент будет точнее решать, когда сжимать историю.

Какую модель выбрать

Каждая строка — серия: имя, которое вы выбираете в Kilo, а не конкретная версия модели. Серия сама ссылается на актуальную модель, так что после обновлений настройку не нужно править. Для планирования и отладки имеет смысл серия классом выше, чем для рутинных правок.

Если не работает: 401, 403, 404

Kilo Code, Cline и Roo Code

Все три — агенты для VS Code с одинаковой идеей: провайдер моделей подключается вручную. Отличие Kilo — один конфиг на три среды: расширение, плагин JetBrains и CLI. Настройка Cline разобрана в главе Cline: настройка OpenAI-совместимого API; терминальный агент, на котором основан формат конфига Kilo, — в главе opencode в России. Если нужен другой набор моделей — аналоги OpenRouter в России. Вся книга — API для ИИ-агентов.

Как не переплачивать

• Новая задача — новая сессия. Контекст уходит в каждый запрос целиком, и длинная переписка дорожает с каждым шагом.
• Задайте small_model. Служебные запросы не должны идти через дорогую модель.
• Начинайте с дешёвой серии и поднимайте класс там, где не хватило качества.

Попробуйте сами

Получите base_url и ключ прямо сейчас

Кнопка на странице API выдаёт адрес и ключ сразу — без регистрации и без привязки карты.

Получить API-ключ

⚡Лендинг по темеAPI для кодаTwelver на AndroidТот же чат в приложении