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.
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
- command not found: git. Não instalou ou o terminal ainda está no PATH antigo. Rode
brew install git, feche o terminal e abra um novo. - fatal: not a git repository. Você está numa pasta sem git. Entre na pasta do projeto e rode
git initprimeiro. - Pede usuário e senha no push. Você não terminou o
gh auth login. Rode de novo e escolha HTTPS + navegador.
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.
Eu construo sites, automações e ferramentas de IA, e escrevo o que aprendo no caminho.
Mais tutoriais ↗