Setup Completo: do zero ao Claude Code · Capítulo 18 de 18 · 5 min
Instale o Node.js quando um site exigir (apêndice)
Projetos em React, Next.js ou JavaScript pedem o Node; o instalador nativo do Claude Code nunca precisou dele.
Este capítulo faz parte do curso gratuito Setup Completo: do zero ao Claude Code.
Você já colocou o Claude Code para rodar pelo instalador nativo, que dispensa o Node. Então por que este apêndice existe? Para o dia em que o projeto precisar de ferramentas de frontend e web (React, Next.js, um site) ou de scripts em JavaScript/TypeScript. O Node.js é a plataforma que traz o npm, uma espécie de loja de aplicativos para desenvolvedores. Se hoje o seu trabalho não passa por isso, pode pular e voltar quando precisar. Suponha uma pet shop que decide ter uma loja virtual em Next.js: esse é o dia de instalar o Node.
Quando chegar a hora, baixe o instalador pelo Chrome
- 01No Chrome, vá em nodejs.org
- 02Na página inicial você vê dois botões grandes: clique no botão da esquerda escrito "LTS" (significa "versão estável e recomendada", hoje a linha 24.x, e evita bugs).
- 03O arquivo
node-vXX.XX.X-x64.msicomeça a baixar. - 04Clique no arquivo na barra de Downloads do Chrome.
Depois, rode o instalador (é simples, só "Next, Next, Next") e confira o fim: quando surgir a tela "Completed the Node.js Setup Wizard", terminou.
- 01Tela de boas-vindas → Next.
- 02Aceite o contrato de licença → Next.
- 03Pasta de instalação (não mude) → Next.
- 04Custom Setup → Next (deixe como está).
- 05Tela "Tools for Native Modules": DEIXE A CAIXINHA DESMARCADA. Não vamos compilar nada em C++, e marcar essa opção instala 4 GB de coisa que você não vai usar. Next.
- 06Install → se o Windows pedir, clique em Sim.
- 07Aguarde 1-2 minutos.
- 08Finish.
Já tem Node antigo instalado de algum tempo atrás? Pode reinstalar por cima sem problema: o instalador atualiza para a versão nova automaticamente.
INTERNET npm (loja) SEU PC
┌───────────┐ ┌──────────────────────┐
│ Anthropic │ publica pacote │ │
│ servers │ ─────────────────────────▶ │ npm install -g │
│ │ @anthropic-ai/claude-code │ @anthropic-ai/ │
└───────────┘ │ claude-code │
│ │ │
│ ▼ │
│ C:\...\claude.exe │
│ (disponível em │
│ todo o sistema) │
└──────────────────────┘
Node.js traz o npm, que baixa pacotes. Instalar o Claude Code por aqui
é o caminho avançado; o padrão recomendado é o instalador nativo, que
dispensa o Node por completo.┌─────────────────────────────────────────────────────────────────┐ │ Node.js Setup — □ × │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Tools for Native Modules │ │ ───────────────────────────────────────────────────── │ │ │ │ Automatically install the necessary tools. Note that │ │ this will also install Chocolatey. The script will pop-up │ │ in a new window after the installation completes. │ │ │ │ [ ] Automatically install the necessary tools (optional) │ │ ← DEIXE DESMARCADO — instalaria 4 GB que você não usa. │ │ │ │ [< Back] [Next >] [Cancel] │ │ │ │ ✓ Caixinha DESMARCADA → clique Next → Install → Finish. │ └─────────────────────────────────────────────────────────────────┘
Feche o instalador em Finish, abra um terminal novo e digite node --version. Acertou se aparece um número começando por v22 ou mais alto, o mínimo que o caminho npm do Claude Code exige. Número menor? Baixe de novo o botão LTS e reinstale por cima.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Frontend vs Backendsugerido pelo grafoApresenta o conceito “Node.js”, usado em “Instale o Node.js quando um site exigir (apêndice)”.
- Introdução ao Next.jssugerido pelo grafoApresenta o conceito “Next.js”, usado em “Instale o Node.js quando um site exigir (apêndice)”.
- O que é JavaScriptsugerido pelo grafoApresenta o conceito “JavaScript”, usado em “Instale o Node.js quando um site exigir (apêndice)”.
- CursoGitHub: Controle de Versão do Zerosugerido pelo grafo6 capítulos de “Setup Completo: do zero ao Claude Code” usam conceitos apresentados em “GitHub: Controle de Versão do Zero”.
Depois, siga para
- CursoClaude Code CLI: Programação com IA
- CursoAgentes de código para executivossugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoSetup de Vibecoding no Macsugerido pelo grafo11 capítulos de “Setup de Vibecoding no Mac” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo7 capítulos de “Vídeo com IA: Claude Code, Codex e ElevenLabs” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacInstalar o Node.jsExaminar conexões de Instalar o Node.js
- Node.js: JavaScript no ServidorInstalação do Node.js e npmExaminar conexões de Instalação do Node.js e npm
- Claude Code CLI: Programação com IAInstalar o Claude Code e fazer o primeiro acesso sem o TIExaminar conexões de Instalar o Claude Code e fazer o primeiro acesso sem o TI
Voltar ao capítulo anterior: Instale o Python só quando o projeto pedir (apêndice)
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Setup Completo: do zero ao Claude Code
- 14Crie automações que disparam sempre (avançado, opcional)
- 15Divida tarefas grandes entre Claudes ajudantes (avançado, opcional)
- 16Publique sua página de apresentação profissional na internet
- 17Instale o Python só quando o projeto pedir (apêndice)
- 18Instale o Node.js quando um site exigir (apêndice)