Dernière mise à jour:
Comment utiliser Muse Code : de l’installation à la première tâche
muse dans votre projet, faites confiance à l’espace de travail, connectez-vous et saisissez une tâche. Fonctionne sous macOS, Linux et Windows. La configuration prend environ 10 minutes. Tout ce qui suit résume la documentation officielle de Muse Code publiée par Meta, avec un lien vers la source sous chaque section.- Installez la CLI. macOS/Linux : curl -fsSL https://dev.meta.ai/install.sh | sh. Windows (PowerShell) : irm https://dev.meta.ai/install.ps1 | iex.
- Vérifiez l’installation. Exécutez muse --version.
- Ouvrez une session dans votre projet. Lancez muse dans le répertoire de votre projet et acceptez l’invite de confiance de l’espace de travail.
- Connectez-vous. Choisissez la connexion via le navigateur, ou collez une clé API Meta. Pour les scripts et la CI, définissez la variable d’environnement META_API_KEY.
- Confiez-lui une première tâche. Saisissez une tâche dans la zone de saisie. Entrée ajoute des consignes au tour en cours, Alt+Entrée les met en file pour le tour suivant, Échap annule.
Comment installer Muse Code (Mac, Linux, Windows)
macOS et Linux
curl -fsSL https://dev.meta.ai/install.sh | shWindows (PowerShell)
irm https://dev.meta.ai/install.ps1 | iexMuse Code fonctionne nativement sous Windows ; vous n’avez pas besoin de WSL. Vérifiez ensuite l’installation :
muse --versionN’installez Muse Code que depuis dev.meta.ai. Les sites tiers de « téléchargement de Muse Code » ne sont pas officiels. Voir comment télécharger Muse Code en toute sécurité et le guide d’installation sous Windows.
Source: Documentation officielle
Connexion : navigateur ou clé API
La première fois que vous lancez muse dans un projet, il vous demande de vous connecter. Deux possibilités :
- Connexion via le navigateur : un navigateur s’ouvre, vous approuvez la session et revenez au terminal.
- Clé API : collez plutôt une clé API Meta. Pour les scripts et la CI, exportez-la :
export META_API_KEY="<your-key>"Vous pouvez aussi enregistrer une clé avec muse auth set. La variable d’environnement l’emporte sur une clé enregistrée, qui l’emporte elle-même sur une session navigateur. Les utilisateurs d’un Meta Managed Account (MMA) doivent utiliser une clé API. Déconnectez-vous avec muse logout.
Quel compte ? Muse Code se connecte avec un compte Meta. Un abonnement Muse Code nécessite un compte Meta et un compte Meta Model API associé, et le forfait ne couvre que Muse Code. Un compte muse.ai est le même type de compte Meta, mais un forfait grand public Meta Muse n’inclut pas Muse Code ; vous vous y abonnez séparément.
Hors des États-Unis ? La facturation de Muse Code passe par la Meta Model API, qui selon Meta est « disponible dans la plupart des pays et territoires où Meta AI est disponible et où la facturation est prise en charge » (pays pris en charge). La politique d’utilisation géographique de Meta liste les territoires où elle n’est pas proposée, dont la Chine (avec Hong Kong et Macao) et la Russie. Pour les lecteurs chinois, voir notre solution de contournement testée, 中国如何注册 Muse (avec ses risques).
Source: Documentation officielle
L’invite de confiance et les permissions
Au premier lancement dans un dossier, Muse Code vous demande de faire confiance à l’espace de travail. Les instructions de projet (comme AGENTS.md) ne se chargent que dans les espaces de travail approuvés. Ensuite, deux niveaux de sécurité sont activés par défaut :
- Approbations : les actions sûres s’exécutent automatiquement ; les actions risquées (par exemple un
rm -rfdestructeur) attendent votre accord. Vous pouvez autoriser une fois, toujours autoriser dans cet espace de travail, ou refuser. - Sandbox : les commandes shell s’exécutent dans un sandbox du système d’exploitation (Seatbelt sous macOS, bubblewrap sous Linux, le sandbox Windows sous Windows), limité à votre espace de travail et aux dossiers temporaires.
.git,.museet.agentsrestent en lecture seule.
| Profil de permissions | Effet |
|---|---|
| Ask me | Vous examinez chaque approbation concernée |
| Auto-review (par défaut) | Un relecteur automatique traite les décisions courantes et vous transmet le reste |
| Read-only | Lecture de fichiers uniquement ; aucune écriture ni effet de bord |
| Unrestricted | Ni approbations ni sandbox (équivaut à --yolo) |
L’accès réseau est par défaut en proxy-only (vous approuvez chaque destination) ; utilisez --sandbox-network restricted pour le couper entièrement. N’utilisez --yolo que dans un environnement isolé.
Source: Documentation officielle
Lancer votre première tâche
Saisissez une tâche et appuyez sur Entrée. Inutile d’attendre que l’agent ait fini : appuyez sur Entrée pour ajouter des consignes au tour en cours, sur Alt+Entrée pour les mettre en file pour le tour suivant, et sur Échap pour annuler le tour. Vous pouvez coller des images dans la zone de saisie et y faire référence avec [Image #N] ; Alt+V active ou désactive la dictée vocale (pas sous Windows).
Source: Documentation officielle
Commandes de Muse Code : aide-mémoire
| Commande | Effet |
|---|---|
/login | Rouvre les options de connexion |
/new, /clear | Démarre une nouvelle session |
/resume | Reprend une session précédente |
/fork, /name | Crée une branche de la session ou la renomme |
/rewind (ou Esc Esc) | Revient à un message précédent et crée une branche à partir de là |
/compact | Résume le contexte précédent pour libérer des tokens |
/recap | Affiche un résumé de l’activité récente |
/goal | Définit un objectif que l’agent conserve d’un tour à l’autre |
/loop | Répète un prompt à intervalle régulier (ex. 10m) ou selon un planning cron |
/tasks, /subagents | Suit le travail en arrière-plan et les agents auxiliaires |
/workflows | Surveille les exécutions de workflows multi-agents |
/side | Ouvre une conversation parallèle sans toucher au fil principal |
/models, /effort | Change de modèle ou d’effort de raisonnement en cours de session |
/export transcript | Enregistre une transcription lisible (/export trajectory pour les journaux JSON complets) |
/copy | Copie la dernière réponse |
/settings | Ouvre les paramètres (ex. Tools > Workflows) |
Source: Documentation officielle
Règles du projet : AGENTS.md (et CLAUDE.md)
Créez un fichier d’instructions de projet avec :
muse init # creates AGENTS.md
muse init --dry-run # preview firstMuse Code recherche AGENTS.md, CLAUDE.md, .agents/AGENTS.md et .claude/CLAUDE.md, de la racine de l’espace de travail jusqu’au .git le plus proche. Si vous utilisez déjà Claude Code, votre CLAUDE.md existant fonctionne donc tel quel. Les paramètres utilisateur se trouvent dans ~/.config/muse/settings.json.
Source: Documentation officielle
Choisir le modèle et l’effort de raisonnement
Changez de modèle en cours de session avec /models, ou au lancement avec --model. L’effort de raisonnement va de none à ultra (par défaut high) ; modifiez-le avec /effort ou --reasoning-effort. Un effort plus élevé consomme plus de tokens en sortie, ce qui compte si vous payez au token (voir les prix de Muse Code).
Source: Documentation officielle
Multi-agent : sous-agents et workflows
Un agent principal peut confier des tâches délimitées à des sous-agents, chacun pouvant tourner dans son propre git worktree pour que les modifications en parallèle n’entrent pas en conflit. Une arborescence d’agents exécute jusqu’à 8 agents simultanément par défaut, configurable jusqu’à 64. Pour les chantiers plus importants (audits en parallèle, comparaison d’approches, migrations par étapes), Muse Code peut exécuter un workflow : il orchestre des agents enfants et renvoie un résultat unique combiné. Gardez les petites modifications étroitement liées sur l’agent principal.
Source: Documentation officielle
Annuler un mauvais tour : le retour en arrière
Lancez /rewind ou appuyez deux fois sur Échap avec une zone de saisie vide, choisissez un message précédent, et Muse Code ouvre une nouvelle branche à partir de là. La session d’origine est conservée. Le retour en arrière ne modifie que l’historique de la conversation : il ne rétablit pas les fichiers de votre espace de travail ; utilisez git pour cela.
Source: Documentation officielle
Exécuter Muse Code dans des scripts et en CI
muse exec "run the tests and fix any failures" --jsonLe mode headless n’a pas d’interface. Le code de sortie est 0 en cas de succès, 1 en cas d’échec et 2 en cas d’erreur d’utilisation. Plafonnez les exécutions avec --max-model-steps et authentifiez-vous avec META_API_KEY.
Source: Documentation officielle
Muse Code sous Windows : ce qui change
- Les commandes s’exécutent dans PowerShell au lieu de Bash.
- Le sandbox peut demander une autorisation administrateur la première fois.
- La saisie vocale et la messagerie de session ne sont pas disponibles sous Windows.
Source: Documentation officielle
Utiliser Muse Code dans VS Code
La documentation officielle ne mentionne pas d’extension VS Code. Ouvrez le terminal intégré de VS Code et lancez-y muse. Considérez toute extension « Muse Code pour VS Code » comme non officielle.
Les limites à connaître avant de commencer
- Les forfaits plafonnent l’usage par fenêtres de 5 heures (Everyday Usage : 10 à 50 prompts toutes les 5 heures). Une fois la limite atteinte, vous passez à un forfait supérieur ou attendez qu’elle se renouvelle.
- Le palier au token Contributor, le moins cher, autorise Meta à entraîner ses modèles sur vos prompts et réponses, et a une limite de débit plus basse.
- Les hooks et les serveurs MCP s’exécutent en dehors du sandbox et des approbations.
Les coûts et les forfaits sont détaillés sur la page des prix de Muse Code. Lisez ensuite notre test de Muse Code ou comparez Muse Code vs Claude Code.
FAQ
Comment utiliser Muse ?
S’il s’agit de Muse Code : installez la CLI, lancez muse dans le dossier de votre projet, faites confiance à l’espace de travail, connectez-vous et saisissez une tâche. S’il s’agit de Meta Muse, l’assistant conversationnel grand public, c’est un autre produit.
Muse Code fonctionne-t-il sous Windows ?
Oui, nativement. Installez-le depuis PowerShell avec « irm https://dev.meta.ai/install.ps1 | iex ». Les commandes s’exécutent dans PowerShell au lieu de Bash, et la saisie vocale ainsi que la messagerie de session ne sont pas disponibles sous Windows.
Comment installer Muse Code sur Mac ou Linux ?
Exécutez « curl -fsSL https://dev.meta.ai/install.sh | sh » dans votre terminal, puis vérifiez avec « muse --version ».
Ai-je besoin d’une clé API ?
Non. Vous pouvez vous connecter via le navigateur. Une clé API (META_API_KEY ou muse auth set) n’est nécessaire que pour un usage non interactif, ou si vous avez un Meta Managed Account, qui ne peut pas utiliser la connexion via le navigateur.
Peut-on utiliser Muse Code dans VS Code ?
La documentation officielle ne mentionne pas d’extension VS Code. Lancez muse dans le terminal intégré de VS Code.
Que signifie l’invite de confiance de l’espace de travail ?
Elle vous demande si Muse Code peut travailler dans ce dossier. Les instructions de projet comme AGENTS.md ne sont chargées que dans les espaces de travail approuvés. Ne faites confiance qu’aux dossiers dont vous connaissez le contenu.
Muse Code lit-il mon CLAUDE.md ?
Oui. Il recherche AGENTS.md, CLAUDE.md, .agents/AGENTS.md et .claude/CLAUDE.md, de la racine de l’espace de travail jusqu’au dossier .git le plus proche. Lancez muse init pour créer un AGENTS.md.
Comment arrêter un agent en cours de tâche ?
Appuyez sur Échap pour annuler le tour en cours. Les processus en arrière-plan continuent de tourner ; gérez-les avec /tasks.
Peut-on exécuter Muse Code en CI ?
Oui. Utilisez le mode headless : muse exec "<prompt>", avec --json pour une sortie JSONL. Le code de sortie est 0 en cas de succès, 1 en cas d’échec et 2 en cas d’erreur d’utilisation.