ai2saveai2save

Node.js Tutorial de Instalação de Ambiente

Claude Code, Codex CLI, Gemini CLI e a maioria dos scripts de API dependem do Node.js. É recomendável instalar a versão LTS, mantendo a versão principal em 18 ou superior.

Windows

Método 1: Pacote Oficial de Instalação

Acesse nodejs.org, baixe o pacote de instalação LTS .msi, siga clicando em "Avançar" até concluir a instalação e mantenha a opção de adicionar automaticamente ao PATH.

Método 2: Chocolatey

choco install nodejs-lts -y

Método 3: Scoop

scoop install nodejs-lts

Verifique novamente após reabrir PowerShell:

node --version
npm --version

macOS

Método 1: Homebrew (Recomendado)

brew install node
node --version
npm --version

Método 2: Pacote de instalação oficial

Acesse nodejs.org para baixar o macOS .pkg, clique duas vezes para instalar e depois reabra o terminal.

Linux

Método 1: nvm (recomendado, sem necessidade de sudo, suporta múltiplas versões)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc  # para usuários do zsh use source ~/.zshrc
nvm install --lts
nvm use --lts
node --version
npm --version

Método 2: Gerenciador de Pacotes

# Debian / Ubuntu
sudo apt update
sudo apt install -y nodejs npm

# Fedora
sudo dnf install -y nodejs npm

Forma geral de instalar o CLI

npm install -g <package-name>

Se ocorrer um erro de permissão, verifique primeiro se o nvm ou a versão atual do Node está sendo aplicada corretamente; não é recomendável usar diretamente privilégios de administrador para sobrescrever diretórios do sistema. Após a instalação, use where node (Windows) ou which node (macOS/Linux) para confirmar o caminho.