Быстрая установка Самый быстрый способ начать работу - установка не требуется:
Это запускает последнюю версию напрямую без постоянной установки.
Методы установки Метод 1: NPX (Рекомендуется) Запуск напрямую без установки:
Преимущества:
Установка не требуется
Всегда использует последнюю версию
Не занимает дисковое пространство
Идеально для разового или периодического использования
Использование: # Запустить последнюю версию npx megallm@latest # Запустить конкретную версию npx megallm@2.5.9 # С переменными окружения NO_BANNER = 1 npx megallm@latest Метод 2: Глобальная установка Установите один раз, используйте в любое время:
Затем запустите с помощью:
Преимущества:
Быстрый запуск (уже установлено)
Работает офлайн (после первоначальной установки)
Более короткая команда
Хорошо для частого использования
Обновление: Удаление: Метод 3: Локальная установка проекта Установка в качестве зависимости проекта:
npm install --save-dev megallm Добавьте в скрипты package.json:
{ "scripts" : { "setup-megallm" : "megallm" } } Запустите с помощью:
Лучше всего для:
Командных проектов со стандартизированной настройкой
Установок с фиксированной версией
CI/CD конвейеров
Системные требования Требуется Node.js 18.0.0 или выше требуется для запуска MegaLLM CLI
Проверьте версию Node.js:
Если вам нужно установить или обновить Node.js:
Используя Homebrew: Используя nvm (рекомендуется): curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install 18 nvm use 18 Официальный установщик:
Скачайте с nodejs.org Поддерживаемые платформы Платформа Статус Примечания 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 Устранение неполадок при установке
Node.js не установлен или не в вашем PATH. Исправление:
Установите Node.js с nodejs.org
Перезапустите терминал
Проверьте: node --version
npm не установлен или это старая версия. Исправление: # Обновить npm npm install -g npm@latest # Или переустановить Node.js
У вас нет разрешения на установку глобальных пакетов. Исправление: # 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 Для автоматизированных сред:
GitHub Actions
GitLab CI
Jenkins
- 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'
Установка 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 Просмотреть последнюю версию:
Удаление Удалить глобальную установку Удалить файлы конфигурации 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 Следующие шаги 
