Cómo descargar e instalar Muse Code en macOS, Linux y Windows

La «descarga» es un comando

Quien busca una descarga de Muse Code espera un .dmg, un .exe o una ficha en una tienda de aplicaciones. No existe. Muse Code es un programa de línea de comandos, y la forma oficial de conseguirlo es el script de instalación de Meta. En macOS y Linux:

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

En Windows, desde PowerShell:

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

Cualquiera de los dos scripts deja un binario muse en tu PATH; muse --version confirma que ha funcionado. Si prefieres no canalizar un script remoto directamente a tu shell, descárgalo primero (por ejemplo, con curl -fsSL https://dev.meta.ai/install.sh -o install.sh), léelo y luego ejecútalo. Eso es todo lo que hay que saber sobre la descarga en cualquier plataforma compatible: lo único que cambia es dónde lo ejecutas.

macOS y Linux

En un Mac o en una máquina Linux, abre una terminal y ejecuta el comando curl de arriba. Antes de la primera sesión conviene saber dos cosas:

Si no se encuentra muse tras la instalación, abre una nueva ventana de terminal para que tu shell vuelva a leer el PATH.
La primera ejecución inicia tu sesión. Al ejecutar muse en un directorio de proyecto se abre el navegador para autenticarte en dev.meta.ai con una cuenta de desarrollador de Meta. Las credenciales se guardan en caché, así que no tendrás que repetirlo en cada sesión. En servidores, runners de CI y otras máquinas sin interfaz, sáltate el navegador: crea una clave en el panel de la Model API y expórtala como META_API_KEY, o guárdala una sola vez con muse auth set.

A partir de ahí, haz cd a un repositorio git y ejecuta muse. Nuestra guía de primeros pasos propone una buena primera tarea.

Windows: el instalador nativo de PowerShell

Cuando publicamos esta guía por primera vez no había versión nativa para Windows y WSL2 era el único camino. Eso ha cambiado: la documentación de Meta incluye ahora un instalador nativo para Windows. Meta no ha anunciado cuándo apareció (una guía de terceros ya lo documentaba el 22 de septiembre de 2026), pero hoy es la vía oficial.

Abre PowerShell y ejecuta:

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

Después abre una nueva ventana de PowerShell, comprueba muse --version y ejecuta muse dentro de un repositorio git. Eso sí, Muse Code en Windows no se comporta exactamente igual que en las otras plataformas; Meta enumera estas diferencias:

PowerShell en lugar de Bash. El agente ejecuta sus comandos en PowerShell, así que los scripts y comandos de una línea que escriba para tu proyecto serán de PowerShell, no de Bash.
Un aviso de UAC la primera vez que se inicia el sandbox. La primera vez que el sandbox se inicializa, Windows puede pedirte permiso. Es lo esperado.
Sin entrada de voz. La voz no está disponible en Windows.
Sin mensajería entre sesiones. En Windows las sesiones no pueden enviarse mensajes entre sí; esa función es solo para macOS y Linux.

Alternativa en Windows: cuándo es mejor WSL2

WSL2 sigue funcionando: es Linux, así que Muse Code se comporta exactamente igual que en una máquina Linux. Elígelo si las herramientas de tu proyecto dan por hecho Bash, si los scripts de tu equipo están escritos para Linux o si quieres mensajería entre sesiones. El Subsistema de Windows para Linux te da un entorno Linux real en Windows 10 u 11:

Abre PowerShell como administrador y ejecuta wsl --install. Esto instala WSL2 con Ubuntu por defecto. Reinicia cuando te lo pida.
Abre Ubuntu desde el menú Inicio y crea tu usuario de Linux.
Asegúrate de tener lo básico: sudo apt update && sudo apt install -y curl git.
Ejecuta el instalador de macOS/Linux dentro de la terminal de Ubuntu: la misma línea curl … | sh de arriba, no la de PowerShell.
Guarda tus repositorios en el sistema de archivos de Linux, por ejemplo en ~/code, y no bajo /mnt/c. Muse Code lee y escribe muchísimos archivos, y el acceso a través de la frontera entre Windows y Linux es mucho más lento.

Si el inicio de sesión en el navegador no aparece desde dentro de WSL, usa una clave de API: crea una en el panel de la Model API y define META_API_KEY en el perfil de tu shell de Linux o guárdala con muse auth set.

VS Code, JetBrains y la cuestión de la «aplicación de escritorio»

Meta sigue sin ofrecer aplicación de escritorio, ni IDE, ni extensión oficial de editor para Muse Code. Eso no significa que tengas que renunciar a tu editor:

VS Code: ejecuta muse en la terminal integrada. Con el instalador nativo, funciona directamente en Windows en una terminal de PowerShell. Solo si has optado por WSL2 necesitas la extensión WSL de Microsoft: abre la carpeta de tu proyecto en WSL y la terminal integrada pasa a ser una shell de Linux en la que Muse Code funciona con normalidad.
Zed e IDEs de JetBrains: hay proyectos de la comunidad que conectan Muse Code con editores que hablan el Agent Client Protocol (ACP). No son oficiales: comprueba qué envían y a dónde antes de apuntar uno a código privado.

Desconfía de cualquier cosa anunciada como «aplicación de escritorio de Muse Code» o como descarga independiente de «Muse Code para Windows». Nada de eso lo publica Meta; los dos scripts de instalación de arriba son la única distribución oficial. (Microsoft anunció el 7 de octubre que el agente Muse de Meta para el gran público llegará a Windows como aplicación nativa, pero eso es Muse, no Muse Code.)

Actualizar Muse Code

Normalmente no tienes que hacer nada: Muse Code se actualiza solo. El instalador deja un pequeño lanzador que mantiene al día el binario real y, desde la CLI 1.4.11, una sesión que estuviera abierta cuando llegó una actualización automática se retoma con su historial. Para saber qué versión tienes, ejecuta muse --version y compárala con nuestro registro de cambios; las novedades de la 1.4 cubren la serie actual. Si quieres la última versión ya mismo, vuelve a ejecutar el mismo comando de instalación: sustituye lo que tengas instalado.

Tampoco hay un gestor de paquetes que mantener sincronizado. Meta no publica fórmula de Homebrew, paquete de npm ni paquete de winget para la CLI; el paquete @muse-code/sdk de npm es el SDK para crear tus propios agentes, no Muse Code en sí.

Solucionar los problemas de instalación más comunes

muse: command not found después de instalar. Abre una terminal nueva para que tu shell vuelva a leer el PATH. En macOS y Linux, el instalador añade ~/.local/bin al perfil de tu shell; si usas una shell poco habitual, añade tú ese directorio al PATH.
En Linux falla cualquier comando de shell. El sandbox de Linux depende de un ayudante de bubblewrap que viene incluido. Si no funciona —también en distribuciones basadas en musl como Alpine, que no lo traen—, Muse Code se niega a ejecutar comandos de shell antes que ejecutarlos sin sandbox. Usa una distribución o un contenedor con glibc.
Un aviso de permisos de Windows en la primera ejecución. El sandbox de Windows puede pedir aprobación de administrador (UAC) la primera vez que se inicializa. Después no hace falta ejecutar Muse Code como administrador.
Proxies corporativos y redes restringidas. Descarga antes el script con -o install.sh para ver a qué hosts se conecta y pide a tu equipo de redes que los permita.

Desinstalar Muse Code

Meta no documenta ningún comando de desinstalación, así que hay que hacerlo a mano. En macOS y Linux, el instalador coloca un lanzador muse y los archivos versionados muse-bin-* en ~/.local/bin: bórralos y elimina también ~/.config/muse/ si quieres deshacerte de tu configuración. En Windows, ejecuta Get-Command muse en PowerShell para ver dónde está el binario y bórralo. Hay dos cosas que desinstalar no hace: no cancela la suscripción —eso se hace en Suscripciones, dentro del Accounts Center de Meta— ni borra los archivos de proyecto que Muse Code haya creado en tus repositorios, como AGENTS.md, .agents/ y .muse/.

Después, elige cómo vas a pagar

Instalarlo es gratis; usar Muse Code, no. Puedes suscribirte a un plan mensual — Everyday Usage por 5 $, High Usage por 15 $, Power Usage por 50 $ o Maximum Usage por 200 $ — o prescindir del plan y pagar por token a través de la Meta Model API. La página de precios compara ambas opciones e incluye un estimador de costes.