Перейти к содержимомуKumoДокументация
Разделы
На странице
Интеграции

Расширения VS Code

Cline, Roo Code и Continue — один и тот же OpenAI-совместимый провайдер: base URL, ключ, идентификатор модели. Где эти поля лежат у каждого.

Открыть как Markdown

Быстро

Все три расширения подключаются одинаково: они умеют «OpenAI-совместимого» провайдера, а значит, им нужны три значения — адрес, ключ, модель.

# Cline Roo Code Continue → OpenAI-compatible provider
- name: Kumo
  provider: openai
  apiBase: https://api.kumorouter.com/v1
  apiKey: ${KUMO_API_KEY}
  model: <model>

Base URL заканчивается на /v1 — это OpenAI-совместимый диалект. Идентификатор модели берите из каталога: расширение подставит его в запрос как есть и своего списка моделей Kumo не знает.

Cline и Roo Code

Оба расширения хранят провайдера в собственной панели настроек внутри VS Code, а ключ — в защищённом хранилище редактора. Файла, который стоило бы править руками, здесь нет.

  1. Проверьте, что стоит`code --list-extensions` покажет, установлен ли Cline, Roo Code или оба.
  2. Откройте настройки расширенияЭкран выбора провайдера в его панели.
  3. API ProviderВыберите «OpenAI Compatible».
  4. Base URL`https://api.kumorouter.com/v1`.
  5. API KeyВаш ключ Kumo.
  6. Model IDИдентификатор из каталога.

У расширений есть переключатели возможностей — изображения, работа с экраном, кеширование промпта. Держите выключенными те, которых выбранная модель не поддерживает: включённый переключатель добавляет в запрос поля, которых модель не ждёт. Что именно умеет модель, написано на её карточке в каталоге.

Расположение полей меняется от выпуска к выпуску. Если на экране не то, что описано выше, ориентируйтесь на то, что видите: пара «провайдер» и «base URL» есть в любом выпуске.

Continue

Continue настраивается файлом, и файл существует в двух форматах. Правьте тот, который у вас уже есть, и не заводите второй.

  • ~/.continue/config.yaml — текущий формат.
  • ~/.continue/config.json — прежний формат.

Модель добавляется в список, а не заменяет его: рядом остаются те, что уже настроены.

models:
  - name: Kumo
    provider: openai
    model: <model>
    apiBase: https://api.kumorouter.com/v1
    apiKey: <ваш ключ>
    roles: [chat, edit, apply]

Добавьте вторую запись с другой моделью, если хотите переключаться прямо в Continue, не возвращаясь к файлу.

Внимание

Ключ в этом файле лежит открытым текстом. Проверьте, умеет ли ваш выпуск Continue читать ключ из переменной окружения, — если умеет, используйте её. Файл конфигурации в репозитории под контролем версий ключа содержать не должен.

Проверка

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

export KUMO_API_KEY="kumo_sk_..."

curl https://api.kumorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $KUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "max_tokens": 64,
    "messages": [{ "role": "user", "content": "reply with OK" }]
  }'

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

Если не работает

  • 401 — ключ не тот или не сохранён в панели расширения.
  • 404 — в base URL нет /v1, либо расширение дописывает путь само; сверьте адрес запроса в выводе расширения.
  • Модель не найдена — идентификатор не из каталога.
  • Continue не видит правок — правится не тот файл: у вас два формата конфигурации, а читается один.
  • Ответ обрывается или отвергается — включён переключатель возможности, которой у модели нет. Выключите и повторите.

Что умеет модель → Все статусы шлюза →