Перейти к основному содержанию
Kilo Code — это open-source AI-агент для кодинга, доступный в VS Code, JetBrains, CLI, Slack и Cloud. Он подключается к OrcaRouter через свой Custom provider (кастомный провайдер) — эндпоинт, совместимый с OpenAI. Это руководство охватывает как расширение для VS Code (самый распространённый способ использования Kilo Code), так и CLI (@kilocode/cli, для headless-режима).
Протокол: OpenAI-совместимый
  • Базовый URL: https://api.orcarouter.ai/v1 (включает /v1)
  • Идентификаторы моделей используют формат vendor/model — самый простой вариант: orcarouter/auto

​
Расширение для VS Code

  1. Установите Kilo Code из VS Code Marketplace (откройте панель Extensions и найдите “Kilo Code”), затем откройте его по иконке Kilo Code на панели Activity Bar (левая полоса с иконками). В панели нажмите на ⚙ шестерёнку в правом верхнем углу, чтобы открыть настройки.
Панель Kilo Code с выделенной шестерёнкой настроек
  1. Перейдите в Providers (провайдеры). В разделе Popular providers (популярные провайдеры) найдите Custom provider (кастомный провайдер, “Add an OpenAI-compatible provider by base URL”) и нажмите + Connect.
Запись Custom provider в настройках Providers в Kilo Code
  1. Заполните поля провайдера:
    • Provider ID: orcarouter (только строчные буквы, цифры, дефисы или подчёркивания — без слешей; orcarouter/auto здесь не принимается).
    • Display name: OrcaRouter (любое имя на ваш вкус).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: ваш ключ OrcaRouter (sk-orca-...).
Provider ID, базовый URL и API-ключ OrcaRouter в Kilo Code
  1. Выберите модели. Как только ключ и базовый URL станут корректными, Kilo Code загрузит актуальный список моделей из OrcaRouter — отметьте нужные (или нажмите Select all), затем нажмите Submit. Чтобы использовать авто-маршрутизацию, дополнительно нажмите + Add model и укажите ID модели orcarouter/auto (это алиас маршрутизации, поэтому в загруженном списке он не появится).
Выбор моделей в Kilo Code со списком моделей, загруженным из OrcaRouter
  1. Теперь провайдер отображается в разделе Connected providers как OrcaRouter (CUSTOM).
OrcaRouter в списке Connected providers в Kilo Code
  1. Выберите модель OrcaRouter в выборе модели на панели чата и отправьте тестовое сообщение — ответ подтвердит подключение.
Kilo Code отвечает через OrcaRouter
На большом репозитории Kilo Code может сначала спросить, ждать ли инициализации своей системы снимков (snapshot) — выберите Disable for this project, чтобы пропустить её (git по-прежнему отслеживает всё), и тогда запрос пройдёт.
Плагин для JetBrains использует тот же Custom provider с идентичными значениями базового URL / ключа / моделей.

​
CLI

Для headless-режима / использования в скриптах установите CLI.

​
Установка

npm install -g @kilocode/cli
Команда называется kilo.

​
Настройка

Файл конфигурации: ~/.config/kilo/kilo.jsonc (также принимает kilo.json; проектный ./kilo.jsonc переопределяет). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
При желании подставьте конкретную модель, например anthropic/claude-opus-4.8 или google/gemini-2.5-flash. Имена моделей используют формат vendor/model.

​
Запуск

echo "Reply with exactly: OK" | kilo run --auto --format json
Ожидается: JSON-событие с "type":"text" и "text":"OK".

​
Примечания

  • base_url включает /v1.
  • Ссылки на модели используют формат provider/model. Поскольку провайдер называется orcarouter, а идентификатор модели тоже несёт префикс vendor, ссылка состоит из трёх сегментов: orcarouter/orcarouter/auto (или orcarouter/anthropic/claude-opus-4.8).
  • Headless-режим — это kilo run "<prompt>" --auto (или передайте промпт через stdin). --format json даёт машиночитаемый поток событий.
  • Reasoning/thinking: используйте флаг --variant <name> для специфичного для провайдера усилия reasoning (например, high, max, minimal) и --thinking для отображения блоков мышления.
Известная проблема: для --auto зарегистрированы случаи зависания после завершения / при отсутствии ключа (kilocode issues). Оборачивайте в timeout в CI и убедитесь, что ключ загружен.