# Configurar Git GitHub: guia completo do zero em 5 passos

> O guia "Configurar Git GitHub: guia completo do zero em 5 passos" ensina a instalação do Git, configuração de nome de usuário e e-mail, criação de chave SSH e realização do primeiro push para o GitHub. O tutorial permite configurar o ambiente de versionamento em menos de 15 minutos, seguindo cinco passos práticos e diretos para iniciantes.

*Blog Sem Juízo · Novidades · 01 de julho de 2026 · Sol Henriques*

Quer configurar Git e GitHub, mas não sabe por onde começar? Este guia cobre a instalação, configuração de nome de usuário e e-mail, chave SSH e o primeiro push. Em menos de 15 minutos, você estará versionando projetos.

Todo mundo já ouviu: "Git é essencial para programar." É mito? Não. Git é o sistema de controle de versão mais usado, e GitHub é onde os projetos vivem online. A boa notícia: configurar Git e GitHub do zero leva menos de 15 minutos. Este guia mostra o passo a passo, com os comandos exatos e os erros que todo iniciante comete.

## Passo 1: Instalar o Git

O Git não vem instalado no Windows nem no macOS. Baixe o instalador em [git-scm.com](https://git-scm.com), a versão mais recente é sempre a recomendada. Durante a instalação, aceite as opções padrão, mas preste atenção na tela "Choosing the default editor": escolha um editor que você conheça (VS Code ou Nano).

**Dica:** No Linux (Ubuntu/Debian), use sudo apt install git. No macOS, pode usar o Homebrew: brew install git.

**Erro comum:** Pular a instalação do Git Bash. No Windows, o Git Bash é o terminal que permite rodar comandos Unix. Use-o, não o CMD.

## Passo 2: Criar uma conta no GitHub

Acesse [github.com](https://github.com) e clique em "Sign up". Escolha um nome de usuário profissional, algo como seunome-dev. Use um e-mail que você verifica com frequência. Após o cadastro, confirme o e-mail clicando no link enviado.

**Dica:** Ative a autenticação de dois fatores (2FA) nas configurações de segurança. É rápido e evita dores de cabeça.

**Erro comum:** Usar o mesmo e-mail do trabalho para conta pessoal. Separe contas profissional e pessoal para evitar conflitos de acesso.

## Passo 3: Configurar nome de usuário e e-mail no Git

Abra o Git Bash (ou terminal) e rode:

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

Use o mesmo nome e e-mail da sua conta GitHub. O --global aplica a configuração para todos os repositórios do seu computador. Se quiser configurar apenas um repositório, remova --global.

**Dica:** Para verificar se deu certo: git config --list. Isso mostra todas as configurações ativas.

**Erro comum:** Digitar o e-mail errado. O Git associa cada commit ao e-mail configurado. Um erro aqui e seus commits aparecem sem foto no GitHub.

## Passo 4: Configurar chave SSH (autenticação sem senha)

A chave SSH evita digitar senha toda vez que você faz push ou pull. No terminal, rode:

ssh-keygen -t ed25519 -C "seuemail@exemplo.com"

Pressione Enter para aceitar o local padrão (~/.ssh/id_ed25519). Quando pedir uma passphrase, você pode deixar vazia (menos seguro) ou criar uma (mais seguro). Depois, exiba a chave pública:

cat ~/.ssh/id_ed25519.pub

Copie o conteúdo (começa com ssh-ed25519 e termina com seu e-mail). Vá no GitHub, clique na sua foto > Settings > SSH and GPG keys > New SSH key. Cole a chave e salve.

**Dica:** Teste a conexão com ssh -T git@github.com. Se aparecer "Hi seu-usuario! You've successfully authenticated", pronto.

**Erro comum:** Copiar a chave privada (id_ed25519) em vez da pública (id_ed25519.pub). A chave privada nunca deve ser compartilhada.

## Passo 5: Criar e enviar o primeiro repositório

No GitHub, clique no botão "+" > New repository. Dê um nome (ex: meu-primeiro-repo), deixe público e **não** marque "Initialize this repository with a README", você vai criar o README local.

No terminal, crie uma pasta e inicialize:

mkdir meu-primeiro-repo cd meu-primeiro-repo git init echo "# Meu primeiro repositório" > README.md git add README.md git commit -m "Primeiro commit" git branch -M main git remote add origin git@github.com:seu-usuario/meu-primeiro-repo.git git push -u origin main

**Dica:** O -u do último comando define o branch main como padrão. Nos próximos pushes, basta git push.

**Erro comum:** Usar master em vez de main. Desde 2020, o GitHub usa main como branch padrão. Se der erro, verifique o nome do branch com git branch.

## Checklist: o que você fez até aqui

- [ ] Git instalado e funcionando
- [ ] Conta no GitHub criada e e-mail confirmado
- [ ] Nome de usuário e e-mail configurados no Git
- [ ] Chave SSH gerada e adicionada ao GitHub
- [ ] Primeiro repositório criado e enviado com sucesso

Próximo passo prático: clone um repositório existente com git clone git@github.com:usuario/repositorio.git e comece a contribuir.

## FAQ

### Como dar Git config?

Use git config seguido da opção. Exemplos: git config --global user.name "Seu Nome" para configurar nome global, ou git config user.email para ver o e-mail atual. O comando git config --list exibe todas as configurações.

### Como configurar a conta do Git?

Configure nome e e-mail com git config --global user.name e git config --global user.email. Depois, gere uma chave SSH com ssh-keygen e adicione ao GitHub em Settings > SSH and GPG keys. Teste com ssh -T git@github.com.

### Como usar o Git e o GitHub?

Git gerencia versões localmente (commits, branches). GitHub hospeda repositórios remotos. O fluxo básico: git add (prepara), git commit (salva local), git push (envia ao GitHub), git pull (traz atualizações).

### Como ver as configs do Git?

git config --list mostra todas as configurações ativas. Para ver apenas uma específica, use git config user.name ou git config --global user.email. O arquivo de configuração global fica em ~/.gitconfig.

---

Fonte (canonical): https://blogsemjuizo.com.br/novidades/configurar-git-github-guia-completo-do-zero-em-5-passos/