Como instalar o Claude Code no Windows (guia 2026)

Fala programador(a), beleza? Bora aprender coisa nova!

Instalar o Claude Code no Windows em 2026 ficou bem mais fácil do que você imagina, sem aquela ladainha de WSL e Node.js.

O ano é 2026 e o Claude Code agora roda nativo no Windows, via um instalador de PowerShell. Ou seja: não precisa de WSL, não precisa de Node.js pra colocar ele pra rodar. Se você quer o caminho mais rápido, do zero até o primeiro comando, é esse post aqui. Tudo que a gente usar vai ser explicado, então relaxa que ninguém vai ficar boiando 🙂

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

O que você precisa antes de instalar

Antes de sair rodando comando, vale conferir a listinha do que é necessário. É pouca coisa, viu?

• Windows nativo (o WSL2 é opcional, só se você quiser uma toolchain Linux por perto);
• Uma conta paga da Anthropic: Pro, Max, Team, Enterprise ou uma conta Console (API);
• PowerShell (já vem no Windows);
• Git for Windows: recomendado, é ele que dá a ferramenta Bash pro Claude Code;
• Não precisa rodar como Administrador.

Sobre a conta, presta atenção nesse ponto: o Claude Code não funciona no plano gratuito do Claude.ai. Você precisa de um plano pago. O Pro sai por US$ 20/mês (ou US$ 17/mês no anual). Se você usa muito e quer mais folga, tem o Max 5x a US$ 100/mês e o Max 20x a US$ 200/mês. Team, Enterprise e Console (API) também servem.

O Git for Windows não é obrigatório, mas ajuda: sem ele, o Claude Code usa o PowerShell como shell no lugar do Bash. Dá pra viver sem, porém com ele a experiência fica mais completa.

Passo a passo: instalar o Claude Code no Windows

Agora a parte boa. São quatro passos e em cada um eu aviso o erro comum, pra você não cair na armadilha.

1) Abrir o PowerShell

Abre o menu Iniciar, digita "PowerShell" e abre. Não precisa ser como Administrador, pode ser a janela normal mesmo.

O erro comum deste passo: achar que precisa de admin e sair clicando em "Executar como administrador". Não precisa. A instalação roda a partir do PowerShell (ou do CMD) sem privilégios de admin.

2) Rodar o instalador nativo

Com o PowerShell aberto, cola e roda esse comando:

irm https://claude.ai/install.ps1 | iex

Esse é o caminho recomendado no Windows. Ele baixa e instala o binário nativo. E lembra: com o instalador nativo você não precisa de Node.js nem de npm, o binário não usa Node pra rodar.

O erro comum deste passo: o PowerShell bloquear a execução do script. Se aparecer uma mensagem reclamando de política de execução, roda isso e tenta de novo:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Isso libera scripts pro seu usuário, sem mexer no sistema todo.

3) Conferir o binário e o PATH

O instalador coloca o claude.exe na pasta ~\.local\bin. Na prática, esse caminho é tipo C:\Users\SeuUsuario\.local\bin.

O erro comum deste passo: essa pasta não estar no PATH. Aí você digita claude e o Windows diz que não reconhece o comando. A solução é adicionar ~\.local\bin ao PATH e reabrir o PowerShell (fechar e abrir de novo, pra ele reler as variáveis).

4) Rodar o claude e autenticar

Agora é só chamar:

claude

Na primeira vez ele vai te pedir pra fazer login. Você autentica com a sua conta paga (Pro, Max, Team, Enterprise ou Console) e pronto, tá rodando.

O erro comum deste passo: tentar entrar com uma conta do plano gratuito. Não vai rolar, o Claude Code exige plano pago. Se o login falhar, confere se a conta que você usou tem um dos planos que servem.

Erros comuns na instalação e como resolver

Se travou em algum ponto, provavelmente é um destes três. Vou no formato sintoma, causa e solução, que é mais fácil de achar o seu caso.

"claude não é reconhecido"

Sintoma: você digita claude e o terminal responde que o comando não existe.

Causa: o binário está em ~\.local\bin, mas essa pasta não entrou no PATH.

Solução: adiciona ~\.local\bin ao PATH do seu usuário e reabre o PowerShell.

Como prevenir: sempre que instalar algo por linha de comando, feche e abra o terminal antes de sair achando que deu errado. Muita vez é só o PATH que ainda não foi relido.

Script bloqueado no PowerShell

Sintoma: ao rodar o instalador, aparece um erro de política de execução e o script nem começa.

Causa: por padrão o Windows pode barrar a execução de scripts.

Solução:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Como prevenir: rodar esse comando uma vez, no seu usuário, já deixa o terreno pronto pros próximos scripts.

Ferramenta Bash sem o Git for Windows

Sintoma: você esperava o Claude Code usando Bash e ele está usando PowerShell.

Causa: falta o Git for Windows, que é quem fornece o Bash no Windows nativo.

Solução: instala o Git for Windows e o Claude Code passa a ter o Bash disponível.

Como prevenir: já deixa o Git for Windows instalado antes, junto dos pré-requisitos. Assim você não descobre isso no meio do caminho.

Métodos alternativos: WinGet e npm

O instalador de PowerShell é o caminho recomendado, mas não é o único. Se você já vive na linha de comando, talvez prefira um destes.

WinGet

Se você usa o gerenciador de pacotes do Windows, dá pra instalar assim:

winget install Anthropic.ClaudeCode

E pra atualizar depois, é manual:

winget upgrade Anthropic.ClaudeCode

É uma mão na roda pra quem já organiza os programas pelo WinGet ou automatiza a máquina.

npm

A instalação via npm ainda é suportada, mas deixou de ser o método principal testado pela Anthropic. Ou seja: funciona, só não é mais o caminho primário.

npm install -g @anthropic-ai/claude-code

Um detalhe importante: por esse método você precisa do Node.js 22 ou superior (esse requisito passou a valer a partir da v2.1.198). Se você já tem Node no seu fluxo, ou depende de npm pra automação, esse pode ser o seu caminho. Fora isso, o instalador nativo é mais direto porque nem Node pede.

Como foi instalar na prática

Na prática, o fluxo é bem curto: abre o PowerShell, roda o comando do instalador, digita claude, faz login. Quando dá tudo certo, você sai do zero até o primeiro comando em poucos minutos.

O ponto onde a maioria tropeça é sempre o mesmo: o PATH. Você instala, digita claude, e o Windows diz que não conhece o comando. Aí bate aquele "não funcionou". Na real, é só apontar a pasta ~\.local\bin e reabrir o terminal. Depois disso, flui.

O segundo tropeço clássico é a política de execução do PowerShell barrando o script. Também tem solução de uma linha só, aquele Set-ExecutionPolicy que a gente viu ali em cima. Sabendo desses dois pontos de antemão, a instalação é tranquila. No vídeo abaixo eu mostro o caminho completo, do comando até a autenticação.

Veja o passo a passo em vídeo

Conclusão

E é isso! Instalar o Claude Code no Windows em 2026 virou coisa de poucos minutos: instalador nativo pelo PowerShell, sem WSL e sem Node obrigatório, e sem precisar de admin. Os dois perrengues mais comuns (PATH e política de execução) você já sabe resolver.

Com ele instalado, o próximo passo é autenticar com a sua conta paga e rodar o primeiro projeto de verdade. É aí que a ficha cai e você vê o Claude Code trabalhando pra valer.

E por hoje é isso, até o próximo post! 🙂