Kilo Code

Open-source агент для VS Code, JetBrains и терминала. Один конфиг на все три клиента, AITUNNEL подключается как Custom provider.

Kilo Code — open-source агент для программирования в VS Code, JetBrains IDE и терминале. С версии 7 он построен на ядре OpenCode, и все три клиента читают один конфиг: провайдер настраивается один раз.

Инструкция для Kilo Code 7.x, старое расширение 5.x с 31 июля 2026 года не поддерживается. Понадобится ключ из панели. Аккаунт Kilo не обязателен.

Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Kilo Code в каталоге инструментов.

Быстрый старт

  1. Установка

    Поставьте расширение для VS Code, плагин для JetBrains или CLI:

    bash
    npm install -g @kilocode/cli
  2. Ключ

    Конфиг ссылается на переменную окружения, ключ в нём открытым текстом не хранится. Добавьте её в ~/.zshrc или ~/.bashrc:

    bash
    export AITUNNEL_API_KEY="sk-aitunnel-xxx"

    На Windows — setx AITUNNEL_API_KEY …. IDE, запущенная из Dock или меню «Пуск», может не видеть переменную: откройте её из терминала (code .).

  3. Провайдер

    Создайте глобальный конфиг, он действует во всех клиентах:

    ~/.config/kilo/kilo.jsonc
    {
      "$schema": "https://app.kilo.ai/config.json",
      "model": "aitunnel/claude-sonnet-5.5",
      "small_model": "aitunnel/gpt-6-luna",
      "provider": {
        "aitunnel": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "AITUNNEL",
          "options": {
            "baseURL": "https://api.aitunnel.ru/v1",
            "apiKey": "{env:AITUNNEL_API_KEY}"
          },
          "models": {
            "claude-sonnet-5.5": {
              "name": "Claude Sonnet 5.5",
              "tool_call": true,
              "attachment": true,
              "modalities": { "input": ["text", "image"], "output": ["text"] },
              "limit": { "context": 200000, "output": 32000 }
            },
            "gpt-6-luna": {
              "name": "GPT-6 Luna",
              "tool_call": true,
              "limit": { "context": 200000, "output": 16000 }
            }
          }
        }
      }
    }

    small_model пишет заголовки сессий и сообщения коммитов. limit обязателен у каждой модели: без него контекст считается нулевым и история не сжимается.

    В IDE можно вместо файла заполнить форму: Providers → Custom provider, Provider ID aitunnel, Provider API OpenAI Compatible, Base URL https://api.aitunnel.ru/v1, затем Fetch models. Лимиты форма не задаёт, их всё равно придётся дописать в kilo.jsonc.

  4. Запуск

    bash
    kilo models                      # модели aitunnel/* должны быть в списке
    kilo -m aitunnel/claude-sonnet-5.5

    После правки конфига перезапустите CLI или IDE.

Модели для агентов

Режимы в Kilo 7 называются агентами: code, plan, ask, debug. Каждому можно назначить свою модель на вкладке Models или в конфиге:

~/.config/kilo/kilo.jsonc
{
  "agent": {
    "plan": { "model": "aitunnel/claude-opus-5.5" },
    "code": { "model": "aitunnel/claude-sonnet-5.5" },
    "ask": { "model": "aitunnel/deepseek-v4.1-flash" }
  }
}

Приоритет: модель, выбранная в сессии, затем модель агента, затем глобальная model.

Модели

ЗадачаМодель
Агент codeclaude-sonnet-5.5, gpt-6.1-sol
Планирование (plan)claude-opus-5.5
Код подешевлеkimi-k2.7-code, glm-5.3
Вопросы (ask)deepseek-v4.1-flash
small_modelgpt-6-luna, claude-haiku-5.5

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

Fetch models ничего не загружает

Проверьте ключ и Base URL с /v1: список моделей отдаётся только с ключом. Можно добавить id вручную из каталога.

Агент забывает начало задачи

У модели нет limit в kilo.jsonc. Добавьте "limit": { "context": ..., "output": ... }.

Missing API key в проектном конфиге

{env:...} раскрывается только в глобальном ~/.config/kilo/kilo.jsonc. Перенесите провайдер туда и не кладите ключ в ./kilo.jsonc, если файл попадает в git.

Смотрите также