Pré-requisitos antes de instalar o Claude Code
- O Claude Code é distribuído como pacote npm, então você precisa do Node.js 18 ou superior instalado — esse é o pré-requisito que mais trava iniciantes na hora de instalar.
- Para checar se já tem o Node.js, abra o terminal e rode node --version; se aparecer um número 18 ou maior, está pronto, e se der 'comando não encontrado', baixe o Node em nodejs.org primeiro.
- Você vai precisar de uma conta na Anthropic — o uso real exige o plano Pro (cerca de US$20/mês) ou uma chave de API com créditos; a camada gratuita existe mas trava cedo em projetos sérios.
- Funciona em Windows (via PowerShell ou WSL), macOS e Linux com o mesmo comando, então não importa o seu sistema operacional: o passo a passo de instalação é idêntico.
O comando de instalação (uma linha só)
- Com o Node.js instalado, a instalação do Claude Code é um único comando no terminal: npm install -g @anthropic-ai/claude-code — o -g instala globalmente para você poder rodar de qualquer pasta.
- No Windows, recomenda-se rodar pelo PowerShell ou, idealmente, pelo WSL (subsistema Linux), porque alguns caminhos de arquivo funcionam de forma mais previsível em ambiente Unix.
- Se aparecer erro de permissão (EACCES) no macOS ou Linux, evite usar sudo direto — o caminho mais limpo é configurar o npm para instalar pacotes globais na sua pasta de usuário e rodar o comando de novo.
- Terminada a instalação, confirme que deu certo rodando claude --version; se ele imprimir um número de versão, o Claude Code já está disponível na sua máquina.
Login e primeiro teste depois de instalar
- Crie uma pasta vazia para um projeto de teste, abra o terminal dentro dela e digite apenas claude — na primeira execução, ele vai pedir para você autenticar com sua conta Anthropic.
- O login normalmente abre o navegador para você autorizar; se preferir usar a API, você cola sua chave (ANTHROPIC_API_KEY) e ele passa a consumir créditos por token em vez do plano Pro.
- Para o primeiro teste, peça algo simples e concreto como 'crie um arquivo README.md explicando esta pasta' — assim você vê o ciclo de propor ação, pedir aprovação e executar.
- Antes de cada ação que altera arquivos ou roda comandos, o Claude Code pede sua confirmação; aprovar passo a passo é a melhor forma de entender o que ele está fazendo logo após instalar.
Erros comuns de instalação e seus limites
- O erro mais frequente é 'command not found' depois de instalar: quase sempre é Node.js ausente ou desatualizado, ou a pasta de binários globais do npm fora do PATH do sistema.
- No Windows puro (sem WSL), alguns usuários relatam atritos com caminhos e permissões; se você travar, instalar o WSL e rodar o Claude Code de lá costuma resolver de uma vez.
- Instalar o Claude Code não substitui ter uma assinatura ativa: sem plano Pro ou chave de API com crédito, a ferramenta abre mas não consegue processar suas instruções de verdade.
- A instalação em si leva poucos minutos, mas lembre que o resultado depende das suas instruções — instalar é o passo fácil; descrever bem o que você quer construir é onde está o aprendizado real.
// Dado próprio ZX LAB
Na ZX LAB, instalamos o Claude Code em dezenas de máquinas de alunos sem fundo técnico — o gargalo nunca é o Claude Code em si, e sim ter o Node.js na versão certa antes. É o mesmo setup que usamos nos cursos de entrada de R$37.