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 в каталоге инструментов.
Быстрый старт
Установка
Поставьте расширение для VS Code, плагин для JetBrains или CLI:
bashnpm install -g @kilocode/cliКлюч
Конфиг ссылается на переменную окружения, ключ в нём открытым текстом не хранится. Добавьте её в
~/.zshrcили~/.bashrc:bashexport AITUNNEL_API_KEY="sk-aitunnel-xxx"На Windows —
setx AITUNNEL_API_KEY …. IDE, запущенная из Dock или меню «Пуск», может не видеть переменную: откройте её из терминала (code .).Провайдер
Создайте глобальный конфиг, он действует во всех клиентах:
~/.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 URLhttps://api.aitunnel.ru/v1, затем Fetch models. Лимиты форма не задаёт, их всё равно придётся дописать вkilo.jsonc.Запуск
bashkilo models # модели aitunnel/* должны быть в списке kilo -m aitunnel/claude-sonnet-5.5После правки конфига перезапустите CLI или IDE.
Модели для агентов
Режимы в Kilo 7 называются агентами: code, plan, ask, debug. Каждому можно назначить свою модель на вкладке Models или в конфиге:
{
"agent": {
"plan": { "model": "aitunnel/claude-opus-5.5" },
"code": { "model": "aitunnel/claude-sonnet-5.5" },
"ask": { "model": "aitunnel/deepseek-v4.1-flash" }
}
}Приоритет: модель, выбранная в сессии, затем модель агента, затем глобальная model.
Модели
| Задача | Модель |
|---|---|
| Агент code | claude-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_model | gpt-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.