← Блог
Kilo CodeИнтеграцияАгенты для кода

Kilo Code с Claude и GPT: настройка своего API-провайдера

(цены в тексте следуют актуальному прайс-листу)

Коротко

Чтобы использовать Kilo Code с APIVAI, откройте Settings в Kilo Code, перейдите на вкладку Providers, нажмите Custom provider, в поле Provider API выберите OpenAI Compatible, в Base URL укажите https://api.apivai.com/v1, вставьте ключ APIVAI в API key и добавьте ID модели, например claude-sonnet-4-6 или gpt-5.5. Если нужен только Claude, в качестве Provider API можно выбрать Anthropic Messages, и в Kilo Code этот вариант тоже принимает https://api.apivai.com/v1 с /v1, потому что Kilo Code добавляет к Base URL только /messages. На 2026-10-10 Claude Sonnet 4.6 через APIVAI стоит $1.15 / $5.74 за миллион входных / выходных токенов против официальных $3.00 / $15.00. Оплата идёт за токены с предоплаченного баланса, без подписки.

Что такое Kilo Code и зачем подключать свой API-ключ?

Kilo Code — AI-агент для программирования с открытым исходным кодом. Он работает как расширение VS Code, плагин JetBrains и консольная утилита. Агент планирует изменения, правит файлы по всему проекту и с вашего разрешения запускает команды. Kilo Code нужен провайдер модели, и каждый шаг задачи — это запрос, который оплачивается у этого провайдера.

Руководство основано на актуальной документации Kilo Code и расширении VS Code версии 7.8 (октябрь 2026 года), где сторонние API добавляются через диалог Custom provider. Если в настройках нет кнопки Custom provider, сначала обновите расширение.

APIVAI даёт один ключ для моделей Claude и GPT с оплатой за токены (для большинства моделей ниже официальных цен), с баланса, который вы пополняете сами. Ключ работает и в формате OpenAI, и в формате Anthropic, поэтому подходит для любого варианта Provider API в Kilo Code.

Какой Provider API выбрать в Kilo Code?

В диалоге Custom provider есть три протокола. С APIVAI у всех трёх один и тот же Base URL:

Provider APIBase URLМоделиСписок моделей
OpenAI Compatiblehttps://api.apivai.com/v1Claude и GPTРаботает Fetch models
Anthropic Messageshttps://api.apivai.com/v1Только ClaudeID вводятся вручную
OpenAI Responseshttps://api.apivai.com/v1GPTРаботает Fetch models

Выбирайте OpenAI Compatible, если нужен один провайдер для Claude и GPT. Добавьте провайдер Anthropic Messages, если работаете в основном с Claude: тогда Kilo Code отправляет нативные запросы Anthropic с метками cache_control, и повторяющийся контекст оплачивается по цене чтения из кэша — $0.12 за миллион токенов для Claude Sonnet 4.6 — вместо полной цены входа. Запись в кэш стоит $1.44 за миллион. OpenAI Responses — по желанию: модели GPT и так работают через OpenAI Compatible.

Как настроить Kilo Code с APIVAI по шагам?

Шаг 1: Создайте ключ APIVAI

  1. Зарегистрируйтесь на apivai.com по email.
  2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Бесплатного периода и подписки нет.
  3. В Панели создайте ключ и скопируйте его. Задайте лимит бюджета, если хотите жёстко ограничить расходы Kilo Code.

Шаг 2: Добавьте APIVAI как пользовательского провайдера

  1. В VS Code откройте панель Kilo Code, нажмите на шестерёнку, чтобы открыть Settings, и перейдите на вкладку Providers.
  2. Прокрутите вниз и нажмите Custom provider.
  3. Заполните диалог по таблице и нажмите Submit.
ПолеЗначение
Provider IDapivai (строчные буквы, цифры, дефисы или подчёркивания)
Display nameAPIVAI
Provider APIOpenAI Compatible
Base URLhttps://api.apivai.com/v1
API keyВаш ключ APIVAI
ModelsНажмите Fetch models и выберите, например, claude-sonnet-4-6 и gpt-5.5

Когда Base URL и ключ заполнены, Kilo Code запрашивает GET /v1/models с вашим ключом и показывает список с поиском, так что вы добавляете только те ID, которые APIVAI действительно обслуживает. Если загрузка не удалась, проверьте ключ и адрес или нажмите Add model и введите точный ID вручную. Base URL содержит /v1 ровно один раз; Kilo Code сам добавляет /chat/completions. После Submit выберите модель в списке моделей Kilo Code.

Тот же список можно проверить из терминала:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

Модели со временем добавляются и снимаются, поэтому копируйте ID из этого списка или со страницы цен.

Шаг 3 (по желанию): Добавьте провайдер Claude через Anthropic Messages

  1. Снова нажмите Custom provider.
  2. В Provider ID укажите apivai-claude, в Display name — «APIVAI Claude».
  3. В Provider API выберите Anthropic Messages.
  4. В Base URL введите https://api.apivai.com/v1, в API key вставьте тот же ключ.
  5. В разделе Models нажмите Add model и введите ID моделей Claude, например claude-sonnet-4-6 и claude-opus-5-5. Fetch models для этого Provider API недоступен.
  6. Нажмите Submit.

Здесь /v1 нужно оставить. Клиент Anthropic Messages в Kilo Code считает Base URL версионированным префиксом API (его собственное значение по умолчанию — https://api.anthropic.com/v1) и добавляет только /messages, поэтому запросы уходят на https://api.apivai.com/v1/messages. Это противоположно Claude Code и Roo Code, где базовый адрес Anthropic — https://api.apivai.com без /v1. О формате Anthropic — на странице прокси для Claude API.

Шаг 4: Задайте лимиты токенов в файле конфигурации

Диалог не задаёт лимиты контекста и вывода. Документация Kilo Code рекомендует указывать limit.context и limit.output для пользовательских моделей: если оба не заданы, они становятся равны 0, и автоматическое сжатие контекста отключается. Откройте редактирование провайдера (в диалоге есть ссылка Edit advanced settings in the JSON config file) или глобальный файл ~/.config/kilo/kilo.json и добавьте лимиты в раздел провайдера:

{
  "provider": {
    "apivai": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "tool_call": true,
          "limit": { "context": 200000, "output": 16384 }
        }
      }
    }
  },
  "model": "apivai/claude-sonnet-4-6"
}

В limit.context укажите контекстное окно со страницы модели, а limit.output оставьте 16384 (не меньше 4096). Ключ, введённый в диалоге, остаётся там, куда его сохранил Kilo Code; чтобы брать его из переменной окружения, добавьте "apiKey": "{env:APIVAI_API_KEY}" в options (это работает в глобальной конфигурации, но не в kilo.json на уровне проекта). Kilo CLI читает тот же файл.

Какую модель выбрать в Kilo Code?

Цены за 1M входных / выходных токенов на 2026-10-10:

ID моделиЦена (вход / выход)Для чего
claude-sonnet-4-6$1.15 / $5.74Повседневное программирование: выбор по умолчанию
claude-sonnet-5-5$0.77 / $3.82Программирование на более новом Sonnet
claude-opus-5-5$1.54 / $7.65Планирование, самые сложные баги
claude-haiku-4-5$0.38 / $1.92Быстрые дешёвые вопросы и мелкие правки
gpt-6-sol$0.30 / $1.52Альтернатива на GPT для кода или ревью
gpt-6-luna$0.0144 / $0.0768Очень дешёвые вопросы

Агенты Kilo Code вызывают инструменты почти на каждом шаге, поэтому выбирайте модели с поддержкой function calling; все модели в таблице её поддерживают. Если задача на Sonnet ходит по кругу, переключите эту задачу на Opus, а не делайте Opus моделью по умолчанию.

Сколько стоит Kilo Code с APIVAI?

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

  • Одна задача по программированию на Claude Sonnet 4.6: около 25 запросов по 35 000 входных и 2 000 выходных токенов. Стоимость: $1.29 с APIVAI, $3.38 по официальным ценам.
  • Рабочий месяц по три такие задачи в день в течение 22 дней (1 650 запросов): $85.35 с APIVAI, $223 по официальным ценам. Если 20 быстрых вопросов в день отдавать Claude Haiku 4.5 (по 8 000 входных и 800 выходных токенов, 440 в месяц), это добавит $2.01.

В расчётах не учтено кэширование промптов, которое удешевляет повторяющийся контекст у провайдера Anthropic Messages. Токены размышлений считаются выходными. Реальные цифры по каждому запросу — в Панели. Более широкое сравнение — в статье цены Claude API в 2026 году.

Как исправить частые ошибки Kilo Code?

  • «Authentication failed» при загрузке моделей или 401: ключ неполный, удалён или исчерпал лимит бюджета; проверьте Панель и вставьте ключ заново без пробелов.
  • 404 Not Found: неправильный /v1. В Kilo Code для любого Provider API указывается https://api.apivai.com/v1. Без /v1 Anthropic Messages обращается к /messages, а OpenAI Compatible — к /chat/completions по неверному пути.
  • Anthropic Messages не находит моделей: так и должно быть — у этого Provider API нет загрузки списка. Добавьте ID Claude через Add model.
  • Модель не найдена: укажите точный ID, например claude-sonnet-4-6, а не отображаемое название. Сверьтесь с GET /v1/models.
  • Пустые или обрезанные ответы: размышления включены по умолчанию и расходуют выходные токены. Установите limit.output 16384 (не меньше 4096).
  • Контекст не сжимается на длинных задачах: задайте limit.context и limit.output, как в шаге 4.
  • 429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ. Подождите немного или попросите поддержку увеличить лимит.

Подробнее о форматах запросов — в документации и на странице OpenAI-совместимый API.

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

Можно ли использовать Claude и GPT в Kilo Code с одним ключом?

Да. Один ключ APIVAI работает со всеми моделями. В одном провайдере OpenAI Compatible можно держать ID Claude и GPT рядом.

Что выбрать: OpenAI Compatible или Anthropic Messages?

OpenAI Compatible — для моделей GPT или одного провайдера на всё. Anthropic Messages добавьте для работы в основном с Claude: там Kilo Code использует кэширование промптов; его Base URL тоже https://api.apivai.com/v1.

Почему Kilo Code нужен /v1 для Anthropic, а Claude Code — нет?

Клиент Claude Code добавляет к базовому адресу /v1/messages, а клиент Anthropic Messages в Kilo Code — только /messages. В обоих случаях запрос приходит на https://api.apivai.com/v1/messages.

Работает ли та же настройка в Kilo CLI?

Да. CLI берёт провайдера из kilo.json, поэтому блок конфигурации из шага 4 подходит и для него.

Хранит ли APIVAI мой код?

Нет. Содержимое запросов и ответов не записывается; для биллинга сохраняются только данные об использовании: модель, токены и стоимость.

Чем это отличается от Roo Code или Cline?

Модели и ключ те же, но экраны настроек другие. См. руководство по Roo Code и руководство по Cline.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Kilo Code.

Готовы начать?

Получите API-ключ за 30 секунд. Оплата по факту использования Claude и GPT.

Начать