Неофициальный гид. Не связан с Meta.

Обновлено:

Muse Code в Windows: нативная установка без WSL2

Коротко Muse Code работает в Windows нативно. Откройте PowerShell и выполните irm https://dev.meta.ai/install.ps1 | iex. Вам не нужны ни WSL2, ни виртуальная машина с Linux, ни десктопное приложение. В Windows недоступны только голосовой ввод и обмен сообщениями между сессиями.

Нужен ли WSL2? Нет

Многие руководства до сих пор пишут: «установщика для Windows нет, сначала настройте WSL2». Это устарело. В официальной документации есть установщик для PowerShell и раздел о поддерживаемых платформах, где сказано, что Muse Code «работает в macOS, Linux и Windows на единой кодовой базе». WSL в документации не упоминается вовсе.

Если вы уже работаете в WSL и вам так удобно, можете по-прежнему установить туда версию для Linux. Это вопрос предпочтений, а не требование.

Установка Muse Code в Windows за 5 шагов

  1. Откройте PowerShell. Откройте Windows PowerShell или Терминал Windows под обычным пользователем. Запускать от имени администратора не нужно.
  2. Запустите официальный установщик. Выполните: irm https://dev.meta.ai/install.ps1 | iex. Он добавит нативный бинарный файл muse в PATH.
  3. Проверьте установку. Откройте новое окно PowerShell и выполните: muse --version.
  4. Запустите Muse Code в проекте. Перейдите в папку проекта командой cd и запустите muse. Подтвердите доверие к рабочей области, затем войдите через браузер или с помощью API-ключа.
  5. Один раз подтвердите запрос песочницы. При первом запуске песочницы Windows может показать запрос контроля учётных записей. Подтвердите его; для обычной работы права администратора не нужны.
irm https://dev.meta.ai/install.ps1 | iex
muse --version

Устанавливайте только с dev.meta.ai. Официального .exe, .msi или десктопного приложения Muse Code не существует. Смотрите, как безопасно скачать Muse Code.

Источник: Официальная документация: установка и поддерживаемые платформы

Что в Windows работает иначе

ОбластьВ Windows
ОболочкаКоманды, которые запускает агент, используют синтаксис PowerShell и инструменты командной строки Windows, а не Bash.
ПесочницаПри первом запуске песочницы может появиться запрос UAC. Для обычной работы права администратора не нужны.
Голосовой вводНедоступен
Обмен сообщениями между сессиямиНедоступен (поддерживается в macOS и Linux)
Всё остальноеТот же CLI, те же модели, тарифы и команды, что в macOS и Linux

Поскольку команды выполняются в PowerShell, учитывайте это, если инструкции вашего проекта (AGENTS.md) или скрипты рассчитаны на Bash.

Muse Code в VS Code в Windows

Официального расширения для VS Code нет. Откройте встроенный терминал (по умолчанию PowerShell), перейдите в репозиторий командойcd и запустите muse. Всё описанное выше применяется без изменений.

Что дальше

Частые вопросы

Поддерживает ли Muse Code Windows?

Да. В документации Meta сказано, что Muse Code «работает в macOS, Linux и Windows на единой кодовой базе». В Windows он устанавливается из PowerShell командой irm https://dev.meta.ai/install.ps1 | iex.

Нужен ли WSL2 для Muse Code?

Нет. Официальный установщик добавляет в PATH нативный бинарный файл для Windows. В официальной документации WSL вообще не упоминается. Руководства, которые предлагают сначала установить WSL2, описывают устаревшее состояние продукта.

Можно ли всё же использовать Muse Code внутри WSL?

Если вам удобнее оболочка Linux, можно запустить установщик для macOS/Linux (curl -fsSL https://dev.meta.ai/install.sh | sh) в своём дистрибутиве WSL, как на любой Linux-машине. Это по желанию, а не обязательно.

Почему Windows запрашивает разрешение администратора?

Windows может показать запрос контроля учётных записей (UAC) при первой инициализации песочницы Muse Code. Согласно документации Meta, для обычной работы запуск от имени администратора не требуется.

Что не работает в Windows?

Голосовой ввод и обмен сообщениями между сессиями в Windows недоступны. Команды, которые запускает агент, используют синтаксис PowerShell вместо Bash.

Есть ли приложение Muse Code для Windows или .exe для скачивания?

Нет. Meta распространяет Muse Code как инструмент командной строки, который устанавливается одной командой в PowerShell. Сайты, предлагающие .exe или десктопный клиент «Muse Code для Windows», не являются официальными.

Можно ли использовать Muse Code в VS Code в Windows?

Да, из встроенного терминала VS Code (PowerShell). Расширения для VS Code в официальной документации нет.