← A Trilha
🚧
Rascunho · pendente de revisão humana
Esta página foi gerada com IA e ainda não foi revisada por uma pessoa. O conteúdo pode mudar bastante.

🌐 GitHub: leve seu projeto pra nuvem

O histórico do Capítulo 3 ainda mora só no seu computador. Aqui ele ganha uma cópia na nuvem: backup se o PC morrer, abrir de outro computador e compartilhar.

🎯 O que você vai ter no final

O seu projeto inteiro (arquivos + histórico) guardado no GitHub, na nuvem. Se o computador morrer, nada se perde; dá pra abrir de outro lugar; e dá pra mandar o link pra alguém ver ou ajudar. Reserve uns 15 a 25 minutos na primeira vez.

É o Capítulo 4, e ele resolve o buraco que o Capítulo 3 deixou: "o histórico está só no seu computador".

Uma coisa importante logo de cara: "estar no GitHub" não é o mesmo que "estar publicado como site". Aqui você guarda o projeto na nuvem (um cofre com o código e o histórico); ainda não é uma página que abre no navegador pra qualquer um. Transformar em site público é o próximo capítulo (o Pages). Um passo de cada vez.

💡 A ideia central Pense no GitHub como um backup na nuvem do projeto inteiro, tipo o Google Drive, mas feito sob medida pra código: ele guarda os arquivos e todo o histórico de versões (as "fotos" do Capítulo 3). A cópia na nuvem chama repositório. Com ela, seu trabalho deixa de depender de um computador só.
💻 Seu sistema

Já vem marcado o seu sistema — se estiver errado, é só trocar aqui. Muda só a parte de instalar o GitHub CLI; o resto (conta, repositório, envio) é igual.

1

Criar a conta no GitHub

grátis, sem cartão; uma vez na vida

O GitHub é o serviço onde seu projeto vai morar na nuvem. A conta é grátis e não pede cartão.

  1. 1Vá em github.com/signup e crie a conta com e-mail, uma senha e um nome de usuário.
  2. 2Confirme o e-mail. Pode escolher o plano Free, que serve de sobra.
🔑 Use uma senha exclusiva dessa conta e, se puder, ligue a verificação em duas etapas. É onde seu trabalho vai ficar guardado.
✅ Você deve ter: uma conta no GitHub, logada no navegador. Anote seu nome de usuário (vai aparecer no endereço do seu projeto).
2

Instalar o GitHub CLI e conectar sua conta

só na 1ª vez; é o que permite enviar sem digitar senha

Pra qualquer coisa sair do seu computador pro GitHub, o seu computador precisa provar que é você. Quem cuida disso é uma ferramentinha oficial do GitHub chamada GitHub CLI (o "gh"): você instala uma vez, conecta sua conta pelo navegador, e a autorização fica guardada em segurança na sua máquina. Depois disso, é só pedir em português — sem senha, sem código, nunca mais.

2.1 — Instalar o gh. só na 1ª vez

  1. 1Baixe o instalador do Windows em cli.github.com (o botão de download pega o .msi).
  2. 2Abra o instalador e vá avançando ("Next") — os padrões servem.
  3. 3Feche e reabra o Claude Desktop inteiro (o app, não só a sessão), pra ele enxergar o gh — igual você fez com o Git no Capítulo 1.

2.2 — Conectar sua conta. só na 1ª vez Agora peça pra IA conectar você — sem copiar senha nem token na mão, ela abre um login pelo navegador:

Prompt · conectar o GitHub
Conecta minha conta do GitHub usando o gh (gh auth login), pelo navegador. Me mostra o código e o endereço pra eu autorizar.

A IA vai mostrar um código curto (tipo AB12-CD34) e o endereço github.com/login/device. Abra esse endereço no navegador (você já está logado do passo 1), cole o código e clique em autorizar. Pronto: a IA fica conectada à sua conta, guardada com segurança na sua máquina.

✅ Sinal de que deu certo: a IA confirma algo como "autenticado como seu-usuário". Você não digitou senha nem token em lugar nenhum — só autorizou no site do GitHub.
💡 Por que pelo navegador, e não com senha?
Esse login é um OAuth: o GitHub confirma que é você e entrega pra ferramenta uma autorização limitada, guardada com segurança no seu computador, sem a sua senha passar pela conversa. É o mesmo tipo de "entrar com sua conta" que você já usa em vários apps. Dá pra revogar quando quiser, nas configurações do GitHub. ⚠️ E fica a regra pra sempre: senha se digita no site, nunca numa conversa — se alguma ferramenta pedir a sua senha na conversa, desconfie.
3

Criar o repositório no GitHub

o "cofre" vazio, feito por você, no site

Antes de mandar qualquer coisa, o projeto precisa de um lugar na nuvem. Esse lugar chama repositório, e você mesmo vai criar — assim fica claro o que ele é, em vez de aparecer pronto do nada.

  1. 1Vá em github.com/new (ou clique no + no canto superior direito do GitHub e escolha "New repository").
  2. 2Em Repository name, dê um nome sem espaços e sem acento, tipo primeira-pagina.
  3. 3Marque Private importante — assim só você vê. Dá pra tornar público depois, quando quiser mostrar pra alguém.
  4. 4Não marque nada nas opções de baixo ("Add a README file", .gitignore, license). O repositório precisa nascer vazio pra receber o que já está no seu computador.
  5. 5Clique em Create repository. Na tela que abrir, copie o endereço que começa com https:// e termina em .git.
⚠️ Copie o endereço https://, não o outro. O GitHub oferece dois formatos, e o que começa com git@ exige uma configuração extra que você não fez. O https:// funciona com o login que você já fez no passo 2.
✅ Você deve ter: uma página de repositório vazia, com um cadeado de "Private" ao lado do nome, e o endereço copiado.
4

Associar seu projeto ao repositório e mandar tudo

uma frase, e o que está no seu PC aparece lá

Agora é juntar as duas pontas — a pasta do projeto no seu computador e esse repositório vazio na nuvem (é o que se costuma chamar de "linkar"). Na conversa aberta na pasta do seu projeto (aquela com o histórico do Capítulo 3), peça, colando o endereço que você copiou no lugar do exemplo:

Prompt · associar e enviar
Associa este projeto ao repositório https://github.com/seu-usuario/primeira-pagina.git e envia tudo pra lá, com o histórico.

A IA faz a associação e manda os arquivos. Ela pode pedir sua permissão no caminho: aceite.

⚠️ Se der erro dizendo que o envio foi "rejeitado": quase sempre é porque o repositório não nasceu vazio (alguma opção ficou marcada no passo 3). O jeito mais simples é apagar esse repositório no GitHub e criar outro, agora sem marcar nada. Se preferir, cole o erro na conversa e peça pra IA resolver.
✅ Sinal de que deu certo — e confira você mesmo: volte na página do repositório no GitHub e atualize. Onde antes estava vazio, agora estão os seus arquivos. Não fique só no "a IA disse que enviou": veja com seus olhos.
🔑 A partir de agora seu projeto tem duas cópias

Esse é o conceito que faz todo o resto fazer sentido:

  • 💻A do seu computador, na pasta onde você trabalha. É onde as mudanças acontecem primeiro, sempre.
  • ☁️A do GitHub, na nuvem. É o backup, e é o que outra pessoa (ou outro computador) enxerga.

⚠️ E o principal: elas não se atualizam sozinhas. Mudou no computador, a cópia da nuvem continua igual até você mandar. Por isso, quando quiser guardar o trabalho lá, o pedido é sempre "envia pro GitHub" — e a conferência é abrir o site e olhar.

5

O hábito daqui pra frente

o "envia pro GitHub" do dia a dia

Na página do repositório, clicando em algo como "commits", você encontra o mesmo histórico que criou no Capítulo 3, agora na nuvem. Cada ponto que você salvou está ali, com a data e o que mudou.

🎉 Está na nuvem. Seu projeto não depende mais de um computador só: se o PC morrer, é só baixar de volta do GitHub; dá pra abrir de outro lugar; e, tornando público, dá pra mandar o link pra alguém ver ou ajudar.

Daqui pra frente, sempre que você salvar um ponto e quiser guardar na nuvem também, é uma frase só:

Prompt · atualizar a nuvem
Salva um ponto no histórico e envia pro GitHub.

Salvar (no PC) e enviar (pra nuvem) são dois gestos, e é por isso que o pedido junta os dois numa frase: um guarda perto, o outro guarda longe. Na dúvida se chegou, você já sabe o que fazer — abre o repositório e olha.

🔜 O que ficou de fora de propósito

Este é o Capítulo 4. Seu projeto está na nuvem, mas ainda não é um site que qualquer um abre. Os próximos passos:

De onde saiu cada afirmação (verificado em 30/07/2026):