Claude Code roda no Windows? A resposta direta
- Sim, mas o caminho recomendado oficialmente é via WSL (Windows Subsystem for Linux), não o PowerShell ou CMD puro.
- O suporte nativo ao terminal do Windows existe e evoluiu, mas ainda esbarra em detalhes de path e em algumas ferramentas de linha de comando que esperam ambiente Unix.
- Quem já usa WSL para outras tarefas de desenvolvimento não sente diferença nenhuma: a experiência fica praticamente igual à de Mac ou Linux.
- Quem nunca usou terminal Linux vai ter uma curva de aprendizado extra nos primeiros dias, e isso é normal — não é sinal de que algo está errado.
Passo a passo para instalar via WSL
- 1. Abra o PowerShell como administrador e rode 'wsl --install' para instalar o Ubuntu como distribuição padrão.
- 2. Reinicie o computador quando pedido e crie um usuário e senha dentro do ambiente Linux na primeira execução.
- 3. Instale o Node.js dentro do WSL (via nvm ou apt) e depois instale o Claude Code com o comando oficial da Anthropic.
- 4. Abra o Claude Code de dentro do terminal WSL, sempre navegando até a pasta do projeto com 'cd' antes de rodar comandos.
Erros comuns e como evitar
- Rodar comandos misturando terminal do Windows e terminal WSL na mesma sessão costuma gerar erro de caminho de arquivo não encontrado.
- Editar arquivos do WSL usando um editor apenas do Windows (fora do modo de integração) pode corromper permissões e quebrar scripts depois.
- Antivírus e firewall corporativo às vezes bloqueiam a instalação de dependências Node — vale checar isso antes de abrir chamado de suporte.
- Notebooks corporativos com política de TI restritiva podem impedir a ativação do WSL; nesse caso, é preciso pedir liberação ao time de TI antes de tentar instalar.
Quando vale a pena migrar para Mac ou usar Windows mesmo
- Se o uso é ocasional e o projeto é simples, o Windows com WSL resolve bem e não justifica trocar de máquina.
- Se o trabalho envolve automações rodando 24/7 (agentes de WhatsApp, webhooks, cron jobs), um ambiente Linux dedicado ou um Mac tende a dar menos dor de cabeça a longo prazo.
- O Claude Code em si não exige Mac — a diferença está no ecossistema ao redor (scripts, cron, permissões) que é nativamente mais simples fora do Windows.
- Não existe resposta única: o critério é o volume e a criticidade da automação, não modismo de ferramenta.
// Dado próprio ZX LAB
Na ZX LAB, boa parte dos setups de automação que ensinamos roda em cima do Claude Code, e uma fatia relevante dos alunos usa Windows no dia a dia — então testamos as duas rotas (WSL e terminal nativo) antes de indicar qualquer uma pros alunos. A recomendação que sustentamos hoje é rodar via WSL: evita os pequenos atritos de caminho de arquivo e permissão que aparecem no terminal nativo do Windows.