← Tutoriais
SETUP · FERRAMENTAS · 3 MIN

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.

Para
quem está começando a construir com IA num Mac
Precisa
do Terminal e do Homebrew instalado
Tempo
3 minutos

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:

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.

FEITO PELO EDRA

Eu construo sites, automações e ferramentas de IA, e escrevo o que aprendo no caminho.

Mais tutoriais ↗