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

# Обзор CLI

> MegaLLM CLI — это интерактивный инструмент настройки, который конфигурирует AI-ассистенты для кодирования для использования сервиса MegaLLM AI. Он автоматизирует конфигурацию, безопасно управляет API-ключами и обеспечивает бесшовную настройку на различных платформах.

## Быстрый старт

Начните за считанные секунды:

```bash theme={null}
npx megallm@latest
```

Вот и всё! Интерактивный мастер проведёт вас через весь процесс настройки.

<Tip>
  Установка не требуется - просто запустите `npx megallm@latest` и следуйте подсказкам
</Tip>

## Что он делает

CLI автоматически:

* **Обнаруживает** установленные AI-инструменты и конфигурацию вашей системы
* **Устанавливает** отсутствующие инструменты при необходимости (с вашего разрешения)
* **Настраивает** AI-ассистенты с вашим API-ключом MegaLLM
* **Создаёт резервные копии** существующих конфигураций перед внесением изменений
* **Валидирует** настройки, чтобы убедиться, что всё работает корректно

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

<CardGroup cols={3}>
  <Card title="Claude Code" icon="robot">
    Системная и проектная конфигурация
  </Card>

  <Card title="Codex/Windsurf" icon="code">
    Системная конфигурация
  </Card>

  <Card title="OpenCode" icon="brackets-curly">
    Системная и проектная конфигурация
  </Card>
</CardGroup>

## Ключевые функции

<CardGroup cols={2}>
  <Card title="Умное обнаружение" icon="magnifying-glass">
    Автоматически определяет ОС, оболочку, установленные инструменты и существующие конфигурации
  </Card>

  <Card title="Автоматизированная настройка" icon="wand-magic-sparkles">
    Интерактивный мастер с пошаговыми инструкциями
  </Card>

  <Card title="Безопасное хранение" icon="shield-halved">
    Автоматическое резервное копирование и безопасное управление API-ключами
  </Card>

  <Card title="Кросс-платформенность" icon="globe">
    Работает на macOS, Linux, Windows со всеми основными оболочками
  </Card>
</CardGroup>

## Как это работает

<Steps>
  <Step title="Запустите CLI">
    Выполните `npx megallm@latest` в терминале
  </Step>

  <Step title="Обнаружение системы">
    CLI обнаруживает вашу ОС, оболочку и установленные AI-инструменты
  </Step>

  <Step title="Выберите конфигурацию">
    Выберите, какой инструмент(ы) настроить и на каком уровне (системный/проектный)
  </Step>

  <Step title="Введите API-ключ">
    Укажите ваш API-ключ MegaLLM (или получите инструкции по его созданию)
  </Step>

  <Step title="Проверьте и подтвердите">
    Просмотрите сводку конфигурации и подтвердите
  </Step>

  <Step title="Примените настройки">
    CLI настраивает файлы, устанавливает переменные окружения и перезагружает оболочку
  </Step>
</Steps>

## Уровни настройки

Выберите между двумя уровнями конфигурации:

### Системный уровень (Глобальный)

Применяется ко **всем проектам** на вашей машине.

**Лучше всего для:**

* Персональных сред разработки
* Настроек для одного разработчика
* Быстрого тестирования и прототипирования

**Хранение:**

* `~/.claude/` - Claude Code
* `~/.codex/` - Codex/Windsurf
* `~/.config/opencode/` - OpenCode

### Проектный уровень (Локальный)

Применяется **только к текущему проекту**.

**Лучше всего для:**

* Командных проектов с общими конфигурациями
* Разных API-ключей для каждого проекта
* Настроек под контролем версий

**Хранение:**

* `./.claude/` - Claude Code
* `./opencode.json` - OpenCode

<Note>
  **Codex/Windsurf поддерживает только системную конфигурацию**
</Note>

## Требования

<Info>
  Требуется **Node.js 18.0.0+**. Проверьте вашу версию: `node --version`
</Info>

**Поддерживаемые платформы:**

* macOS (Intel и Apple Silicon)
* Linux (все основные дистрибутивы)
* Windows (10/11 с WSL или нативно)

**Поддерживаемые оболочки:**

* bash
* zsh
* fish
* PowerShell

## Варианты установки

### NPX (Рекомендуется)

Установка не требуется:

```bash theme={null}
npx megallm@latest
```

### Глобальная установка

Установите один раз, используйте в любое время:

```bash theme={null}
npm install -g megallm
megallm
```

### Определённая версия

Запустите определённую версию:

```bash theme={null}
npx megallm@2.5.9
```

## Пример первой настройки

```bash theme={null}
# Запустите CLI
npx megallm@latest

# Интерактивные подсказки:
# ✓ Обнаружена система: Linux (bash)
# ✓ Обнаружены инструменты: Claude Code ✓, Codex ✗
#
# ? Какой инструмент? › Claude Code
# ? Уровень настройки? › Системный уровень (глобальный)
# ? Введите API-ключ: sk-mega-***
#
# ✓ Конфигурация успешно применена!
# 🎉 Готово к использованию Claude Code с MegaLLM
```

## Получение вашего API-ключа

<Steps>
  <Step title="Посетите панель управления">
    Перейдите на [megallm.io/dashboard](https://megallm.io/dashboard)
  </Step>

  <Step title="Зарегистрируйтесь или войдите">
    Создайте аккаунт или войдите в существующий
  </Step>

  <Step title="Сгенерируйте API-ключ">
    Перейдите в раздел API Keys и нажмите "Create New API Key"
  </Step>

  <Step title="Скопируйте ключ">
    Скопируйте ваш ключ (начинается с `sk-mega-`) - вы не увидите его снова
  </Step>

  <Step title="Используйте в CLI">
    Вставьте ключ при запросе во время настройки
  </Step>
</Steps>

<Tip>
  CLI может автоматически открыть панель управления для вас во время настройки
</Tip>

## Что дальше?

<CardGroup cols={2}>
  <Card title="Руководство по установке" icon="download" href="/ru/cli/installation">
    Подробная установка и требования
  </Card>

  <Card title="Конфигурация" icon="gear" href="/ru/cli/configuration">
    Полный процесс настройки и конфигурации
  </Card>

  <Card title="Конфигурация" icon="gear" href="/ru/cli/configuration">
    Детали конфигурации для каждого инструмента
  </Card>

  <Card title="Примеры" icon="code" href="/ru/cli/examples">
    Практические примеры использования
  </Card>

  <Card title="Устранение неполадок" icon="circle-exclamation" href="/ru/cli/troubleshooting">
    Распространённые проблемы и решения
  </Card>

  <Card title="FAQ" icon="circle-question" href="/ru/cli/faq">
    Часто задаваемые вопросы
  </Card>
</CardGroup>

## Быстрые ссылки

* [Конфигурация Claude Code](/ru/cli/claude-config)
* [Конфигурация Codex/Windsurf](/ru/cli/codex-config)
* [Конфигурация OpenCode](/ru/cli/opencode-config)
* [Репозиторий GitHub](https://github.com/Megallm/megallm-npm)
* [NPM-пакет](https://www.npmjs.com/package/megallm)

## Поддержка

Нужна помощь? Мы здесь для вас:

* **Email**: [support@megallm.io](mailto:support@megallm.io)
* **Discord**: [Присоединяйтесь к нашему сообществу](https://discord.gg/Megallm)
* **GitHub Issues**: [Сообщить об ошибке или запросить функцию](https://github.com/Megallm/megallm-npm/issues)