Come scaricare e installare Muse Code su macOS, Linux e Windows

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. Su macOS e Linux:

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

Su Windows, in PowerShell:

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

Entrambi gli script piazzano 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 (per esempio 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 curl 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 META_API_KEY, oppure salvala una volta per tutte con muse auth set.

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

Windows: l’installer nativo per PowerShell

Quando abbiamo pubblicato questa guida, non esisteva una build nativa per Windows e WSL2 era l’unica strada. Ora non è più così: la documentazione di Meta elenca un installer nativo per Windows. Meta non ha annunciato quando è comparso (una guida di terze parti lo documentava già il 22 settembre 2026), ma oggi è la via ufficiale.

Apri PowerShell ed esegui:

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

Poi apri una nuova finestra di PowerShell, controlla muse --version e lancia muse dentro un repository git. Muse Code su Windows, però, non è identico alle altre piattaforme. Meta elenca queste differenze:

PowerShell al posto di Bash. L’agent esegue i suoi comandi in PowerShell, quindi gli script e i one-liner che scrive per il tuo progetto saranno in PowerShell, non in Bash.
Un prompt UAC alla prima inizializzazione della sandbox. La prima volta che la sandbox si inizializza, Windows può chiederti l’autorizzazione. È normale.
Niente input vocale. La voce non è disponibile su Windows.
Niente messaggi tra sessioni. Su Windows le sessioni non possono scambiarsi messaggi; la funzione c’è solo su macOS e Linux.

L’alternativa su Windows: quando preferire WSL2

WSL2 funziona ancora: è Linux, quindi Muse Code si comporta esattamente come su una macchina Linux. Preferiscilo se gli strumenti del tuo progetto danno per scontato Bash, se gli script del tuo team sono scritti per Linux o se ti servono i messaggi tra sessioni. Il Sottosistema Windows per Linux ti dà un vero ambiente Linux su Windows 10 o 11:

Apri PowerShell come amministratore ed esegui wsl --install. Questo installa WSL2 con Ubuntu come distribuzione predefinita. Riavvia quando richiesto.
Avvia Ubuntu dal menu Start e crea il tuo utente Linux.
Assicurati di avere le basi: sudo apt update && sudo apt install -y curl git.
Esegui l’installer per macOS/Linux nel terminale di Ubuntu: la stessa riga curl … | sh di prima, non quella per PowerShell.
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 META_API_KEY nel profilo della tua shell Linux, oppure salvala con muse auth set.

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

Meta continua a non distribuire 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. Con l’installer nativo funziona direttamente su Windows, in un terminale PowerShell. L’estensione WSL di Microsoft ti serve solo se hai scelto WSL2: 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 a sé di “Muse Code per Windows”. Niente di tutto questo è pubblicato da Meta; i due script di installazione qui sopra sono l’unica distribuzione ufficiale. (Il 7 ottobre Microsoft ha annunciato che l’agent consumer Muse di Meta arriverà su Windows come app nativa: si tratta di Muse, non di Muse Code.)

Aggiornare Muse Code

Di norma non devi fare nulla: Muse Code si aggiorna da solo. L’installer configura un piccolo launcher che tiene aggiornato il binario vero e proprio e, dalla CLI 1.4.11, una sessione rimasta aperta durante un aggiornamento automatico riparte con la sua cronologia. Per sapere a che punto sei, esegui muse --version e confronta il risultato con il nostro changelog; le note di rilascio della 1.4 coprono la serie attuale. Se vuoi subito la build più recente, riesegui lo stesso comando di installazione: sostituisce quella che hai.

Non c’è nemmeno un gestore di pacchetti da tenere allineato. Meta non pubblica nessuna formula Homebrew, nessun pacchetto npm e nessun pacchetto winget per la CLI: il pacchetto @muse-code/sdk su npm è l’SDK per costruire i tuoi agent, non Muse Code.

Risolvere i problemi di installazione più comuni

muse: command not found dopo l’installazione. Apri un nuovo terminale così la shell rilegge il PATH. Su macOS e Linux l’installer aggiunge ~/.local/bin al profilo della shell; se usi una shell poco diffusa, aggiungi tu quella directory al PATH.
Su Linux falliscono tutti i comandi di shell. La sandbox di Linux si appoggia a un helper bubblewrap incluso nel pacchetto. Se non ne trova uno funzionante (succede anche con le build basate su musl come Alpine, che ne sono prive), Muse Code si rifiuta di eseguire comandi di shell piuttosto che lanciarli fuori dalla sandbox. Usa una distribuzione o un container con glibc.
Una richiesta di autorizzazione di Windows al primo avvio. La sandbox di Windows può chiedere l’approvazione da amministratore (UAC) la prima volta che si inizializza. Dopo non serve eseguire Muse Code come amministratore.
Proxy aziendali e reti blindate. Scarica prima lo script con -o install.sh per vedere quali host contatta, poi chiedi al team di rete di sbloccarli.

Disinstallare Muse Code

Meta non documenta un comando di disinstallazione, quindi la rimozione è manuale. Su macOS e Linux l’installer mette in ~/.local/bin un launcher muse e alcuni file versionati muse-bin-*: cancellali e rimuovi anche ~/.config/muse/ se vuoi eliminare le impostazioni. Su Windows esegui Get-Command muse in PowerShell per vedere dove si trova il binario, poi cancellalo. Due cose che la disinstallazione non fa: non disdice l’abbonamento (per quello vai in Abbonamenti nell’Accounts Center di Meta) e non cancella i file di progetto che Muse Code ha scritto nei tuoi repository, come AGENTS.md, .agents/ e .muse/.

Poi scegli come pagare

Installarlo è gratis; usare Muse Code no. Puoi abbonarti a un piano mensile — Everyday Usage a 5 $, High Usage a 15 $, Power Usage a 50 $ o Maximum Usage a 200 $ — 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.