🔐 Guia Completo: Configurar Conta Git e Chaves SSH no macOS (2025)

Este guia ensina a configurar sua conta Git pela primeira vez e criar suas chaves SSH (pública e privada) no macOS — ideal para usar com GitHub, GitLab ou qualquer outro serviço Git.

---

👤 1. Configurar sua conta Git (primeira vez)

Antes de criar as chaves, é essencial definir seu nome e e-mail globais.
Essas informações serão gravadas nos commits que você fizer.

git config --global user.name "Seu Nome"
git config --global user.email "[email protected]"

Para confirmar se deu certo:

git config --list

Saída esperada:

user.name=Seu Nome
[email protected]

---

🧠 2. Entendendo rapidamente as chaves SSH

• Chave privada (id_ed25519) → Fica somente no seu Mac. Nunca compartilhe, nunca suba para a nuvem.
• Chave pública (id_ed25519.pub) → Pode ser compartilhada e enviada ao GitHub (ou outro serviço).
• A combinação das duas permite que o servidor saiba que você é você — sem precisar digitar senha.

---

🧩 3. Verifique se já existem chaves

ls -al ~/.ssh

Se aparecerem arquivos como id_ed25519 e id_ed25519.pub, você já tem chaves criadas.

---

⚙️ 4. Gerar novas chaves SSH

Substitua o e-mail pelo mesmo usado no seu GitHub/GitLab:

ssh-keygen -t ed25519 -C "[email protected]"

Pressione Enter para aceitar o caminho padrão:

/Users/seunome/.ssh/id_ed25519

Quando pedir passphrase, você pode deixar em branco ou criar uma senha extra (recomendado se a chave for usada em mais de um dispositivo).

---

🔑 5. Adicionar a chave ao agente SSH

O agente gerencia suas chaves e evita digitar a senha toda vez.

eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Se estiver num Mac antigo (sem suporte ao keychain), use:

ssh-add ~/.ssh/id_ed25519

---

📋 6. Copiar a chave pública

pbcopy < ~/.ssh/id_ed25519.pub

Isso copia o conteúdo da chave pública para a área de transferência.

---

🌐 7. Adicionar a chave no GitHub

1. Acesse: https://github.com/settings/keys
2. Clique em New SSH Key
3. Cole a chave pública copiada no campo “Key”
4. Dê um nome (ex: MacBook Pro Thiago) e salve

---

🧪 8. Testar a conexão

ssh -T [email protected]

Se tudo estiver certo, verá algo como:

Hi thiagooliveira! You've successfully authenticated...

---

🧹 9. Se precisar remover e gerar novamente

rm ~/.ssh/id_ed25519 ~/.ssh/id_ed25519.pub
ssh-keygen -t ed25519 -C "[email protected]"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Depois é só substituir a chave antiga no GitHub.

---

🧠 10. Dica extra: múltiplas contas

Se usar mais de uma conta (ex: pessoal e trabalho), crie chaves separadas:

ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/id_ed25519_personal
ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/id_ed25519_work

E configure o arquivo ~/.ssh/config:

Host github.com-pessoal
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal

Host github.com-trabalho
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_work

Assim, cada repositório usa a chave certa.

---

✅ 11. Conclusão

Você agora tem:

• Sua conta Git configurada globalmente
• Chaves SSH seguras (pública e privada)
• Login automático com GitHub sem senha
• Suporte ao Keychain do macOS
• E o ambiente pronto para git push, pull e clone sem dor de cabeça.