Claude Code no Windows: Instalação Nativa ou WSL

O Claude Code funciona no Windows?

Sim. O Claude Code funciona no Windows de duas formas: de modo nativo, rodando direto no PowerShell com o Git for Windows instalado, ou dentro do WSL, o subsistema Linux da Microsoft. As duas rotas usam a mesma ferramenta e a mesma conta Anthropic. Para a maioria dos iniciantes, a instalação nativa é o caminho mais rápido.

O Claude Code é a ferramenta de linha de comando da Anthropic que lê, cria e edita os arquivos de um projeto a partir de instruções em português. Ele não depende de sistema operacional específico: o que muda entre Windows, macOS e Linux é o terminal em volta dele e alguns detalhes de caminho de arquivo e permissão.

A escolha entre nativo e WSL tem menos a ver com a ferramenta e mais com o tipo de projeto que você vai construir. Quem vai criar páginas, scripts simples e agentes hospedados na nuvem fica bem no modo nativo. Quem vai trabalhar com muitas ferramentas pensadas para Linux tende a ter menos atrito no WSL.

• Rota nativa: Claude Code rodando no PowerShell, com o Git for Windows instalado para fornecer o Git Bash usado pela ferramenta.
• Rota WSL: Claude Code rodando dentro de uma distribuição Linux, como o Ubuntu, instalada no próprio Windows.
• Mesma conta nas duas: uma assinatura paga do Claude ou créditos de API na Console da Anthropic.
• Mesmo resultado: os projetos criados funcionam igual, e os agentes publicados na nuvem não dependem do seu sistema.

Nativo ou WSL: comparação pelos mesmos critérios

Não existe uma rota certa para todo mundo. A melhor forma de decidir é avaliar as duas pelos mesmos critérios práticos: facilidade de instalação, compatibilidade com ferramentas de terceiros, desempenho com arquivos e curva de aprendizado. Cada uma ganha em pontos diferentes, e vale ser honesto sobre isso. Escolher bem no começo evita reinstalações, mas nenhuma das duas decisões é definitiva.

Se você está começando e quer ver o Claude Code funcionando hoje, a rota nativa resolve. Se depois perceber que os tutoriais e scripts que você usa assumem um terminal Linux, migrar para o WSL é simples, e os projetos podem ser copiados de um ambiente para o outro. O que importa é não misturar os dois ambientes no mesmo projeto: escolha um terminal por projeto e mantenha a consistência até o fim.

• Instalação — nativo: poucos passos no PowerShell; WSL: exige ativar o subsistema, reiniciar e configurar a distribuição Linux.
• Compatibilidade — nativo: atende bem a maioria dos projetos; WSL: melhor quando o projeto depende de ferramentas e scripts feitos para Linux.
• Arquivos — nativo: acesso direto às pastas do Windows; WSL: mais rápido quando o projeto fica dentro do sistema de arquivos do Linux.
• Curva de aprendizado — nativo: menor para quem nunca usou terminal; WSL: exige noções básicas de comandos Linux.
• Quando escolher — nativo: começar rápido e projetos simples; WSL: automações mais técnicas e ambiente parecido com servidores de produção.

Passo a passo para instalar o Claude Code no Windows (rota nativa)

A instalação nativa leva poucos minutos quando os pré-requisitos estão no lugar. O ponto que mais trava iniciantes é esquecer o Git for Windows, que o Claude Code usa para executar comandos de terminal. Instale-o antes e o resto do processo tende a fluir sem surpresas. Se a sua máquina for corporativa, confirme antes com o time de TI se a instalação de programas e a execução de scripts estão liberadas.

A Anthropic disponibiliza um instalador oficial de uma linha para PowerShell e mantém também a opção de instalar pelo npm, que exige o Node.js 18 ou superior. Como os comandos podem mudar com novas versões, copie sempre o comando atual da documentação oficial do Claude Code, em vez de confiar em prints antigos.

• 1. Instale o Git for Windows a partir do site oficial do Git, mantendo as opções padrão do instalador.
• 2. Abra o PowerShell e rode o comando de instalação indicado na documentação oficial do Claude Code (instalador nativo ou npm, com Node.js 18+).
• 3. Feche e abra o terminal de novo e rode claude --version para confirmar que o comando foi reconhecido.
• 4. Entre na pasta do projeto com cd, digite claude e conclua o login com a sua conta Anthropic no navegador.
• 5. Faça um primeiro teste simples, como pedir a criação de um arquivo README explicando a pasta.

Como instalar pela rota WSL

O WSL permite rodar uma distribuição Linux completa dentro do Windows, sem máquina virtual separada nem dual boot. Uma vez ativado, você abre o terminal do Ubuntu e segue exatamente o mesmo processo de instalação usado em Linux. A experiência do Claude Code ali dentro fica praticamente idêntica à de um servidor ou de um computador com Linux.

O cuidado principal é manter o projeto dentro do sistema de arquivos do Linux, na sua pasta de usuário do Ubuntu, e não nas pastas do Windows acessadas por /mnt/c. Projetos guardados no lado Windows funcionam, mas ficam mais lentos e podem gerar problemas de permissão em scripts. Para abrir essas pastas no editor de código, use o modo de integração com WSL disponível nos principais editores, em vez de editar os arquivos pelo Explorer do Windows.

• 1. Abra o PowerShell como administrador e rode wsl --install para instalar o WSL com o Ubuntu.
• 2. Reinicie quando solicitado e crie o usuário e a senha do Linux na primeira abertura do Ubuntu.
• 3. Dentro do Ubuntu, instale o Claude Code com o comando para Linux da documentação oficial.
• 4. Crie seus projetos na pasta de usuário do Linux e abra o Claude Code a partir dela.

Erros comuns do Claude Code no Windows e como resolver

Quase todos os problemas relatados por quem usa Claude Code no Windows caem em três categorias: o terminal não encontra o comando, o ambiente mistura Windows e WSL na mesma sessão, ou uma política de segurança bloqueia a instalação. Nenhum deles é defeito da ferramenta, e todos têm solução conhecida.

O primeiro hábito que evita dor de cabeça é sempre fechar e reabrir o terminal depois de instalar algo. Muitas instalações atualizam o PATH do sistema, mas o terminal já aberto continua com a configuração antiga e acusa que o comando não existe. Antes de abrir chamado ou reinstalar tudo, teste esse passo: ele resolve uma parte grande dos casos de comando não encontrado.

• Comando não encontrado: reabra o terminal; se persistir, confira se a pasta de instalação está no PATH do usuário.
• Erro ao executar comandos de shell: verifique se o Git for Windows está instalado na rota nativa.
• Arquivo não encontrado: não misture terminal do Windows e terminal WSL no mesmo projeto.
• Instalação bloqueada: antivírus ou política corporativa de TI podem impedir scripts; peça liberação antes de insistir.
• Lentidão no WSL: mova o projeto de /mnt/c para a pasta de usuário do Linux.

Rodando automações 24 horas a partir do Windows

Uma dúvida comum é se o computador com Windows precisa ficar ligado o tempo todo para um agente de WhatsApp ou um webhook funcionar. Não precisa. O Claude Code é a ferramenta que constrói a automação; quem executa no dia a dia é um backend na nuvem, como um Cloudflare Worker ou uma Supabase Edge Function.

Esse desenho resolve a maior parte das preocupações com o sistema operacional. Você desenvolve e testa no seu computador, publica na nuvem, e o agente continua respondendo mesmo com a máquina desligada. Rodar processos permanentes no próprio notebook só faz sentido em testes, nunca para atender clientes reais. Isso também protege o cliente: um agente na nuvem não para quando o notebook atualiza, perde a bateria ou é levado para outro lugar.

• Desenvolvimento: no seu computador com Windows, nativo ou WSL.
• Execução: em um backend serverless na nuvem, independente do seu sistema.
• Agendamentos: use os recursos de agendamento do próprio provedor de nuvem, não o computador pessoal.
• Teste: rode localmente para validar e publique só depois de conferir as respostas.

Quando o Windows não é o problema

Muita gente atribui ao Windows dificuldades que vêm de outro lugar. Se o Claude Code instalou, abriu e respondeu ao primeiro teste, o sistema operacional já cumpriu o papel dele. Daí em diante, o que define o resultado é a qualidade das instruções, a clareza do objetivo do projeto e a disciplina de testar antes de publicar.

Trocar de computador raramente acelera o aprendizado. O que acelera é praticar com projetos reais, aprender a dividir pedidos grandes em etapas e revisar o que a ferramenta entregou. Essas habilidades são as mesmas em qualquer sistema. Quem domina o processo em um computador consegue repeti-lo em qualquer outro, o que importa muito quando você passa a entregar projetos para clientes que usam sistemas diferentes do seu.

• Instruções vagas geram resultados vagos, em qualquer sistema operacional.
• Pedidos grandes funcionam melhor quando divididos em etapas menores e testados um a um.
• Revisar o que o Claude Code criou antes de publicar evita a maior parte dos erros em produção.
• Trocar de computador não substitui prática com projetos reais.