Atualizado em:
Como usar Muse Code: da instalação à primeira tarefa
muse no seu projeto, confie no workspace, faça login e digite uma tarefa. Funciona no macOS, Linux e Windows, e a configuração leva uns 10 minutos. Tudo abaixo é um resumo da documentação oficial do Muse Code, com o link da fonte em cada seção.- Instale a CLI. macOS/Linux: curl -fsSL https://dev.meta.ai/install.sh | sh. Windows (PowerShell): irm https://dev.meta.ai/install.ps1 | iex.
- Confira a instalação. Rode muse --version.
- Abra uma sessão no seu projeto. Rode muse dentro da pasta do projeto e aprove o aviso de confiança do workspace.
- Faça login. Escolha o login pelo navegador ou cole uma chave de API da Meta. Para scripts e CI, defina a variável de ambiente META_API_KEY.
- Passe a primeira tarefa. Digite a tarefa no campo de texto. Enter ajusta o turno em andamento, Alt+Enter deixa na fila para o próximo turno e Esc cancela.
Como instalar o Muse Code (Mac, Linux, Windows)
macOS e Linux
curl -fsSL https://dev.meta.ai/install.sh | shWindows (PowerShell)
irm https://dev.meta.ai/install.ps1 | iexO Muse Code roda nativamente no Windows; você não precisa de WSL. Depois, confira a instalação:
muse --versionInstale só a partir do dev.meta.ai. Sites de terceiros com "download do Muse Code" não são oficiais.
Fonte: Documentação oficial
Login: pelo navegador ou com chave de API
Na primeira vez que você roda muse num projeto, ele pede login. Há dois caminhos:
- Login pelo navegador: o navegador abre, você aprova a sessão e volta para o terminal.
- Chave de API: cole uma chave de API da Meta. Para scripts e CI, exporte assim:
export META_API_KEY="<sua-chave>"Você também pode guardar a chave com muse auth set. A variável de ambiente tem prioridade sobre a chave guardada, que tem prioridade sobre a sessão do navegador. Quem usa Meta Managed Account (MMA) precisa usar chave de API. Para sair, use muse logout.
Que conta usar: o Muse Code usa uma conta Meta. Para assinar um plano, você precisa de uma conta Meta com uma conta da Meta Model API associada, e o plano vale só para o Muse Code. A conta do muse.ai é o mesmo tipo de conta Meta, mas um plano do Meta Muse (o assistente para consumidor) não inclui o Muse Code.
Do Brasil: a Meta Model API, sobre a qual roda a cobrança do Muse Code, está disponível na maioria dos países e territórios onde a Meta AI está disponível e há suporte para cobrança, e o Brasil não está na lista de territórios excluídos da Política de Uso Geográfico da Meta. O cadastro pessoal no Meta Muse (o assistente para consumidor) ainda é só para os EUA, mas isso é outro produto, separado do Muse Code.
Fonte: Documentação oficial
Aviso de confiança do workspace e permissões
Na primeira vez numa pasta, o Muse Code pede que você confie no workspace. Instruções de projeto (como o AGENTS.md) só carregam em workspaces confiáveis. Depois disso, duas camadas de segurança ficam ligadas por padrão:
- Aprovações: ações seguras rodam sozinhas; as arriscadas (por exemplo um
rm -rfdestrutivo) esperam por você. Você pode permitir uma vez, permitir sempre neste workspace ou recusar. - Sandbox: os comandos de shell rodam num sandbox do sistema operacional (Seatbelt no macOS, bubblewrap no Linux, sandbox do Windows no Windows), limitado ao workspace e às pastas temporárias.
.git,.musee.agentsficam somente leitura.
| Perfil de permissão | O que faz |
|---|---|
| Ask me | Você revisa toda aprovação que se aplica |
| Auto-review (padrão) | Um revisor automático cuida das decisões de rotina e escala para você |
| Read-only | Só lê arquivos; nada de escrita nem efeitos colaterais |
| Unrestricted | Sem aprovações e sem sandbox (o mesmo que --yolo) |
O acesso à rede é proxy-only por padrão (você aprova cada destino); use --sandbox-network restricted para nenhum acesso. Use --yolo só num ambiente isolado.
Fonte: Documentação oficial
Rode a sua primeira tarefa
Digite a tarefa e aperte Enter. Você não precisa esperar o agente terminar: Enter acrescenta instruções ao turno em andamento, Alt+Enter deixa na fila para o próximo turno e Esc cancela o turno. Dá para colar imagens no campo de texto e citá-las como [Image #N]; Alt+V liga e desliga o ditado por voz (não disponível no Windows).
Fonte: Documentação oficial
Comandos do Muse Code: cola rápida
| Comando | O que faz |
|---|---|
/login | Reabre as opções de login |
/new, /clear | Começa uma sessão do zero |
/resume | Retoma uma sessão anterior |
/fork, /name | Cria um ramo da sessão ou renomeia |
/rewind (ou Esc Esc) | Volta a uma mensagem anterior e abre um ramo a partir dela |
/compact | Resume o contexto antigo para liberar tokens |
/recap | Mostra um resumo da atividade recente |
/goal | Define um objetivo que o agente mantém entre turnos |
/loop | Repete um prompt num intervalo (ex.: 10m) ou numa agenda cron |
/tasks, /subagents | Acompanha o trabalho em segundo plano e os agentes auxiliares |
/workflows | Monitora as execuções de workflows multiagente |
/side | Abre uma conversa paralela sem mexer na principal |
/models, /effort | Troca o modelo ou o esforço de raciocínio no meio da sessão |
/export transcript | Salva uma transcrição legível (/export trajectory gera os logs completos em JSON) |
/copy | Copia a última resposta |
/settings | Abre as configurações (ex.: Tools > Workflows) |
Fonte: Documentação oficial
Regras do projeto: AGENTS.md (e CLAUDE.md)
Crie um arquivo de instruções do projeto com:
muse init # cria o AGENTS.md
muse init --dry-run # mostra antes o que vai criarO Muse Code procura AGENTS.md, CLAUDE.md, .agents/AGENTS.md e .claude/CLAUDE.md, da raiz do workspace até o .git mais próximo. Ou seja, se você já usa o Claude Code, o seu CLAUDE.md continua valendo. As configurações do usuário ficam em ~/.config/muse/settings.json.
Fonte: Documentação oficial
Escolha o modelo e o esforço de raciocínio
Troque de modelo no meio da sessão com /models, ou ao iniciar com --model. O esforço de raciocínio vai de none a ultra (padrão high); mude com /effort ou --reasoning-effort. Mais esforço gasta mais tokens de saída, o que pesa se você paga por token (veja o preço do Muse Code).
Fonte: Documentação oficial
Multiagente: subagentes e workflows
Um agente principal pode passar tarefas delimitadas para subagentes, cada um, se você quiser, na sua própria git worktree, para que edições em paralelo não se atropelem. Uma árvore de agentes roda até 8 agentes ao mesmo tempo por padrão, configurável até 64. Para trabalhos maiores (auditorias em paralelo, comparar abordagens, migrações em etapas) o Muse Code pode rodar um workflow: ele orquestra agentes filhos e devolve um resultado único. Deixe edições pequenas e muito acopladas com o agente principal.
Fonte: Documentação oficial
Desfazer um caminho errado: rewind
Rode /rewind ou aperte Esc duas vezes com o campo de texto vazio, escolha uma mensagem anterior e o Muse Code abre um novo ramo a partir dali. A sessão original é mantida. O rewind muda só o histórico da conversa: ele não desfaz alterações nos arquivos do workspace, então use o git para isso.
Fonte: Documentação oficial
Rodar o Muse Code em scripts e CI
muse exec "rode os testes e corrija as falhas" --jsonO modo headless não tem interface. Ele sai com 0 em caso de sucesso, 1 em caso de falha e 2 em erro de uso. Limite a execução com --max-model-steps e autentique com META_API_KEY.
Fonte: Documentação oficial
Muse Code no Windows: o que muda
- Os comandos rodam no PowerShell em vez do Bash.
- O sandbox pode pedir aprovação de administrador na primeira vez.
- Entrada por voz e troca de mensagens entre sessões não estão disponíveis no Windows.
Fonte: Documentação oficial
Usando o Muse Code no VS Code
A documentação oficial não lista extensão para VS Code. Abra o terminal integrado do VS Code e rode muse ali. Trate qualquer extensão "Muse Code para VS Code" como não oficial.
Limites que você precisa conhecer antes de começar
- Os planos limitam o uso em janelas de 5 horas (Everyday Usage: 10 a 50 prompts a cada 5 horas). Ao bater o limite, você sobe de plano ou espera renovar.
- A faixa por token barata, Contributor, permite que a Meta treine com seus prompts e respostas, e tem um limite de requisições menor.
- Hooks e servidores MCP rodam fora do sandbox e das aprovações.
Custos e planos estão na página de preço do Muse Code. Depois, leia a nossa análise do Muse Code ou compare Muse Code vs Claude Code.
Perguntas frequentes
Como usar o Muse?
Se você quer dizer o Muse Code: instale a CLI, rode muse dentro da pasta do projeto, confie no workspace, faça login e digite uma tarefa. Se você quer dizer o Meta Muse, o assistente de chat para o consumidor final, é outro produto.
Como instalar o Muse Code no Windows?
Ele roda nativamente, sem WSL. Instale pelo PowerShell com "irm https://dev.meta.ai/install.ps1 | iex". Os comandos rodam no PowerShell em vez do Bash, e entrada por voz e troca de mensagens entre sessões não estão disponíveis no Windows.
Como instalar o Muse Code no Mac ou no Linux?
Rode "curl -fsSL https://dev.meta.ai/install.sh | sh" no terminal e confira com "muse --version".
Preciso de chave de API?
Não. Dá para fazer login pelo navegador. A chave de API (META_API_KEY ou muse auth set) só é necessária para uso não interativo, ou se você tem uma Meta Managed Account, que não aceita login pelo navegador.
Consigo usar o Muse Code no Brasil?
Pelas regras da Meta, sim. A cobrança do Muse Code roda sobre a Meta Model API, que segundo a Meta está disponível na maioria dos países e territórios onde a Meta AI está disponível e há suporte para cobrança, e o Brasil não está na lista de territórios excluídos da Política de Uso Geográfico da Meta. O que ainda é só para os EUA é o cadastro pessoal no Meta Muse, o assistente para consumidor em muse.ai, que é outro produto.
Minha conta do muse.ai serve para o Muse Code?
O login do Muse Code é com uma conta Meta, e a conta do muse.ai é o mesmo tipo de conta Meta. Mas o Muse Code é assinado à parte: a assinatura exige uma conta Meta com uma conta da Meta Model API associada e vale só para o Muse Code. Um plano do Meta Muse não inclui o Muse Code.
Dá para usar o Muse Code no VS Code?
A documentação oficial não lista extensão para VS Code. Rode o muse no terminal integrado do VS Code.
O que significa o aviso para confiar no workspace?
Ele pergunta se o Muse Code pode trabalhar nessa pasta. Instruções de projeto como o AGENTS.md só são carregadas em workspaces confiáveis. Confie só em pastas cujo conteúdo você conhece.
O Muse Code lê o meu CLAUDE.md?
Lê. Ele procura AGENTS.md, CLAUDE.md, .agents/AGENTS.md e .claude/CLAUDE.md, da raiz do workspace até a pasta .git mais próxima. Rode muse init para criar um AGENTS.md.
Como paro o agente no meio de uma tarefa?
Aperte Esc para cancelar o turno atual. Processos em segundo plano continuam rodando; gerencie com /tasks.
Dá para rodar o Muse Code no CI?
Dá. Use o modo headless: muse exec "<prompt>", com --json para saída em JSONL. Ele sai com 0 em caso de sucesso, 1 em caso de falha e 2 em erro de uso.