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

ETAPA 4 DE 4 20 MIN

Tarefa: mudar com o Claude

Peça ao Claude Code para explicar a demo e colocar o seu nome na tela, e guarde a mudança com um commit.

Seu computadorMeu computador é

Até aqui você usou comandos fixos. Agora entra o Claude Code: ele vai explicar o projeto e mudar uma coisa pequena na tela, do jeito que você aprendeu no guia anterior: desenho, plano e só depois a construção.

A mudança: colocar o seu nome no texto de parabéns, logo abaixo do título Seu computador está pronto!.

Abrir o Claude na pasta

Deixe o npm run dev ligado na primeira janela, para ver a mudança depois de recarregar a página. Abra uma terceira janela do terminal (a segunda, a do conferir, também fica aberta), entre na pasta e abra o Claude, um comando por vez:

cd ~/meu-primeiro-sistema
claude

Se ele perguntar se confia nesta pasta, responda que sim: é a pasta meu-primeiro-sistema, que você mesmo baixou.

Pedir uma explicação

Antes de mudar qualquer coisa, entenda o que tem ali. Escreva e aperte Enter:

Explique este projeto em linguagem simples

Ele lê os arquivos (pode pedir licença para isso: leia e responda Yes) e conta para que serve cada parte. Pergunte o que não entender: não existe pergunta boba aqui.

Pedir a mudança

Agora o pedido, já pedindo o desenho e o plano antes. Troque Seu Nome pelo seu nome, copie a linha inteira, cole e aperte Enter:

Quero que o texto logo abaixo de "Seu computador está pronto!" comece com "Parabéns, Seu Nome!". Não mude o título. Antes de mudar, me mostre o desenho e o plano e espere eu aprovar.

O que deve acontecer:

  1. O Claude mostra o desenho e o plano: qual arquivo vai mudar e como. Leia. Se estiver bom, responda pode fazer.
  2. Ele pede licença para mudar os arquivos. Confira o que ele quer mudar e responda Yes. Ele pode mudar também um teste, o arquivo que confere esse texto: é esperado.
  3. Pelas regras do CLAUDE.md, ele roda npm run check e npm run test:run para conferir o que fez. Ele pede licença para rodar: responda Yes.

Quando ele terminar, recarregue a página da demo no navegador (F5 no Windows, Cmd + R no Mac). O título continua Seu computador está pronto! e o texto logo abaixo agora começa com Parabéns, seguido do seu nome.

Na janela do conferir (ou numa janela livre, dentro da pasta), rode npm run conferir de novo: a última linha continua começando com Seu computador está pronto!, agora com o seu nome logo depois. Se você ligou a demo em outra porta, use a mesma no conferir: no Windows, a janela do conferir já guarda o $env:PORT que você rodou nela; no Mac, rode PORT=3001 npm run conferir.

Guardar a mudança com um commit

Um commit é uma foto do projeto que o Git guarda, com uma frase dizendo o que mudou. Se um dia algo quebrar, você volta para essa foto.

Saia do Claude com /exit. Primeiro veja o que mudou:

git status

A primeira linha é On branch main: você está na branch main, a que o npm run comecar criou. Abaixo, ele lista os arquivos alterados, em vermelho. Devem ser os que o Claude disse que ia mudar, e nada além. Então guarde, um comando por vez:

git add -A
git commit -m "Meu nome na tela"

O git add -A escolhe todas as mudanças para a foto, e o git commit tira a foto com a frase entre aspas.

Não deu certo? Veja o que fazer
  • O Claude mudou coisa demais (arquivos que você não esperava no git status): desfaça tudo que ainda não foi guardado com git restore . (o ponto no fim faz parte do comando) e peça de novo, menor e mais claro, por exemplo: "Mude só o texto de parabéns, nada mais". Se ele tiver criado um arquivo novo, o git status ainda mostra esse arquivo: peça ao Claude para apagá-lo.
  • Apareceu que você bateu o limite do plano: o limite do Pro renova sozinho depois de algumas horas, e o aviso diz quando. Espere e continue de onde parou: nada do que já foi feito se perde.
  • O commit foi recusado com "Author identity unknown" ou "Please tell me who you are": o Git ainda não sabe o seu nome. Faça a parte Dizer ao Git quem é você da etapa Preparar o notebook do guia anterior e rode o git commit de novo.
  • A tela não mudou depois de recarregar: veja se a janela do npm run dev continua ligada e se o Claude disse que terminou. Peça a ele: "Confira se o texto de parabéns da tela já tem o meu nome".
  • A tela mostra um erro, ou o conferir diz "O servidor respondeu com erro": a mudança quebrou alguma coisa. Rode git restore . para voltar como estava, recarregue a página e peça de novo ao Claude, menor.

Travou nesta etapa? Me conta o que aconteceu.