Resposta rápida: para instalar o Claude Code no Windows 10 ou 11 sem WSL, instale o Git for Windows, abra o PowerShell e rode irm https://claude.ai/install.ps1 | iex. Depois feche e reabra o terminal, confirme com claude --version e faça login ao executar claude.
Se você ainda está entendendo onde o Claude Code entra na rotina, vale ler também o guia sobre o que é Claude AI e como usar para diferenciar chat web, app e terminal. Se a sua dúvida é escolher ferramenta para programar, veja o comparativo Claude Code vs Cursor.
O que é o Claude Code?
Claude Code é a ferramenta oficial da Anthropic para usar o Claude diretamente no terminal, integrado ao seu ambiente de desenvolvimento. Em vez de abrir o navegador e copiar código manualmente, você trabalha dentro do próprio projeto — o Claude lê os seus arquivos, entende o contexto e escreve, corrige ou explica código sem sair do terminal.
É voltado para desenvolvedores, mas também funciona muito bem para quem cria scripts de automação, processa dados ou quer usar IA no fluxo de trabalho técnico sem depender de interface gráfica.
O que dá pra fazer com Claude Code:
- Escrever e editar código em qualquer linguagem
- Criar e mover arquivos, rodar comandos no terminal
- Entender e explicar projetos inteiros (o Claude lê o contexto completo)
- Automatizar tarefas repetitivas com comandos em linguagem natural
- Depurar erros com análise do código real, não de exemplos genéricos
Por que instalar no Windows?
O Claude Code foi projetado originalmente para macOS e Linux, mas desde 2025 tem suporte nativo completo para Windows — sem precisar de WSL (Windows Subsystem for Linux). Isso significa que você pode usar PowerShell ou CMD diretamente, com o instalador oficial da Anthropic.
Se você trabalha com Python, Node.js, automações ou qualquer projeto técnico no Windows, o Claude Code vira um assistente que fica ao lado do seu fluxo de trabalho — não uma aba separada no navegador.
Pré-requisitos
- Windows 10 versão 1809 ou superior — ou Windows 11 (recomendado)
- Git for Windows recomendado — baixe em git-scm.com/downloads/win e instale com as opções padrão. Segundo a documentação oficial, ele é opcional no Windows nativo, mas melhora a experiência porque libera o uso do Bash tool
- Conta Anthropic com plano pago — Claude Pro, Max, Teams ou Console. Se estiver comparando planos, veja também o guia sobre Claude grátis, limites e quando vale o Pro
- Terminal disponível — PowerShell (recomendado) ou CMD. Não precisa de WSL
Quanto custa? O Claude Code exige uma assinatura compatível, como Claude Pro, Max, Teams ou acesso via Console. O plano gratuito do Claude pode servir para testar o chat, mas não é o caminho indicado para usar Claude Code no terminal.
PowerShell vs CMD: qual você está usando?
Esse é o ponto que mais causa confusão no Windows. Os comandos de instalação do Claude Code são diferentes dependendo do terminal — usar o comando errado no terminal errado vai dar erro imediatamente.
Como identificar qual você está usando:
- PowerShell: o prompt começa com
PS C:\> - CMD (Prompt de Comando): o prompt começa com
C:\>(sem o “PS”)
Para abrir o PowerShell: pressione Win + X e escolha “Terminal” ou “Windows PowerShell”. Para abrir como Administrador: Win + X → Terminal (Administrador).
Para abrir o CMD: pressione Win + R, digite cmd e pressione Enter.
Recomendação: use o PowerShell. É o método oficial e mais estável para o Claude Code no Windows.
Leitura rápida: se você quer o caminho mais simples, use PowerShell. CMD e WinGet servem bem quando esse já é o seu terminal padrão.
| Método | Quando usar | Comando principal | Observação |
|---|---|---|---|
| PowerShell | Quer o fluxo oficial e mais simples. | irm https://claude.ai/install.ps1 | iex | Melhor opção para a maioria dos usuários Windows. |
| CMD | Você já trabalha no Prompt de Comando. | powershell -Command "irm https://claude.ai/install.ps1 | iex" | Chama o PowerShell internamente. |
| WinGet | Prefere instalar e atualizar via gerenciador de pacotes. | winget install Anthropic.ClaudeCode | Exige atualização manual com winget upgrade. |
| npm | Já usa Node 18+ e quer controle manual. | npm install -g @anthropic-ai/claude-code | Alternativa válida, mas não é o caminho mais simples no Windows. |
Método 1: Instalador Nativo pelo PowerShell (Recomendado)
Método oficial da Anthropic. Instala sem dependências extras, atualiza automaticamente em segundo plano e funciona direto no Windows sem WSL.
Passo 1: Instale o Git for Windows
Acesse git-scm.com/downloads/win, baixe o instalador e execute. Nas opções de instalação, mantenha os padrões — especialmente “Git from the command line and also from 3rd-party software”. Após instalar, feche e reabra o PowerShell.
Passo 2: Execute o instalador no PowerShell
Abra o PowerShell normal — a documentação oficial diz que não precisa executar como Administrador — e rode:
irm https://claude.ai/install.ps1 | iexO instalador baixa e configura o Claude Code automaticamente. Aguarde a conclusão (geralmente menos de 1 minuto).
Passo 3: Verifique a instalação
Ainda no PowerShell, execute:
claude --versionSe aparecer o número da versão (ex: claude 1.x.x), a instalação funcionou. Se aparecer “não reconhecido como comando”, veja a seção de erros abaixo.
Passo 4: Faça login
Execute claude no terminal. O navegador abre automaticamente para você fazer login com sua conta Anthropic. Após autorizar, volte ao terminal — o Claude Code está pronto.
Para diagnóstico completo do ambiente:
claude doctorMétodo 2: Instalação pelo CMD
Se você prefere usar o CMD, o comando é diferente (chama o PowerShell internamente para rodar o script):
powershell -Command "irm https://claude.ai/install.ps1 | iex"Após a instalação, feche e reabra o CMD antes de usar o comando claude.
Método 3: WinGet
O WinGet vem instalado por padrão no Windows 11 e Windows 10 atualizado.
winget install Anthropic.ClaudeCodeAtenção: o WinGet não atualiza automaticamente. Para manter o Claude Code atualizado, rode periodicamente:
winget upgrade Anthropic.ClaudeCodeMétodo 4: npm Global (para quem já usa Node.js)
O npm continua sendo uma alternativa válida para quem já usa Node.js 18+ no dia a dia. Hoje, porém, a Anthropic prioriza o instalador nativo no Windows porque ele reduz problemas de PATH e autenticação.
npm install -g @anthropic-ai/claude-codeAntes de usar esse método, confirme a versão do Node:
node --versionSe você só quer instalar rápido no Windows, volte para o PowerShell. O npm faz mais sentido quando o Node já está configurado e você prefere manter tudo no mesmo fluxo de desenvolvimento.
Precisa de WSL? Quando usar e quando não usar
Não. Desde 2025, o Claude Code tem instalador nativo para Windows — você não precisa instalar o WSL.
Quando usar WSL mesmo assim:
- Você já usa WSL para desenvolvimento e quer manter tudo no mesmo ambiente Linux
- Seu projeto tem dependências que funcionam melhor em Linux (Docker, certos pacotes Python ou Node)
Quando não usar WSL:
- Você só quer instalar e começar a usar rapidamente
- Seu projeto é em Windows puro (PowerShell scripts, .NET, etc.)
- Não tem experiência com Linux e não precisa ter
Se instalar via WSL, use WSL 2 — o WSL 1 tem suporte limitado e pode causar problemas de performance.
Erros Comuns na Instalação (e Como Resolver)
“claude” não é reconhecido como comando
O PATH do Windows não foi atualizado. Solução: feche o terminal completamente e abra um novo. Se não resolver, vá em Variáveis de Ambiente (Win + S, pesquise “variáveis de ambiente”), edite o Path do usuário e adicione o caminho %LOCALAPPDATA%\Programs\claude. Abra um novo terminal e teste.
“The token ‘&&’ is not a valid statement separator”
Você está usando um comando de CMD dentro do PowerShell. O separador && não funciona no PowerShell. Certifique-se de estar no PowerShell e use exatamente o comando do Método 1.
“‘irm’ is not recognized as an internal or external command”
Você está usando CMD com um comando de PowerShell. irm só funciona no PowerShell. Use o Método 2 que tem o prefixo correto para CMD.
PowerShell bloqueia o script (ExecutionPolicy)
Execute o PowerShell como Administrador e rode primeiro:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserDepois repita o comando de instalação.
Git não encontrado
O Claude Code exige o Git for Windows. Acesse git-scm.com, instale com as opções padrão e reinicie o terminal. Verifique: git --version
Antivírus bloqueia o instalador
Desative temporariamente a proteção em tempo real, execute a instalação e reative. Alternativa: use o WinGet (Método 3) que passa por canais verificados pelo Windows.
Erro de login: “Authentication failed”
Certifique-se de que sua conta tem um plano ativo. O plano gratuito não inclui Claude Code. Se o plano está ativo, refaça a autenticação:
claude logout
claude loginClaude Code instalou mas não abre
Rode o diagnóstico automático:
claude doctorO comando verifica dependências, versão, configuração de PATH e autenticação, e indica exatamente o que está faltando.
Depois que o terminal estiver funcionando, o próximo passo é organizar como você vai usar o Claude em projetos reais. Para isso, vale abrir também o guia de Claude Projects e entender quando usar projeto, chat comum e Claude Code.
Primeiros Comandos para Começar a Usar
Com o Claude Code instalado e logado, navegue até a pasta do seu projeto e inicie:
claudeVocê entra num chat interativo onde pode pedir em linguagem natural. Exemplos:
- “Crie um script Python que lê um CSV e gera um relatório em HTML”
- “Explica o que esse código faz” (e cola o código)
- “Corrija os erros nesse arquivo: app.py”
- “Liste todos os arquivos desse projeto e explica a estrutura”
Para rodar um comando único sem entrar no chat:
claude "crie um arquivo README.md básico para esse projeto"Para sair do chat interativo: Ctrl + C ou digite /exit.
Documentação oficial: docs.anthropic.com — Claude Code
Próximo passo: o que aprender depois de instalar
Se a instalação deu certo, não pare no comando claude. O ganho real vem de combinar Claude Code com organização de contexto, bons prompts e tarefas pequenas o suficiente para o agente executar com segurança.
- Claude Projects: use para organizar contexto, arquivos e instruções recorrentes.
- Claude grátis e limites: entenda o que dá para testar antes de assinar.
- Meta Ads com Claude: exemplo prático de uso do Claude fora da programação pura.
Perguntas Frequentes
Claude Code é gratuito?
Não. Claude Code exige assinatura ativa: Claude Pro (US$20/mês), Max, Teams ou Console. O plano gratuito da Anthropic não inclui Claude Code.
Preciso instalar WSL para usar Claude Code no Windows?
Não. Desde 2025, o Claude Code tem instalador nativo para Windows que funciona direto no PowerShell ou CMD, sem precisar de WSL.
Preciso saber programar para usar Claude Code?
Ajuda bastante, mas não é obrigatório. Você pode usar linguagem natural para pedir tarefas técnicas.
Claude Code funciona com qual versão do Windows?
Windows 10 versão 1809 ou superior, e Windows 11.
Como atualizar o Claude Code no Windows?
Se instalou pelo método nativo, as atualizações são automáticas. Se instalou pelo npm, use npm install -g @anthropic-ai/claude-code@latest. Se instalou pelo WinGet, rode winget upgrade Anthropic.ClaudeCode.