Télécharger et installer Muse Code sur macOS, Linux et Windows
Il n'y a pas d'application desktop de Muse Code à télécharger : sur toutes les plateformes, l'installation tient en une commande dans le terminal — y compris un installateur PowerShell natif pour Windows. Comment l'installer sur Mac, sur Linux ou sur Windows (en natif ou via WSL2), le garder à jour, corriger les erreurs d'installation courantes et le désinstaller.
Le « téléchargement » tient en une commande
Ceux qui cherchent un téléchargement de Muse Code s’attendent à un .dmg, un .exe ou une fiche sur un store d’applications. Il n’y en a pas. Muse Code est un programme en ligne de commande, et la façon officielle de l’obtenir, c’est le script d’installation de Meta. Sur macOS et Linux :
curl -fsSL https://dev.meta.ai/install.sh | sh
Sur Windows, dans PowerShell :
irm https://dev.meta.ai/install.ps1 | iex
Dans les deux cas, le script place un binaire muse dans ton PATH ; muse --version confirme que tout a fonctionné. Si tu préfères ne pas piper un script distant directement dans ton shell, télécharge-le d’abord (par exemple avec curl -fsSL https://dev.meta.ai/install.sh -o install.sh), lis-le, puis exécute-le. C’est tout ce qu’il y a à savoir sur le téléchargement, quelle que soit la plateforme prise en charge — ce qui change, c’est l’endroit où tu le lances.
macOS et Linux
Sur un Mac ou une machine Linux, ouvre un terminal et lance la commande curl ci-dessus. Deux choses à savoir avant la première session :
- Si
museest introuvable après l’installation, ouvre une nouvelle fenêtre de terminal pour que ton shell relise son PATH. - Le premier lancement te connecte. Lancer
musedans un répertoire de projet ouvre ton navigateur pour t’authentifier sur dev.meta.ai avec un compte développeur Meta. Les identifiants sont mis en cache : tu n’auras pas à recommencer à chaque session. Sur les serveurs, les runners CI et les autres machines headless, oublie le navigateur : crée une clé dans le dashboard Model API et exporte-la enMETA_API_KEY, ou enregistre-la une fois pour toutes avecmuse auth set.
À partir de là, fais cd dans un dépôt git et lance muse. Notre guide de démarrage propose une bonne première tâche.
Windows : l’installateur PowerShell natif
À la première publication de ce guide, il n’existait pas de version native pour Windows et WSL2 était la seule voie possible. Ce n’est plus le cas : la documentation de Meta liste désormais un installateur Windows natif. Meta n’a pas annoncé la date de son apparition (un guide tiers le documentait déjà le 22 septembre 2026), mais c’est aujourd’hui la voie officielle.
Ouvre PowerShell et lance :
irm https://dev.meta.ai/install.ps1 | iex
Ouvre ensuite une nouvelle fenêtre PowerShell, vérifie muse --version, puis lance muse dans un dépôt git. Muse Code sous Windows n’est toutefois pas identique aux autres plateformes — Meta liste ces différences :
- PowerShell au lieu de Bash. L’agent exécute ses commandes dans PowerShell : les scripts et one-liners qu’il écrit pour ton projet seront en PowerShell, pas en Bash.
- Une invite UAC à la première initialisation du sandbox. La première fois que le sandbox s’initialise, Windows peut te demander une autorisation. C’est normal.
- Pas de saisie vocale. La voix n’est pas disponible sous Windows.
- Pas de messagerie entre sessions. Les sessions ne peuvent pas s’envoyer de messages sous Windows ; cette fonctionnalité est réservée à macOS et Linux.
Alternative sous Windows : quand préférer WSL2
WSL2 fonctionne toujours — c’est du Linux, donc Muse Code s’y comporte exactement comme sur une machine Linux. Préfère-le si l’outillage de ton projet suppose Bash, si les scripts de ton équipe sont écrits pour Linux, ou si tu veux la messagerie entre sessions. Le Sous-système Windows pour Linux te donne un vrai environnement Linux sur Windows 10 ou 11 :
- Ouvre PowerShell en tant qu’administrateur et lance
wsl --install. Cela installe WSL2 avec Ubuntu par défaut. Redémarre quand on te le demande. - Lance Ubuntu depuis le menu Démarrer et crée ton utilisateur Linux.
- Vérifie que l’essentiel est là :
sudo apt update && sudo apt install -y curl git. - Lance l’installateur macOS/Linux dans le terminal Ubuntu — la même ligne
curl … | shque plus haut, pas celle de PowerShell. - Garde tes dépôts dans le système de fichiers Linux, par exemple dans
~/code, plutôt que sous/mnt/c. Muse Code lit et écrit énormément de fichiers, et l’accès à travers la frontière entre Windows et Linux est beaucoup plus lent.
Si la connexion dans le navigateur ne s’affiche pas depuis WSL, utilise plutôt une clé d’API : crée-en une dans le dashboard Model API, puis définis META_API_KEY dans le profil de ton shell Linux ou enregistre-la avec muse auth set.
VS Code, JetBrains et la question de l’« application desktop »
Meta ne propose toujours ni application desktop, ni IDE, ni extension d’éditeur officielle pour Muse Code. Ça ne veut pas dire que tu dois renoncer à ton éditeur :
- VS Code : lance
musedans le terminal intégré. Avec l’installateur natif, ça fonctionne directement sous Windows, dans un terminal PowerShell. Tu n’as besoin de l’extension WSL de Microsoft que si tu as choisi WSL2 : ouvre le dossier de ton projet dans WSL, et le terminal intégré devient un shell Linux où Muse Code fonctionne normalement. - Zed et IDE JetBrains : des projets communautaires font le pont entre Muse Code et les éditeurs qui parlent l’Agent Client Protocol (ACP). Ils ne sont pas officiels — vérifie ce qu’ils envoient et où avant d’en brancher un sur du code privé.
Méfie-toi de tout ce qui se présente comme une « application desktop Muse Code » ou un téléchargement autonome « Muse Code pour Windows ». Rien de tout cela n’est publié par Meta ; les deux scripts d’installation ci-dessus sont la seule distribution officielle. (Microsoft a annoncé le 7 octobre que l’agent grand public Muse de Meta arrive sur Windows sous forme d’application native — mais c’est Muse, pas Muse Code.)
Mettre à jour Muse Code
En temps normal, tu n’as rien à faire : Muse Code se met à jour tout seul. L’installateur met en place un petit lanceur qui garde le vrai binaire à jour et, depuis la CLI 1.4.11, une session ouverte au moment d’une mise à jour automatique reprend avec son historique. Pour savoir où tu en es, lance muse --version et compare avec notre changelog — les notes de version 1.4 couvrent la série actuelle. Si tu veux la toute dernière build tout de suite, relance la même commande d’installation : elle remplace ce qui est déjà installé.
Pas de gestionnaire de paquets à synchroniser non plus. Meta ne publie ni formule Homebrew, ni paquet npm, ni paquet winget pour la CLI — le paquet @muse-code/sdk sur npm est le SDK qui sert à créer tes propres agents, pas Muse Code lui-même.
Corriger les problèmes d’installation courants
muse: command not foundaprès l’installation. Ouvre un nouveau terminal pour que ton shell relise son PATH. Sur macOS et Linux, l’installateur ajoute~/.local/binau profil de ton shell ; si tu utilises un shell peu courant, ajoute toi-même ce répertoire au PATH.- Toutes les commandes shell échouent sous Linux. Le sandbox Linux s’appuie sur un helper bubblewrap fourni avec l’outil. S’il ne fonctionne pas — c’est le cas sur les distributions basées sur musl comme Alpine, qui en sont dépourvues —, Muse Code refuse d’exécuter des commandes shell plutôt que de les lancer hors sandbox. Utilise une distribution ou un conteneur basé sur glibc.
- Une demande d’autorisation Windows au premier lancement. Le sandbox Windows peut demander une validation administrateur (UAC) la première fois qu’il s’initialise. Inutile ensuite de lancer Muse Code en tant qu’administrateur.
- Proxys d’entreprise et réseaux verrouillés. Télécharge d’abord le script avec
-o install.shpour voir quels hôtes il contacte, puis demande à ton équipe réseau de les autoriser.
Désinstaller Muse Code
Meta ne documente aucune commande de désinstallation : la suppression se fait à la main. Sur macOS et Linux, l’installateur place un lanceur muse et des fichiers versionnés muse-bin-* dans ~/.local/bin ; supprime-les, et efface ~/.config/muse/ si tu veux aussi faire disparaître tes réglages. Sous Windows, lance Get-Command muse dans PowerShell pour savoir où se trouve le binaire, puis supprime-le. Deux choses que la désinstallation ne fait pas : elle ne résilie pas ton abonnement — ça se passe dans la rubrique Abonnements de l’Accounts Center de Meta — et elle ne supprime pas les fichiers de projet que Muse Code a écrits dans tes dépôts, comme AGENTS.md, .agents/ et .muse/.
Ensuite, choisis comment payer
L’installation est gratuite ; l’utilisation de Muse Code, non. Tu peux souscrire un forfait mensuel — Everyday Usage à 5 $, High Usage à 15 $, Power Usage à 50 $ ou Maximum Usage à 200 $ — ou te passer de forfait et payer au token via la Meta Model API. La page tarifs compare les deux et inclut un estimateur de coûts.