Como instalar Claude Code Passo a Passo (Windows, Mac e Linux)

Como instalar Claude Code no terminal

Para instalar como instalar Claude Code, você precisa de Node.js 18 ou superior e rodar npm install -g @anthropic-ai/claude-code no terminal. No Windows, use o WSL, porque o Claude Code não funciona nativamente no PowerShell.

Eu já vi essa instalação parecer trivial até bater no WSL no Windows. Perdi 2 horas tentando rodar no PowerShell puro antes de alguém me avisar que precisava do WSL. (Desenvolvedor júnior, Discord Anthropic, março 2026)

O ponto de partida confiável é a Documentação oficial Anthropic — docs.claude.ai/en/docs/claude-code/getting-started, que define os requisitos e evita a maioria dos erros boatos.

Se você quer como instalar Claude Code sem dor, o caminho certo começa por conferir Node.js 18+, escolher o sistema operacional correto e validar a instalação com claude --version.

Passo a passo para instalar Claude Code no Mac, Linux e Windows via WSL

O jeito mais seguro de instalar Claude Code passo a passo é começar pela base certa: Node.js 18 ou superior, terminal funcionando e permissão adequada no sistema.

Primeiro, confirme a versão do Node.js com node --version. Se estiver abaixo de 18, atualize antes de continuar.

Depois, rode npm install -g @anthropic-ai/claude-code no terminal do macOS, do Linux ou do WSL2. Em seguida, valide com claude --version.

• Requisito mínimo: Node.js 18+
• Comando de instalação: npm install -g @anthropic-ai/claude-code
• Verificar versão: claude --version
• Sistemas suportados: macOS 12+, Ubuntu 20+, Windows via WSL2
• Tamanho do pacote: ~45 MB
• Primeira autenticação: via browser com conta Anthropic

Erros mais comuns na instalação e como resolver

Instalação Claude Code Windows Mac Linux costuma falhar por detalhe bobo, e o pior erro é insistir no ambiente errado por tempo demais.

O primeiro problema aparece quando o sistema tenta instalar em um ambiente não suportado. No Windows nativo, isso quase sempre termina em EBADPLATFORM ou erro equivalente.

O segundo problema comum é o caminho do npm ou do Node.js estar quebrado no macOS, especialmente com instalações antigas do Homebrew. Eu já vi isso virar um ENOENT simples de resolver com um nvm use 20.

Para evitar isso, use nvm no macOS e no Linux, valide node --version antes de instalar e nunca tente forçar o PowerShell puro no Windows.

Depois da instalação, rode claude --version e faça a autenticação no navegador com sua conta Anthropic.

Comparativo prático entre macOS, Linux e Windows

Se você quer configurar Claude Code terminal sem perder tempo, vale entender qual sistema entrega menos atrito logo de cara.

Comparativo de ferramentas e abordagens relacionadas a como instalar Claude Code.

Sistema	Status	Observação prática
macOS	Instalação direta via npm	Sem dependências extras
Linux (Ubuntu/Debian)	Instalação direta via npm	Precisa de Node.js via nvm
Windows nativo	NÃO SUPORTADO	Não tente no PowerShell puro
Windows via WSL2	Suportado	Mesmo processo do Linux

Fontes: docs.claude.ai

No meu uso, o macOS costuma ser o caminho mais direto porque a instalação é previsível e a autenticação no browser vai rápido.

No Linux, nvm ajuda a evitar conflito de permissões e facilita manter o Node.js no nível correto sem depender de sudo.

No Windows, o WSL2 muda o jogo porque coloca você num ambiente compatível com o mesmo fluxo do Linux, sem improviso.

Para Quem Vale a Pena e Para Quem Não Vale

Para quem faz sentido

Faz sentido para desenvolvedores que querem um agente autônomo no terminal e já trabalham com Git, edição de arquivos e comandos de shell todos os dias.

Também vale para quem mantém um pipeline CI/CD e quer testar fluxos de codificação orientados por prompt engineering com menos fricção.

Se você vive alternando entre repositórios e precisa de um subagente para tarefas repetitivas, o Claude Code poupa tempo real.

Para times que documentam fluxo no CLAUDE.md e usam git hook, ele encaixa bem como peça operacional.

Para quem não é a escolha certa

Não faz tanto sentido se você quer apenas um chatbot para perguntas pontuais, porque o foco aqui é terminal e automação prática.

Também não é ideal para quem não quer lidar com tokens, autenticação inicial ou configuração de ambiente.

Se seu fluxo depende de API key em várias ferramentas e você busca algo totalmente sem terminal, há opções mais simples.

Para quem usa o computador quase todo em interface gráfica e evita shell, o custo de adoção pode ser maior que o ganho.

A melhor escolha é a que combina com seu terminal real e com o tipo de tarefa que você quer automatizar de verdade.

Dica prática para instalar sem travar no Windows

No Windows, instale o WSL2 antes de qualquer coisa com wsl --install no PowerShell como administrador. Tentar rodar Claude Code no PowerShell puro vai falhar — o erro mais comum é ENOENT ou command not found.

1. Abra o PowerShell como administrador e rode wsl --install. Depois reinicie a máquina e entre no ambiente Linux antes de prosseguir.
2. Instale o Node.js 18+ dentro do WSL2, de preferência com nvm. Isso evita conflito de permissões e ajuda a manter o terminal limpo.
3. Rode npm install -g @anthropic-ai/claude-code e valide com claude --version. Se o comando não responder, pare e revise o ambiente antes de insistir.

Erro comum ao usar Node antigo

Instalar com versão antiga do Node.js. Se você tem Node 16 ou anterior, o Claude Code vai dar erro de compatibilidade silencioso. Rode node --version antes de instalar e atualize se necessário.

O erro aparece quando a instalação até termina, mas o comando não se comporta como deveria no terminal. Na prática, você acha que funcionou e descobre a falha na primeira execução.

Por que acontece porque a ferramenta depende de um runtime moderno e teste com Node.js antigo costuma quebrar partes do fluxo sem aviso claro. Isso é especialmente comum em máquinas com versões herdadas de projetos antigos.

Consequência é perder tempo depurando algo que se resolve antes da instalação. O Requisito mínimo: Node.js 18+ existe justamente para evitar esse tipo de dor.

Como evitar é simples: use nvm, confirme node --version e instale novamente só depois de subir para 18 ou superior. Se estiver no macOS ou Linux, isso reduz bastante a chance de conflito.

Ficha Técnica: Claude Code

Produto	Claude Code
Marca	Anthropic
Descrição	Agente de codificação via linha de comando da Anthropic que opera diretamente no terminal, lê e edita arquivos, executa comandos e interage com repositórios Git de forma autônoma.
Categoria	Tutorial de Instalação
Fonte técnica	Documentação oficial Anthropic — docs.claude.ai/en/docs/claude-code/getting-started

Veredicto Final sobre como instalar Claude Code

Instalar Claude Code é simples quando você parte do sistema correto e respeita os requisitos mínimos desde o começo.

Em macOS e Linux, o fluxo com npm costuma ser rápido, previsível e fácil de repetir. No Windows, o ponto decisivo é aceitar o WSL2 como parte da instalação.

Se o seu ambiente já está organizado com Node.js 18+, a execução costuma ser rápida, e a primeira autenticação no browser fecha o ciclo sem complicação.

Para quem quer trabalhar em terminal com um agente autônomo, essa é uma instalação que vale o esforço. Para quem quer evitar shell e ambiente Linux, talvez não seja a melhor entrada.

Aviso importante: este artigo é informativo, preços e disponibilidade podem variar — verifique sempre a documentação oficial antes de tomar decisões.

Perguntas Frequentes sobre como instalar Claude Code

• Claude Code o que é e Como Usar em 2026 (Guia Completo)

Página Home