# Подключение Kilo Code

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (расширение Kilo Code; документация на kilo.ai)

> **⚠️ Сменились и владелец, и интерфейс**: 2026-07-15 [Anaconda объявила о покупке Kilo Code](https://www.anaconda.com/press/anaconda-acquires-kilo-code), и после этого настройка кастомного эндпоинта в Kilo **переработана**: вместо «выпадающего списка API Provider и галочки Use custom base URL» из Roo Code теперь это Settings → вкладка **Providers** → диалог **Custom provider** (дословно на официальных страницах [anthropic](https://kilo.ai/docs/ai-providers/anthropic) и [openai-compatible](https://kilo.ai/docs/ai-providers/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](https://kilo.ai) |

[Kilo Code](https://kilo.ai) — открытое расширение VS Code для AI-программирования. Это форк [Roo Code](/docs/ide/roo-code), который, в свою очередь, отделился от [Cline](/docs/ide/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](/docs/getting-started/endpoints-and-api-paths) |

🔴 **Не вызывайте Claude через OpenAI Compatible** — эндпоинт QCode для OpenAI отклоняет модели Claude с
`model_not_available_on_endpoint`. Официальная документация тоже относит Anthropic и MiniMax к
**Anthropic Messages**.
## Установка

Найдите **Kilo Code** в магазине расширений VS Code либо следуйте инструкциям на [kilo.ai](https://kilo.ai).

## Настройка Claude (Custom provider)

1. Откройте **настройки** в боковой панели Kilo Code (шестерёнка) и перейдите на вкладку **Providers**
2. Прокрутите вниз и нажмите **Custom provider**
3. Заполните диалог:

   | Поле | Что вписать |
   |---|---|
   | **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-заголовки парами ключ-значение |

4. Нажмите **Submit** — модели появятся в model picker
5. Отправьте сообщение в чате для проверки

> **Из материкового Китая** замените хост на `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**, меняются только два поля:

1. **Provider API** — **OpenAI Compatible**
2. **Base URL** — `https://api.qcode.cc/openai/v1`
3. **API key** — тот же ключ `cr_`
4. **Models** — впишите `gpt-6-sol`, `gpt-5.6-terra` или [китайский id](/docs/usage/cn-models) вроде `glm-5.2`

Для интерфейса Responses у GPT / xAI официальное значение — **OpenAI Responses**; модели Anthropic по-прежнему
только через Anthropic Messages (Base URL `https://api.qcode.cc/api`), две ветки не взаимозаменяемы.
## Проверка связи

Сначала проверьте точку и ключ через curl — так вы поймёте, нужно ли разбираться с интерфейсом расширения:

```bash
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](/docs/getting-started/endpoints-and-api-paths) — таблица «протокол × семейство моделей»
- [Подключение Roo Code](/docs/ide/roo-code) — вышестоящий проект, настройка почти та же
- [Интеграция с Cline](/docs/ide/cline) — ещё выше по цепочке
- [Китайские модели](/docs/usage/cn-models)