← Tutoriais
SETUP · FERRAMENTAS · 6 MIN

Git e GitHub do zero

Você construiu algo com o Claude, funciona, e quer salvar ou colocar online. Todo mundo diz "sobe pro GitHub", mas você nunca usou git e o terminal te joga fatal: not a git repository na cara. Vamos passo a passo.

Para
qualquer pessoa que constrói com IA e ainda não usa controle de versão
Precisa
do Terminal, do Homebrew e de uma conta no GitHub (grátis)
Tempo
6 minutos

São duas coisas diferentes que costumam andar juntas. O Git é o controle de versão: ele mantém o histórico do seu projeto na sua própria máquina, salva "fotos" (commits) de como o código estava em cada ponto, e deixa você voltar atrás se algo quebrar. O GitHub é o site onde você sobe esse projeto para guardar na nuvem, compartilhar e conectar a ferramentas como o Vercel. Em termos simples: git é o histórico, GitHub é o site online.

Verifique se você já tem git

No Mac ele costuma vir pré-instalado. Primeiro peça a versão:

git --version
git version 2.45.0

Se aparecer um número, está tudo certo. Se não, instale com o Homebrew (uma linha):

brew install git

Diga ao git quem você é

Todo commit carrega seu nome e e-mail. Você configura uma vez, para todos os seus projetos. Use o mesmo e-mail que vai usar para abrir a conta no GitHub:

git config --global user.name "Seu Nome"
git config --global user.email "voce@email.com"

Abra sua conta no GitHub

Vá em github.com e crie uma conta grátis. Anote seu nome de usuário, porque seus projetos vão ficar em github.com/seu-usuario/seu-projeto.

Conecte o terminal ao GitHub (do jeito fácil)

Para subir as coisas, seu terminal precisa se identificar pro GitHub. O caminho mais simples é a ferramenta oficial gh. Instale e faça login:

brew install gh
gh auth login

Ela faz algumas perguntas. Escolha GitHub.com, depois HTTPS, e quando oferecer "Login with a web browser", aceite: o navegador abre, você confirma, e pronto. Sem briga com senhas nem colar tokens na mão.

Suba seu primeiro projeto

Entre na pasta do seu projeto e crie o repositório local com três linhas: inicializa, adiciona tudo, e salva a primeira foto.

cd meu-projeto
git init
git add .
git commit -m "first commit"

Agora crie o repo no GitHub e suba, tudo de uma vez, com o gh:

gh repo create meu-projeto --source=. --public --push

Isso cria github.com/seu-usuario/meu-projeto e sobe seu código para lá. Troque --public por --private se não quiser ninguém vendo ainda.

O loop do dia a dia

Daqui pra frente, toda vez que você avançar, salva e sobe as mudanças com três linhas:

git add .
git commit -m "o que eu mudei"
git push

Se algo falhar

Com isso você já tem o básico: histórico local com git e uma cópia online no GitHub. É a base para colocar seu site no Vercel e para quase qualquer fluxo com IA.

FEITO PELO EDRA

Eu construo sites, automações e ferramentas de IA, e escrevo o que aprendo no caminho.

Mais tutoriais ↗