Windows, do jeito
que rende.
O MVCode roda nativamente no Windows, mas o WSL entrega mais: filesystem mais rápido, terminal completo e compatibilidade total com as ferramentas que o agente usa. Este guia cobre os dois caminhos e as combinações úteis.
Ferramentas de build, LSP e formatadores assumem um ambiente Unix. No WSL, tudo funciona sem adaptação — e o acesso a disco em projetos grandes é sensivelmente mais rápido.
01Setup no WSL
- Instale o WSL
Siga o guia oficial da Microsoft (
wsl --installno PowerShell como administrador resolve na maioria dos casos). - Instale o MVCode dentro do WSLterminal wsl
# [[INSTALL_URL]] · placeholder de handoff — substituir pela URL oficial curl -fsSL [[INSTALL_URL]] | bash
- Abra o projeto
Os discos do Windows ficam em
/mnt/c,/mnt/de assim por diante.terminal wslcd /mnt/c/Users/voce/projetos/meu-app mvcode
Para o máximo de performance, clone o repositório dentro do filesystem do WSL (por exemplo ~/code/) em vez de trabalhar por /mnt/c.
02Desktop no Windows + servidor no WSL
Prefere o app desktop mas quer o runtime dentro do WSL? Suba o servidor aceitando conexões externas e aponte o app para ele:
MVCODE_SERVER_PASSWORD=sua-senha mvcode serve --hostname 0.0.0.0 --port 4096No app desktop, conecte em http://localhost:4096. Se localhost não resolver no seu setup, use o IP do WSL (hostname -I dentro do WSL).
Com --hostname 0.0.0.0 o servidor aceita conexões de fora da máquina. Sempre defina MVCODE_SERVER_PASSWORD nesse modo.
03Web pelo navegador do Windows
Rode a interface web a partir do WSL — nunca do PowerShell — para garantir acesso correto a arquivos e terminal:
mvcode web --hostname 0.0.0.0 → interface disponível em http://localhost:36999
Abra a URL impressa no navegador do Windows e trabalhe de lá.
04Windows nativo
Sem WSL, o MVCode funciona no Windows Terminal e no PowerShell 7+, com as correções de plataforma da casa — clipboard de imagem no paste, spinner e terminal Win32. Limitações práticas: alguns LSPs e formatadores esperam ambiente Unix e precisam de equivalentes Windows configurados.
05Onde ficam os dados
Instalações WSL e Windows nativas mantêm dados separados — sessões de um lado não aparecem do outro, a menos que você conecte as superfícies ao mesmo servidor.