ETAPA 3 DE 4 15 MIN
Conferir o computador
Leia o que a tela da demo diz sobre o seu computador e resolva o que estiver faltando.
A tela da demo confere, item por item, se o seu computador ficou pronto no guia anterior. Ela roda sozinha quando a página abre: os itens começam em CONFERINDO… e se preenchem em alguns segundos. Na primeira vez, se algum item não respondeu a tempo, a tela confere de novo sozinha, uma vez.
Como ler cada item
Cada item tem um selo com uma palavra (a cor nunca é o único sinal):
- OK: está tudo certo.
- FALTA: não está instalado ou não está certo. Tem um link Como resolver.
- ATENÇÃO: funciona, mas tem uma recomendação. Também tem Como resolver.
- NÃO CONSEGUI CONFERIR: a demo não conseguiu saber, por exemplo porque um programa demorou demais para responder. Não quer dizer que falta: quer dizer que ela não sabe.
No topo, uma barra conta quantos itens que contam estão OK. Alguns itens são só recomendação (como o editor) e não seguram o "pronto".
Os quatro grupos
Ferramentas. Os programas que você instalou no guia anterior: o Node.js (o motor que roda o sistema), o Git (guarda cada versão do código), se o Git sabe quem é você (o nome que vai em cada mudança guardada), o Claude Code e o editor (VS Code, opcional).
Skills. Os cinco plugins que eu uso todo dia: superpowers, frontend-design,
code-review, security-guidance e skill-creator. Eles fazem o Claude trabalhar em ordem,
caprichar nas telas, revisar o código e avisar de falhas de segurança.
Segurança. O que protege você desde o primeiro dia:
- Cabeçalhos de proteção: regras que a página manda ao navegador para se defender de ataques comuns, como outro site tentar mostrar a sua página dentro dele.
- Só o seu computador enxerga: o servidor só atende quem está neste computador. Ninguém na mesma rede (no café, no trabalho) consegue abrir a sua demo.
- Segredos fora do Git: senhas e chaves ficam num arquivo chamado
.env, e o Git está configurado para nunca guardar esse arquivo. Assim um segredo não vaza junto com o código. - Pasta é sua: a pasta não está mais ligada ao meu repositório no GitHub.
Performance. Página abre rápido mede, no seu navegador, quanto tempo a página levou para
aparecer. Ele não segura o "pronto": a primeira abertura no modo de desenvolvimento (o jeito como o
npm run dev liga o sistema, feito para você mexer nele) é sempre mais lenta.
Item com FALTA ou ATENÇÃO
Clique em Como resolver, ao lado do item. O link abre a etapa do curso que resolve aquilo. Faça o que ela manda e recarregue a página da demo (F5 no Windows, Cmd + R no Mac): ela confere de novo.
Item com NÃO CONSEGUI CONFERIR
Primeiro, recarregue a página: quase sempre o programa só demorou na primeira vez. Se continuar, confira à mão numa janela do terminal. Cada comando responde uma linha quando o programa está instalado:
git --version
node -v
claude --version
E, para as skills, claude plugin list mostra a lista de plugins instalados.
Conferir pelo terminal
Dá para ver o mesmo resultado no terminal. A janela do npm run dev está ocupada, então abra
outra janela do terminal, entre na pasta e rode o conferir, um comando por vez:
cd ~/meu-primeiro-sistema
npm run conferir
Ele mostra cada item numa linha, com [OK], [FALTA], [!] (atenção) ou [?] (não consegui
conferir), e no fim a mesma frase do topo da tela. Deixe essa janela aberta: ela vai ser útil na
próxima etapa.
Se você ligou a demo em outra porta na etapa anterior, o conferir precisa saber. Sem isso ele procura a demo na porta 3000:
NO WINDOWS
Nessa janela nova, rode antes a mesma porta, um comando por vez:
$env:PORT = "3001"
npm run conferir
A porta fica valendo nessa janela: da próxima vez, basta npm run conferir.
NO MAC
Rode o conferir com a mesma porta:
PORT=3001 npm run conferir
Use sempre assim, com o PORT=3001 na frente.
Não deu certo? Veja o que fazer
- Skills com FALTA: falta instalar um ou mais plugins. Volte à etapa Instalar as skills do guia anterior e depois recarregue a página.
- Claude Code com FALTA, mesmo você tendo instalado: ele provavelmente foi instalado de outro
jeito, pelo
npm. A demo só reconhece o instalador oficial: volte à etapa Instalar o Claude Code do guia anterior e instale pelo comando oficial. - "Página abre rápido" em ATENÇÃO (amarelo): recarregue a página. A primeira abertura é sempre mais lenta; da segunda em diante fica rápida. Esse item não segura o "pronto".
- "Pasta é sua" em ATENÇÃO: a pasta ainda aponta para o meu repositório. Rode
npm run comecar(numa janela livre, dentro da pasta) e recarregue a página. - "O servidor está desligado": o conferir não achou a demo. Veja se a janela do
npm run devcontinua ligada e, se você mudou a porta, use a mesma porta no conferir (o aviso logo acima). - "Missing script: conferir": a janela nova está fora da pasta. Rode
cd meu-primeiro-sistemae tente de novo.
Travou nesta etapa? Me conta o que aconteceu.




