Instalar o Node.js no seu Mac
Você está seguindo um tutorial, chega num passo que diz npm install something,
e o terminal te trava: command not found: node ou
npm: command not found. Você não quebrou nada. Só
está faltando o Node.js. Você instala uma vez e ele fica.
O Node.js é o que deixa o JavaScript rodar fora do navegador: na sua
própria máquina, no terminal. O Node vem com o npm, o gerenciador
que você usa pra instalar pacotes e ferramentas escritas em JavaScript (incluindo um
monte de ferramentas de IA). Direto ao ponto: sem o Node, metade da internet de dev
não inicia no seu Mac.
Se você ainda não tem o Homebrew, instale ele primeiro. É uma linha só e é a base pra todo o resto. Aqui está o passo a passo: instalar o Homebrew.
Instalar
Com o Homebrew já configurado, o Node é uma linha. Cole no Terminal e aperte Enter:
brew install node
Leva uns dois minutos. Isso instala a versão estável mais recente do
Node e o npm junto, então você não precisa instalar os dois
separados.
Conferir se funcionou
Rode estas duas linhas. Se cada uma te devolver um número de versão, está pronto:
node --version
v22.11.0
npm --version
10.9.0 Os números exatos não importam, desde que apareçam. Esse par de versões é toda a confirmação que você precisa.
Se ainda disser command not found
Duas causas comuns, as duas rápidas:
- Terminal desatualizado. A instalação terminou, mas o seu terminal ainda está no PATH antigo. Feche, abra um novo e tente de novo.
- O Homebrew não está no PATH. Num Mac com Apple Silicon (M1 até M4), o Homebrew precisa de duas linhas extras pra que o terminal consiga encontrá-lo. Elas estão no tutorial do Homebrew, na seção sobre o passo que quase todo mundo pula.
Pronto pro próximo passo
Com o Node e o npm funcionando, agora você consegue instalar ferramentas escritas em JavaScript com uma linha só. Uma delas é o Claude Code, o agente de IA que vive no seu terminal e escreve código com você: instalar o Claude Code.
Eu construo sites, automações e ferramentas de IA, e escrevo o que aprendo no caminho.
Mais tutoriais ↗