Kilo Code (VS Code / PyCharm)
Подключение Kilo Code — AI-агента для VS Code и PyCharm — к Hubris.
Kilo Code — AI-агент для разработчиков, доступный и в VS Code, и в PyCharm. Автономно выполняет многошаговые задачи: пишет, рефакторит, отлаживает, добавляет тесты, при необходимости открывает браузер для проверки результата.
Требования
- VS Code 1.85+ или PyCharm 2024.1+
- Аккаунт на hubris.pw и API-ключ
Установка и подключение в VS Code
- Откройте панель расширений (
Ctrl+Shift+X), найдите Kilo Code, нажмите Install. - В боковой панели появится иконка Kilo — откройте её → Settings (шестерёнка) → вкладка Providers.
- Нажмите Custom provider → Connect.
- Заполните поля:
| Поле | Значение |
|---|---|
| Provider ID | hubris (или любое имя — это локальный идентификатор) |
| Base URL | https://api.hubris.pw/v1 |
| API Key | ваш ключ из личного кабинета |
- Сохраните настройки. Kilo автоматически подтянет список моделей.
Установка и подключение в PyCharm
- Откройте Settings → Plugins → Marketplace, найдите Kilo Code, установите. Перезапустите IDE.
- В правой панели появится иконка Kilo — откройте, нажмите Settings.
- В разделе Configuration Profile создайте новый профиль.
- В поле API Provider выберите OpenAI Compatible.
- Заполните Base URL =
https://api.hubris.pw/v1и API Key. Список моделей подтянется автоматически.
Рекомендуемые модели
Kilo автономно делает много шагов (план → код → тест → правка), поэтому имеет смысл выбирать модели с поддержкой tool calling и нормальным reasoning.
| ID | Когда подходит |
|---|---|
anthropic/claude-haiku-4.5 | быстрая работа над типовыми правками |
openai/gpt-4o-mini | универсальный недорогой выбор |
google/gemini-2.0-flash | мультимодальные сценарии |
Для тяжёлых рефакторингов и многошаговых задач — берите Claude Opus/Sonnet из каталога. Фильтр «tool calling» поможет отсеять модели, не поддерживающие агентский сценарий.
Контроль расходов
- Заведите отдельный ключ под Kilo, поставьте суточный лимит — на случай если автономный агент уйдёт «копать» дольше ожидаемого.
- Для рутины используйте недорогую модель, на тяжёлые задачи переключайте Opus.
- Расход по сессиям виден в «Расходах» — фильтруйте по ключу.
Решение проблем
Список моделей пустой / Kilo не подтягивает каталог
- Это обычно про невалидный API-ключ или неправильный Base URL. Перепроверьте оба.
- В VS Code иногда нужно перезагрузить окно:
Ctrl+Shift+P→ Developer: Reload Window. - В PyCharm — закройте и заново откройте панель Kilo.
401 при первом запросе
- Ключ должен быть в формате
sk-gw-+ hex, без пробелов и переводов строк.
Модель «не поддерживает изображения» / картинка не доходит
Симптомы: при попытке прикрепить изображение Kilo пишет, что модель не поддерживает image input, либо картинка вроде бы отправляется, но модель отвечает что-то вроде «This model does not support image input, please provide details as text» — и так на любой модели, даже заведомо мультимодальной (openai/gpt-4o, Claude Sonnet, Gemini).
Причина — в самом Kilo, а не в Hubris. Для провайдеров типа OpenAI Compatible Kilo определяет поддержку изображений на своей стороне, не запрашивая возможности модели у сервера, и по умолчанию считает такие модели текстовыми. В итоге расширение либо блокирует прикрепление, либо кладёт в запрос только имя файла без самой картинки — модель получает текст вроде 233.png, но не пиксели, и закономерно отвечает, что изображения не видит.
Решение — явно объявить модальности модели в файле 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". Поддерживает ли модель изображения, видно в каталоге (фильтр «принимает изображения»). - Пропишите так каждую модель, которой будете отправлять картинки.
После правки перезагрузите окно: Ctrl+Shift+P → Developer: Reload Window.
Со стороны Hubris vision работает в полном объёме: /v1/chat/completions принимает изображения и публичным URL, и base64 data URL — подробности в Изображения на вход. Ограничение здесь чисто на стороне Kilo.
Kilo не справляется с задачей / зацикливается
- Слабая модель плохо ведёт себя как агент. Попробуйте более сильную из каталога с явной поддержкой tool calling.
- Уменьшите размер задачи: дайте Kilo более узкую цель.
Что дальше
- Каталог моделей — выбор по поддержке tool calling.
- Управление API-ключами — отдельный ключ под Kilo с дневным лимитом.
- Расходы — детализация сессий.
- Cline, Roo Code — альтернативные VS Code агенты.
Обновлено: