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.
Atualizado em junho de 2026: o caminho mais seguro para instalar o Claude Code no Windows continua sendo o instalador nativo no PowerShell: irm https://claude.ai/install.ps1 | iex. Se você está no CMD, use curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Depois valide com claude --version e claude doctor.
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.
Se você quer ver o que dá para construir com Claude Code no marketing e no dia a dia de um negócio, veja o guia sobre o que é o Claude Code e como instalar.
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. | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | 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):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdApó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.
Esses são os erros mais frequentes na instalação. Se o seu caso for diferente — travamentos, lentidão ou erros de PATH e permissão mais específicos —, reuni o passo a passo em erros comuns do Claude Code no Windows e como resolver.
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.
Claude Code CMD, CLI e comando claude: qual é a diferença?
Nas buscas, muita gente mistura Claude Code, Claude CLI, CMD e o comando claude. Na prática, Claude Code é a ferramenta; Claude CLI é a interface de terminal; CMD e PowerShell são os terminais do Windows; e claude é o comando que você roda depois da instalação.
- Instalar Claude Code Windows: use PowerShell, CMD, WinGet ou npm.
- Claude Code CMD: use o comando de CMD, não o comando de PowerShell.
- Comando claude: depois de instalar, rode
claudedentro da pasta do projeto. - Claude Code para que serve: editar arquivos, explicar código, executar comandos e automatizar tarefas técnicas dentro do terminal.
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.
Para a referência completa dos comandos do terminal — claude, claude --version, claude doctor, claude mcp e slash commands como /help e /clear —, veja os principais comandos do Claude.
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.
Como instalar Claude CLI no Windows?
Para instalar a Claude CLI no Windows, instale o Claude Code. No PowerShell, rode irm https://claude.ai/install.ps1 | iex; no CMD, use curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Depois feche e reabra o terminal.
O que é o comando claude?
É o comando que abre o Claude Code no terminal. Depois da instalação, você pode rodar claude dentro de uma pasta de projeto para iniciar o chat interativo, ou usar claude doctor para diagnosticar problemas.
Claude Code funciona no CMD?
Sim. O Claude Code funciona no CMD, mas o comando de instalação é diferente do PowerShell. Se aparecer erro com irm, você provavelmente está no CMD usando comando de PowerShell.
Claude Code precisa de Node.js?
Não para o instalador nativo nem para o WinGet. Node.js 18+ só é necessário se você escolher instalar pelo npm com npm install -g @anthropic-ai/claude-code.
O que fazer se ‘claude’ não aparece no CMD ou PowerShell?
Feche todos os terminais e abra um novo. Depois rode claude --version e claude doctor. Se ainda falhar, revise o PATH do Windows e confirme se a instalação terminou sem erro.