Como instalar o Claude Code no Windows e macOS (2026): guia passo a passo

confira cada comando e número de versão na documentação oficial em code.claude.com/docs antes de seguir o passo a passo, já que a Anthropic lança mudanças com rapidez.

Sou a Jasmine, uma dev que usa o Claude Code todos os dias no Windows e no macOS. Este guia cobre os dois sistemas operacionais em uma única página, com comandos prontos para copiar e colar em cada passo, além de como escolher o método certo, como verificar a instalação e como corrigir os erros que mais aparecem. Se você ainda não tem certeza do que é essa ferramenta, leia antes o que é o Claude Code e depois volte aqui.

O que você precisa antes de instalar (requisitos do sistema)

Antes de digitar qualquer comando, passe por esta checklist rápida para não terminar a instalação e só então descobrir que ela não vai rodar:

• Sistema operacional: Windows 10 (build 1809 ou mais recente) ou Windows 11; ou macOS (funciona tanto em Apple Silicon quanto em Intel).
• Uma conta paga do Claude - obrigatória: o Claude Code precisa de um plano Pro ($20/mês), Max 5x ($100/mês), Max 20x ($200/mês), Team/Enterprise ou cobrança por tokens pelo Anthropic Console (API). O plano gratuito do claude.ai não libera o Claude Code.
• Terminal: PowerShell ou Windows Terminal (Windows); Terminal ou iTerm2 (macOS).
• Depende do seu método: se você instalar via npm, precisa do Node.js 22 ou mais recente. O instalador nativo não precisa de Node algum. No Windows, instalar o WSL2 ou o Git for Windows deixa a experiência de linha de comando mais fluida.

Importante: é aqui que muita gente iniciante tropeça - você consegue baixar e instalar o Claude Code em um plano gratuito, mas o login é bloqueado porque a conta não tem acesso. Faça upgrade para um plano pago antes, ou deixe uma chave de API do Console pronta.

Uma dica rápida antes de começar: se a sua máquina já tem Node, rode node --version para ver em qual versão você está - se for uma versão antiga (18 ou 20), vai precisar atualizar antes de instalar via npm, ou simplesmente mude para o instalador nativo e pule o Node de vez. Sobre o tamanho, o Claude Code é uma ferramenta de linha de comando leve, que não exige muito disco ou RAM; o que realmente determina a velocidade é a sua conexão de rede, não o seu hardware.

Como escolher o método de instalação certo

Existem quatro abordagens comuns. Se você está em dúvida, vá de instalador nativo - é a opção mais enxuta e se atualiza sozinha. A tabela abaixo ajuda você a decidir em uns 30 segundos:

Instalar o Claude Code no Windows

O Windows em 2026 tem instalador nativo e WinGet, então o WSL não é mais obrigatório como já foi. Dito isso, o WSL2 ainda oferece a linha de comando estilo Linux mais fluida. Escolha uma das três abordagens abaixo.

Método 1 - Instalador nativo (recomendado)

Abra o PowerShell e rode o comando de instalação de uma linha da Anthropic. Esse caminho não precisa de Node.js e se atualiza sozinho depois:

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

Esse comando baixa a build estável para o seu sistema operacional e arquitetura, instala o binário no seu diretório de usuário e o adiciona ao seu PATH automaticamente. Quando terminar, feche e reabra o terminal para o PATH ser atualizado e verifique com claude --version. Se o PowerShell bloquear o script por causa da Execution Policy, você pode afrouxá-la só para a sessão atual com Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass e rodar de novo.

Método 2 - WinGet

Se você já gerencia softwares com o WinGet, dá para instalar diretamente:

winget install Anthropic.ClaudeCode

O WinGet serve para quem quer manter o Claude Code atualizado junto com todo o resto via winget upgrade.

Método 3 - WSL2 + npm (ambiente Linux)

Esta é a escolha para quem quer um ambiente Linux de verdade no Windows. Abra o PowerShell como administrador e ative o WSL2:

wsl --install

Reinicie se for solicitado, abra o Ubuntu e instale o Node.js 22 LTS dentro do WSL (use o nvm ou o repositório oficial do NodeSource). Depois disso, instale o Claude Code via npm:

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

Algumas coisas para ter em mente com o WSL2:

• NÃO rode sudo npm install -g - instalar globalmente com sudo costuma causar dores de cabeça com permissões depois. Configure um prefix do npm no seu diretório de usuário, ou use o nvm.
• Mantenha seu código dentro do sistema de arquivos do WSL (por exemplo, ~/projects) em vez de um caminho montado /mnt/c/... - a I/O fica drasticamente mais rápida.
• Instale o Git for Windows (ou o git dentro do WSL) - o Claude Code funciona melhor com o git disponível. Se você usar o PowerShell puro sem git, algumas operações ficam limitadas.

Instalar o Claude Code no macOS

No macOS você tem dois caminhos limpos: instalador nativo/Homebrew (sem Node) ou npm, se já tiver o Node. Os dois funcionam bem em Macs com Apple Silicon (M1/M2/M3 em diante) e Intel; o instalador detecta a arquitetura certa, então você nunca escolhe na mão. Se você nunca usou o Terminal em um Mac, abra-o pelo Spotlight (Cmd+Space, digite "Terminal") e está pronto.

Método 1 - Instalador nativo / Homebrew

O caminho mais rápido, sem Node.js, roda no Terminal:

curl -fsSL https://claude.ai/install.sh | bash

Se você já usa o Homebrew e quer gerenciá-lo junto com suas outras ferramentas:

brew install --cask claude-code

Método 2 - npm

Se você se sente à vontade com o Node, instale primeiro o Node.js 22+ (pegue o LTS em nodejs.org ou rode brew install node) e depois instale o Claude Code:

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

Confirme que o Node está atualizado o suficiente com node --version (precisa ser 22 ou superior). Se você topar com um erro de permissão durante uma instalação global, evite o sudo - em vez disso, redefina o prefix do npm para o seu diretório de usuário.

Autenticação e sua primeira sessão

Instalar não basta - você precisa fazer login para liberar a ferramenta. Entre em qualquer pasta de projeto e rode:

cd path-to-your-project
claude

Na primeira execução, o Claude Code abre o navegador para você entrar na sua conta da Anthropic (ou colar uma chave de API, se você usa o Console). Depois de fazer login, volte ao terminal e sua sessão começa. Se você entrar com uma conta Pro/Max, seus limites de uso seguem a sua assinatura; se usar uma chave de API, a cobrança é por token - as duas coisas são separadas, então escolha o que combina com suas necessidades e seu orçamento.

Logo de cara, teste um prompt simples como "liste a estrutura deste diretório" para confirmar que o Claude Code consegue ler o seu projeto. Este também é um bom momento para pegar prática: você pode escrever pedidos em inglês (ou em qualquer idioma), e sempre vê uma prévia das mudanças antes de aprovar a escrita de um arquivo.

O Claude Code também pergunta se você confia na pasta atual. Isso é um mecanismo de segurança: a ferramenta só lê e escreve arquivos nas pastas que você permitir. Para um projeto desconhecido que você acabou de clonar, pense bem antes de conceder acesso.

Verifique se a instalação funcionou

A maioria dos guias pula esta etapa, mas verificar ajuda você a pegar problemas de PATH ou de versão cedo. Rode estes comandos e compare com o resultado esperado:

Se o claude --version roda e o claude doctor não mostra erros em vermelho, pode considerar sua instalação um sucesso.

Erros comuns de instalação e correções rápidas

Aqui estão os erros que eu mais encontro ao instalar nos dois sistemas operacionais, com uma correção rápida para cada um:

• 'claude' is not recognized / command not found: o executável não está no seu PATH. Feche e reabra o terminal; se ainda falhar, adicione o diretório de instalação (geralmente ~/.local/bin) ao seu PATH e reinicie o terminal.
• Node muito antigo: o npm dá erro quando o Node está abaixo da versão exigida. Atualize o Node para 22+ com o nvm ou reinstalando o LTS de nodejs.org.
• Erro de permissão (EACCES) durante o npm install -g: não resolva na marra com sudo. Reconfigure o prefix do npm para um diretório de usuário, ou mude para o instalador nativo para evitar de vez os problemas de permissão global.
• WSL não habilitado (Windows): se o wsl --install der erro, ative tanto "Plataforma de Máquina Virtual" quanto "Subsistema do Windows para Linux" nos Recursos do Windows e reinicie.
• Terminal não atualizado: depois de instalar, as novas variáveis de ambiente só valem para novas sessões de terminal. Sempre abra um terminal novo antes de tentar de novo.

Esbarrou em outra coisa ou quer se aprofundar? Veja o guia dedicado sobre como corrigir erros comuns do Claude Code - onde eu reúno a solução completa para cada situação.

Atualizar e desinstalar

Atualizar:

• Instalador nativo: se atualiza sozinho em segundo plano, nada a fazer. Para checar manualmente, você pode rodar claude update.
• npm: rode npm update -g @anthropic-ai/claude-code.

Desinstalar:

• npm: npm uninstall -g @anthropic-ai/claude-code.
• Homebrew: brew uninstall --cask claude-code.
• Instalador nativo: apague o binário em ~/.local/bin e o diretório de configuração relacionado.

O que fazer depois de instalar

Agora que o Claude Code roda, é hora de usá-lo de verdade. Um caminho sugerido:

• Quem está começando deve ler os 10 passos para começar como iniciante para aprender o fluxo de trabalho básico.
• Se você programa no VS Code, veja como usar o Claude Code no VS Code para integração com o editor.
• Ainda com o conceito nebuloso? Volte para o que é o Claude Code.

Quando ficar natural, você consegue ir mais rápido com pacotes prontos de skill e subagent - por exemplo, o bundle do AgentKit para o Claude Code (que é ativado pela ak CLI (20% de desconto pelo link)) evita que você configure cada skill na mão. É opcional - o Claude Code funciona muito bem antes mesmo de você recorrer a um kit.

Perguntas frequentes (FAQ)

Instalar o Claude Code custa dinheiro?

Instalar é grátis, mas para usar você precisa de uma conta paga do Claude: Pro ($20/mês), Max 5x ($100/mês), Max 20x ($200/mês), um plano Team/Enterprise, ou cobrança por tokens pelo Anthropic Console. O plano gratuito do claude.ai não libera o Claude Code.

Preciso saber programar?

Um conhecimento básico de programação ajuda você a trabalhar com eficiência, mas você não precisa ser especialista. Você precisa saber abrir um terminal, navegar entre pastas e ler a saída. Iniciantes totais também conseguem usar, desde que sigam os passos com atenção.

O WSL é obrigatório no Windows?

Não. O Windows em 2026 tem instalador nativo e WinGet, então dá para instalar direto, sem WSL. Dito isso, o WSL2 ainda oferece a experiência estilo Linux mais fluida, o que combina com você se seus projetos esperam um ambiente POSIX.

De qual versão do Node.js eu preciso?

Você só precisa do Node se instalar via npm, e deve usar o Node.js 22 ou mais recente. Se usar o instalador nativo, não precisa de Node.js algum.

Consigo rodar em uma máquina de configuração modesta?

Sim. O Claude Code roda a maior parte do processamento nos servidores da Anthropic, então não exige uma máquina potente; os requisitos de verdade são uma conexão de rede estável e uma conta paga. Uma configuração modesta dá conta.

Como eu desinstalo o Claude Code?

Depende de como você instalou: no npm use npm uninstall -g @anthropic-ai/claude-code; no Homebrew use o brew uninstall correspondente; no instalador nativo, apague o binário em ~/.local/bin junto com o diretório de configuração.

Conclusão

Instalar o Claude Code no Windows ou no macOS se resume a três coisas: escolher um método (o instalador nativo é o mais seguro para iniciantes), fazer login com uma conta paga e então verificar com claude --version e claude doctor. Se você travar, volte à seção de erros comuns acima ou ao guia dedicado sobre como corrigir erros do Claude Code. Depois de instalado, comece pelos 10 passos para iniciantes para tornar sua primeira sessão realmente produtiva.

Fonte dos comandos de instalação e requisitos do sistema: documentação oficial da Anthropic em code.claude.com/docs (acesso em 08/2026).