Конфигурация Kilocode

Kilocode — мощное расширение для VSCode, предоставляющее автодополнение кода на основе AI, встроенный чат и действия с кодом. Настройте его для использования MegaLLM и получите доступ к множеству AI-моделей.

Быстрая настройка

Через интерфейс настроек
Через settings.json
Используя переменные окружения

Пошаговая настройка

Откройте настройки VSCode

Нажмите Ctrl+Shift+P (Windows/Linux) или Cmd+Shift+P (Mac)
Введите: Preferences: Open Settings (UI)
Найдите: Kilocode

Настройте API-провайдера

API Provider: Выберите Custom
Provider Name: MegaLLM
Base URL: https://ai.megallm.io/v1
API Key: sk-mega-your-api-key-here

Выберите модель по умолчанию

Default Model: gpt-5 (или любая поддерживаемая модель)
Temperature: 0.3 (ниже = более детерминированно)
Max Tokens: 500 (для автодополнений)

Включите функции

Enable AutoComplete
Enable Inline Chat
Enable Code Actions
Enable Suggestions

Файл конфигурации

Расположение: .vscode/settings.json или ~/.config/Code/User/settings.json

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "sk-mega-your-api-key-here"
  },
  "kilocode.defaultModel": "gpt-5",
  "kilocode.enableAutoComplete": true,
  "kilocode.enableInlineChat": true,
  "kilocode.enableCodeActions": true,
  "kilocode.modelSettings": {
    "temperature": 0.3,
    "maxTokens": 500,
    "topP": 0.9
  }
}

Вы можете использовать переменные окружения: "apiKey": "${env:MEGALLM_API_KEY}"

Безопасная конфигурация

Шаг 1: Установите переменные окружения

# Добавьте в ~/.bashrc, ~/.zshrc, или ~/.config/fish/config.fish
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
export MEGALLM_BASE_URL="https://ai.megallm.io/v1"

Шаг 2: Перезагрузите оболочку

source ~/.bashrc  # или ~/.zshrc

Шаг 3: Укажите ссылки в settings.json

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "${env:MEGALLM_BASE_URL}",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gpt-5"
}

API-ключ остается в безопасности и вне системы контроля версий

Примеры сценариев

Сценарий 1: Первая установка

Полная настройка с нуля:

Установите расширение Kilocode

Откройте VSCode
Перейдите в Расширения: Ctrl+Shift+X / Cmd+Shift+X
Найдите: Kilocode
Нажмите Install
Перезагрузите окно VSCode

Получите API-ключ MegaLLM

Посетите Панель управления MegaLLM
Перейдите в раздел API Keys
Нажмите Create New Key
Скопируйте ключ (начинается с sk-mega-)
Сохраните его в безопасном месте

Настройте расширение

Откройте настройки (Ctrl+, / Cmd+,) и добавьте:

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "sk-mega-your-actual-key-here"
  },
  "kilocode.defaultModel": "gpt-5"
}

Проверьте конфигурацию

Создайте новый файл: test.js
Введите комментарий: // function to calculate fibonacci
Нажмите Tab для запуска автодополнения
Должен появиться код, сгенерированный AI

Ожидаемый результат:

// function to calculate fibonacci
function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}

Сценарий 2: Конфигурация командного проекта

Настройка Kilocode для всей команды разработки: Структура проекта:

my-project/
├── .vscode/
│   ├── settings.json          # Общая конфигурация (коммитится)
│   └── settings.local.json    # Личные ключи (в gitignore)
├── .gitignore
└── README.md

Шаг 1: Создайте общую конфигурацию .vscode/settings.json (коммитится в git):

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gpt-5",
  "kilocode.modelSettings": {
    "temperature": 0.7,
    "maxTokens": 1000
  },
  "kilocode.enableAutoComplete": true,
  "kilocode.enableInlineChat": true
}

Шаг 2: Настройте .gitignore

# .gitignore
.vscode/settings.local.json
.env

Шаг 3: Создайте инструкции по установке README.md:

## Настройка Kilocode

### Предварительные требования
1. VSCode с установленным расширением Kilocode
2. API-ключ MegaLLM ([Получить](https://megallm.io/dashboard))

### Конфигурация

1. **Установите переменную окружения:**
   ```bash
   export MEGALLM_API_KEY="your-key-here"

Добавьте в конфигурацию вашей оболочки (~/.bashrc или ~/.zshrc) для сохранения.

Или создайте локальные настройки (не коммитится): .vscode/settings.local.json:
{ "kilocode.customProvider": { "apiKey": "your-key-here" } }
Перезагрузите VSCode и начинайте кодить!

Проверка

Введите // hello world function и нажмите Tab. Должен появиться код, сгенерированный AI.

**Шаг 4: Члены команды клонируют и настраивают**

```bash
# Рабочий процесс члена команды
git clone https://github.com/company/my-project.git
cd my-project

# Добавьте личный API-ключ
export MEGALLM_API_KEY="their-personal-key"

# Или создайте .vscode/settings.local.json с их ключом

# Откройте в VSCode
code .

Сценарий 3: Выбор модели для конкретного проекта

Используйте разные модели для разных проектов: Проект по Data Science на Python: .vscode/settings.json:

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "claude-opus-4-1-20250805",
  "kilocode.customPrompts": {
    "analyze": "Проанализируйте этот код обработки данных на эффективность",
    "doc": "Сгенерируйте docstring в стиле numpy для этой функции"
  }
}

Проект на JavaScript/React: .vscode/settings.json:

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gpt-5",
  "kilocode.customPrompts": {
    "component": "Сгенерируйте функциональный компонент React",
    "test": "Напишите тесты Jest для этого компонента"
  }
}

Системное программирование (Rust/Go): .vscode/settings.json:

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gemini-2.5-pro",
  "kilocode.modelSettings": {
    "temperature": 0.2  // Ниже для более точного системного кода
  }
}

Сценарий 4: Работа с несколькими моделями

Динамическое переключение моделей в зависимости от задачи: Конфигурация:

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gpt-5",
  "kilocode.modelProfiles": {
    "fast": {
      "model": "gpt-4o-mini",
      "temperature": 0.5,
      "maxTokens": 300
    },
    "quality": {
      "model": "claude-opus-4-1-20250805",
      "temperature": 0.3,
      "maxTokens": 1000
    },
    "creative": {
      "model": "gpt-5",
      "temperature": 0.9,
      "maxTokens": 800
    }
  }
}

Использование:

Утро (быстрое прототипирование): Используйте профиль fast с GPT-4o-mini
День (качественный код): Используйте профиль quality с Claude Opus
Документация: Используйте профиль creative с более высокой температурой

Переключение профилей через командную палитру:

Ctrl+Shift+P / Cmd+Shift+P
Kilocode: Switch Model Profile
Выберите: fast, quality или creative

Сценарий 5: Миграция с GitHub Copilot

Переход с Copilot на Kilocode с MegaLLM: Текущая настройка (Copilot):

{
  "github.copilot.enable": true
}

Новая настройка (Kilocode + MegaLLM):

Отключите Copilot

{
  "github.copilot.enable": false
}

Установите Kilocode

VSCode Расширения → Поиск “Kilocode” → Установить

Настройте MegaLLM

{
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },
  "kilocode.defaultModel": "gpt-5"
}

Сравните опыт

Преимущества перед Copilot:

Доступ к нескольким моделям (GPT, Claude, Gemini)
Лучшие цены и без ограничений на места
Встроенный чат для объяснений
Индивидуальный выбор модели для каждого проекта
Действия с кодом помимо автодополнения

Параметры конфигурации

Полный справочник

{
  // Конфигурация провайдера
  "kilocode.apiProvider": "custom",
  "kilocode.customProvider": {
    "name": "MegaLLM",
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}"
  },

  // Настройки модели
  "kilocode.defaultModel": "gpt-5",
  "kilocode.modelSettings": {
    "temperature": 0.3,        // 0.0-2.0: Ниже = более сфокусированно
    "maxTokens": 500,          // Макс. длина автодополнения
    "topP": 0.9,               // Nucleus sampling
    "frequencyPenalty": 0.0,   // Уменьшение повторений
    "presencePenalty": 0.0     // Поощрение разнообразия
  },

  // Переключатели функций
  "kilocode.enableAutoComplete": true,
  "kilocode.enableInlineChat": true,
  "kilocode.enableCodeActions": true,
  "kilocode.enableSuggestions": true,
  "kilocode.enableHover": true,

  // Поведение
  "kilocode.autoTrigger": true,
  "kilocode.debounceDelay": 300,     // мс перед запуском
  "kilocode.maxSuggestions": 3,
  "kilocode.showInlineHints": true,

  // Пользовательские промпты
  "kilocode.customPrompts": {
    "doc": "Сгенерируйте подробную документацию",
    "test": "Напишите юнит-тесты с высоким покрытием",
    "refactor": "Рефакторинг для лучшей поддерживаемости",
    "optimize": "Оптимизируйте производительность",
    "secure": "Проверьте на уязвимости безопасности"
  },

  // Сочетания клавиш
  "kilocode.shortcuts": {
    "acceptSuggestion": "Tab",
    "nextSuggestion": "Alt+]",
    "prevSuggestion": "Alt+[",
    "dismissSuggestion": "Esc",
    "triggerInlineChat": "Ctrl+K"
  },

  // Настройки интерфейса
  "kilocode.ui": {
    "showStatusBar": true,
    "showInlineButtons": true,
    "theme": "auto",               // auto, light, dark
    "position": "right"            // left, right
  }
}

Руководство по выбору модели

Задача	Рекомендуемая модель	Причина
Автодополнение кода	`gpt-4o-mini`	Быстрая, экономичная
Сложная логика	`claude-opus-4-1-20250805`	Превосходное рассуждение
Веб-разработка	`gpt-5`	Отличный JS/TS/React
Data Science	`claude-sonnet-4`	Сильный анализ
Документация	`gpt-5`	Четкие объяснения
Алгоритмы	`gemini-2.5-pro`	Математическая точность

См. полный каталог моделей для всех доступных вариантов.

Проверка

Тест 1: Базовое автодополнение

// Введите этот комментарий и нажмите Tab:
// function to check if string is palindrome

// Ожидаемый результат:
function isPalindrome(str) {
  const cleaned = str.toLowerCase().replace(/[^a-z0-9]/g, '');
  return cleaned === cleaned.split('').reverse().join('');
}

Тест 2: Встроенный чат

Выделите функцию
Нажмите Ctrl+K (или Cmd+K на Mac)
Введите: Explain this function
Должно появиться объяснение в панели чата

Тест 3: Действия с кодом

Щелкните правой кнопкой мыши на коде
Должны увидеть “Kilocode Actions” в контекстном меню
Опции: Объяснить, Улучшить, Сгенерировать тесты и т.д.

Тест 4: Строка состояния

Проверьте правый нижний угол VSCode:

Должно показывать: Kilocode: Connected
Название модели: gpt-5 (или ваша выбранная модель)
Кликните, чтобы увидеть детали подключения

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

Автодополнения не появляются

Симптомы:

Нет предложений при вводе
Строка состояния показывает “Disconnected”

Решения:

Проверьте API-ключ:

echo $MEGALLM_API_KEY
# Должен вывести: sk-mega-...

Проверьте конфигурацию:

{
  "kilocode.apiProvider": "custom",  // Должно быть "custom"
  "kilocode.customProvider": {
    "baseURL": "https://ai.megallm.io/v1"  // Без слэша в конце
  }
}

Перезагрузите VSCode:
- Ctrl+Shift+P / Cmd+Shift+P
- Запустите: Developer: Reload Window
Проверьте, что расширение включено:
- Панель расширений
- Поиск: Kilocode
- Должно показывать “Enabled”

Протестируйте API вручную:

curl -X POST https://ai.megallm.io/v1/chat/completions \
  -H "Authorization: Bearer $MEGALLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"test"}]}'

Неправильные или низкокачественные автодополнения

Симптомы:

Автодополнения некорректны
Предложения не соответствуют стилю кода
Нерелевантные ответы

Решения:

Настройте температуру:

{
  "kilocode.modelSettings": {
    "temperature": 0.2  // Ниже = более сфокусированно (0.0-1.0)
  }
}

Попробуйте другую модель:

{
  "kilocode.defaultModel": "claude-sonnet-4"  // Лучше для анализа
}

Увеличьте контекст:

{
  "kilocode.modelSettings": {
    "maxTokens": 1000  // Более детальные автодополнения
  }
}

Добавьте промпт для конкретного проекта:

{
  "kilocode.systemPrompt": "Вы эксперт по TypeScript и React. Следуйте руководству по стилю Airbnb."
}

Высокая задержка / медленные автодополнения

Симптомы:

Долгое ожидание предложений
Ошибки тайм-аута

Решения:

Используйте более быструю модель:

{
  "kilocode.defaultModel": "gpt-4o-mini"  // Самая быстрая
}

Уменьшите максимум токенов:

{
  "kilocode.modelSettings": {
    "maxTokens": 300  // Более быстрые автодополнения
  }
}

Увеличьте задержку debounce:

{
  "kilocode.debounceDelay": 500  // Ждите дольше перед запуском
}

Проверьте сеть:

ping ai.megallm.io
curl -w "@-" -o /dev/null -s https://ai.megallm.io/v1/models <<'EOF'
time_total: %{time_total}s
EOF

API-ключ не распознается

Симптомы:

Ошибка “Invalid API key”
401 Unauthorized

Решения:

Проверьте формат ключа:
- Должен начинаться с sk-mega-
- Минимум 60 символов
- Без пробелов или кавычек
Проверьте, что ключ активен:
- Войдите в Панель управления
- Перейдите в API Keys
- Убедитесь, что ключ не отозван/истек

Протестируйте ключ напрямую:

curl -H "Authorization: Bearer sk-mega-your-key" \
     https://ai.megallm.io/v1/models

Перегенерируйте при необходимости:
- Панель управления → API Keys → Создать новый
- Обновите конфигурацию новым ключом

Конфликты с другими расширениями

Симптомы:

Автодополнения Kilocode конфликтуют с другими AI-инструментами
Появляется несколько предложений

Решения:

Отключите конфликтующие расширения:

{
  "github.copilot.enable": false,
  "tabnine.disable": true,
  "aws.codeWhisperer.enabled": false
}

Настройте клавиши запуска:

{
  "kilocode.shortcuts": {
    "acceptSuggestion": "Alt+Enter"  // Отличается от Tab
  }
}

Установите приоритет:

{
  "editor.suggest.snippetsPreventQuickSuggestions": false,
  "editor.quickSuggestions": {
    "other": "on",
    "comments": "off",
    "strings": "on"
  }
}

Лучшие практики

Используйте переменные окружения

Храните API-ключи в переменных окружения, ссылайтесь с помощью ${env:MEGALLM_API_KEY}

Модели для конкретных проектов

Настраивайте разные модели в .vscode/settings.json для каждого проекта

Низкая температура для кода

Используйте 0.2-0.4 для генерации кода, 0.7-0.9 для документации

Мониторинг использования токенов

Проверяйте Панель управления для оптимизации затрат

Продвинутые советы

Пользовательские сочетания клавиш

Добавьте в keybindings.json:

[
  {
    "key": "ctrl+alt+k",
    "command": "kilocode.triggerSuggestion",
    "when": "editorTextFocus"
  },
  {
    "key": "ctrl+alt+e",
    "command": "kilocode.explainCode",
    "when": "editorHasSelection"
  },
  {
    "key": "ctrl+alt+t",
    "command": "kilocode.generateTests",
    "when": "editorTextFocus"
  }
]

Промпты для конкретного рабочего пространства

.vscode/settings.json:

{
  "kilocode.customPrompts": {
    "api": "Сгенерируйте RESTful API эндпоинт следуя нашим соглашениям",
    "schema": "Создайте модель схемы Prisma",
    "hook": "Сгенерируйте пользовательский хук React",
    "component": "Создайте styled-component с TypeScript"
  }
}

Контекстно-зависимые автодополнения

{
  "kilocode.contextSettings": {
    "includeOpenFiles": true,
    "includeImports": true,
    "includeTypes": true,
    "maxContextFiles": 5
  }
}

Следующие шаги

Настройка RooCode

Настройте приложение RooCode

Настройка Cline

Настройте расширение VSCode Cline

Каталог моделей

Просмотрите все доступные модели

Другие агенты

Просмотрите все CLI и GUI агенты

Справочник API

Изучите документацию API

Сообщество Discord

Присоединяйтесь для поддержки

​Быстрая настройка

​Пошаговая настройка

​Файл конфигурации

​Безопасная конфигурация

​Примеры сценариев

​Сценарий 1: Первая установка

​Сценарий 2: Конфигурация командного проекта

​Проверка

​Сценарий 3: Выбор модели для конкретного проекта

​Сценарий 4: Работа с несколькими моделями

​Сценарий 5: Миграция с GitHub Copilot

​Параметры конфигурации

​Полный справочник

​Руководство по выбору модели

​Проверка

​Тест 1: Базовое автодополнение

​Тест 2: Встроенный чат

​Тест 3: Действия с кодом

​Тест 4: Строка состояния

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

​Лучшие практики

Используйте переменные окружения

Модели для конкретных проектов

Низкая температура для кода

Мониторинг использования токенов

​Продвинутые советы

​Пользовательские сочетания клавиш

​Промпты для конкретного рабочего пространства

​Контекстно-зависимые автодополнения

​Следующие шаги

Настройка RooCode

Настройка Cline

Каталог моделей

Другие агенты

Справочник API

Сообщество Discord

Быстрая настройка

Пошаговая настройка

Файл конфигурации

Безопасная конфигурация

Примеры сценариев

Сценарий 1: Первая установка

Сценарий 2: Конфигурация командного проекта

Проверка

Сценарий 3: Выбор модели для конкретного проекта

Сценарий 4: Работа с несколькими моделями

Сценарий 5: Миграция с GitHub Copilot

Параметры конфигурации

Полный справочник

Руководство по выбору модели

Проверка

Тест 1: Базовое автодополнение

Тест 2: Встроенный чат

Тест 3: Действия с кодом

Тест 4: Строка состояния

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

Лучшие практики

Продвинутые советы

Пользовательские сочетания клавиш

Промпты для конкретного рабочего пространства

Контекстно-зависимые автодополнения

Следующие шаги