Baixar a demo

Entenda o que é rodar um sistema no seu computador e baixe a demo com um comando.

Meu computador é

Neste guia você vai ligar um sistema de verdade no seu próprio computador. Eu preparei um sistema pequeno, o Meu primeiro sistema: uma página que confere se o seu computador ficou pronto no guia anterior. Você baixa, liga, olha o resultado e, no fim, muda uma coisa nele com o Claude Code.

O que é rodar local

Um site que você abre na internet está ligado num servidor: um computador, em algum lugar, que fica esperando pedidos e mandando as páginas. Rodar local é fazer o seu próprio computador ser esse servidor. A página aparece no seu navegador, mas não sai do seu computador.

Duas palavras que vão aparecer:

localhost: quer dizer "este computador". Quando o endereço é http://localhost, o navegador fala com o seu próprio computador, não com a internet.
Porta: um número que separa um programa do outro dentro do mesmo computador. A demo usa a porta 3000, por isso o endereço dela vai ser http://localhost:3000.

Por que começar por aqui: é grátis, ninguém mais vê, e você pode errar à vontade. Se algo quebrar, você baixa de novo e pronto.

Abrir o terminal

NO WINDOWS

Abra o Windows PowerShell pelo menu Iniciar (o mesmo do guia anterior, não o CMD). Ele já abre na sua pasta de usuário: a linha começa com algo como PS C:\Users\voce>. É ali que a demo vai ficar.

NO MAC

Abra o Terminal (Cmd + Espaço, digite Terminal). Ele já abre na sua pasta de usuário, a pasta com o seu nome. É ali que a demo vai ficar.

Baixar

Este comando é igual nos dois sistemas. Ele usa o Git para copiar a demo da internet para uma pasta nova chamada meu-primeiro-sistema, dentro da sua pasta de usuário (é para lá que o cd ~ leva o terminal). Cole um comando por vez e aperte Enter:

cd ~
git clone --depth 1 --branch v1 https://github.com/idearagencia/primeiro-sistema.git meu-primeiro-sistema

O que cada pedaço faz, sem precisar decorar:

git clone copia um projeto do GitHub (o site onde o código fica guardado).
--depth 1 baixa só a versão atual, sem o histórico antigo. Fica mais rápido.
--branch v1 pega a versão v1, a que este guia usa. Assim o que você vê bate com o que está escrito aqui.
meu-primeiro-sistema é o nome da pasta que vai ser criada.

No fim, o Git escreve um texto comprido em inglês que fala de detached HEAD. Pode ignorar: quer dizer só que a pasta ainda não tem uma branch, a linha do histórico onde o Git guarda as suas mudanças. Na próxima etapa, o npm run comecar cria essa linha, chamada main.

Agora entre na pasta (igual nos dois sistemas):

cd meu-primeiro-sistema

O cd quer dizer "entrar na pasta". Daqui em diante, todo comando do guia é digitado dentro dessa pasta.

Não deu certo? Veja o que fazer

"already exists and is not an empty directory": a pasta meu-primeiro-sistema já existe, porque você baixou antes. Se não fez nada nela que queira guardar, entre nela com cd meu-primeiro-sistema e siga para a próxima etapa. Se quiser começar do zero, baixe com outro nome no fim do comando, por exemplo meu-primeiro-sistema-2, e use esse nome no cd.
"Could not resolve host" ou "unable to access": o computador não conseguiu falar com o GitHub. Confira se a internet está funcionando (abra um site qualquer no navegador) e rode o comando de novo.
"git não é reconhecido" ou "command not found: git": o Git não está instalado, ou o terminal foi aberto antes da instalação. Feche o terminal e abra de novo. Se continuar, volte à etapa Preparar o notebook do guia Preparar o computador e instale o Git.
"not a git repository": você rodou o git status fora da pasta. Rode cd meu-primeiro-sistema e tente de novo.

Travou nesta etapa? Me conta o que aconteceu.