Kilo Code в VS Code: установка и настройка из России

Что такое Kilo Code и почему он не подключается «из коробки»

Kilo Code — это расширение-агент для VS Code с открытым исходным кодом, выросшее из Cline и Roo Code. Устройство поэтому узнаваемое: панель чата в сайдбаре, агент сам читает файлы проекта, предлагает правки, запускает команды в терминале и ведёт задачу в несколько шагов, спрашивая подтверждение перед действиями. От автодополнения вроде Copilot это отличается принципиально — вы описываете задачу словами, а не дописываете строку за строкой.

Ключевая деталь, из-за которой и возникают все сложности: своей модели у расширения нет. Kilo Code — оболочка, которая ходит к внешнему API. Провайдера вы выбираете сами, и вариантов расширение поддерживает много: собственный шлюз Kilo Code, OpenRouter, Anthropic и OpenAI напрямую, Google Gemini, локальные Ollama и LM Studio.

Из России почти все эти пути упираются в одно и то же. Прямые Anthropic и OpenAI не дадут ни зарегистрироваться, ни оплатить без зарубежной карты. Собственный шлюз Kilo Code — та же история с оплатой. Локальные Ollama и LM Studio работают без интернета и без денег, но агентский цикл с чтением файлов и многошаговым планированием требователен к модели: на среднем ноутбуке маленькая локальная модель начнёт путаться уже на третьем-четвёртом шаге задачи. Для разовых подсказок годится, для работы — не очень.

Отсюда и запросы, с которыми люди приходят: «kilo code не работает», «kilo code 403», «kilo code в россии». Само расширение при этом исправно — не работает доступ к модели.

Выход — оставить провайдера Anthropic, то есть родной для моделей Claude формат запросов, но отправлять запросы не в Anthropic, а на совместимый прокси. Для Kilo Code это ровно одно изменённое поле в настройках.

Установка расширения

Расширение лежит в официальном каталоге VS Code, ставится штатно и никаких обходных путей на этом этапе не требует — блокировки касаются моделей, а не Marketplace.

1. Откройте VS Code и перейдите в раздел Extensions (Ctrl+Shift+X, на macOS Cmd+Shift+X).
2. Введите в поиске Kilo Code.
3. В результатах найдите расширение от издателя Kilo Code и нажмите Install.
4. После установки в левой панели появится иконка Kilo Code — она открывает панель чата с агентом.

Если панель не появилась, перезапустите окно редактора: Ctrl+Shift+P → команда Developer: Reload Window.

На этом шаге агент уже установлен, но при первой попытке что-то спросить он попросит настроить провайдера. Этим и займёмся.

Подключение моделей Claude через провайдера Anthropic

Где взять ключ и base URL

Нужны две вещи: API-ключ и адрес прокси, который этот ключ принимает. И то и другое выдаёт AI для кода — сервис PurpleSchool, который проксирует запросы к моделям и берёт оплату в рублях, без зарубежной карты и без VPN.

Адрес для Anthropic-совместимых клиентов:

https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic

Тарифы на момент публикации: «Помощник» — 499 ₽/мес, «Напарник» — 1 199 ₽/мес, «Соавтор» — 2 499 ₽/мес, отмена в любой момент.

Отдельно стоит знать про автонастройку:

npx @purpleschool/ai-for-code

Эта команда сама прописывает конфиги, но только для клиентов, у которых на странице сервиса есть готовая инструкция, — Claude Code, Codex, Cursor, Windsurf, Cline для JetBrains, OpenCode и несколько других. Kilo Code в этот список пока не входит, поэтому его настраиваем руками. Хорошая новость: Kilo Code — форк Cline, а для Cline у сервиса инструкция есть, и она сводится ровно к трём полям — провайдер Anthropic, ключ в API Key, свой адрес в Base URL. Те же три поля мы и заполним.

Заполняем настройки провайдера

1. Откройте панель Kilo Code и нажмите иконку настроек в её верхней части.
2. В блоке выбора провайдера выберите Anthropic.
3. В поле API Key вставьте ключ, полученный в сервисе.
4. Включите опцию, разрешающую задать собственный адрес API, — в интерфейсе она выглядит как отдельная галочка рядом с полем адреса. После включения появится поле Base URL, вставьте в него адрес прокси из блока выше.
5. В списке моделей выберите любую доступную модель Claude.
6. Сохраните настройки.

Адрес важно вставить точно как указано, без завершающего слэша и без добавленного вручную /v1 — суффикс /v1 нужен OpenAI-совместимому адресу, а у Anthropic-адреса его быть не должно. Это самая частая причина, по которой запрос уходит «в никуда».

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

Альтернатива: OpenAI-совместимый провайдер

Если по каким-то причинам поле собственного адреса у провайдера Anthropic вам недоступно, есть второй путь — тот же сервис отдаёт OpenAI-совместимую точку входа, а её Kilo Code поддерживает как отдельного провайдера.

1. В настройках выберите провайдера OpenAI Compatible.
2. В Base URL укажите:

https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1

3. В API Key вставьте тот же ключ.
4. В поле идентификатора модели укажите модель из доступных на вашем тарифе.

Здесь суффикс /v1 обязателен — это часть OpenAI-совместимого контракта, и без него клиент будет собирать неправильные пути запросов.

Ключ в любом из вариантов хранится в настройках редактора, а не в проекте. Но если вы всё же вынесли его в файл в репозитории — например, в локальный конфиг или скрипт запуска, — сразу добавьте этот файл в исключения, чтобы ключ не уехал в историю коммитов. Как это работает, разобрано в справочнике по .gitignore.

Выбор и переключение модели

Модель в Kilo Code выбирается в том же экране настроек и меняется в любой момент — перенастраивать ключ и адрес заново не нужно. Конкретные имена моделей зависят от того, что доступно на вашем тарифе: в примерах на странице сервиса на месте имени стоит плейсхолдер, потому что набор меняется. Поэтому правильный порядок такой — открыть список моделей после того, как ключ и адрес уже сохранены, и выбрать из того, что реально пришло.

Практический смысл переключения простой. Тяжёлая модель нужна там, где агент проектирует: разложить задачу на шаги, разобраться в незнакомом модуле, предложить структуру. Рутину — переименования, однотипные правки по десяти файлам, генерацию тестов по готовому шаблону — дешевле отдавать более лёгкой модели. На длинных агентских сессиях разница в расходе получается заметная, потому что агент отправляет не один запрос, а десятки: каждое чтение файла и каждый шаг плана — это обращение к модели.

Если список моделей пришёл пустым, значит запрос к прокси не прошёл, и дело не в модели — возвращайтесь к проверке ключа и адреса.

Частые ошибки подключения

403. Запрос дошёл, но доступ не выдан. Проверяйте по порядку: активна ли подписка, тот ли ключ вставлен (не от другого сервиса и не с лишними пробелами по краям), доступна ли выбранная модель на вашем тарифе. Если раньше вы настраивали провайдера напрямую на Anthropic, убедитесь, что адрес действительно заменён — обращение напрямую к зарубежному API из России как раз и вернёт отказ.

401. Ключ не распознан. Обычно это опечатка при вставке, обрезанный конец ключа или остатки старого значения в поле. Удалите содержимое поля полностью и вставьте ключ заново.

404 при обращении к модели. Почти всегда неверный путь: лишний или отсутствующий /v1, завершающий слэш, либо идентификатор модели, которого на прокси нет. Сверьте адрес с тем, что указано выше, символ в символ.

Агент не видит файлы проекта. Это не про доступ к модели. Kilo Code работает с открытой папкой — если вы открыли в редакторе одиночный файл, а не директорию, агенту нечего читать. Откройте проект целиком через File → Open Folder.

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

Kilo Code, Cline или Cursor — что выбрать

Kilo Code, Cline и Roo Code — близкие родственники, и настраиваются они почти одинаково: провайдер, ключ, адрес, модель. Если вы уже настроили одно из них, второе займёт минуту. Выбирать между ними стоит по мелочам вроде удобства интерфейса и набора режимов работы, а не по возможностям доступа к моделям — они здесь равны.

Принципиальная разница начинается дальше. Cursor — это отдельный редактор, форк VS Code, а не расширение: там агент встроен глубже, но и переезжать нужно целиком, и с доступом из России у самого редактора отдельная история. Как это решается, разобрано в статье про Claude Code и Codex в VS Code — там же сравнение расширений, которые живут в обычном VS Code.

Если же вам ближе работа в терминале, а не в панели редактора, посмотрите на консольные агенты — например, на Qwen Code с моделями Claude. Принцип подключения там тот же: свой base URL и ключ, только задаются они переменными окружения.

Итоги

Kilo Code в России настраивается в три действия: поставить расширение из Marketplace, выбрать провайдера Anthropic и вписать в него свой ключ вместе с адресом прокси. Всё, что ломается на этом пути, ломается в одном из двух полей — ключ или адрес, поэтому диагностика короткая: сверить оба и проверить, что суффикс /v1 стоит там, где он нужен, и отсутствует там, где не нужен.

Ключ, который принимает рублёвую оплату и не требует VPN, выдаёт AI для кода — один и тот же ключ подходит и для Kilo Code, и для Claude Code, и для остальных агентов, так что менять инструмент потом можно без перенастройки доступа.