Cómo instalar Muse Code (Meta) en Linux

Respuesta rápida: instala Muse Code en Linux en una línea

# Instalador oficial para macOS y Linux
curl -fsSL https://dev.meta.ai/install.sh | bash

# Comprueba la instalación
muse --version

# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
muse

La documentación oficial pasa el script a sh, pero está escrito para Bash, así que pasárselo a bash es lo más seguro en Ubuntu y Debian, donde sh es otro shell. Es también lo que ejecuta CodeAgentSwarm cuando instala Muse por ti. Los comandos de esta guía salen de la documentación oficial de Muse Code.

Requisitos

• Un Linux con curl y mktemp disponibles. Si falta alguno, el instalador se para con "required command not found".
• Bash, Zsh o fish. El instalador añade Muse al PATH en el archivo de arranque que toque.
• Una cuenta de Meta para entrar con el navegador, o una API key de Meta.
• Un sandbox que funcione. En Linux, Muse Code ejecuta los comandos de shell dentro de un helper de bubblewrap que trae incluido.

Qué cambia el instalador

El script descarga el lanzador de Muse, comprueba su checksum y lo deja en ~/.local/bin/muse. Puedes elegir otra carpeta con la variable de entorno MUSE_INSTALL_DIR.

Si ~/.local/bin aún no está en tu PATH, añade una línea a ~/.bashrc, ~/.zshrc, tu configuración de fish o ~/.profile, según tu shell. Define MUSE_NO_MODIFY_PATH si prefieres tocar el PATH tú.

# Instalar en otra carpeta
curl -fsSL https://dev.meta.ai/install.sh | MUSE_INSTALL_DIR="$HOME/bin" bash

Primer arranque e inicio de sesión (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe muse.
• Muse te pregunta si confías en ese espacio de trabajo. Di que sí solo en carpetas tuyas.
• Elige entrar con el navegador para aprobar la sesión allí, o pega directamente una API key de Meta.
• Escribe /login dentro de una sesión para volver a ver las opciones de login, y ejecuta muse logout para borrar la sesión y la clave guardadas.

En un servidor o por SSH, donde no se puede abrir un navegador, usa una API key. Exporta META_API_KEY y tendrá prioridad sobre cualquier clave o sesión guardada. Los usuarios de Meta Managed Account también tienen que usar API key, porque no pueden entrar con el navegador. Tienes los detalles en la página oficial de autenticación.

# Scripts y CI: sin interfaz interactiva
META_API_KEY="$MUSE_KEY" muse exec "Resume el README"

Errores comunes en Linux y cómo arreglarlos

• "muse: command not found" después de instalar: el cambio de PATH solo se aplica a shells nuevas. Abre otro terminal o ejecuta la línea source que te mostró el instalador.
• "required command not found: curl" o "mktemp": instala la herramienta que falta con tu gestor de paquetes y vuelve a lanzar el instalador.
• Todos los comandos de shell fallan como error de entorno: el helper de bubblewrap no funciona en esta máquina. Meta avisa de que una versión musl sin el helper falla igual.
• Muse no puede escribir en .git o .muse: es lo esperado. El sandbox da escritura en el espacio de trabajo y en una carpeta temporal, deja el resto del sistema en solo lectura y protege .git, .muse y .agents.
• El login con navegador funcionó pero se usa otra cuenta: mira si META_API_KEY está definida en tu shell. Tiene prioridad sobre la sesión del navegador.

La referencia oficial de permisos y seguridad explica con detalle los límites del sandbox.

Varias sesiones de Muse Code en Linux

Con Muse funcionando, el siguiente límite llega rápido: un terminal solo lleva una tarea a la vez. Le das un trabajo a Muse y esperas. Abrir más pestañas en GNOME Terminal o en tmux ayuda, hasta que pierdes la cuenta de qué sesión ha terminado, cuál espera tu aprobación y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio pensada justo para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o AppImage (Fedora y la mayoría de las demás distros), en x64 y ARM64. Puede instalar y abrir Muse Code en Linux, pone varios terminales de agentes uno al lado del otro y añade notificaciones cuando un agente termina o necesita algo, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal. Puedes tener Muse junto a Claude Code, Codex y otros agentes en la misma ventana.

Siguientes pasos: cómo usar Muse Code para tu primera tarea real, y modelos, precios y privacidad de Muse Code para entender la facturación antes de abrir varias sesiones.

Conclusión

En Linux, Muse Code está a un comando curl. Entra con el navegador en tu escritorio y con META_API_KEY en servidores, y si fallan los comandos de shell, revisa primero el sandbox de bubblewrap. Cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varios a la vez.