Kilo Code — VS Code, JetBrains и CLI без VPN
Kilo Code — open-source агент для VS Code, JetBrains и терминала, подключённый к моделям AITUNNEL
Kilo Code — open-source агент для программирования, который работает в VS Code, JetBrains IDE и в терминале. С версии 7 он построен на ядре OpenCode: все три клиента читают один и тот же конфиг, так что провайдер достаточно настроить один раз. AITUNNEL подключается как пользовательский провайдер и даёт доступ к Claude, GPT, Gemini, DeepSeek, Kimi и другим моделям.
> Инструкция для Kilo Code 7.x. Старое расширение 5.x (форк Roo Code) с 31 июля 2026 года не поддерживается — если у вас оно, обновитесь.
API-ключ для Kilo Code
Kilo Code обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.ru и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
В kilo.jsonc ключ не пишется открытым текстом: конфиг ссылается на переменную {env:AITUNNEL_API_KEY}. Задайте её в профиле оболочки:
# macOS / Linux: ~/.zshrc или ~/.bashrc
export AITUNNEL_API_KEY="sk-aitunnel-xxx"# Windows
setx AITUNNEL_API_KEY "sk-aitunnel-xxx"VS Code и JetBrains, запущенные из Dock или меню «Пуск», могут не видеть переменную из ~/.zshrc. Тогда откройте IDE из терминала (code .) или введите ключ в форме Custom provider. Один ключ работает во всех трёх клиентах Kilo и для индексации кода.
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- Kilo Code для VS Code, плагин для JetBrains или Kilo CLI
- Ключ AITUNNEL
sk-aitunnel-...из личного кабинета - Положительный баланс (от 500₽)
Аккаунт Kilo не обязателен — пользовательский провайдер работает без входа.
Способ 1: через интерфейс VS Code или JetBrains
- Откройте панель Kilo Code → шестерёнка → вкладка Providers.
- Пролистайте вниз и нажмите Custom provider.
- Заполните форму:
- Provider ID: aitunnel — строчными буквами; модели будут называться aitunnel/<модель> - Display name: AITUNNEL - Provider API: OpenAI Compatible - Base URL: https://api.aitunnel.ru/v1 - API key: sk-aitunnel-xxx - Models: нажмите Fetch models, чтобы загрузить список с AITUNNEL, или добавьте нужные id вручную
- Нажмите Submit.
В JetBrains настройки Kilo находятся в Settings → Tools → Kilo Code.
Форма не умеет задавать размер контекста и лимит ответа — их нужно дописать в конфиг (см. ниже). Без этого Kilo считает контекст нулевым и не сжимает историю автоматически.
Способ 2: через kilo.jsonc
Глобальный конфиг лежит в ~/.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 }
},
"kimi-k2.7-code": {
"name": "Kimi K2.7 Code",
"tool_call": true,
"limit": { "context": 262144, "output": 32000 }
},
"deepseek-v4.1-flash": {
"name": "DeepSeek V4.1 Flash",
"tool_call": true,
"reasoning": true,
"limit": { "context": 200000, "output": 32000 }
},
"gpt-6-luna": {
"name": "GPT-6 Luna",
"tool_call": true,
"limit": { "context": 200000, "output": 16000 }
}
}
}
}
}И задайте ключ в профиле оболочки:
export AITUNNEL_API_KEY="sk-aitunnel-xxx"Что важно:
model— модель по умолчанию,small_model— дешёвая модель для заголовков сессий и сообщений коммитовlimitобязателен для каждой модели. Без него контекст и лимит ответа считаются нулевыми{env:AITUNNEL_API_KEY}подставляется только в глобальном конфиге. В проектномkilo.jsoncпеременные не раскрываются — не кладите туда ключ, если файл попадает в git
Проектные настройки можно положить в ./kilo.jsonc или ./.kilo/kilo.jsonc — они дополняют глобальные.
Claude через формат Anthropic
Для Claude можно добавить второй провайдер на эндпоинте Anthropic Messages — он даёт родное кэширование промптов:
{
"provider": {
"aitunnel-claude": {
"npm": "@ai-sdk/anthropic",
"name": "AITUNNEL Claude",
"options": {
"baseURL": "https://api.aitunnel.ru/v1",
"apiKey": "{env:AITUNNEL_API_KEY}"
},
"models": {
"claude-sonnet-5.5": { "tool_call": true, "limit": { "context": 200000, "output": 64000 } },
"claude-opus-5.5": { "tool_call": true, "limit": { "context": 200000, "output": 64000 } }
}
}
}
}Здесь baseURL с /v1: AI SDK добавляет к нему только /messages.
GPT через Responses API
Для моделей GPT можно использовать "npm": "@ai-sdk/openai" с тем же baseURL — запросы пойдут на /v1/responses, который AITUNNEL тоже поддерживает. В форме интерфейса это вариант OpenAI Responses.
Kilo CLI
npm install -g @kilocode/cli
kiloCLI читает тот же ~/.config/kilo/kilo.jsonc. Полезные команды:
kilo models # убедиться, что модели aitunnel/* видны
kilo -m aitunnel/kimi-k2.7-code # запуск с конкретной модельюВнутри сессии /connect запускает интерактивное подключение провайдера. После правки конфига перезапустите CLI.
Модели для агентов
Режимы в Kilo 7 называются агентами: code, plan (бывший Architect), ask, debug. Каждому можно назначить свою модель — в Settings → вкладка Models или в конфиге:
{
"agent": {
"plan": { "model": "aitunnel/claude-opus-5.5" },
"code": { "model": "aitunnel/claude-sonnet-5.5" },
"ask": { "model": "aitunnel/deepseek-v4.1-flash" },
"debug": { "model": "aitunnel/claude-sonnet-5.5" }
}
}Приоритет: модель, выбранная в сессии → модель агента из конфига → глобальная model.
Индексация кода
Семантический поиск по проекту настраивается в Settings → Indexing (в CLI — команда /indexing) или в конфиге:
{
"indexing": {
"enabled": true,
"provider": "openai-compatible",
"model": "text-embedding-3-small",
"dimension": 1536,
"vectorStore": "lancedb",
"openai-compatible": {
"baseUrl": "https://api.aitunnel.ru/v1",
"apiKey": "sk-aitunnel-xxx"
}
}
}LanceDB работает локально без отдельного сервера (кроме Mac на Intel). Если предпочитаете Qdrant, укажите "vectorStore": "qdrant" и "qdrant": { "url": "http://localhost:6333" }. Обратите внимание: здесь ключ baseUrl пишется с маленькой rl, в отличие от baseURL у провайдера.
Какую модель выбрать
| Задача | Модель |
|---|---|
| Агент 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. Список моделей AITUNNEL отдаёт только с ключом. Если всё равно пусто — добавьте id вручную, они есть на странице моделей.
Агент быстро «забывает» начало задачи или не сжимает контекст
У модели не задан limit в kilo.jsonc. Добавьте "limit": { "context": ..., "output": ... }.
«Missing API key» в проектном конфиге
{env:...} в проектном файле не раскрывается. Перенесите провайдер в глобальный ~/.config/kilo/kilo.jsonc.
Старые инструкции не совпадают с интерфейсом
Инструкции для Kilo 5.x (провайдер «OpenAI Compatible» с полями как у Roo Code) к версии 7 не подходят. Используйте Custom provider или kilo.jsonc.
Почему это выгодно
- Без VPN — российский endpoint
api.aitunnel.ru - Один конфиг для трёх клиентов — VS Code, JetBrains и CLI
- Все модели по одному ключу — включая эмбеддинги для индексации
- Оплата в рублях — карты МИР, СБП, от 500₽
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- Custom provider в VS Code и JetBrains
- Один kilo.jsonc для IDE и CLI
- Claude через Anthropic Messages, GPT через Responses API
- Свои модели для агентов code, plan, ask, debug
- Индексация кода на эмбеддингах AITUNNEL
- Без VPN, оплата в рублях
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.