Подключение Kilo Code
Подключение QCode.cc в расширении Kilo Code для VS Code: Settings -> Providers -> Custom provider, где для Claude в Provider API выбирают Anthropic Messages
Содержание
Последняя проверка: 2026-09-18 · 📄 По официальной документации (расширение Kilo Code; документация на kilo.ai)
⚠️ Сменились и владелец, и интерфейс: 2026-07-15 Anaconda объявила о покупке Kilo Code, и после этого настройка кастомного эндпоинта в Kilo переработана: вместо «выпадающего списка API Provider и галочки Use custom base URL» из Roo Code теперь это Settings → вкладка Providers → диалог Custom provider (дословно на официальных страницах anthropic и openai-compatible). Шаги ниже описаны под новый интерфейс.
Кратко¶
| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (Provider API = Anthropic Messages) · GPT ✅ · китайские модели ✅ (Provider API = OpenAI Compatible) · Gemini ❌ (этот путь на странице не описан) |
| Протокол и Base URL | Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1 |
| Где настраивается | настройки расширения (шестерёнка) → вкладка Providers → прокрутить вниз → диалог Custom provider |
| Официальная документация | kilo.ai |
Kilo Code — открытое расширение VS Code для AI-программирования. Это форк Roo Code, который, в свою очередь, отделился от Cline. Происхождение общее, а интерфейс разошёлся: в Kilo это диалог Custom provider на вкладке Providers, тогда как Roo Code и Cline остались на выпадающем списке API Provider. Не переносите эти шаги в те два инструмента — у них свои страницы.
Какой протокол выбрать¶
| Нужные модели | Provider API | Base URL |
|---|---|---|
| Claude | Anthropic Messages |
https://api.qcode.cc/api |
| GPT и четыре китайских семейства | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
| GPT / xAI в стиле Responses | OpenAI Responses |
см. Точки доступа и форматы API |
🔴 Не вызывайте Claude через OpenAI Compatible — эндпоинт QCode для OpenAI отклоняет модели Claude с
model_not_available_on_endpoint. Официальная документация тоже относит Anthropic и MiniMax к
Anthropic Messages.
Установка¶
Найдите Kilo Code в магазине расширений VS Code либо следуйте инструкциям на kilo.ai.
Настройка Claude (Custom provider)¶
- Откройте настройки в боковой панели Kilo Code (шестерёнка) и перейдите на вкладку Providers
- Прокрутите вниз и нажмите Custom provider
- Заполните диалог:
| Поле | Что вписать |
|---|---|
| Provider ID | уникальный идентификатор, например qcode |
| Display name | имя в интерфейсе, любое |
| Provider API | для Claude — Anthropic Messages |
| Base URL | https://api.qcode.cc/api |
| API key | ваш ключ QCode (начинается с cr_) |
| Models | вписать вручную или выбрать из автоматически полученного списка (например, claude-sonnet-5) |
| Headers | необязательно, свои HTTP-заголовки парами ключ-значение |
- Нажмите Submit — модели появятся в model picker
- Отправьте сообщение в чате для проверки
Из материкового Китая замените хост на
https://asia.qcode.cc/api(азиатский узел, поблизости от Кореи / Тайваня / Гонконга); ключ тот же. Примеры Base URL в документации записаны с версионным сегментом (видаhttps://api.your-provider.com/v1), и Kilo по рабочему адресу сам подтягивает список моделей. Для ветки Anthropic Messages мы советуем останавливаться на/api— расширение само добавит/v1/messages. Завершающий слэш не ставьте. Даёт ли лишний слэш именно 404, мы не проверяли, поэтому держитесь рекомендуемой формы. Настройки из интерфейса сохраняются в файл конфигурации (в документации он в одном местеkilo.json, в другом —kilo.jsonc), его можно править руками.
Настройка GPT и китайских моделей (OpenAI Compatible)¶
Тот же диалог Custom provider, меняются только два поля:
- Provider API — OpenAI Compatible
- Base URL —
https://api.qcode.cc/openai/v1 - API key — тот же ключ
cr_ - Models — впишите
gpt-6-sol,gpt-5.6-terraили китайский id вродеglm-5.2
Для интерфейса Responses у GPT / xAI официальное значение — OpenAI Responses; модели Anthropic по-прежнему
только через Anthropic Messages (Base URL https://api.qcode.cc/api), две ветки не взаимозаменяемы.
Проверка связи¶
Сначала проверьте точку и ключ через curl — так вы поймёте, нужно ли разбираться с интерфейсом расширения:
KEY="cr_ваш_ключ_QCode"
curl -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
JSON с полем content означает, что со стороны точки всё в порядке; если расширение всё равно не работает, дело в его настройках.
Диагностика¶
| Симптом | Причина | Решение |
|---|---|---|
model_not_available_on_endpoint |
Claude запрашивается через OpenAI Compatible | Переключитесь на провайдер Anthropic и /api |
Invalid API key |
Неверный ключ или пробелы | Проверьте префикс cr_ и уберите пробелы |
| 404 | Слеш в конце base URL или неверный путь | Сверьтесь с таблицей выше |
| Нужного id нет в списке моделей | Его нет во встроенном списке расширения | Введите его в поле пользовательского model id |
Смежные документы¶
- Точки доступа и форматы API — таблица «протокол × семейство моделей»
- Подключение Roo Code — вышестоящий проект, настройка почти та же
- Интеграция с Cline — ещё выше по цепочке
- Китайские модели