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

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

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

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

В Windows, в PowerShell:

irm https://dev.meta.ai/install.ps1 | iex

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

macOS и Linux

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

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

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

Windows: нативный установщик для PowerShell

Когда это руководство только вышло, нативной сборки под Windows не было и единственным путём был WSL2. Теперь это не так: в документации Meta появился нативный установщик для Windows. Когда именно он появился, Meta не сообщала (стороннее руководство описывало его уже к 22 сентября 2026 года), но сегодня это официальный способ установки.

Откройте PowerShell и выполните:

irm https://dev.meta.ai/install.ps1 | iex

Затем откройте новое окно PowerShell, проверьте muse --version и запустите muse внутри git-репозитория. Впрочем, в Windows Muse Code ведёт себя не совсем так, как на других платформах, — Meta перечисляет такие отличия:

PowerShell вместо Bash. Агент выполняет команды в PowerShell, поэтому скрипты и однострочники, которые он пишет для вашего проекта, будут на PowerShell, а не на Bash.
Запрос UAC при первой инициализации песочницы. Когда песочница запускается впервые, Windows может попросить разрешение. Это нормально.
Нет голосового ввода. В Windows голосовой ввод недоступен.
Нет обмена сообщениями между сессиями. В Windows сессии не могут писать друг другу — эта функция есть только на macOS и Linux.

Альтернатива для Windows: когда лучше WSL2

WSL2 по-прежнему работает — это Linux, так что Muse Code ведёт себя там ровно так же, как на Linux-машине. Выбирайте его, если инструменты вашего проекта рассчитаны на Bash, если скрипты команды написаны под Linux или если вам нужен обмен сообщениями между сессиями. Подсистема Windows для Linux даёт настоящее Linux-окружение на Windows 10 или 11:

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

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

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

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

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

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

Как обновить Muse Code

Обычно делать ничего не нужно: Muse Code обновляется сам. Установщик ставит небольшой лаунчер, который следит за актуальностью основного бинарника, а начиная с CLI 1.4.11 сессия, открытая в момент автообновления, после него продолжается вместе с историей. Чтобы узнать текущую версию, запустите muse --version и сверьтесь с нашим Changelog — актуальную серию разбирает наш обзор релизов 1.4. Если нужна самая свежая сборка прямо сейчас, просто запустите ту же команду установки ещё раз — она заменит то, что уже стоит.

Пакетного менеджера, за которым нужно следить, тоже нет. Meta не публикует для CLI ни формулу Homebrew, ни пакеты npm или winget — пакет @muse-code/sdk в npm — это SDK для создания собственных агентов, а не сам Muse Code.

Как исправить типичные проблемы с установкой

muse: command not found после установки. Откройте новый терминал, чтобы шелл перечитал PATH. На macOS и Linux установщик добавляет ~/.local/bin в профиль шелла; если у вас нестандартный шелл, добавьте этот каталог в PATH вручную.
В Linux не выполняется ни одна команда шелла. Песочница в Linux опирается на встроенный помощник bubblewrap. Если рабочего помощника нет — в том числе в дистрибутивах на musl вроде Alpine, где его нет изначально, — Muse Code отказывается запускать команды шелла, а не выполняет их без песочницы. Используйте дистрибутив или контейнер на glibc.
Запрос разрешения в Windows при первом запуске. При первой инициализации песочница Windows может запросить права администратора (UAC). Запускать Muse Code от имени администратора после этого не нужно.
Корпоративные прокси и закрытые сети. Сначала скачайте скрипт с флагом -o install.sh, чтобы увидеть, к каким хостам он обращается, а затем попросите сетевую команду их разрешить.

Как удалить Muse Code

Команды для удаления в документации Meta нет, так что удалять придётся вручную. На macOS и Linux установщик кладёт в ~/.local/bin лаунчер muse и версионированные файлы muse-bin-*; удалите их, а если хотите избавиться и от настроек, сотрите ~/.config/muse/. В Windows выполните в PowerShell Get-Command muse, чтобы узнать, где лежит бинарник, и удалите его. Двух вещей удаление не делает: оно не отменяет подписку — это делается в разделе Subscriptions в Accounts Center от Meta, — и не стирает файлы, которые Muse Code записал в ваши репозитории, например AGENTS.md, .agents/ и .muse/.

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

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