Subindo seu projeto pro GitHub

Seu projeto está pronto e salvo no seu computador. Mas ele ainda mora só na sua máquina. Se o computador quebrar, some tudo. E ninguém além de você consegue ver. Hoje a gente muda isso: vamos levar seu código pra nuvem.

A ideia, com uma analogia

Pense no Git (a ferramenta que guarda o histórico do seu projeto) como um caderno de anotações que vive na sua mesa. Está tudo lá, organizado, mas é um caderno só, num lugar só.

O GitHub é como uma estante na biblioteca da cidade. Você sobe uma cópia do seu caderno pra lá. Agora ele está protegido (se sua mesa pegar fogo, a cópia continua na biblioteca) e acessível (você pega de qualquer lugar, de qualquer computador).

Levar o caderno da sua mesa pra estante da biblioteca tem um nome: push. Em inglês, "push" é empurrar, enviar. Você "empurra" seu código pra nuvem.

Passo 1: criar uma conta no GitHub

Se você ainda não tem, acesse https://github.com e crie uma conta gratuita. É de graça e leva dois minutos. Guarde bem o seu nome de usuário e a senha.

Passo 2: criar um repositório novo

Um repositório (ou "repo") é só o nome chique pra "a pasta do seu projeto guardada no GitHub".

1. Logado no GitHub, clique no botão verde New (Novo). Costuma ficar no canto superior, ao lado da sua foto, ou na página inicial.
2. Dê um nome pro repositório. Algo curto e sem espaços, tipo meu-primeiro-site.
3. Pode deixar como Public (público) — assim qualquer pessoa vê. Ou Private (privado), só você. Pra um projeto de aprendizado, público está ótimo.
4. Não marque nenhuma opção extra (como "Add a README"). Deixe o repositório vazio. Isso evita conflito com o que você já tem na sua máquina.
5. Clique em Create repository (Criar repositório).

Pronto. O GitHub vai te mostrar uma página com alguns comandos. Não se assuste. A gente vai usar dois deles.

Passo 3: conectar sua pasta local ao repositório

Aqui tem dois caminhos. Escolha um.

Caminho fácil: peça pro Claude Code

Abra o terminal na pasta do seu projeto, com o Claude Code rodando, e peça em português:

Conecte esta pasta ao meu repositório no GitHub e envie o código.
A URL do repositório é: <cole aqui a URL que o GitHub te mostrou>

A URL é aquele endereço que aparece na página do repositório, parecido com https://github.com/seu-usuario/meu-primeiro-site.git. O Claude faz o resto e te avisa se precisar de algo.

Caminho manual: dois comandos

Se preferir digitar você mesmo, são duas linhas. Digite uma, dê Enter, depois a outra.

git remote add origin https://github.com/seu-usuario/meu-primeiro-site.git

Essa linha diz: "ó, Git, o endereço da minha estante na biblioteca é esse aqui". origin é só um apelido pro endereço. Troque a URL pela sua.

git push -u origin main

Essa linha faz o envio de fato: empurra (push) seu código pro origin (a tal estante), no ramo principal chamado main. O -u só diz "lembra desse caminho pras próximas vezes", pra você só precisar digitar git push no futuro.

Passo 4: ver o código aparecer

Volte pra página do repositório no GitHub e atualize (F5). Seus arquivos vão estar lá, na tela, pra qualquer um ver. É um momento bom. Seu projeto saiu da sua mesa e entrou no mundo.

Se algo der errado

• Pediu login, usuário ou "token": o GitHub não aceita mais sua senha normal no terminal. Ele pede um token (uma senha especial). Quando travar, copie a mensagem inteira e cole pro Claude pedindo: "como eu gero e uso esse token?". Ele te guia passo a passo. É chato uma vez, depois nunca mais.
• Erro falando em master em vez de main: versões antigas chamavam o ramo principal de master. Se o comando reclamar, troque main por master na linha do push — ou só pergunte ao Claude "meu ramo é master ou main?".
• "remote origin already exists" (origin já existe): você rodou o primeiro comando duas vezes. Sem drama. Pule direto pro git push -u origin main.

Quando empacar, lembre: copie a mensagem de erro e cole pro Claude. Ele lê inglês de computador melhor que ninguém.

No próximo post, o grande momento: colocar esse projeto no ar pra qualquer pessoa do planeta abrir pelo navegador.