Cómo usar Muse Code: instalación, login y primera tarea

Por CodeAgentSwarm · Actualizado el 22 de septiembre de 2026

Muse Code es el agente de programación de Meta para terminal. Empieza con un repositorio pequeño que conozcas, pídele que lo inspeccione y comprueba su primer cambio con una prueba que puedas ejecutar tú. Esta guía recorre la instalación y la primera conversación que podrás retomar.

Instala Muse Code y comprueba su versión

Muse Code

En macOS o Linux, usa el instalador enlazado en la guía oficial de Muse Code. Después, comprueba la versión instalada antes de copiar comandos de un tutorial. Los ejemplos de esta guía se contrastaron con los comandos disponibles en Muse 1.3.0.

bash
curl -fsSL https://dev.meta.ai/install.sh | sh
muse --version
muse --help

Usa un terminal normal con tu propia cuenta. Si no encuentra el comando tras instalarlo, abre un terminal nuevo para que reciba el PATH actualizado. Anota la versión cuando comuniques un fallo. Para los comandos nativos de PowerShell y las diferencias entre plataformas, consulta Muse Code en Windows.

Abre un proyecto e inicia sesión

bash
cd /ruta/a/tu/proyecto
muse --model muse-spark-1.3 --reasoning-effort medium

Sustituye la ruta de ejemplo por la de tu proyecto. Elige el acceso con navegador que ofrece Muse o usa tu propia clave de la API de Meta. El comando interactivo /login vuelve a abrir la autenticación. Una clave existente puede tener prioridad sobre las credenciales del navegador; revisa la documentación de autenticación si aparece otra cuenta o forma de facturación.

El modelo explícito permite repetir este ejemplo. Algunas páginas de configuración siguen indicando Spark 1.2 como predeterminado, mientras que el catálogo actual incluye 1.3. Comprueba el modelo mostrado en la sesión y consulta la guía de modelos, precios y privacidad antes de cambiar de modalidad.

Haz una primera petición fácil de comprobar

text
Lee README.md y la configuración de compilación del proyecto.
Explica cómo arranca la aplicación e identifica un comando de tests
que ya exista. Cita los archivos consultados. No edites archivos.

Elige un repositorio que conozcas. Si no tiene README, indica su punto de entrada o un archivo de configuración real. Compara la respuesta con los archivos del disco. El comando de tests debe existir en ese proyecto y corresponder al paquete que quieres cambiar. Una respuesta convincente no basta para darlo por válido.

Para la segunda petición, elige un defecto observable, como un mensaje de validación incorrecto. Describe la entrada que lo provoca y el resultado esperado. Pide a Muse que revise quién usa ese código, haga la corrección mínima y ejecute la comprobación adecuada. Revisa tú mismo git diff antes de aceptar el resultado. Esa tarea también servirá para comparar modelos más adelante.

Añade instrucciones sin sustituir las reglas existentes

bash
muse init --dry-run

Examina primero las instrucciones propuestas. La simulación no crea ningún archivo. Si no existe AGENTS.md y la propuesta es correcta, ejecuta muse init y revisa el archivo generado. Si el repositorio ya contiene un AGENTS.md, lee y modifica ese archivo de forma deliberada. Conserva información útil: la carpeta del paquete, el comando de tests y una restricción concreta del proyecto. La guía de configuración y contexto explica cómo carga Muse estos archivos.

Cuando Muse lo solicite, concede confianza al espacio de trabajo correcto. Esa decisión incluye las instrucciones y los hooks del proyecto. Escribir “no edites” expresa el alcance de tu petición, pero no cambia por sí solo el perfil de permisos. Consulta los permisos de Muse cuando necesites restringir las herramientas a la lectura.

Reanuda la tarea original y comprueba su estado

bash
muse resume --last

Ejecuta el comando desde el proyecto adecuado cuando vuelvas. Antes de pedir más cambios, explica qué ha ocurrido fuera de la conversación: una actualización de dependencias, un commit de otra persona o una edición manual. El historial no garantiza que los archivos actuales coincidan con lo que se habló antes.

Si interrumpes una edición, revisa el diff antes de enviar otra petición. Cancelar una respuesta no implica que todos los archivos sigan intactos. Pide al agente que explique el estado actual y continúa a partir de esa evidencia. La referencia de controles interactivos cubre la gestión y la interrupción de sesiones.

Cuando la primera tarea funcione

Mantén la configuración pequeña hasta tener una edición comprobada. Añade herramientas MCP, skills o workflows cuando una tarea real lo requiera. Para repetir una revisión, conserva la petición exacta y su condición de aceptación; te permitirá comparar resultados entre sesiones.

La integración de Muse se está probando para una próxima versión de CodeAgentSwarm. Sigue los pasos de la CLI independiente de esta guía y consulta las notas de versión antes de esperar soporte de Muse en la app descargada.

Preguntas frecuentes

La CLI se ejecuta localmente y trabaja con archivos locales, pero las peticiones a Muse Spark usan el servicio alojado de Meta. Abrir un terminal local no hace que el modelo funcione sin conexión.

Así queda identificado el modelo del ejemplo aunque cambien los valores predeterminados o la documentación. Comprueba los modelos disponibles en tu cuenta antes de empezar una tarea real.

Un cambio pequeño permite evaluar mejor el resultado. Verifica una edición y su test antes de ampliar el alcance, una vez que entiendas cómo funcionan los permisos, el contexto y la revisión.