ГАЙД· 3 мин чтения

Как установить Muse Code на macOS, Linux и Windows (WSL2)

У Muse Code нет десктопного приложения и нет установщика для Windows — только установка одной командой в терминале. Рассказываем, как запустить его на Mac, в Linux и в Windows через WSL2 и что делать с VS Code.

#install#windows#wsl#getting-started

«Скачать» — это одна команда

Те, кто ищет, где скачать Muse Code, ожидают .dmg, .exe или страницу в магазине приложений. Ничего такого нет. Muse Code — программа для командной строки, и официальный способ её получить — установочный скрипт Meta:

curl -fsSL https://dev.meta.ai/install.sh | bash

Скрипт кладёт бинарник muse в PATH; muse --version подтверждает, что всё получилось. Если не хочется пайпить удалённый скрипт прямо в шелл, сначала скачайте его командой curl -fsSL https://dev.meta.ai/install.sh -o install.sh, прочитайте и только потом запускайте. Вот и вся история со скачиванием на любой поддерживаемой платформе — меняется лишь то, где вы эту команду запускаете.

macOS и Linux

На Mac или машине с Linux откройте терминал и выполните команду выше. Перед первой сессией полезно знать две вещи:

  • Если после установки muse не находится, откройте новое окно терминала, чтобы шелл заново прочитал PATH.
  • При первом запуске нужно войти. Запуск muse в каталоге проекта открывает браузер для аутентификации на dev.meta.ai через аккаунт разработчика Meta. Учётные данные кэшируются, так что делать это в каждой сессии не придётся. На серверах, CI-раннерах и других headless-машинах браузер не нужен: создайте ключ в дашборде Model API и экспортируйте его как MODEL_API_KEY.

Дальше сделайте cd в git-репозиторий и запустите muse. В нашем руководстве для начинающих есть хорошая первая задача.

Windows: устанавливайте внутри WSL2

Нативной сборки под Windows нет. Установщик Meta рассчитан на macOS и Linux, а разработчики, пробовавшие запустить его из PowerShell, сообщают, что он просто отказывается работать. Рабочий путь — подсистема Windows для Linux, которая даёт настоящее Linux-окружение на Windows 10 или 11:

  1. Откройте PowerShell от имени администратора и выполните wsl --install. По умолчанию это установит WSL2 с Ubuntu. Перезагрузитесь, когда система попросит.
  2. Запустите Ubuntu из меню «Пуск» и создайте пользователя Linux.
  3. Убедитесь, что базовые инструменты на месте: sudo apt update && sudo apt install -y curl git.
  4. Запустите установщик Muse Code в терминале Ubuntu — ту же строку curl … | bash, что и выше.
  5. Держите репозитории в файловой системе Linux, например в ~/code, а не в /mnt/c. Muse Code читает и пишет много файлов, а доступ через границу между Windows и Linux намного медленнее.

Если вход через браузер изнутри WSL не открывается, используйте API-ключ: создайте его в дашборде Model API и пропишите MODEL_API_KEY в профиле вашего Linux-шелла.

VS Code, JetBrains и вопрос о «десктопном приложении»

Meta не выпускает для Muse Code ни десктопного приложения, ни IDE, ни официального расширения для редактора. Но это не значит, что от своего редактора придётся отказаться:

  • VS Code: запускайте muse во встроенном терминале. В Windows установите расширение WSL от Microsoft, откройте папку проекта в WSL — и встроенный терминал станет Linux-шеллом, в котором Muse Code работает как обычно.
  • Zed и IDE от JetBrains: проекты сообщества подключают Muse Code к редакторам, поддерживающим Agent Client Protocol (ACP). Они неофициальные — прежде чем натравливать какой-либо из них на приватный код, проверьте, что и куда он отправляет.

С осторожностью относитесь ко всему, что рекламируется как «десктопное приложение Muse Code» или загрузка «Muse Code для Windows». Ничего из этого Meta не публиковала; установочный скрипт выше — единственный официальный способ распространения.

Как держать установку актуальной

Документация Meta показывает установщик — и больше ничего, так что смотрите в muse --help, какие команды поддерживает ваша версия, а за релизами следите в нашем Changelog. Muse Code вышел из беты 31 августа 2026 года, а через два дня перешёл на модель Muse Spark 1.3 — актуальная установка получает и то и другое.

Затем выберите, как платить

Установка бесплатна; пользоваться Muse Code — нет. Можно оформить месячную подписку — Everyday Usage за $5, High Usage за $15 или Power Usage за $50 — или обойтись без подписки и платить за токены через Meta Model API. Страница цен сравнивает оба варианта и включает калькулятор расходов.

Читать дальше