GUIDA· 4 min di lettura

Come installare Muse Code su macOS, Linux e Windows (WSL2)

Non esiste un'app desktop di Muse Code né un installer per Windows: solo un'installazione da terminale in una riga. Ecco come farlo girare su Mac, su Linux e su Windows tramite WSL2, più cosa fare con VS Code.

#install#windows#wsl#getting-started

Il “download” è un comando

Chi cerca un download di Muse Code si aspetta un .dmg, un .exe o una pagina su un app store. Non c’è. Muse Code è un programma a riga di comando, e il modo ufficiale per ottenerlo è lo script di installazione di Meta:

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

Lo script piazza un binario muse nel tuo PATH; muse --version conferma che ha funzionato. Se preferisci non fare pipe di uno script remoto direttamente nella tua shell, scaricalo prima con curl -fsSL https://dev.meta.ai/install.sh -o install.sh, leggilo e poi eseguilo. Il download, su ogni piattaforma supportata, è tutto qui: cambia solo dove lo esegui.

macOS e Linux

Su un Mac o su una macchina Linux, apri un terminale ed esegui il comando qui sopra. Prima della prima sessione vale la pena sapere due cose:

  • Se muse non viene trovato dopo l’installazione, apri una nuova finestra di terminale così la shell rilegge il PATH.
  • Il primo avvio ti fa fare il login. Lanciare muse in una directory di progetto apre il browser per autenticarti su dev.meta.ai con un account developer Meta. Le credenziali restano in cache, quindi non dovrai rifarlo a ogni sessione. Su server, runner CI e altre macchine headless, salta il browser: crea una chiave nella dashboard della Model API ed esportala come MODEL_API_KEY.

Da lì, fai cd in un repository git e lancia muse. La nostra guida introduttiva suggerisce un buon primo task.

Windows: installalo dentro WSL2

Non esiste una build nativa per Windows. L’installer di Meta punta a macOS e Linux, e gli sviluppatori che lo provano da PowerShell riferiscono che si rifiuta semplicemente di partire. La strada che funziona è il Sottosistema Windows per Linux, che ti dà un vero ambiente Linux su Windows 10 o 11:

  1. Apri PowerShell come amministratore ed esegui wsl --install. Questo installa WSL2 con Ubuntu come distribuzione predefinita. Riavvia quando richiesto.
  2. Avvia Ubuntu dal menu Start e crea il tuo utente Linux.
  3. Assicurati di avere le basi: sudo apt update && sudo apt install -y curl git.
  4. Esegui l’installer di Muse Code nel terminale di Ubuntu: la stessa riga curl … | bash di prima.
  5. Tieni i tuoi repository nel filesystem Linux, per esempio in ~/code, invece che sotto /mnt/c. Muse Code legge e scrive un sacco di file, e l’accesso attraverso il confine tra Windows e Linux è molto più lento.

Se il login dal browser non compare da dentro WSL, usa una chiave API: creane una nella dashboard della Model API e imposta MODEL_API_KEY nel profilo della tua shell Linux.

VS Code, JetBrains e la questione dell’“app desktop”

Meta non distribuisce nessuna app desktop, nessun IDE e nessuna estensione ufficiale per editor per Muse Code. Questo non significa che tu debba rinunciare al tuo editor:

  • VS Code: esegui muse nel terminale integrato. Su Windows, installa l’estensione WSL di Microsoft, apri la cartella del progetto in WSL e il terminale integrato diventa una shell Linux in cui Muse Code funziona normalmente.
  • Zed e IDE JetBrains: alcuni progetti della community collegano Muse Code agli editor che parlano l’Agent Client Protocol (ACP). Non sono ufficiali: controlla cosa inviano e dove prima di puntarne uno su codice privato.

Diffida di qualsiasi cosa pubblicizzata come “app desktop di Muse Code” o come download di “Muse Code per Windows”. Niente di tutto questo è pubblicato da Meta; lo script di installazione qui sopra è l’unica distribuzione ufficiale.

Tenerlo aggiornato

La documentazione di Meta mostra l’installer e nient’altro, quindi controlla muse --help per i comandi supportati dalla tua versione e segui il nostro changelog per le nuove release. Muse Code è uscito dalla beta il 31 agosto 2026 ed è passato al modello Muse Spark 1.3 due giorni dopo: un’installazione aggiornata ti dà entrambe le cose.

Poi scegli come pagare

Installarlo è gratis; usare Muse Code no. Puoi abbonarti a un piano mensile — Everyday Usage a 5 $, High Usage a 15 $ o Power Usage a 50 $ — oppure fare a meno del piano e pagare a token tramite la Meta Model API. La pagina dei prezzi mette a confronto le due strade e include uno stimatore dei costi.

Continua a leggere