Установка

Быстрая установка

Самый быстрый способ начать работу - установка не требуется:

npx megallm@latest

Это запускает последнюю версию напрямую без постоянной установки.

Методы установки

Метод 1: NPX (Рекомендуется)

Запуск напрямую без установки:

npx megallm@latest

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

Установка не требуется
Всегда использует последнюю версию
Не занимает дисковое пространство
Идеально для разового или периодического использования

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

# Запустить последнюю версию
npx megallm@latest

# Запустить конкретную версию
npx megallm@2.5.9

# С переменными окружения
NO_BANNER=1 npx megallm@latest

Метод 2: Глобальная установка

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

npm install -g megallm

Затем запустите с помощью:

megallm

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

Быстрый запуск (уже установлено)
Работает офлайн (после первоначальной установки)
Более короткая команда
Хорошо для частого использования

Обновление:

npm update -g megallm

Удаление:

npm uninstall -g megallm

Метод 3: Локальная установка проекта

Установка в качестве зависимости проекта:

npm install --save-dev megallm

Добавьте в скрипты package.json:

{
  "scripts": {
    "setup-megallm": "megallm"
  }
}

Запустите с помощью:

npm run setup-megallm

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

Командных проектов со стандартизированной настройкой
Установок с фиксированной версией
CI/CD конвейеров

Системные требования

Требуется

Node.js 18.0.0 или выше требуется для запуска MegaLLM CLI

Проверьте версию Node.js:

node --version

Если вам нужно установить или обновить Node.js:

macOS
Linux
Windows

Используя Homebrew:

brew install node

Используя nvm (рекомендуется):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

Официальный установщик: Скачайте с nodejs.org

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora:

sudo dnf install nodejs

Используя nvm (рекомендуется):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

Официальный установщик: Скачайте с nodejs.orgИспользуя Chocolatey:

choco install nodejs

Используя nvm-windows:

nvm install 18
nvm use 18

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

Платформа	Статус	Примечания
macOS	Полная поддержка	Intel и Apple Silicon
Linux	Полная поддержка	Все основные дистрибутивы
Windows	Полная поддержка	Native и WSL

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

Оболочка	Статус	Платформа
bash	Полная поддержка	Все платформы
zsh	Полная поддержка	macOS, Linux
fish	Полная поддержка	macOS, Linux
PowerShell	Полная поддержка	Windows

Проверка

После установки проверьте, что все работает:

# Проверить версию Node.js
node --version
# Должно показать: v18.0.0 или выше

# Проверить версию npm
npm --version
# Должно показать: 9.0.0 или выше

# Запустить CLI
npx megallm@latest --version
# или если установлено глобально:
megallm --version

Разрешения

macOS/Linux

CLI требуется доступ на запись к:

~/.claude/ - конфигурация Claude Code
~/.codex/ - конфигурация Codex
~/.config/opencode/ - конфигурация OpenCode
~/.bashrc, ~/.zshrc, и т.д. - файлы конфигурации оболочки

Если вы сталкиваетесь с ошибками разрешений:

# Исправить владение
sudo chown -R $USER ~/.claude ~/.codex ~/.config/opencode

# Исправить разрешения
chmod -R 755 ~/.claude ~/.codex ~/.config/opencode

Windows

Запустите терминал от имени администратора, если возникают проблемы с разрешениями.

Установка инструментов ИИ

CLI может автоматически установить инструменты кодирования ИИ, если они отсутствуют. Требуемые разрешения:

# Разрешение на глобальную установку NPM
npm install -g @anthropic-ai/claude-code
npm install -g @codeium/windsurf
npm install -g opencode

Если у вас нет разрешения на глобальные установки: Вариант 1: Используйте npx

# Вместо глобальной установки используйте npx
npx @anthropic-ai/claude-code

Вариант 2: Исправьте разрешения npm

# macOS/Linux
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

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

npm: команда не найдена

Node.js не установлен или не в вашем PATH.Исправление:

Установите Node.js с nodejs.org
Перезапустите терминал
Проверьте: node --version

npx: команда не найдена

npm не установлен или это старая версия.Исправление:

# Обновить npm
npm install -g npm@latest

# Или переустановить Node.js

Ошибки разрешений EACCES

У вас нет разрешения на установку глобальных пакетов.Исправление:

# macOS/Linux - Настроить npm для использования другого каталога
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile

Или используйте sudo (не рекомендуется):

sudo npm install -g megallm

Ошибки несоответствия версий

Вы используете старую версию.Исправление:

# Очистить кэш npm
npm cache clean --force

# Обновить до последней версии
npm update -g megallm

# Или запустить последнюю с npx
npx megallm@latest

Сетевые ошибки или ошибки прокси

npm не может подключиться к реестру.Исправление:

# Проверить реестр npm
npm config get registry

# Установить реестр
npm config set registry https://registry.npmjs.org/

# Если за прокси
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

Расширенная установка

Оффлайн установка

Для сред без доступа в интернет:

Скачать на машине с интернетом:

npm pack megallm
# Создает: megallm-2.5.9.tgz

Перенести файл на оффлайн машину
Установить из tarball:
npm install -g ./megallm-2.5.9.tgz

Установка CI/CD

Для автоматизированных сред:

- name: Setup Node.js
  uses: actions/setup-node@v3
  with:
    node-version: '18'

- name: Run MegaLLM CLI
  run: npx megallm@latest
  env:
    NO_BANNER: '1'

setup_cli:
  image: node:18
  script:
    - npm install -g megallm@latest
    - megallm --version

pipeline {
  agent {
    docker {
      image 'node:18'
    }
  }
  stages {
    stage('Setup') {
      steps {
        sh 'npx megallm@latest'
      }
    }
  }
}

Установка Docker

Включите в ваш Dockerfile:

FROM node:18

# Установить megallm глобально
RUN npm install -g megallm

# Или использовать npx
RUN npx megallm@latest --version

# Настроить во время выполнения
CMD ["megallm"]

Управление версиями

Проверить текущую версию

# Если установлено глобально
megallm --version

# Используя npx
npx megallm@latest --version

Установить конкретную версию

# Установить конкретную версию глобально
npm install -g megallm@2.5.9

# Запустить конкретную версию с npx
npx megallm@2.5.9

История версий

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

npm view megallm versions

Просмотреть последнюю версию:

npm view megallm version

Удаление

Удалить глобальную установку

npm uninstall -g megallm

Удалить файлы конфигурации

CLI создает файлы конфигурации, которые сохраняются после удаления:

# Удалить все конфигурации MegaLLM
rm -rf ~/.claude/settings.json ~/.claude.json
rm -rf ~/.codex/config.toml
rm -rf ~/.config/opencode/opencode.json

# Удалить переменные окружения
# Отредактируйте конфигурацию оболочки (~/.bashrc, ~/.zshrc, и т.д.)
# и удалите строки, содержащие:
# ANTHROPIC_BASE_URL
# ANTHROPIC_API_KEY
# MEGALLM_API_KEY

Полная очистка

Чтобы полностью удалить все следы:

# Удалить CLI
npm uninstall -g megallm

# Удалить файлы конфигурации
rm -rf ~/.claude ~/.codex ~/.config/opencode

# Удалить конфигурации уровня проекта
rm -rf ./.claude ./opencode.json

# Очистить кэш npm
npm cache clean --force

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

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

Полный процесс настройки

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

Детали конфигурации

Примеры

Примеры использования

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

Распространенные проблемы

Начало работы

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

Руководства

Установка

Быстрая установка

Методы установки

Метод 1: NPX (Рекомендуется)

Метод 2: Глобальная установка

Метод 3: Локальная установка проекта

Системные требования

Требуется

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

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

Проверка

Разрешения

macOS/Linux

Windows

Установка инструментов ИИ

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

Расширенная установка

Оффлайн установка

Установка CI/CD

Установка Docker

Управление версиями

Проверить текущую версию

Установить конкретную версию

История версий

Удаление

Удалить глобальную установку

Удалить файлы конфигурации

Полная очистка

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

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

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

Примеры

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

​Быстрая установка

​Методы установки

​Метод 1: NPX (Рекомендуется)

​Метод 2: Глобальная установка

​Метод 3: Локальная установка проекта

​Системные требования

​Требуется

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

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

​Проверка

​Разрешения

​macOS/Linux

​Windows

​Установка инструментов ИИ

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

​Расширенная установка

​Оффлайн установка

​Установка CI/CD

​Установка Docker

​Управление версиями

​Проверить текущую версию

​Установить конкретную версию

​История версий

​Удаление

​Удалить глобальную установку

​Удалить файлы конфигурации

​Полная очистка

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

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

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

Примеры

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

Быстрая установка

Методы установки

Метод 1: NPX (Рекомендуется)

Метод 2: Глобальная установка

Метод 3: Локальная установка проекта

Системные требования

Требуется

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

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

Проверка

Разрешения

macOS/Linux

Windows

Установка инструментов ИИ

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

Расширенная установка

Оффлайн установка

Установка CI/CD

Установка Docker

Управление версиями

Проверить текущую версию

Установить конкретную версию

История версий

Удаление

Удалить глобальную установку

Удалить файлы конфигурации

Полная очистка

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