windows-dev-setup.md

Setup: Ambiente de Desenvolvimento Windows (sem WSL2)

Guia para migrar do WSL2 para desenvolvimento nativo no Windows, com Windows Terminal, PowerShell 7 e Oh My Posh.

---

Motivação

O WSL2 causa problemas com MCPs que dependem de recursos do Windows (Playwright, Figma MCP). Rodando tudo nativamente no Windows, esses problemas somem — e o Shopify CLI 3.x roda bem, pois é puramente Node.js.

---

1. Windows Terminal

Já vem instalado no Windows 11. Se não tiver, baixa na Microsoft Store (gratuito).

Limpar perfis desnecessários

Em Configurações (Ctrl+,) > menu lateral, ocultar os perfis que não usa:

• Windows PowerShell (5.x legado — substituído pelo PowerShell 7)
• Prompt de comando
• Azure Cloud Shell
• Anaconda PowerShell Prompt / Anaconda Prompt (se não usar)

Manter apenas:

• PowerShell (7.x — principal)
• Ubuntu (WSL2 — para quando precisar de ambiente Linux)

---

2. PowerShell 7

Instala via winget:

winget install Microsoft.PowerShell

Feche e reabra o Terminal. O perfil PowerShell (sem "Windows") já aparece nas abas — esse é o 7.x.

Definir como perfil padrão

Configurações > Padrões > Perfil padrão > PowerShell

---

3. Pasta de projetos

Cria a pasta raiz dos projetos em C:\Dev:

mkdir C:\Dev

Evite C:\Users\<nome>\OneDrive\... — o sync em tempo real conflita com node_modules.

Abrir terminal direto em C:\Dev

Configurações > PowerShell > Diretório inicial → C:\Dev

---

4. Oh My Posh

Prompt estilizado para PowerShell (equivalente ao Oh My Zsh do Linux).

Instalar

winget install JanDeDobbeleer.OhMyPosh

Instalar fonte compatível

oh-my-posh font install meslo

Depois em Configurações do Terminal > PowerShell > Aparência > Fonte seleciona MesloLGM Nerd Font.

Criar arquivo de perfil do PowerShell

Se der erro de caminho ao tentar abrir o $PROFILE, cria o diretório primeiro:

New-Item -ItemType Directory -Force -Path (Split-Path $PROFILE)

Abre o arquivo de perfil:

notepad $PROFILE

Confirma a criação do arquivo quando perguntado. Cola o conteúdo:

oh-my-posh init pwsh | Invoke-Expression

Salva e fecha o Notepad.

Liberar execução de scripts

Se aparecer erro de UnauthorizedAccess ao reabrir o terminal:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Confirma com S. Feche e reabra o Terminal — o prompt estilizado já aparece.

---

Próximos passos

• Instalar Node.js 20.10+
• Instalar Git for Windows
• Instalar Shopify CLI: npm install -g @shopify/cli@latest
• Instalar Claude Code: npm install -g @anthropic-ai/claude-code
• Configurar MCPs (Context7, Playwright, Figma)