Часто задаваемые вопросы

Общие вопросы

Что такое MegaLLM CLI?

MegaLLM CLI - это интерактивный инструмент настройки, который конфигурирует AI-помощники для программирования (Claude Code, Codex/Windsurf и OpenCode) для использования сервиса MegaLLM AI. Он автоматизирует процесс конфигурации, безопасно управляет API-ключами и обеспечивает удобную настройку на разных платформах.

Какие AI-инструменты поддерживаются?

CLI в настоящее время поддерживает:

Claude Code - Системная и проектная конфигурация
Codex/Windsurf - Только системная конфигурация
OpenCode - Системная и проектная конфигурация

В будущих релизах могут быть добавлены другие инструменты.

Нужно ли устанавливать CLI?

Нет! Вы можете запустить его напрямую используя npx:

npx megallm@latest

Однако вы также можете установить его глобально, если предпочитаете:

npm install -g megallm

Каковы системные требования?

Node.js: Версия 18.0.0 или выше
Операционная система: macOS, Linux или Windows
Оболочка: bash, zsh, fish или PowerShell

Проверьте версию Node.js командой: node --version

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

Как получить API-ключ MegaLLM?

Посетите megallm.io/dashboard
Зарегистрируйтесь или войдите в свой аккаунт
Перейдите в раздел API-ключей
Нажмите “Создать новый API-ключ”
Скопируйте свой API-ключ (начинается с sk-mega-)
Сохраните его безопасно - вы не сможете увидеть его снова

CLI может автоматически открыть эту страницу во время настройки.

В чём разница между системной и проектной конфигурацией?

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

Применяется ко всем проектам на вашем компьютере
Хранится в домашней директории (~/.claude/, ~/.codex/ и т.д.)
Лучше всего для личных сред разработки
Проще управлять для отдельных разработчиков

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

Применяется только к текущей директории проекта
Хранится в папке проекта (./.claude/, ./opencode.json и т.д.)
Лучше всего для командных проектов с общими конфигурациями
Позволяет использовать разные API-ключи для разных проектов
Может контролироваться версиями (без раскрытия API-ключей)

Важно: Codex/Windsurf поддерживает только системную конфигурацию.

Как настроить несколько инструментов?

При запуске CLI вас спросят, какой инструмент настроить:

? Какой инструмент вы хотите настроить?
  Claude Code
  Codex/Windsurf
  OpenCode
  Настроить все  ← Выберите эту опцию

Выбор “Настроить все” настроит все обнаруженные инструменты по очереди.Alternatively, запустите CLI несколько раз и выбирайте по одному инструменту каждый раз.

Будет ли CLI устанавливать AI-инструменты, если они отсутствуют?

Да! Если CLI обнаружит, что инструмент не установлен, он предложит его установить:

? Claude Code не установлен. Хотите установить его? (Y/n)

CLI устанавливает инструменты через NPM как глобальные пакеты.

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

Где хранятся файлы конфигурации?

Claude Code:

Системный: ~/.claude/settings.json, ~/.claude.json
Проектный: ./.claude/settings.json или ./.claude/settings.local.json

Codex/Windsurf:

Системный: ~/.codex/config.toml

OpenCode:

Системный: ~/.config/opencode/opencode.json
Проектный: ./opencode.json

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

bash: ~/.bashrc
zsh: ~/.zshrc
fish: ~/.config/fish/config.fish
PowerShell: профиль PowerShell

Что если у меня уже настроен MegaLLM?

CLI обнаружит существующие конфигурации и спросит, что вы хотите сделать:

Найдена существующая конфигурация MegaLLM:
- ~/.claude/settings.json
- ~/.codex/config.toml

? Что вы хотите сделать?
  Переопределить (удалить старую, применить новую)
  Пропустить (оставить существующую)
  Отменить

Выбор “Переопределить”:

Создаст резервные копии файлов (суффикс .backup)
Удалит старую конфигурацию
Применит новую конфигурацию

Выбор “Пропустить” сохранит вашу существующую настройку и выйдет.

Как обновить мой API-ключ?

Просто запустите CLI снова и выберите “Переопределить” при запросе о существующей конфигурации:

npx megallm@latest

# Выберите: Переопределить (удалить старую, применить новую)
# Введите ваш новый API-ключ

CLI создаст резервную копию вашей старой конфигурации перед применением новой.

Могу ли я использовать разные API-ключи для разных проектов?

Да! Используйте проектную конфигурацию:

# Проект A
cd ~/projects/project-a
npx megallm@latest
# Выберите: Проектный уровень
# Введите API-ключ для Проекта A

# Проект B
cd ~/projects/project-b
npx megallm@latest
# Выберите: Проектный уровень
# Введите API-ключ для Проекта B

Каждый проект будет иметь свой собственный .claude/settings.json со своим API-ключом.

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

CLI говорит, что инструмент установлен, но я не могу его найти

CLI проверяет наличие инструментов следующими методами:

Список глобальных пакетов NPM
Доступность команды в PATH
Известные директории установки

Если обнаружение не удалось:

Убедитесь, что инструмент установлен глобально: npm list -g --depth=0
Проверьте, доступна ли команда: which claude-code или which codex
Перезапустите терминал
Попробуйте установить вручную: npm install -g @anthropic-ai/claude-code

Я получаю ошибки 'permission denied'

Это обычно означает, что у вас нет прав на запись в директории конфигурации.Исправление для macOS/Linux:

# Исправить владение директориями конфигурации
sudo chown -R $USER ~/.claude ~/.codex ~/.config/opencode

# Исправить права доступа
chmod -R 755 ~/.claude ~/.codex ~/.config/opencode

Исправление для Windows:

Запустите терминал от имени администратора
Или: Исправьте права доступа в Проводнике → Свойства → Безопасность

Моя конфигурация не используется

Проверка 1: Переменные окружения

# Claude Code
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# Codex
echo $MEGALLM_API_KEY

Если пусто, перезагрузите оболочку:

source ~/.bashrc  # или ~/.zshrc
# Или перезапустите терминал

Проверка 2: Файлы конфигурации

# Claude Code
cat ~/.claude/settings.json

# Codex
cat ~/.codex/config.toml

Убедитесь, что файлы существуют и содержат ваш API-ключ.Проверка 3: Права доступа к файлам

ls -la ~/.claude/settings.json
ls -la ~/.codex/config.toml

Файлы должны быть доступны для чтения вашим пользователем.

Я получаю ошибки 'Invalid API key'

Проверьте формат ключа: Должен начинаться с sk-mega-
Проверьте на опечатки: Скопируйте ключ прямо из панели управления
Удалите пробелы: Удалите любые пробелы до/после ключа
Длина ключа: Должна быть не менее 20 символов
Перегенерируйте: Создайте новый API-ключ на megallm.io/dashboard

Протестируйте ваш API-ключ:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://ai.megallm.io/v1/models

Как полностью удалить конфигурацию MegaLLM?

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

# Claude Code
rm -rf ~/.claude/settings.json ~/.claude.json

# Codex
rm -rf ~/.codex/config.toml

# OpenCode
rm -rf ~/.config/opencode/opencode.json

# Проектный уровень
rm -rf ./.claude ./opencode.json

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

export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-..."
export MEGALLM_API_KEY="sk-mega-..."

Затем перезагрузите: source ~/.bashrc или перезапустите терминал.

Могу ли я видеть, что CLI делает подробно?

Да! Запустите в режиме отладки:

DEBUG=* npx megallm@latest

Это покажет подробные логи:

Обнаружение системы
Обнаружение инструментов
Файловые операции
Изменения конфигурации
Трассировки ошибок

Продвинутое использование

Могу ли я использовать CLI в CI/CD конвейерах?

Да, но лучше настроить вручную в CI/CD средах:

# Пример GitHub Actions
- name: Configure MegaLLM
  env:
    ANTHROPIC_API_KEY: ${{ secrets.MEGALLM_API_KEY }}
  run: |
    mkdir -p .claude
    echo '{"env":{"ANTHROPIC_BASE_URL":"https://ai.megallm.io","ANTHROPIC_API_KEY":"'$ANTHROPIC_API_KEY'"}}' > .claude/settings.json

Это избегает интерактивных запросов и более надежно в автоматизированных средах.

Как настроить MegaLLM в Docker-контейнере?

Добавьте конфигурацию во время сборки Docker:

FROM node:18

# Установите переменные окружения
ENV ANTHROPIC_BASE_URL=https://ai.megallm.io
ENV ANTHROPIC_API_KEY=your-key-here

# Или скопируйте файлы конфигурации
COPY .claude/settings.json /root/.claude/settings.json

WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

Или передайте API-ключ во время выполнения:

docker run -e ANTHROPIC_API_KEY=sk-mega-... myimage

Могу ли я контролировать версии моей конфигурации?

Да, но осторожно:СЛЕДУЕТ коммитить:

Проектная конфигурация БЕЗ API-ключей
.claude/settings.json только с ANTHROPIC_BASE_URL
Документацию для членов команды

НЕ СЛЕДУЕТ коммитить:

API-ключи
.claude/settings.local.json
Личные переменные окружения

Пример .claude/settings.json для контроля версий:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io"
  }
}

Добавьте в .gitignore:

.claude/settings.local.json
.claude.json

Члены команды добавляют свои собственные API-ключи:

# .claude/settings.local.json (не коммитится)
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-personal-key"
  }
}

Могу ли я использовать разные модели с каждым инструментом?

Да! Файл конфигурации каждого инструмента позволяет указать модель.Claude Code (~/.claude/settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-...",
    "ANTHROPIC_MODEL": "claude-opus-4-1-20250805"
  }
}

Codex (~/.codex/config.toml):

model = "gpt-5"  # Измените на любую поддерживаемую модель

OpenCode (~/.config/opencode/opencode.json):

{
  "model": "gemini-2.5-pro"
}

См. Каталог моделей для доступных моделей.

Что происходит с моими резервными копиями?

CLI создает резервные копии файлов перед изменением конфигураций:

~/.claude/settings.json.backup
~/.codex/config.toml.backup
~/.config/opencode/opencode.json.backup

Резервные копии создаются с суффиксом .backup и содержат вашу предыдущую конфигурацию.Чтобы восстановить из резервной копии:

mv ~/.claude/settings.json.backup ~/.claude/settings.json

Вы можете удалить резервные копии вручную, если они вам не нужны:

rm ~/.claude/*.backup ~/.codex/*.backup

Получение помощи

Где я могу получить поддержку?

Документация:

Основная документация: docs.megallm.io
API справочник: docs.megallm.io/api

Каналы поддержки:

Email: support@megallm.io
GitHub Issues: github.com/Megallm/megallm-npm/issues
Discord: discord.gg/Megallm

Сообщество:

Twitter/X: @megallmio
YouTube: youtube.com/@Megallmio

Как сообщить об ошибке?

Проверьте существующие проблемы: github.com/Megallm/megallm-npm/issues
Если не найдено, создайте новую проблему с:
- Версией CLI: npx megallm@latest --version
- Версией Node.js: node --version
- Операционной системой
- Типом оболочки
- Сообщением об ошибке/логами (запустите с DEBUG=*)
- Шагами воспроизведения

Как запросить функцию?

Откройте запрос функции на GitHub: github.com/Megallm/megallm-npm/issues/newВключите:

Описание функции
Случай использования / почему это нужно
Любые соответствующие примеры или макеты

Остались вопросы?

Не можете найти ответ? Мы здесь, чтобы помочь!

Поддержка по Email

Получите помощь от нашей команды поддержки

GitHub Issues

Сообщите об ошибках или запросите функции

Сообщество Discord

Общайтесь с сообществом

Документация

Просмотрите полную документацию

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

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

Руководства

Часто задаваемые вопросы

Общие вопросы

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

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

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

Продвинутое использование

Получение помощи

Остались вопросы?

Поддержка по Email

GitHub Issues

Сообщество Discord

Документация

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

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

Руководства

​Общие вопросы

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

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

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

​Продвинутое использование

​Получение помощи

​Остались вопросы?

Поддержка по Email

GitHub Issues

Сообщество Discord

Документация

Общие вопросы

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

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

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

Продвинутое использование

Получение помощи

Остались вопросы?