Rodando o projeto na sua máquina pela primeira vez

Os arquivos do seu site existem. Estão na pasta do projeto, prontinhos. Mas até agora você só viu os nomes deles no terminal — não viu o site. É como ter um bolo na fôrma sem nunca ter tirado pra olhar. Chegou a hora de ligar o projeto e ver sua página aparecer no navegador pela primeira vez.

Prepare-se pro friozinho na barriga. É o primeiro "no ar" — mesmo que, por enquanto, só no seu computador.

A ideia: acender a luz de uma sala

Os arquivos do seu site são como uma sala montada, mas com a luz apagada. Está tudo lá — móveis, decoração — só que escuro. "Rodar o projeto" é acender a luz pra você finalmente enxergar a sala. Nada muda nos móveis; você só passa a ver.

Existem dois jeitos de acender essa luz num site simples. Em vez de decorar qualquer um, você vai usar o melhor atalho que tem: perguntar ao Claude.

O caminho mais fácil: pergunte ao Claude

Dentro do Claude Code, na pasta do seu projeto, faça a pergunta mais natural do mundo:

Como eu vejo esse site no navegador?

O Claude vai te dar o caminho certo pro seu projeto. Em geral, vai ser uma destas duas opções:

Opção A: abrir o arquivo direto no navegador

Para um site de uma página bem simples, às vezes basta abrir o arquivo index.html no seu navegador. O Claude pode até fazer isso por você. Se preferir na mão:

• No Mac: abra o Finder, ache a pasta do projeto, clique com o botão direito no index.html, escolha "Abrir com" e selecione seu navegador (Chrome, Safari, Edge...).
• No Windows: abra o Explorador de Arquivos, ache a pasta, clique com o botão direito no index.html, escolha "Abrir com" e selecione seu navegador.

O navegador abre e — pronto — seu site aparece.

Opção B: rodar um servidor local

Em projetos um pouquinho mais elaborados, o Claude pode sugerir rodar um servidor local. Parece técnico, mas a ideia é simples: é um programinha que "serve" seu site pra você ver direito no navegador. O Claude te dá o comando exato e, muitas vezes, roda pra você. Você vai ver na tela um endereço parecido com este:

http://localhost:3000

Copie esse endereço e cole na barra do navegador. Seu site aparece.

O que é "localhost"?

A palavra localhost quer dizer, literalmente, "este computador". Esse endereço http://localhost:... é um site rodando só na sua máquina. Ninguém mais no mundo consegue acessá-lo — nem seu vizinho, nem alguém do outro lado da cidade. É a sua sala de ensaio particular.

E aquele número no final (o :3000 do exemplo) é a porta — pense numa porta numerada do prédio onde seu site está atendendo. Você não precisa entender a fundo; só saber que faz parte do endereço.

Isso é ótimo: você pode testar, errar e mexer à vontade, porque o site ainda é só seu. Publicar pra todo mundo é um passo separado, que vem mais pra frente no curso.

O momento

Quando a página abrir e você vir seu nome lá, escrito por você, num site que você dirigiu — aproveite. Esse friozinho é o de quem saiu da plateia e entrou no jogo. Não é pouca coisa. A maioria das pessoas nunca chega aqui. Você chegou.

Se algo der errado

• "Abri e não aparece nada / página em branco." Não entre em pânico. Volte ao Claude Code e diga: "abri no navegador e a página está em branco, o que pode ser?". Descreva exatamente o que vê. Ele investiga e corrige.
• "Apareceu um aviso de 'porta ocupada' (port in use)." Significa que o número da porta já está sendo usado por outra coisa. É comum e fácil: peça "deu erro de porta ocupada, pode usar outra porta?". O Claude troca o número e te passa o novo endereço.
• "Copiei o endereço e o navegador diz que não encontrou." Confira se o servidor ainda está rodando no terminal (se você fechou o Claude Code ou apertou para parar, ele desliga). Se desligou, peça pra rodar de novo. E confira se copiou o endereço inteiro, com o número da porta no fim.

Seu site está vivo na sua máquina, rodando no localhost, pronto pra ser melhorado. No próximo post, a gente começa a deixar a página com a sua cara — ajustando textos, cores e detalhes, sempre conversando com o Claude.