Guia não oficial. Sem vínculo com a Meta.

Atualizado em:

Muse Code no Windows: instalação nativa, sem WSL2

Resposta curta O Muse Code roda nativamente no Windows. Abra o PowerShell e rode irm https://dev.meta.ai/install.ps1 | iex. Você não precisa de WSL2, de máquina virtual Linux nem de app desktop. Só faltam no Windows a entrada por voz e as mensagens de sessão.

Precisa de WSL2? Não

Muitos guias ainda dizem "não tem instalador para Windows, configure o WSL2 primeiro". Isso está desatualizado. A documentação oficial tem um instalador para PowerShell e uma seção de plataformas dizendo que o Muse Code "runs on macOS, Linux, and Windows from one codebase". O WSL nem aparece.

Se você já trabalha dentro do WSL e gosta, pode instalar a versão Linux lá. É preferência, não requisito.

Instale o Muse Code no Windows em 5 passos

  1. Abra o PowerShell. Abra o Windows PowerShell ou o Windows Terminal com seu usuário normal. Não precisa rodar como administrador.
  2. Rode o instalador oficial. Rode: irm https://dev.meta.ai/install.ps1 | iex. Ele coloca um binário nativo do muse no seu PATH.
  3. Confira a instalação. Abra uma nova janela do PowerShell e rode: muse --version.
  4. Abra o Muse Code num projeto. Entre com cd na pasta do projeto e rode muse. Confie no workspace e faça login pelo navegador ou com uma API key.
  5. Aprove uma vez o aviso do sandbox. Na primeira vez que o sandbox inicia, o Windows pode mostrar um aviso do Controle de Conta de Usuário. Aprove; o uso normal não precisa de administrador.
irm https://dev.meta.ai/install.ps1 | iex
muse --version

Instale só a partir de dev.meta.ai. Não existe .exe, .msi nem app desktop oficial do Muse Code. Veja como baixar o Muse Code com segurança.

Fonte: Documentação oficial: instalação e plataformas

O que muda no Windows

ItemNo Windows
ShellOs comandos do agente usam sintaxe do PowerShell e ferramentas do Windows, não Bash.
SandboxA primeira inicialização pode mostrar um aviso UAC. O uso normal não precisa de administrador.
Entrada por vozIndisponível
Mensagens de sessãoIndisponível (funciona no macOS e no Linux)
Todo o restoMesmo CLI, modelos, planos e comandos do macOS e do Linux

Como os comandos rodam no PowerShell, fique atento se as instruções do projeto (AGENTS.md) ou seus scripts assumem Bash.

Muse Code no VS Code com Windows

Não há extensão oficial para o VS Code. Abra o terminal integrado (o padrão é PowerShell), entre com cd no seu repositório e rode muse. Tudo acima vale igual.

Próximos passos

Perguntas frequentes

O Muse Code funciona no Windows?

Sim. A documentação da Meta diz que o Muse Code "runs on macOS, Linux, and Windows from one codebase". No Windows, você instala pelo PowerShell com irm https://dev.meta.ai/install.ps1 | iex.

Preciso do WSL2 para usar o Muse Code?

Não. O instalador oficial coloca um binário nativo do Windows no seu PATH, e a documentação oficial nem menciona WSL. Guias que mandam instalar o WSL2 antes descrevem uma versão antiga do produto.

Ainda dá para usar dentro do WSL?

Se você prefere um shell Linux, pode rodar o instalador de macOS/Linux (curl -fsSL https://dev.meta.ai/install.sh | sh) dentro da sua distribuição WSL, como em qualquer Linux. É opcional.

Por que o Windows pede permissão de administrador?

O Windows pode mostrar um aviso do Controle de Conta de Usuário (UAC) na primeira vez que o sandbox do Muse Code inicia. Segundo a Meta, o uso normal não exige rodar como administrador.

O que não funciona no Windows?

Entrada por voz e mensagens de sessão não estão disponíveis no Windows. Os comandos que o agente roda usam sintaxe do PowerShell, não do Bash.

Existe app ou .exe do Muse Code para Windows?

Não. A Meta distribui o Muse Code como ferramenta de linha de comando instalada com o comando do PowerShell. Sites que oferecem um .exe ou cliente desktop "Muse Code para Windows" não são oficiais.

Dá para usar o Muse Code no VS Code no Windows?

Sim, pelo terminal integrado do VS Code (PowerShell). A documentação oficial não lista extensão para o VS Code.