> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megallm.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Обзор AI-агентов для кодирования
> Настройка AI-агентов для использования MegaLLM - CLI инструменты и GUI расширения
MegaLLM поддерживает все основные AI-агенты для кодирования. Это единое руководство охватывает настройку Claude Code, Codex/Windsurf, OpenCode, Kilocode, RooCode и Cline.
## Доступные агенты
CLI + интеграция с редактором через JSON конфигурацию
CLI + редактор с TOML конфигурацией
CLI + редактор с автоматической загрузкой моделей
Расширение VSCode с встроенным чатом (CLI скоро)
Отдельное приложение с визуальным интерфейсом
Расширение VSCode с автономными задачами (CLI скоро)
## Быстрое сравнение
| Агент | Интерфейсы | Формат конфигурации | Уровень конфигурации | Лучше для |
| ------------------ | -------------------- | ------------------- | ----------------------------------- | ----------------------------------------- |
| **Claude Code** | CLI + VSCode | JSON | Система + Проект | Терминальные процессы, интеграция VSCode |
| **Codex/Windsurf** | CLI + Редактор | TOML | Только система | Опытные пользователи, Cascade AI |
| **OpenCode** | CLI + Редактор | JSON | Система + Проект | Переключение моделей, гибкость |
| **Kilocode** | VSCode (CLI скоро) | Настройки VSCode | Пользователь + Рабочее пространство | Встроенный чат, автодополнение кода |
| **RooCode** | Отдельное приложение | JSON | Уровень приложения | Визуальный UI, автономный рабочий процесс |
| **Cline** | VSCode (CLI скоро) | Настройки VSCode | Пользователь + Рабочее пространство | Автономные задачи, операции терминала |
## Типы агентов
### CLI-первые агенты (с поддержкой редактора)
* CLI-первый дизайн
* Доступно расширение VSCode
* JSON конфигурация
* Системный и проектный уровень
* Поддержка строки состояния
* CLI-первый дизайн
* Интеграции с редактором
* TOML конфигурация
* Cascade AI (Windsurf)
* Функции Supercomplete
* CLI-первый дизайн
* Доступны плагины для редактора
* JSON конфигурация
* Автозагрузка моделей
* Поддержка нескольких провайдеров
**Когда использовать CLI-первые агенты:**
* Терминальные рабочие процессы
* Интеграция CI/CD
* Серверные среды
* Скриптинг и автоматизация
* Также отлично работают в редакторах с расширениями
### Агенты только для редактора (CLI скоро)
* Расширение VSCode (основное)
* CLI на обслуживании
* Интерфейс встроенного чата
* Автодополнение кода
* Интеграция с деревом файлов
* Отдельное приложение
* Визуальный интерфейс
* Поддержка нескольких проектов
* Функции проверки кода
* Расширение VSCode (основное)
* CLI на обслуживании
* Автономное выполнение задач
* Интеграция с терминалом
* Поддержка Git-процессов
**Поддержка CLI для Kilocode и Cline:** CLI версии в настоящее время на обслуживании и будут доступны в ближайшее время. Используйте расширения VSCode пока что.
**Когда использовать агенты, ориентированные на редактор:**
* Чисто визуальные рабочие процессы редактирования
* Встроенные предложения и автодополнения
* Рефакторинг нескольких файлов
* Процессы проверки кода
* Нативный опыт IDE
## Начало работы
Выберите CLI-агента для терминальных процессов или GUI-агента для визуального редактирования
Зарегистрируйтесь на [панели MegaLLM](https://megallm.io/dashboard) и получите свой API-ключ, начинающийся с `sk-mega-`
Следуйте конкретному руководству по настройке для выбранного агента (ссылки ниже)
Запустите своего агента и начните использовать помощь в кодировании с ИИ
## Руководства по настройке
### CLI-первые агенты (также работают в редакторах)
**Работает как:** CLI инструмент + расширение VSCode
**Файлы конфигурации:**
* Система: `~/.claude/settings.json`
* Проект: `./.claude/settings.json`
* Локальный: `./.claude/settings.local.json`
**Быстрая настройка:**
```json theme={null}
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.megallm.io",
"ANTHROPIC_API_KEY": "sk-mega-your-api-key-here"
}
}
```
[Полное руководство по настройке Claude Code →](/ru/agents/claude)
**Работает как:** CLI инструмент + интеграции с редактором (Windsurf - улучшенный вариант)
**Файл конфигурации:**
* Система: `~/.codex/config.toml` (только)
**Быстрая настройка:**
```toml theme={null}
model_provider = "megallm"
model = "gpt-5"
[model_providers.megallm]
name = "OpenAI using Chat Completions"
base_url = "https://ai.megallm.io/v1"
env_key = "MEGALLM_API_KEY"
[tools]
web_search = true
file_browser = true
```
[Полное руководство по настройке Codex/Windsurf →](/ru/agents/codex)
**Работает как:** CLI инструмент + плагины для редактора (VSCode, Vim и т.д.)
**Файлы конфигурации:**
* Система: `~/.config/opencode/opencode.json`
* Проект: `./.opencode/opencode.json`
**Быстрая настройка:**
```json theme={null}
{
"providers": [
{
"id": "megallm",
"name": "MegaLLM",
"type": "openai",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "sk-mega-your-api-key-here"
}
],
"defaultProvider": "megallm"
}
```
[Полное руководство по настройке OpenCode →](/ru/agents/opencode)
### Агенты только для редактора
**Расположение конфигурации:**
* Настройки пользователя (глобальные): UI настроек VSCode или `settings.json`
* Настройки рабочего пространства (проект): `.vscode/settings.json`
**Быстрая настройка (settings.json):**
```json theme={null}
{
"kilocode.apiProvider": "custom",
"kilocode.customProvider": {
"name": "MegaLLM",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "${env:MEGALLM_API_KEY}"
},
"kilocode.defaultModel": "gpt-5"
}
```
**Переменная окружения:**
```bash theme={null}
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
```
[Полное руководство по настройке Kilocode →](/ru/agents/kilocode)
**Расположение конфигурации:**
* Windows: `%APPDATA%\RooCode\config.json`
* macOS: `~/Library/Application Support/RooCode/config.json`
* Linux: `~/.config/roocode/config.json`
**Быстрая настройка:**
```json theme={null}
{
"provider": "openai-compatible",
"api": {
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "sk-mega-your-api-key-here",
"model": "gpt-5"
},
"features": {
"codeCompletion": true,
"chatInterface": true,
"codeReview": true,
"terminalIntegration": false
}
}
```
[Полное руководство по настройке RooCode →](/ru/agents/roocode)
**Расположение конфигурации:**
* Настройки пользователя (глобальные): UI настроек VSCode или `settings.json`
* Настройки рабочего пространства (проект): `.vscode/settings.json`
**Быстрая настройка для моделей GPT (формат OpenAI):**
```json theme={null}
{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gpt-5"
}
```
**Быстрая настройка для моделей Claude (формат Anthropic):**
```json theme={null}
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4"
}
```
**Переменная окружения:**
```bash theme={null}
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
```
[Полное руководство по настройке Cline →](/ru/agents/cline)
## Выбор модели
Все агенты поддерживают одинаковые модели через MegaLLM:
### Модели GPT
* `gpt-5` - Последняя модель GPT (рекомендуется)
* `gpt-4` - GPT-4
* `gpt-4o` - GPT-4 Оптимизированный
* `gpt-4o-mini` - Быстрый, экономичный
### Модели Claude
* `claude-opus-4-1-20250805` - Самая мощная
* `claude-sonnet-4` - Сбалансированная (рекомендуется)
* `claude-haiku-4` - Быстрая, эффективная
### Модели Gemini
* `gemini-2.5-pro` - Последний Gemini
* `gemini-2.0-flash` - Быстрые ответы
[Смотреть полный каталог моделей →](/ru/home/models)
## Переменные окружения
Большинство агентов поддерживают переменные окружения для API-ключей:
```bash theme={null}
# Для CLI-агентов и некоторых GUI-агентов
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
# Специально для Claude Code
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-api-key-here"
```
Добавьте в конфигурацию вашей оболочки:
* Bash: `~/.bashrc`
* Zsh: `~/.zshrc`
* Fish: `~/.config/fish/config.fish`
## Общие шаблоны конфигурации
### Шаблон 1: Системный уровень для личного использования
**Лучше для**: Личные проекты, один пользователь
```bash theme={null}
# Системная конфигурация
~/.claude/settings.json
# Переменные окружения
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-key"
```
```bash theme={null}
# Пользовательские настройки VSCode
# Файл > Настройки > Параметры > Поиск "kilocode"
# Переменная окружения
export MEGALLM_API_KEY="sk-mega-your-key"
```
```bash theme={null}
# Конфигурация приложения
~/.config/roocode/config.json
# Сохраните API-ключ в конфиге или используйте переменную окружения
```
### Шаблон 2: Уровень проекта для команд
**Лучше для**: Командные проекты, общая конфигурация
```bash theme={null}
# Общая конфигурация (в репозитории)
.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.megallm.io"
}
}
# Личный ключ (не в репозитории)
.claude/settings.local.json
{
"env": {
"ANTHROPIC_API_KEY": "your-personal-key"
}
}
# .gitignore
.claude/settings.local.json
```
```bash theme={null}
# Настройки рабочего пространства (в репозитории)
.vscode/settings.json
{
"kilocode.apiProvider": "custom",
"kilocode.customProvider": {
"name": "MegaLLM",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "${env:MEGALLM_API_KEY}"
}
}
# Члены команды устанавливают свою переменную окружения
export MEGALLM_API_KEY="personal-key"
```
```bash theme={null}
# Конфигурация проекта (в репозитории)
.opencode/opencode.json
{
"providers": [{
"baseURL": "https://ai.megallm.io/v1"
}]
}
# Личный ключ через переменную окружения
export MEGALLM_API_KEY="personal-key"
```
### Шаблон 3: Конфигурация с несколькими моделями
**Лучше для**: Использование разных моделей для разных задач
```json theme={null}
{
"providers": [
{
"id": "megallm-gpt",
"type": "openai",
"baseURL": "https://ai.megallm.io/v1",
"models": ["gpt-5", "gpt-4o"]
},
{
"id": "megallm-claude",
"type": "anthropic",
"baseURL": "https://ai.megallm.io",
"models": ["claude-sonnet-4", "claude-opus-4"]
}
]
}
```
```json theme={null}
{
"providers": [
{
"name": "GPT для чата",
"model": "gpt-5",
"useFor": ["chat", "completion"]
},
{
"name": "Claude для проверки",
"model": "claude-sonnet-4",
"useFor": ["review", "analysis"]
}
]
}
```
## Устранение неполадок
**Проверьте ваш API-ключ:**
```bash theme={null}
# Проверьте, начинается ли он с sk-mega-
echo $MEGALLM_API_KEY
# Протестируйте API напрямую
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
https://ai.megallm.io/v1/models
```
**Распространенные проблемы:**
* Отсутствует префикс `sk-mega-`
* Лишние пробелы или кавычки
* Неправильное имя переменной окружения
* Конфигурация оболочки не перезагружена (выполните `source ~/.bashrc`)
**Проверьте ваш базовый URL:**
Для **формата совместимого с OpenAI** (GPT, Gemini):
```
https://ai.megallm.io/v1 (с /v1)
```
Для **формата Anthropic** (Claude):
```
https://ai.megallm.io (без /v1)
```
**Конечные точки для конкретных агентов:**
* Claude Code: `https://ai.megallm.io` (без /v1)
* Codex/Windsurf: `https://ai.megallm.io/v1`
* OpenCode: `https://ai.megallm.io/v1`
* Kilocode: `https://ai.megallm.io/v1`
* RooCode: `https://ai.megallm.io/v1`
* Cline: `https://ai.megallm.io` (Anthropic) или `https://ai.megallm.io/v1` (OpenAI)
**Проверьте написание имени модели:**
Проверьте [каталог моделей](/ru/home/models) для точных имен моделей:
```bash theme={null}
# Распространенные ошибки:
"gpt5" # Отсутствует дефис
"gpt-5"
"claude-sonnet" # Отсутствует версия
"claude-sonnet-4"
"gemini-pro" # Неправильная версия
"gemini-2.5-pro"
```
**Проверьте расположение файлов:**
```bash theme={null}
# CLI-агенты
ls -la ~/.claude/settings.json # Claude Code
ls -la ~/.codex/config.toml # Codex
ls -la ~/.config/opencode/ # OpenCode
# Конфигурации проектов
ls -la .claude/settings.json # Claude Code
ls -la .opencode/opencode.json # OpenCode
ls -la .vscode/settings.json # Расширения VSCode
# Проверка синтаксиса JSON/TOML
jq . ~/.claude/settings.json # Тест JSON
cat ~/.codex/config.toml | grep - # Тест TOML
```
**Проверьте права доступа:**
```bash theme={null}
chmod 644 ~/.claude/settings.json
chmod 644 ~/.codex/config.toml
```
**Перезагрузите конфигурацию оболочки:**
```bash theme={null}
# Bash
source ~/.bashrc
# Zsh
source ~/.zshrc
# Fish
source ~/.config/fish/config.fish
# Проверка
echo $MEGALLM_API_KEY
echo $ANTHROPIC_BASE_URL
```
**Проверьте, где она определена:**
```bash theme={null}
# Поиск во всех конфигурациях оболочки
grep -r "MEGALLM_API_KEY" ~/.*rc ~/.config/
```
## Сравнение функций
### Интерфейсы и использование
| Агент | CLI доступен | Редактор/GUI | Интерфейс чата | Редактирование нескольких файлов |
| -------------- | ------------------------------- | ---------------------------------------- | -------------------------------- | -------------------------------- |
| Claude Code | Основной | Расширение VSCode | CLI + GUI | |
| Codex/Windsurf | Основной | Редактор | CLI + GUI | |
| OpenCode | Основной | Плагины | CLI + GUI | |
| Kilocode | Скоро | Только VSCode | GUI | |
| RooCode | | Отдельное | GUI | |
| Cline | Скоро | Только VSCode | GUI | |
### Интеграции
| Агент | Доступ к терминалу | Интеграция Git | Дерево файлов | Проверка кода |
| -------------- | -------------------------------------------------- | --------------------------------- | --------------------- | ---------------------------------- |
| Claude Code | Нативный CLI | Нативный | | В редакторе |
| Codex/Windsurf | Нативный CLI | Нативный | | В редакторе |
| OpenCode | Нативный CLI | Нативный | | В редакторе |
| Kilocode | Через VSCode | VSCode | | |
| RooCode | Встроенный | Встроенный | | |
| Cline | Терминал VSCode | VSCode | | |
### Гибкость конфигурации
| Агент | Системная конфигурация | Конфигурация проекта | Переменные окружения | Совместное использование в команде |
| -------------- | ---------------------- | -------------------------------------------- | ------------------------------------------------ | ------------------------------------------------ |
| Claude Code | | | | |
| Codex/Windsurf | | | | Ограничено |
| OpenCode | | | | |
| Kilocode | | | | |
| RooCode | | Импорт | Ограничено | Экспорт |
| Cline | | | | |
## Лучшие практики
Храните API-ключи в переменных окружения, никогда не коммитьте их в систему контроля версий
Используйте конфигурацию уровня проекта для общих настроек, локальные файлы для личных ключей
CLI для автоматизации/CI/CD, GUI для интерактивного кодирования и визуальных процессов
Проверьте API-соединение с curl перед настройкой агентов
Добавляйте конфиденциальные файлы в .gitignore, используйте разные ключи для разработки/продакшена
Обновляйте агенты для получения последних функций, исправлений безопасности и багов
## Следующие шаги
CLI с JSON конфигурацией
CLI с TOML конфигурацией
CLI с автозагрузкой
Расширение VSCode
Отдельное приложение
VSCode + автономия
Просмотреть все доступные модели
Прямая интеграция API