Última actualización:
Cómo usar Muse Code: de la instalación a tu primera tarea
muse en tu proyecto, marca el espacio de trabajo como confiable, inicia sesión y escribe una tarea. Funciona en macOS, Linux y Windows, y la configuración toma unos 10 minutos. Todo lo que sigue es un resumen de la documentación oficial de Muse Code, con el enlace a la fuente debajo de cada sección.- Instala la CLI. macOS/Linux: curl -fsSL https://dev.meta.ai/install.sh | sh. Windows (PowerShell): irm https://dev.meta.ai/install.ps1 | iex.
- Verifica la instalación. Ejecuta muse --version.
- Abre una sesión en tu proyecto. Ejecuta muse dentro de la carpeta de tu proyecto y acepta el aviso de confianza del espacio de trabajo.
- Inicia sesión. Elige iniciar sesión en el navegador o pega una API key de Meta. Para scripts y CI, define la variable de entorno META_API_KEY.
- Dale tu primera tarea. Escribe una tarea en el compositor. Enter agrega instrucciones al turno en curso, Alt+Enter las deja en cola para el siguiente turno y Esc cancela.
Cómo instalar Muse Code (Mac, Linux, Windows)
macOS y Linux
curl -fsSL https://dev.meta.ai/install.sh | shWindows (PowerShell)
irm https://dev.meta.ai/install.ps1 | iexMuse Code corre de forma nativa en Windows; no necesitas WSL. Después verifica la instalación:
muse --versionInstálalo solo desde dev.meta.ai. Los sitios de terceros que ofrecen "descargar Muse Code" no son oficiales.
Fuente: Documentación oficial
Inicio de sesión: navegador o API key
La primera vez que ejecutas muse en un proyecto, te pide iniciar sesión. Hay dos formas:
- En el navegador: se abre tu navegador, apruebas la sesión y vuelves a la terminal.
- Con API key: pegas una API key de Meta. Para scripts y CI, expórtala:
export META_API_KEY="<tu-key>"También puedes guardar la key con muse auth set. La variable de entorno tiene prioridad sobre la key guardada, y esta sobre la sesión del navegador. Los usuarios de Meta Managed Account (MMA) tienen que usar una API key. Para cerrar sesión, usa muse logout.
Cuenta y suscripción: Muse Code inicia sesión con una cuenta de Meta. Para suscribirte necesitas esa cuenta de Meta más una cuenta asociada de Meta Model API, y el plan es solo para Muse Code. Tu cuenta de muse.ai es el mismo tipo de cuenta de Meta, pero un plan de Meta Muse no incluye Muse Code.
Disponibilidad por país: la facturación corre sobre Meta Model API, que según Meta está disponible en la mayoría de los países y territorios donde Meta AI está disponible y se admite la facturación (países admitidos). La Política de Uso Geográfico de Meta deja fuera, entre otros, a Cuba, Nicaragua y Venezuela. Meta también indica que los beneficios y la disponibilidad de la suscripción pueden variar según la región.
Fuente: Documentación oficial
El aviso de confianza y los permisos
La primera vez que lo abres en una carpeta, Muse Code te pide confiar en el espacio de trabajo. Las instrucciones del proyecto (como AGENTS.md) solo se cargan en espacios confiables. A partir de ahí, hay dos capas de seguridad activas por defecto:
- Aprobaciones: las acciones seguras corren solas; las riesgosas (por ejemplo, un
rm -rfdestructivo) esperan tu visto bueno. Puedes permitir una vez, permitir siempre en este espacio de trabajo o rechazar. - Sandbox: los comandos de shell corren dentro de un sandbox del sistema operativo (Seatbelt en macOS, bubblewrap en Linux, el sandbox de Windows en Windows), limitado a tu espacio de trabajo y carpetas temporales.
.git,.musey.agentsquedan en solo lectura.
| Perfil de permisos | Qué hace |
|---|---|
| Ask me | Tú revisas cada aprobación |
| Auto-review (por defecto) | Un revisor automático resuelve lo rutinario y te escala lo demás |
| Read-only | Solo lee archivos; no escribe ni tiene efectos secundarios |
| Unrestricted | Sin aprobaciones y sin sandbox (igual que --yolo) |
El acceso a la red por defecto es proxy-only (apruebas cada destino); usa --sandbox-network restricted para bloquearlo por completo. Usa --yolo solo en un entorno aislado.
Fuente: Documentación oficial
Tu primera tarea
Escribe una tarea y presiona Enter. No tienes que esperar a que el agente termine: presiona Enter para agregar instrucciones al turno en curso, Alt+Enter para dejarlas en cola para el siguiente turno y Esc para cancelar el turno. Puedes pegar imágenes en el compositor y referirte a ellas como [Image #N]; Alt+V activa o desactiva el dictado por voz (no en Windows).
Fuente: Documentación oficial
Comandos de Muse Code: guía rápida
| Comando | Qué hace |
|---|---|
/login | Vuelve a abrir las opciones de inicio de sesión |
/new, /clear | Empieza una sesión nueva |
/resume | Retoma una sesión anterior |
/fork, /name | Crea una rama de la sesión o cámbiale el nombre |
/rewind (o Esc Esc) | Regresa a un mensaje anterior y abre una rama desde ahí |
/compact | Resume el contexto anterior para liberar tokens |
/recap | Muestra un resumen de la actividad reciente |
/goal | Fija un objetivo que el agente mantiene entre turnos |
/loop | Repite un prompt cada cierto tiempo (p. ej. 10m) o con un horario cron |
/tasks, /subagents | Sigue el trabajo en segundo plano y los agentes auxiliares |
/workflows | Monitorea las ejecuciones de workflows multiagente |
/side | Abre una conversación paralela sin tocar el hilo principal |
/models, /effort | Cambia de modelo o de esfuerzo de razonamiento a mitad de sesión |
/export transcript | Guarda una transcripción legible (/export trajectory para los logs JSON completos) |
/copy | Copia la última respuesta |
/settings | Abre la configuración (p. ej. Tools > Workflows) |
Fuente: Documentación oficial
Reglas del proyecto: AGENTS.md (y CLAUDE.md)
Crea un archivo de instrucciones para tu proyecto con:
muse init # crea AGENTS.md
muse init --dry-run # vista previa primeroMuse Code busca AGENTS.md, CLAUDE.md, .agents/AGENTS.md y .claude/CLAUDE.md, desde la raíz del espacio de trabajo hasta el .git más cercano. Así que si ya usas Claude Code, tu CLAUDE.md actual funciona tal cual. La configuración de usuario vive en ~/.config/muse/settings.json.
Fuente: Documentación oficial
Elige el modelo y el esfuerzo de razonamiento
Cambia de modelo a mitad de sesión con /models, o al arrancar con --model. El esfuerzo de razonamiento va de none a ultra (por defecto high); lo cambias con /effort o --reasoning-effort. Más esfuerzo significa más tokens de salida, lo cual importa si pagas por tokens (mira el precio de Muse Code).
Fuente: Documentación oficial
Multiagente: subagentes y workflows
Un agente principal puede pasarle tareas acotadas a subagentes, opcionalmente cada uno en su propio git worktree para que los cambios en paralelo no choquen. Un árbol de agentes corre hasta 8 agentes a la vez por defecto, configurable hasta 64. Para trabajos más grandes (auditorías en paralelo, comparar enfoques, migraciones por etapas) Muse Code puede ejecutar un workflow: orquesta agentes hijos y te devuelve un solo resultado combinado. Deja los cambios pequeños y muy acoplados en el agente principal.
Fuente: Documentación oficial
Deshacer un mal paso: rebobinar
Ejecuta /rewind o presiona Esc dos veces con el compositor vacío, elige un mensaje anterior y Muse Code abre una rama nueva desde ahí. La sesión original se conserva. Rebobinar solo cambia el historial de la conversación: no revierte los archivos de tu espacio de trabajo, para eso usa git.
Fuente: Documentación oficial
Muse Code en scripts y CI
muse exec "run the tests and fix any failures" --jsonEl modo headless no tiene interfaz. Sale con 0 si todo va bien, 1 si falla y 2 si hay errores de uso. Limita las ejecuciones con --max-model-steps y autentícate con META_API_KEY.
Fuente: Documentación oficial
Muse Code en Windows: qué cambia
- Los comandos se ejecutan en PowerShell en lugar de Bash.
- El sandbox puede pedir permisos de administrador la primera vez.
- La entrada por voz y la mensajería de sesiones no están disponibles en Windows.
Fuente: Documentación oficial
Usar Muse Code en VS Code
La documentación oficial no incluye una extensión para VS Code. Abre la terminal integrada de VS Code y ejecuta muse ahí. Cualquier extensión "Muse Code para VS Code" que encuentres es no oficial.
Límites que conviene conocer antes de empezar
- Los planes limitan el uso en ventanas de 5 horas (Everyday Usage: de 10 a 50 prompts cada 5 horas). Cuando llegas al límite, subes de plan o esperas a que se renueve.
- El nivel por tokens Contributor, el más barato, le permite a Meta entrenar con tus prompts y respuestas, y tiene un límite de solicitudes más bajo.
- Los hooks y servidores MCP corren fuera del sandbox y de las aprobaciones.
Los costos y planes están en la página de precios de Muse Code. Después, lee nuestra reseña de Muse Code o compara Muse Code vs Claude Code.
Preguntas frecuentes
¿Cómo se usa Muse?
Si te refieres a Muse Code: instala la CLI, ejecuta muse dentro de la carpeta de tu proyecto, marca el espacio de trabajo como confiable, inicia sesión y escribe una tarea. Si te refieres a Meta Muse, el asistente de chat para consumidores, es otro producto.
¿Cómo instalo Muse Code en Windows?
Corre de forma nativa. Instálalo desde PowerShell con "irm https://dev.meta.ai/install.ps1 | iex". Los comandos se ejecutan en PowerShell en lugar de Bash, y en Windows no están disponibles la entrada por voz ni la mensajería de sesiones.
¿Cómo instalo Muse Code en Mac o Linux?
Ejecuta "curl -fsSL https://dev.meta.ai/install.sh | sh" en tu terminal y luego verifica con "muse --version".
¿Muse Code está disponible en mi país?
La facturación de Muse Code corre sobre Meta Model API, que según Meta está disponible en la mayoría de los países y territorios donde Meta AI está disponible y se admite la facturación. La Política de Uso Geográfico de Meta (https://dev.meta.ai/legal/geographic-use-policy) deja fuera, entre otros, a Cuba, Nicaragua y Venezuela. Meta también aclara que los beneficios y la disponibilidad de la suscripción pueden variar según la región. Ojo: Meta Muse, el asistente de muse.ai, por ahora solo está en Estados Unidos, pero es otro producto.
¿Me sirve mi cuenta de muse.ai para Muse Code?
Es el mismo tipo de cuenta de Meta, pero Muse Code se contrata aparte. Una suscripción de Muse Code necesita una cuenta de Meta más una cuenta asociada de Meta Model API, y el plan es solo para Muse Code. Un plan de Meta Muse no incluye Muse Code.
¿Necesito una API key?
No. Puedes iniciar sesión desde el navegador. La API key (META_API_KEY o muse auth set) solo hace falta para uso no interactivo o si tienes una Meta Managed Account, que no puede iniciar sesión por navegador.
¿Puedo usar Muse Code en VS Code?
La documentación oficial no incluye una extensión para VS Code. Ejecuta muse en la terminal integrada de VS Code.
¿Qué significa el aviso de "confiar en el espacio de trabajo"?
Te pregunta si Muse Code puede trabajar en esa carpeta. Las instrucciones del proyecto, como AGENTS.md, solo se cargan en espacios de trabajo confiables. Confía solo en carpetas cuyo contenido conoces.
¿Muse Code lee mi CLAUDE.md?
Sí. Busca AGENTS.md, CLAUDE.md, .agents/AGENTS.md y .claude/CLAUDE.md, desde la raíz del espacio de trabajo hasta la carpeta .git más cercana. Ejecuta muse init para crear un AGENTS.md.
¿Cómo detengo al agente a mitad de una tarea?
Presiona Esc para cancelar el turno actual. Los procesos en segundo plano siguen corriendo; adminístralos con /tasks.
¿Puedo usar Muse Code en CI?
Sí, con el modo headless: muse exec "<prompt>", con --json para salida JSONL. Sale con 0 si todo va bien, 1 si falla y 2 si hay errores de uso.