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.