kosareva.cloud
RU
РусскийEnglish

Kilo Code через kosareva.cloud

Kilo Code — открытый агент для VS Code: читает проект, правит файлы и запускает команды. У него есть ещё CLI и плагин для JetBrains, и все они читают одни и те же настройки, так что провайдер достаточно добавить один раз.

Наш шлюз подключается в нём как свой провайдер формата OpenAI: адрес, ключ, имена моделей.

Как подключить

/1Получите ключ

Создайте API-ключ в личном кабинете и пополните баланс — от 50 ₽.

/2Установите Kilo Code

В VS Code откройте вкладку расширений и установите Kilo Code. Остальные ваши расширения и настройки остаются на месте.

/3Добавьте свой провайдер

Откройте настройки Kilo (значок шестерёнки), перейдите на вкладку Providers, прокрутите список вниз и нажмите Custom provider.

/4Заполните окно провайдера

Значения такие:

Provider ID    kosareva
Display name   kosareva.cloud
Provider API   OpenAI Compatible
Base URL       https://api.kosareva.cloud/v1
API key        ВАШ_API_КЛЮЧ

Когда адрес и ключ введены, Kilo сам запрашивает список моделей и показывает его с поиском — отметьте нужные. Если список не появился, впишите имя модели вручную, например claude-sonnet-5. Нажмите Submit, и модели появятся в выборе модели.

Для моделей OpenAI Kilo советует вариант OpenAI Responses, для Claude — Anthropic Messages. С нашим адресом модели из примеров работают через OpenAI Compatible, отдельный провайдер под каждого производителя не нужен.

/5Задайте размер контекста

Это шаг, который легко пропустить. Для моделей, которых нет во встроенном каталоге Kilo, контекст и потолок ответа по умолчанию равны нулю — и тогда Kilo не сжимает историю: переписка растёт, пока модель не откажет. Задать размеры можно только в файле ~/.config/kilo/kilo.jsonc (на Windows — C:\Users\<имя>\.config\kilo\kilo.jsonc). Там же можно описать провайдера целиком, без окна:

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "kosareva/claude-sonnet-5",
  "provider": {
    "kosareva": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "kosareva.cloud",
      "options": {
        "baseURL": "https://api.kosareva.cloud/v1",
        "apiKey": "{env:KOSAREVA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "tool_call": true,
          "limit": {
            "context": 1000000,
            "output": 32000
          }
        },
        "deepseek-v4-1-flash": {
          "name": "DeepSeek V4.1 Flash",
          "tool_call": true,
          "limit": {
            "context": 1048576,
            "output": 32000
          }
        }
      }
    }
  }
}

Что здесь важно:

  • limit.context — не больше, чем у модели в каталоге: у Claude Sonnet 5 — 1 000 000 токенов. Это ещё и потолок расхода: история сжимается, только когда подходит к пределу, и запрос на исходе длинной сессии с полным окном стоит до 216 ₽ только за вход. Хотите, чтобы сжималось раньше, — поставьте меньше.
  • limit.output — сколько модель может выдать за один ответ. 32 000 Kilo и так ставит потолком по умолчанию.
  • kosareva — тот же Provider ID, что в окне из шага 4.
  • {env:KOSAREVA_API_KEY} — ключ из переменной окружения; задайте её до запуска VS Code. Такая ссылка работает только в общем файле в ~/.config/kilo: в kilo.jsonc проекта Kilo её игнорирует, чтобы чужой репозиторий не мог увести ваш ключ.
  • model — модель по умолчанию в формате провайдер/модель.

Что учесть

  • Агент отправляет модели содержимое файлов, которые открывает. Это основной расход: чем больше проекта в контексте, тем дороже запрос.
  • Если разрешить агенту запускать команды без подтверждения, он будет делать это без вопроса. На чужом или боевом проекте подтверждения лучше оставить.

Список моделей

Kilo подключает нас как свой провайдер OpenAI Compatible и сам запрашивает список моделей. Главное — задать каждой модели limit.context, иначе Kilo не сжимает историю.

Протокол
OpenAI-совместимый, Chat Completions
Адрес
https://api.kosareva.cloud/v1
Имя модели
как в каталоге, латиницей через дефисы: claude-sonnet-5-5
Подходят
Любая текстовая модель каталога — сейчас их 105; агентам code и debug нужна модель с вызовом инструментов (tool_call: true).
МодельИмя в запросеКонтекст, токеновВход / выход за 1M
Claude Sonnet 5.5claude-sonnet-5-51 000 000216 / 1 080 ₽
Claude Opus 5.5claude-opus-5-51 000 000432 / 2 160 ₽
GPT-6.1 Solgpt-6-1-sol1 050 000216 / 1 080 ₽
Gemini 3.8 Flashgemini-3-8-flash1 048 57681 / 405 ₽
Kimi K2.7 Codekimi-k2-7-code262 144103 / 432 ₽
GLM-5.3glm-5-31 310 720151 / 475 ₽
Qwen3.8 Maxqwen3-8-max1 000 000216 / 648 ₽
DeepSeek V4.1 Flashdeepseek-v4-1-flash1 048 57632,4 / 130 ₽

Контекст из таблицы — потолок для limit.context в kilo.jsonc. Все модели с ценами — на странице цен. Точные имена отдаёт и сам API по адресу /v1/models.

Какие функции Kilo Code работают через kosareva.cloud

Агенты Kilo со своим ключом работают полностью. Не работает то, что Kilo держит в своём облаке.

Агенты code, ask, plan и debug работает

Работают с моделями из каталога, каждому агенту можно назначить свою модель.

MCP-серверы работает

Настраиваются в Kilo как обычно и от провайдера моделей не зависят.

Фоновые задачи с оговорками

Заголовки и сжатие истории Kilo делает отдельной моделью. Задайте её в small_model, иначе Kilo возьмёт свою kilo-auto/small — она идёт через шлюз Kilo.

Индексация кода с оговорками

Выключена по умолчанию. Включается с embedder OpenAI-compatible; в каталоге есть модель эмбеддингов Gemini Embedding 2, но с Kilo мы эту связку не проверяли.

Автодополнение не работает

Подсказки по Tab Kilo направляет через собственный шлюз Kilo, нужен аккаунт Kilo. Наш ключ на них не действует.

Cloud Agent и облачные сессии не работает

Это облако Kilo со своим балансом, к нашему ключу отношения не имеет.

Рекомендуемые модели для Kilo Code

У Kilo несколько агентов, и каждому можно дать свою модель — под его работу и под ваш бюджет.

Агент code

Claude Sonnet 5.5 claude-sonnet-5-5

Основная модель для правок и команд. Стоит столько же, сколько Sonnet 5 из примера выше.

Агенты plan и ask

GPT-6.1 Sol gpt-6-1-sol

Окно больше миллиона токенов — удобно обсуждать план по всему проекту. В kilo.jsonc контекст не больше 1 050 000 токенов.

Экономная для code

Kimi K2.7 Code kimi-k2-7-code

Модель Moonshot для программирования, заметно дешевле флагманов. Окно 262 144 токенов — укажите это в limit.context.

small_model

DeepSeek V4.1 Flash deepseek-v4-1-flash

Для заголовков и сжатия истории: копейки за запрос и окно на миллион токенов.

Устранение неполадок

Наши ошибки приходят с русским текстом — по нему и ищите свой случай. Подробные разборы — в справочнике.

401: «Ключ не найден» или «Ключ не принят»

Ключ скопирован не целиком, с пробелом или переносом строки, удалён в кабинете — или вставлен не в то поле. В Kilo ключ — в окне Custom provider или в options.apiKey файла kilo.jsonc.

404: адрес без /v1 или с лишним хвостом

Базовый адрес — ровно https://api.kosareva.cloud/v1. Без /v1 запрос уходит мимо API, а с /chat/completions на конце путь удваивается — инструмент допишет его сам. В Kilo это Base URL в окне провайдера или options.baseURL в kilo.jsonc.

«Такой модели нет в каталоге»

Имя модели — как в каталоге: латиницей через дефисы, например claude-sonnet-5-5. Вариант через точку шлюз поймёт сам, а с префиксом вендора (anthropic/…), датой версии или пробелом — нет. В kilo.jsonc имя модели — ключ внутри models, а модель по умолчанию пишется как kosareva/claude-sonnet-5.

402: «Закончились средства на балансе»

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

Ответ обрывается на полуслове

Модель упёрлась в потолок длины ответа — max_tokens. Поднимите его или попросите модель продолжить. В Kilo это limit.output. Если не задать limit.context, Kilo не сжимает историю, и длинная сессия упирается в окно модели — это та самая обратная ошибка. Обратная ошибка — 400 «Запрос длиннее, чем помещается в контекст этой модели»: потолок ответа вместе с историей не влезает в окно модели. Тогда уменьшите потолок или сожмите историю.

Долго нет ответа или 504

Длинный ответ без потоковой выдачи идёт минутами, и инструмент может сдаться раньше модели. В Kilo ожидание первого байта — options.timeout (по умолчанию 300 000 мс), паузы между кусками ответа — options.chunkTimeout. Если пришёл наш 504 «Модель не ответила за отведённое время», деньги за такой запрос не списываются — повторите его.

Не работает автодополнение

Так и задумано: автодополнение Kilo ходит через шлюз Kilo и требует аккаунта Kilo. С нашим ключом работают агенты, а не подсказки по Tab.

Частые вопросы

Нужен ли аккаунт Kilo?

Для агентов со своим провайдером — нет. Аккаунт нужен для автодополнения, Cloud Agent и облачных сессий: это сервисы самого Kilo.

Что будет, если не задать limit.context?

У модели, которой нет во встроенном каталоге Kilo, контекст по умолчанию равен нулю. Тогда Kilo не следит за переполнением и не сжимает историю: переписка растёт, пока модель не откажет.

Работает ли это в JetBrains и CLI?

Да. Расширение, CLI и плагин для JetBrains читают один и тот же kilo.jsonc, так что провайдера достаточно описать один раз.

Можно ли дать агентам разные модели?

Да. В Kilo у каждого агента своя модель: сильную — тем, кто планирует и пишет код, дешёвую — служебным задачам через small_model. Все они идут через один ключ и один баланс.

Нужен ли VPN?

Нет. Агенты Kilo обращаются к нашему API напрямую, он отвечает из России.

Рекомендуемые модели и цены

На странице модели — все цены, включая кэш, и калькулятор расхода.