Kilo Code (VS Code / PyCharm)

Kilo Code — AI-агент для разработчиков, доступный и в VS Code, и в PyCharm. Автономно выполняет многошаговые задачи: пишет, рефакторит, отлаживает, добавляет тесты, при необходимости открывает браузер для проверки результата.

Требования

• VS Code 1.105+ или PyCharm (и другие IDE JetBrains) с плагином Kilo Code
• Аккаунт на hubris.pw и API-ключ

Установка и подключение в VS Code

1. Откройте панель расширений (Ctrl+Shift+X), найдите Kilo Code (издатель — kilocode), нажмите Install.
2. В боковой панели появится иконка Kilo — откройте её и нажмите Settings (шестерёнка вверху панели). Настройки откроются вкладкой редактора Kilo Settings — выберите слева раздел Providers.
3. В списке Popular providers найдите строку Custom provider и нажмите в ней Connect.
4. Заполните поля диалога:

5. Как только адрес и ключ заполнены, Kilo загрузит у Hubris список моделей («… models found») — и отметит в нём все модели сразу. Нажмите Deselect all, найдите нужные модели поиском (Search models…), отметьте их и нажмите Add N model(s). Модель можно добавить и вручную: Add model → заполните оба поля, ID и Name.
6. Нажмите Submit. Провайдер появится в разделе Connected providers, а модели — в переключателе моделей под полем ввода, с подписью «Hubris» (ищите их по ID).

Kilo сохраняет провайдера в глобальный файл настроек ~/.config/kilo/kilo.jsonc (в Windows — %USERPROFILE%\.config\kilo\kilo.jsonc).

Установка и подключение в PyCharm

1. Откройте Settings → Plugins → Marketplace, найдите Kilo Code, установите. Перезапустите IDE.
2. В правой панели появится иконка Kilo — откройте, нажмите Settings → Providers.
3. Нажмите Add custom provider — откроется диалог Custom OpenAI-Compatible Provider.
4. Заполните Provider ID (hubris), Display name, Base URL = https://api.hubris.pw/v1 и API key; в поле Model IDs (comma-separated) нажмите Select models — плагин подтянет список у Hubris — либо перечислите ID через запятую.
5. Нажмите Add.

Рекомендуемые модели

Kilo автономно делает много шагов (план → код → тест → правка), поэтому имеет смысл выбирать модели с поддержкой вызова инструментов и размышления.

Для тяжёлых рефакторингов и многошаговых задач — берите Claude Opus/Sonnet из каталога. Фильтр «tool calling» поможет отсеять модели, не поддерживающие агентский сценарий.

Контроль расходов

• Учтите объём системного промпта: даже вопрос из одной строки Kilo отправляет примерно с 14,7 тыс. токенов входа.
• Заведите отдельный ключ под Kilo, поставьте суточный лимит — на случай если автономный агент уйдёт «копать» дольше ожидаемого.
• Для рутины используйте недорогую модель, на тяжёлые задачи переключайте Opus.
• Расход по сессиям виден в «Расходах» — фильтруйте по ключу.

Решение проблем

Список моделей пустой / Kilo не подтягивает каталог

• «Authentication failed. Check the API key above and try again.» — ключ неверный. Сообщение «No models found on this server» по коду Kilo означает, что Base URL ведёт не туда (нужен именно https://api.hubris.pw/v1). Перепроверьте оба поля.
• В VS Code иногда нужно перезагрузить окно: Ctrl+Shift+P → Developer: Reload Window.

«Неверный API-ключ» в ответе

• Ключ должен быть в формате sk-gw- + hex, без пробелов и переводов строк. Поменять его можно в Settings → Providers → Edit provider.

«Модель не найдена: …»

• ID модели в Kilo должен быть полным, с вендором: openai/gpt-4o-mini, а не gpt-4o-mini. Проще всего добавлять модели из загруженного списка, а не вписывать вручную.

Модель «не поддерживает изображения» / картинка не доходит

Симптомы: при попытке прикрепить изображение Kilo пишет, что модель не поддерживает image input, либо картинка вроде бы отправляется, но модель отвечает что-то вроде «This model does not support image input, please provide details as text» — и так на любой модели, даже заведомо мультимодальной (openai/gpt-4o, Claude Sonnet, Gemini).

Причина — в самом Kilo, а не в Hubris. Для пользовательских провайдеров Kilo определяет поддержку изображений на своей стороне, не запрашивая возможности модели у сервера, и по умолчанию считает такие модели текстовыми: в карточке модели в переключателе у них стоит только признак Text. В итоге расширение либо блокирует прикрепление, либо кладёт в запрос только имя файла без самой картинки — модель получает текст вроде 233.png, но не пиксели, и закономерно отвечает, что изображения не видит.

Решение в VS Code — в диалоге провайдера (Settings → Providers → ваш провайдер → Edit provider) включить галочку Image у каждой модели, которой будете отправлять картинки (кнопка Toggle image for all включает её у всех сразу), и нажать Submit. После этого в карточке модели появится признак Images. Поддерживает ли модель изображения, видно в каталоге (фильтр «принимает изображения»).

Если диалог после загрузки снова отметил весь список моделей Hubris, нажмите под списком Cancel — иначе при сохранении добавятся все модели. А если в открытом проекте лежит собственный kilo.jsonc, сохранение в этом диалоге может зависнуть на «Saving...» — тогда правьте файл напрямую.

То же самое можно сделать в файле конфигурации kilo.jsonc — глобальном ~/.config/kilo/kilo.jsonc или проектном (kilo.jsonc в корне проекта либо .kilo/kilo.jsonc):

{
  "provider": {
    "hubris": {
      "models": {
        "openai/gpt-4o": {
          "name": "openai/gpt-4o",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  }
}

• hubris — тот же Provider ID, что вы задали при подключении.
• Ключ модели (openai/gpt-4o) должен точно совпадать с тем, что выбран в Kilo.
• В input перечислите реально поддерживаемые модальности — для работы с картинками обязателен "image". Массив output можно не указывать: сохраняя галочку Image, Kilo сам записывает только input.

После правки перезагрузите окно: Ctrl+Shift+P → Developer: Reload Window (кнопки Reload в настройках Kilo для переключателя моделей недостаточно).

Со стороны Hubris приём изображений работает в полном объёме: /v1/chat/completions принимает изображения и публичным URL, и base64 data URL — подробности в Изображения на вход. Ограничение здесь чисто на стороне Kilo.

Kilo не справляется с задачей / зацикливается

• Слабая модель плохо ведёт себя как агент. Попробуйте более сильную из каталога с явной поддержкой tool calling.
• Уменьшите размер задачи: дайте Kilo более узкую цель.

Что дальше

• Каталог моделей — выбор по поддержке tool calling.
• Управление API-ключами — отдельный ключ под Kilo с дневным лимитом.
• Расходы — детализация сессий.
• Cline — альтернативный агент для VS Code. Roo Code больше не развивается и в свежих версиях VS Code не работает.

Обновлено: 16 сентября 2026 г.