Como instalar o Muse Code no macOS, Linux e Windows (WSL2)
Não existe app de desktop do Muse Code nem instalador para Windows — só uma instalação de uma linha no terminal. Veja como colocá-lo para rodar no Mac, no Linux e no Windows via WSL2, e o que fazer em relação ao VS Code.
O “download” é um comando só
Quem procura um download do Muse Code espera um .dmg, um .exe ou uma página numa loja de apps. Não existe. O Muse Code é um programa de linha de comando, e a forma oficial de obtê-lo é o script de instalação da Meta:
curl -fsSL https://dev.meta.ai/install.sh | bashO script coloca um binário muse no seu PATH; muse --version confirma que deu certo. Se você prefere não encanar um script remoto direto no seu shell, baixe-o antes com curl -fsSL https://dev.meta.ai/install.sh -o install.sh, leia e só então execute. Isso é tudo o que existe de download em qualquer plataforma suportada — o que muda é onde você o executa.
macOS e Linux
No Mac ou numa máquina Linux, abra um terminal e rode o comando acima. Vale saber duas coisas antes da primeira sessão:
- Se o
musenão for encontrado depois da instalação, abra uma nova janela de terminal para que o shell releia o PATH. - A primeira execução faz o seu login. Rodar
musenum diretório de projeto abre o navegador para você se autenticar em dev.meta.ai com uma conta de desenvolvedor Meta. As credenciais ficam em cache, então você não vai repetir isso a cada sessão. Em servidores, runners de CI e outras máquinas headless, pule o navegador: crie uma chave no dashboard da Model API e exporte-a comoMODEL_API_KEY.
A partir daí, dê um cd num repositório git e rode muse. Nosso guia de primeiros passos sugere uma boa primeira tarefa.
Windows: instale dentro do WSL2
Não existe versão nativa para Windows. O instalador da Meta mira macOS e Linux, e desenvolvedores que tentam rodá-lo pelo PowerShell relatam que ele simplesmente se recusa a executar. O caminho que funciona é o Subsistema do Windows para Linux, que oferece um ambiente Linux de verdade no Windows 10 ou 11:
- Abra o PowerShell como administrador e rode
wsl --install. Isso instala o WSL2 com Ubuntu por padrão. Reinicie quando for solicitado. - Abra o Ubuntu pelo menu Iniciar e crie seu usuário Linux.
- Garanta que o básico está instalado:
sudo apt update && sudo apt install -y curl git. - Rode o instalador do Muse Code dentro do terminal do Ubuntu — a mesma linha
curl … | bashde antes. - Mantenha seus repositórios no sistema de arquivos do Linux, por exemplo em
~/code, e não em/mnt/c. O Muse Code lê e grava muitos arquivos, e o acesso que atravessa a fronteira entre Windows e Linux é bem mais lento.
Se o login pelo navegador não abrir de dentro do WSL, use uma chave de API: crie uma no dashboard da Model API e defina MODEL_API_KEY no perfil do seu shell Linux.
VS Code, JetBrains e a questão do “app de desktop”
A Meta não oferece app de desktop, nem IDE, nem extensão oficial de editor para o Muse Code. Isso não significa que você precise abrir mão do seu editor:
- VS Code: rode
museno terminal integrado. No Windows, instale a extensão WSL da Microsoft, abra a pasta do projeto no WSL e o terminal integrado vira um shell Linux onde o Muse Code funciona normalmente. - Zed e IDEs da JetBrains: projetos da comunidade conectam o Muse Code a editores que falam o Agent Client Protocol (ACP). Não são oficiais — verifique o que eles enviam e para onde antes de apontar um deles para código privado.
Desconfie de qualquer coisa anunciada como “app de desktop do Muse Code” ou como download de “Muse Code para Windows”. Nada disso é publicado pela Meta; o script de instalação acima é a única distribuição oficial.
Mantendo tudo atualizado
A documentação da Meta mostra o instalador e nada mais, então consulte muse --help para ver os comandos que a sua versão suporta e acompanhe o nosso changelog para saber das novas versões. O Muse Code saiu do beta em 31 de agosto de 2026 e passou para o modelo Muse Spark 1.3 dois dias depois — uma instalação atualizada traz as duas coisas.
Depois, escolha como vai pagar
Instalar é de graça; usar o Muse Code, não. Você pode assinar um plano mensal — Everyday Usage por US$ 5, High Usage por US$ 15 ou Power Usage por US$ 50 — ou dispensar o plano e pagar por token pela Meta Model API. A página de preços compara as duas opções e inclui um estimador de custos.