> ## 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.

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

> Настройка автономного приложения RooCode для использования MegaLLM

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

## Быстрая конфигурация

<Tabs>
  <Tab title="Через настройки приложения">
    ### Пошаговая настройка

    <Steps>
      <Step title="Открыть настройки RooCode">
        * Запустите приложение RooCode
        * Нажмите на значок шестерёнки ⚙️ (в нижнем левом углу)
        * Перейдите к: `Настройки → Конфигурация API`
      </Step>

      <Step title="Выбрать тип провайдера">
        * **Тип провайдера**: Выберите `OpenAI Compatible`
        * Это включает настройку пользовательского базового URL
        * Позволяет интеграцию с MegaLLM
      </Step>

      <Step title="Настроить конечную точку API">
        * **Базовый URL**: `https://ai.megallm.io/v1`
        * **API-ключ**: `sk-mega-your-api-key-here`
        * **Организация**: Оставьте пустым (не требуется)
        * Нажмите **Сохранить**
      </Step>

      <Step title="Выбрать модель по умолчанию">
        * **Модель по умолчанию**: `gpt-5`
        * **Резервная модель**: `gpt-4o` (опционально)
        * **Temperature**: `0.7` (сбалансированная креативность)
        * **Max Tokens**: `4096`
      </Step>

      <Step title="Включить функции">
        * <Icon icon="check" /> **Автодополнение кода**
        * <Icon icon="check" /> **Чат-интерфейс**
        * <Icon icon="check" /> **Проверка кода**
        * <Icon icon="check" /> **Помощник по рефакторингу**
        * <Icon icon="check" /> **Многофайловое редактирование**
      </Step>
    </Steps>
  </Tab>

  <Tab title="Через конфигурационный файл">
    ### Прямое редактирование файла

    **Расположение конфигурационных файлов:**

    <CodeGroup>
      ```bash Windows theme={null}
      %APPDATA%\RooCode\config.json
      # Полный путь: C:\Users\YourName\AppData\Roaming\RooCode\config.json
      ```

      ```bash macOS theme={null}
      ~/Library/Application Support/RooCode/config.json
      ```

      ```bash Linux theme={null}
      ~/.config/RooCode/config.json
      ```
    </CodeGroup>

    **Содержимое конфигурации:**

    ```json theme={null}
    {
      "provider": "openai-compatible",
      "api": {
        "baseURL": "https://ai.megallm.io/v1",
        "apiKey": "sk-mega-your-api-key-here",
        "organization": "",
        "model": "gpt-5",
        "temperature": 0.7,
        "maxTokens": 4096
      },
      "features": {
        "codeCompletion": true,
        "chatInterface": true,
        "codeReview": true,
        "refactoring": true,
        "multiFileEdit": true
      },
      "ui": {
        "theme": "dark",
        "showInlineHints": true,
        "autoSaveChats": true,
        "fontSize": 14
      }
    }
    ```

    <Warning>
      После редактирования конфигурационного файла перезапустите RooCode, чтобы изменения вступили в силу.
    </Warning>
  </Tab>

  <Tab title="Импорт конфигурации">
    ### Импорт готовой конфигурации

    **Шаг 1**: Создайте `roocode-megallm-config.json`

    ```json theme={null}
    {
      "provider": "openai-compatible",
      "api": {
        "baseURL": "https://ai.megallm.io/v1",
        "apiKey": "REPLACE_WITH_YOUR_KEY",
        "model": "gpt-5"
      },
      "features": {
        "codeCompletion": true,
        "chatInterface": true,
        "codeReview": true,
        "refactoring": true
      }
    }
    ```

    **Шаг 2**: Импортируйте в RooCode

    1. Откройте RooCode
    2. Перейдите к: `Файл → Импорт конфигурации`
    3. Выберите ваш `roocode-megallm-config.json`
    4. Замените `REPLACE_WITH_YOUR_KEY` на ваш реальный API-ключ
    5. Нажмите **Применить**
    6. Перезапустите RooCode

    <Icon icon="check" /> Конфигурация успешно импортирована!
  </Tab>
</Tabs>

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

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

Полная настройка от загрузки до первого использования:

<Steps>
  <Step title="Загрузить и установить RooCode">
    1. Посетите [RooCode.io](https://roocode.io) (пример URL)
    2. Загрузите для вашей ОС (Windows/macOS/Linux)
    3. Установите приложение
    4. Запустите RooCode
  </Step>

  <Step title="Получить API-ключ MegaLLM">
    1. Посетите [Панель управления MegaLLM](https://megallm.io/dashboard)
    2. Зарегистрируйтесь или войдите
    3. Перейдите в раздел **API Keys**
    4. Нажмите **Создать новый ключ**
    5. Скопируйте ключ (начинается с `sk-mega-`)
  </Step>

  <Step title="Настроить API-провайдер">
    В RooCode:

    1. Нажмите значок ⚙️ Настройки
    2. Перейдите к **Конфигурация API**
    3. Выберите **Провайдер**: `OpenAI Compatible`
    4. Введите **Базовый URL**: `https://ai.megallm.io/v1`
    5. Вставьте **API-ключ**: `sk-mega-your-key`
    6. Нажмите **Проверить соединение** (должно показать ✓ Успешно)
    7. Нажмите **Сохранить**
  </Step>

  <Step title="Выбрать первую модель">
    1. В Настройках → **Выбор модели**
    2. Выберите: `gpt-5` (рекомендуется для общего использования)
    3. Или просмотрите доступные модели
    4. Установите **Temperature**: `0.7` (сбалансированная)
    5. Сохраните настройки
  </Step>

  <Step title="Проверить конфигурацию">
    1. Откройте новый чат в RooCode
    2. Напишите: `Привет! Какую модель вы используете?`
    3. Должен ответить информацией о модели
    4. Попробуйте: `Напиши функцию hello world на Python`

    **Ожидаемый ответ:**

    ```python theme={null}
    def hello_world():
        print("Hello, World!")

    if __name__ == "__main__":
        hello_world()
    ```
  </Step>
</Steps>

***

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

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

**Сценарий:** Команда разработки из 10 человек нуждается в единообразной конфигурации RooCode

**Шаг 1: Руководитель команды создаёт базовую конфигурацию**

`team-roocode-config.json`:

```json theme={null}
{
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "TEAM_MEMBER_REPLACES_THIS",
    "model": "gpt-5",
    "temperature": 0.7,
    "maxTokens": 4096
  },
  "features": {
    "codeCompletion": true,
    "chatInterface": true,
    "codeReview": true,
    "refactoring": true,
    "multiFileEdit": true
  },
  "projectSettings": {
    "language": "typescript",
    "framework": "react",
    "codingStyle": "airbnb",
    "testFramework": "jest"
  },
  "customPrompts": {
    "review": "Проверь этот код, следуя стилю Airbnb нашей команды и лучшим практикам",
    "test": "Создай модульные тесты Jest с покрытием не менее 80%",
    "doc": "Создай комментарии JSDoc для этой функции",
    "refactor": "Рефактори этот код для лучшей поддерживаемости и строгого режима TypeScript"
  },
  "ui": {
    "theme": "dark",
    "showInlineHints": true,
    "autoSaveChats": true,
    "fontSize": 14
  }
}
```

**Шаг 2: Создать инструкции по настройке**

`ROOCODE_SETUP.md`:

```markdown theme={null}
# Руководство по настройке RooCode для команды

## Предварительные требования
- Установленное приложение RooCode ([Скачать](https://roocode.io))
- API-ключ MegaLLM ([Получить ключ](https://megallm.io/dashboard))

## Шаги настройки

### 1. Получите свой личный API-ключ
1. Перейдите на https://megallm.io/dashboard
2. Перейдите в раздел **API Keys**
3. Нажмите **Создать новый ключ**
4. Скопируйте ваш ключ (начинается с `sk-mega-`)

### 2. Импортируйте конфигурацию команды
1. Загрузите `team-roocode-config.json` из этого репозитория
2. Откройте RooCode
3. Перейдите к: `Файл → Импорт конфигурации`
4. Выберите `team-roocode-config.json`

### 3. Добавьте свой личный API-ключ
1. После импорта перейдите к: `Настройки → Конфигурация API`
2. Замените `TEAM_MEMBER_REPLACES_THIS` на ваш реальный ключ
3. Нажмите **Проверить соединение** (должно показать ✓ Успешно)
4. Нажмите **Сохранить**

### 4. Перезапустите RooCode
Закройте и снова откройте RooCode, чтобы применить все настройки.

## Проверка
1. Откройте новый чат
2. Напишите: `Создай React-компонент для формы входа`
3. Должен генерировать TypeScript-код, следуя стилю Airbnb

## Устранение неполадок
- **Ошибка соединения**: Проверьте правильность API-ключа
- **Неправильный стиль кода**: Убедитесь, что конфигурация импортирована корректно
- **Ошибки модели**: Убедитесь, что используется `gpt-5` или другие поддерживаемые модели

## Поддержка
Свяжитесь с руководителем команды или проверьте [Документация MegaLLM](https://docs.megallm.io)
```

**Шаг 3: Распространение в команде**

```bash theme={null}
# Руководитель команды коммитит в репозиторий
git add team-roocode-config.json ROOCODE_SETUP.md
git commit -m "Добавить конфигурацию RooCode для команды"
git push

# Члены команды клонируют и настраивают
git pull
# Следуйте инструкциям в ROOCODE_SETUP.md
```

**Результат:** Вся команда использует единообразно:

* <Icon icon="check" /> Одну и ту же AI-модель (gpt-5)
* <Icon icon="check" /> Одинаковые температуру и настройки
* <Icon icon="check" /> Одинаковые пользовательские промпты
* <Icon icon="check" /> Одинаковые стандарты кодирования
* <Icon icon="check" /> Личные API-ключи (не общие)

***

### Сценарий 3: Конфигурации для конкретных проектов

Используйте разные конфигурации RooCode для разных типов проектов:

**Проект Python Data Science:**

`roocode-datascience.json`:

```json theme={null}
{
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}",
    "model": "claude-opus-4-1-20250805",
    "temperature": 0.5
  },
  "projectSettings": {
    "language": "python",
    "libraries": ["numpy", "pandas", "scikit-learn", "matplotlib"],
    "codingStyle": "pep8"
  },
  "customPrompts": {
    "analyze": "Проанализируй этот код обработки данных на эффективность и корректность",
    "optimize": "Оптимизируй эту операцию pandas для больших наборов данных",
    "visualize": "Предложи визуализацию matplotlib для этих данных",
    "doc": "Создай docstring в стиле numpy"
  }
}
```

**React веб-приложение:**

`roocode-webapp.json`:

```json theme={null}
{
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}",
    "model": "gpt-5",
    "temperature": 0.7
  },
  "projectSettings": {
    "language": "typescript",
    "framework": "react",
    "stateManagement": "zustand",
    "styling": "tailwind"
  },
  "customPrompts": {
    "component": "Создай функциональный React-компонент с TypeScript и Tailwind",
    "test": "Напиши тесты React Testing Library для этого компонента",
    "hook": "Создай пользовательский React-хук для этой функциональности",
    "api": "Создай интеграцию API с tanstack-query"
  }
}
```

**Системное программирование (Rust):**

`roocode-systems.json`:

```json theme={null}
{
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "${env:MEGALLM_API_KEY}",
    "model": "gemini-2.5-pro",
    "temperature": 0.3
  },
  "projectSettings": {
    "language": "rust",
    "codingStyle": "rust-fmt"
  },
  "customPrompts": {
    "review": "Проверь этот Rust-код на безопасность памяти и производительность",
    "optimize": "Предложи оптимизации для этого критического по производительности кода",
    "test": "Создай всесторонние Rust-тесты",
    "unsafe": "Проанализируй этот unsafe-блок на корректность"
  }
}
```

**Переключение между проектами:**

<CodeGroup>
  ```bash macOS/Linux theme={null}
  # Создайте алиасы в ~/.bashrc или ~/.zshrc
  alias roocode-ds='cp ~/configs/roocode-datascience.json ~/.config/RooCode/config.json && roocode'
  alias roocode-web='cp ~/configs/roocode-webapp.json ~/.config/RooCode/config.json && roocode'
  alias roocode-sys='cp ~/configs/roocode-systems.json ~/.config/RooCode/config.json && roocode'
  ```

  ```powershell Windows theme={null}
  # Создайте функции в профиле PowerShell
  function RooCode-DataScience {
      Copy-Item "$HOME\configs\roocode-datascience.json" "$env:APPDATA\RooCode\config.json"
      Start-Process "roocode"
  }

  function RooCode-Web {
      Copy-Item "$HOME\configs\roocode-webapp.json" "$env:APPDATA\RooCode\config.json"
      Start-Process "roocode"
  }
  ```
</CodeGroup>

***

### Сценарий 4: Миграция с Cursor/других AI-инструментов

Переход с другого AI-инструмента программирования на RooCode с MegaLLM:

**Текущая настройка: Использование Cursor с OpenAI**

**Почему переходить на RooCode + MegaLLM:**

* <Icon icon="check" /> Доступ к нескольким моделям (GPT, Claude, Gemini) с одним ключом
* <Icon icon="check" /> Автономное приложение (не привязано к конкретному редактору)
* <Icon icon="check" /> Лучшая цена и отсутствие лимитов по местам
* <Icon icon="check" /> Больше возможностей настройки

**Шаги миграции:**

<Steps>
  <Step title="Экспортировать текущие предпочтения">
    Из Cursor (если возможно):

    * Отметьте ваши предпочтительные модели
    * Сохраните любые пользовательские промпты
    * Задокументируйте используемые горячие клавиши
  </Step>

  <Step title="Установить RooCode">
    Загрузите и установите RooCode для вашей ОС
  </Step>

  <Step title="Настроить MegaLLM">
    ```json theme={null}
    {
      "provider": "openai-compatible",
      "api": {
        "baseURL": "https://ai.megallm.io/v1",
        "apiKey": "sk-mega-your-megallm-key",
        "model": "gpt-5"
      }
    }
    ```
  </Step>

  <Step title="Воссоздать пользовательские промпты">
    Добавьте часто используемые промпты:

    ```json theme={null}
    {
      "customPrompts": {
        "explain": "Объясни этот код подробно",
        "fix": "Найди и исправь ошибки в этом коде",
        "improve": "Предложи улучшения для этого кода"
      }
    }
    ```
  </Step>

  <Step title="Проверить функциональность">
    Сравните параллельно:

    1. Откройте один и тот же код в обоих инструментах
    2. Задайте одни и те же вопросы
    3. Сравните качество генерации кода
    4. Оцените скорость ответов
  </Step>
</Steps>

**Сравнительная таблица:**

| Функция                     | Cursor            | RooCode + MegaLLM            |
| --------------------------- | ----------------- | ---------------------------- |
| **Интеграция с редактором** | Форк VS Code      | Автономное + любой редактор  |
| **Доступные модели**        | GPT-4, GPT-3.5    | GPT, Claude, Gemini и другие |
| **API-ключ**                | Только OpenAI     | Один ключ для всех моделей   |
| **Ценообразование**         | Подписка за место | Оплата по использованию      |
| **Настройка**               | Ограниченная      | Обширная                     |
| **Офлайн-режим**            | Нет               | Нет                          |

***

### Сценарий 5: Рабочий процесс с несколькими моделями

Используйте разные модели для разных типов задач:

**Конфигурация с профилями моделей:**

```json theme={null}
{
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "sk-mega-your-api-key-here",
    "model": "gpt-5"
  },
  "modelProfiles": {
    "fast": {
      "model": "gpt-4o-mini",
      "temperature": 0.5,
      "maxTokens": 1000,
      "description": "Быстрое дополнение для простых задач"
    },
    "balanced": {
      "model": "gpt-5",
      "temperature": 0.7,
      "maxTokens": 4096,
      "description": "Сбалансированное качество и скорость"
    },
    "quality": {
      "model": "claude-opus-4-1-20250805",
      "temperature": 0.3,
      "maxTokens": 8192,
      "description": "Высочайшее качество для сложных задач"
    },
    "creative": {
      "model": "gpt-5",
      "temperature": 0.9,
      "maxTokens": 4096,
      "description": "Креативная документация и именование"
    },
    "analysis": {
      "model": "claude-sonnet-4",
      "temperature": 0.4,
      "maxTokens": 6000,
      "description": "Проверка и анализ кода"
    }
  }
}
```

**Пример рабочего процесса:**

```plaintext theme={null}
Утро: Быстрое прототипирование
→ Переключиться на профиль "fast" (gpt-4o-mini)
→ Быстрая генерация кода
→ Быстрые итерации

День: Продакшн-код
→ Переключиться на профиль "quality" (claude-opus-4)
→ Генерация production-готового кода
→ Всестороннее обработка ошибок

Время проверки кода
→ Переключиться на профиль "analysis" (claude-sonnet-4)
→ Детальные проверки кода
→ Анализ безопасности

Документация
→ Переключиться на профиль "creative" (gpt-5, высокая temp)
→ Генерация интересных документов
→ Креативные предложения по именованию
```

**Переключение профилей в RooCode:**

1. Нажмите выпадающее меню модели (верхняя панель)
2. Выберите профиль: Fast / Balanced / Quality / Creative / Analysis
3. Профиль применён к текущей сессии

***

### Сценарий 6: Интеграция с CI/CD

Используйте RooCode API для автоматизированных проверок кода в CI/CD:

**Пример GitHub Actions:**

`.github/workflows/roocode-review.yml`:

```yaml theme={null}
name: AI-проверка кода с RooCode

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Настройка RooCode CLI
        run: |
          curl -O https://roocode.io/cli/install.sh
          bash install.sh

      - name: Настройка MegaLLM
        env:
          MEGALLM_API_KEY: ${{ secrets.MEGALLM_API_KEY }}
        run: |
          mkdir -p ~/.config/RooCode
          cat > ~/.config/RooCode/config.json << EOF
          {
            "provider": "openai-compatible",
            "api": {
              "baseURL": "https://ai.megallm.io/v1",
              "apiKey": "$MEGALLM_API_KEY",
              "model": "claude-sonnet-4"
            }
          }
          EOF

      - name: Запуск AI-проверки кода
        run: |
          roocode review \
            --files "$(git diff --name-only origin/main...HEAD)" \
            --output review.md

      - name: Опубликовать комментарий с проверкой
        uses: actions/github-script@v6
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `## AI-проверка кода\n\n${review}`
            });
```

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

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

```json theme={null}
{
  // Конфигурация API
  "provider": "openai-compatible",
  "api": {
    "baseURL": "https://ai.megallm.io/v1",
    "apiKey": "sk-mega-your-api-key-here",
    "organization": "",
    "model": "gpt-5",
    "temperature": 0.7,
    "maxTokens": 4096,
    "topP": 0.9,
    "frequencyPenalty": 0.0,
    "presencePenalty": 0.0,
    "timeout": 30000
  },

  // Переключатели функций
  "features": {
    "codeCompletion": true,
    "chatInterface": true,
    "codeReview": true,
    "refactoring": true,
    "multiFileEdit": true,
    "contextAwareness": true,
    "autoSave": true
  },

  // Настройки проекта
  "projectSettings": {
    "language": "typescript",
    "framework": "react",
    "codingStyle": "airbnb",
    "testFramework": "jest",
    "linter": "eslint"
  },

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

  // Предпочтения UI
  "ui": {
    "theme": "dark",
    "fontSize": 14,
    "fontFamily": "Fira Code",
    "showInlineHints": true,
    "showLineNumbers": true,
    "autoSaveChats": true,
    "chatPosition": "right",
    "enableAnimations": true
  },

  // Горячие клавиши
  "shortcuts": {
    "newChat": "Cmd+N",
    "sendMessage": "Cmd+Enter",
    "clearChat": "Cmd+K",
    "switchModel": "Cmd+M",
    "openSettings": "Cmd+,"
  },

  // Дополнительно
  "advanced": {
    "logLevel": "info",
    "cacheResponses": true,
    "maxChatHistory": 100,
    "contextWindowSize": 8000,
    "streamResponses": true
  }
}
```

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

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

## Проверка

### Тест 1: Функциональность чата

1. Откройте RooCode
2. Нажмите **Новый чат**
3. Напишите: `Напиши функцию для сортировки массива объектов по свойству`
4. Должен получить работающий код

**Ожидаемый ответ:**

```javascript theme={null}
function sortByProperty(array, property) {
  return array.sort((a, b) => {
    if (a[property] < b[property]) return -1;
    if (a[property] > b[property]) return 1;
    return 0;
  });
}
```

### Тест 2: Проверка кода

1. Вставьте этот код:

```python theme={null}
def divide(a, b):
    return a / b
```

2. Нажмите кнопку **Проверить код**
3. Должен определить: Отсутствует проверка деления на ноль

### Тест 3: Многофайловое редактирование

1. Откройте многофайловое представление
2. Запрос: "Добавь обработку ошибок ко всем вызовам API"
3. Должен показать изменения в нескольких файлах
4. Просмотрите и примените изменения

### Тест 4: Статус соединения

Проверьте индикатор статуса (верхний правый угол):

* 🟢 Зелёный = Подключён к MegaLLM
* 🟡 Жёлтый = Подключение...
* 🔴 Красный = Ошибка подключения

Нажмите на статус, чтобы увидеть:

* Модель: `gpt-5`
* Конечная точка: `https://ai.megallm.io/v1`
* Использование токенов: Статистика текущей сессии

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

<AccordionGroup>
  <Accordion title="Ошибки таймаута соединения">
    **Симптомы:**

    * "Не удалось подключиться к API"
    * Запросы превышают таймаут через 30с
    * Сообщения чата не отправляются

    **Решения:**

    1. **Проверьте правильность базового URL:**
       ```
       https://ai.megallm.io/v1  <Icon icon="check" /> Правильно
       https://ai.megallm.io     <Icon icon="xmark" /> Отсутствует /v1
       https://api.openai.com/v1 <Icon icon="xmark" /> Неправильная конечная точка
       ```

    2. **Проверьте подключение:**
       ```bash theme={null}
       # Проверка соединения
       curl -I https://ai.megallm.io/v1/models

       # Должно вернуть: HTTP/2 200
       ```

    3. **Проверьте фаервол:**
       * Разрешите RooCode через фаервол
       * Проверьте настройки корпоративного прокси
       * Убедитесь, что VPN не блокирует

    4. **Увеличьте таймаут:**
       ```json theme={null}
       {
         "api": {
           "timeout": 60000  // Увеличить до 60 секунд
         }
       }
       ```

    5. **Проверьте API-ключ вручную:**
       ```bash theme={null}
       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"}]}'
       ```
  </Accordion>

  <Accordion title="API-ключ не распознан">
    **Симптомы:**

    * Ошибка "Недействительный API-ключ"
    * 401 Unauthorized
    * Ошибка аутентификации

    **Решения:**

    1. **Проверьте формат ключа:**
       * Должен начинаться с `sk-mega-`
       * Должен быть 60+ символов
       * Без лишних пробелов или переносов строк
       * Без кавычек в конфигурационном файле вокруг самого ключа

    2. **Проверьте, что ключ активен:**
       * Войдите в [Панель управления](https://megallm.io/dashboard)
       * Перейдите к **API Keys**
       * Убедитесь, что ключ показан как "Active"
       * Проверьте, что он не отозван или не истёк

    3. **Введите ключ заново:**
       * Скопируйте ключ из панели управления
       * Удалите старый ключ из настроек RooCode
       * Вставьте новый ключ
       * Сохраните и перезапустите RooCode

    4. **Проверьте ключ напрямую:**
       ```bash theme={null}
       curl -H "Authorization: Bearer sk-mega-your-actual-key" \
            https://ai.megallm.io/v1/models

       # Должно вернуть JSON-список моделей
       ```
  </Accordion>

  <Accordion title="Ответы низкого качества">
    **Симптомы:**

    * Нерелевантные предложения кода
    * Неправильный язык программирования
    * Неполные ответы

    **Решения:**

    1. **Предоставьте лучший контекст:**
       * Установите язык проекта в настройках
       * Добавьте информацию о фреймворке
       * Используйте пользовательские промпты

    2. **Настройте temperature:**
       ```json theme={null}
       {
         "api": {
           "temperature": 0.3  // Ниже = более сфокусированно (0.2-0.4 для кода)
         }
       }
       ```

    3. **Попробуйте другую модель:**
       ```json theme={null}
       {
         "api": {
           "model": "claude-sonnet-4"  // Лучше для анализа
         }
       }
       ```

    4. **Увеличьте max tokens:**
       ```json theme={null}
       {
         "api": {
           "maxTokens": 8192  // Более длинные, полные ответы
         }
       }
       ```

    5. **Используйте конкретные промпты:**
       ```json theme={null}
       {
         "customPrompts": {
           "generate": "Создай production-готовый TypeScript-код, следуя лучшим практикам"
         }
       }
       ```
  </Accordion>

  <Accordion title="Конфигурация не загружается">
    **Симптомы:**

    * Настройки возвращаются после перезапуска
    * Изменения не применяются
    * Используется конфигурация по умолчанию

    **Решения:**

    1. **Проверьте расположение конфигурационного файла:**

           <CodeGroup>
             ```bash Windows theme={null}
             # Должно быть:
             C:\Users\YourName\AppData\Roaming\RooCode\config.json

             # Не:
             C:\Program Files\RooCode\config.json  # Неправильно!
             ```

             ```bash macOS theme={null}
             # Должно быть:
             ~/Library/Application Support/RooCode/config.json

             # Не:
             /Applications/RooCode.app/config.json  # Неправильно!
             ```

             ```bash Linux theme={null}
             # Должно быть:
             ~/.config/RooCode/config.json

             # Не:
             /etc/roocode/config.json  # Неправильно!
             ```
           </CodeGroup>

    2. **Проверьте синтаксис JSON:**
       ```bash theme={null}
       # Проверка на ошибки
       cat config.json | python3 -m json.tool

       # Должно показать форматированный JSON или ошибку
       ```

    3. **Проверьте права доступа к файлу:**
       ```bash theme={null}
       # Linux/macOS
       chmod 644 ~/.config/RooCode/config.json

       # Windows: Убедитесь, что пользователь имеет доступ на чтение/запись
       ```

    4. **Сбросить к настройкам по умолчанию:**
       * Сделайте резервную копию текущей конфигурации
       * Удалите config.json
       * Перезапустите RooCode (создаст новую конфигурацию)
       * Повторно примените настройки через UI
  </Accordion>

  <Accordion title="Приложение вылетает или зависает">
    **Симптомы:**

    * RooCode вылетает при запуске
    * Зависает во время длинных ответов
    * Неотзывчивый UI

    **Решения:**

    1. **Проверьте системные ресурсы:**
       * Закройте другие приложения
       * Убедитесь, что доступно 4GB+ RAM
       * Проверьте использование CPU

    2. **Уменьшите max tokens:**
       ```json theme={null}
       {
         "api": {
           "maxTokens": 2048  // Уменьшить с 8192
         }
       }
       ```

    3. **Отключите стриминг:**
       ```json theme={null}
       {
         "advanced": {
           "streamResponses": false
         }
       }
       ```

    4. **Очистите кэш:**
       ```bash theme={null}
       # Windows
       rmdir /s "%APPDATA%\RooCode\cache"

       # macOS/Linux
       rm -rf ~/Library/Application\ Support/RooCode/cache
       rm -rf ~/.config/RooCode/cache
       ```

    5. **Переустановите RooCode:**
       * Сделайте резервную копию config.json
       * Удалите RooCode
       * Загрузите последнюю версию
       * Установите и восстановите конфигурацию
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="Конфигурации проектов" icon="folder">
    Создавайте отдельные конфигурации для разных типов проектов
  </Card>

  <Card title="Профили моделей" icon="layer-group">
    Настройте профили для разных задач: быстрый, качественный, креативный
  </Card>

  <Card title="Пользовательские промпты" icon="message">
    Определите многоразовые промпты для общих задач
  </Card>

  <Card title="Мониторинг использования" icon="chart-line">
    Регулярно проверяйте [Панель управления](https://megallm.io/dashboard) на использование токенов
  </Card>

  <Card title="Резервное копирование конфигураций" icon="floppy-disk">
    Храните резервные копии работающих конфигураций
  </Card>

  <Card title="Безопасность" icon="lock">
    Используйте переменные окружения для API-ключей в общих конфигурациях
  </Card>
</CardGroup>

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

### Переменные окружения

RooCode поддерживает подстановку переменных окружения:

```json theme={null}
{
  "api": {
    "apiKey": "${env:MEGALLM_API_KEY}",
    "baseURL": "${env:MEGALLM_BASE_URL}"
  }
}
```

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

```bash theme={null}
export MEGALLM_API_KEY="sk-mega-your-key"
export MEGALLM_BASE_URL="https://ai.megallm.io/v1"
```

### Управление контекстом

Улучшайте ответы с лучшим контекстом:

```json theme={null}
{
  "advanced": {
    "contextWindowSize": 16000,
    "includeProjectStructure": true,
    "includeOpenFiles": true,
    "maxRelevantFiles": 10
  }
}
```

### Кэширование ответов

Экономьте на стоимости API с умным кэшированием:

```json theme={null}
{
  "advanced": {
    "cacheResponses": true,
    "cacheExpiry": 3600,  // секунды
    "maxCacheSize": 100   // МБ
  }
}
```

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

<CardGroup cols={3}>
  <Card title="Настройка Kilocode" icon="code" href="/ru/agents/kilocode">
    Настройте расширение Kilocode для VSCode
  </Card>

  <Card title="Настройка Cline" icon="terminal" href="/ru/agents/cline">
    Настройте расширение Cline для VSCode
  </Card>

  <Card title="Каталог моделей" icon="layer-group" href="/ru/home/models">
    Просмотрите все доступные модели
  </Card>

  <Card title="Другие агенты" icon="window" href="/ru/agents/overview">
    Просмотрите все CLI и GUI агенты
  </Card>

  <Card title="Справочник API" icon="book" href="/ru/api-reference/introduction">
    Изучите документацию API
  </Card>

  <Card title="Сообщество Discord" icon="discord" href="https://discord.gg/Megallm">
    Присоединяйтесь для поддержки
  </Card>
</CardGroup>