Pular para o conteúdo
IA-OS // rodar-local
Curso de Introdução · Guia 2 de 3Rodar seu primeiro sistema no seu computador

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.

Seu computadorMeu computador é

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 dev continua 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-sistema e tente de novo.

Travou nesta etapa? Me conta o que aconteceu.