Armazenar suas credenciais do GitHub no Git

Se você estiver clonando repositórios do GitHub usando HTTPS, recomendamos você usar o GitHub CLI ou o Git Credential Manager (GCM) para lembrar suas credenciais.

Platform navigation

Neste artigo

Tip

Se você clonar repositórios do GitHub usando SSH, poderá efetuar a autenticação usando uma chave SSH em vez de usar outras credenciais. Para obter informações sobre como configurar uma conexão SSH, confira Conectar-se ao GitHub com o SSH.

GitHub CLI

O GitHub CLI armazenará automaticamente suas credenciais do Git para você escolher HTTPS como protocolo preferido para operações Git e responder "sim" ao prompt que perguntará se você gostaria de efetuar a autenticação no Git com a suas credenciais do GitHub.

  1. Instale a GitHub CLI no macOS, no Windows ou no Linux.
  2. Na linha de comando, insira gh auth login e siga os prompts.
    • Quando solicitado o protocolo preferido para operações Git, selecione HTTPS.
    • Quando perguntado se você deseja se autenticar no Git com suas credenciais do GitHub, insira Y.

Para obter mais informações sobre como se autenticar com a GitHub CLI, confira gh auth login.

Gerenciador de credenciais do Git

O GCM (Gerenciador de Credenciais do Git) é outra maneira de armazenar suas credenciais com segurança e conectar-se ao GitHub via HTTPS. Com o GCM, você não precisa criar nem armazenar manualmente um personal access token, pois o GCM gerencia a autenticação em seu nome, incluindo a 2FA (autenticação de dois fatores).

  1. Instale o Git usando o Homebrew:

    brew install git

  2. Instale GCM usando o Homebrew:

    brew install --cask git-credential-manager

No macOS, você não precisa executar a git config porque o GCM configura automaticamente o Git para você.

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir autenticação de dois fatores, você também precisará concluir o desafio de 2FA.

Após a autenticação ser concluída com sucesso, suas credenciais serão armazenadas no keychain do macOS e serão usadas toda vez que você clonar uma URL de HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.

  1. Instale o Git para o Windows, que inclui GCM. Para obter mais informações, confira Git para versões Windows nas respectivas página de versões.

Recomenda-se instalar sempre a versão mais recente. No mínimo, instale a versão 2.29 ou superior, que é a primeira versão que oferece suporte do OAuth para o GitHub.

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir autenticação de dois fatores, você também precisará concluir o desafio de 2FA.

Depois de efetuar a autenticação com sucesso, as suas credenciais serão armazenadas no gerenciador de credenciais do Windows e serão usadas toda vez que você clonar uma URL de HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.


Warning

As versões mais antigas do Git para Windows vieram com o Administrador de Credenciais do Git para Windows. Este produto antigo não é mais compatível e não pode se conectar ao GitHub via OAuth. Recomendamos que você atualize para a versão mais recente do Git para Windows.

Warning

Se você armazenou em cache credenciais incorretas ou desatualizadas no Gerenciador de Credenciais para Windows, o Git não terá acesso ao GitHub. Para redefinir as suas credenciais armazenadas em cache para que o Git peça para inserir suas credenciais, acesse o Gerenciador de Credenciais no Painel de Controle do Windows em Contas de Usuário > Gerenciador de Credenciais. Procure a entrada de GitHub e exclua-a.

Para Linux, instale o Git e o GCM e, em seguida, configure o Git para usar o GCM.

  1. Instale o Git a partir do sistema de pacotes da sua distribuição. As instruções vão variar dependendo da versão do Linux que você executar.

  2. Install o GCM. Veja as instruções no repositório do GCM, pois elas são diferentes, de acordo com a variante do Linux executada.

  3. Configurar o Git para usar o GCM. Há várias lojas de apoio que você pode escolher. Portanto, consulte a documentação de do GCM para concluir a sua configuração. Para obter mais informações, confira GCM Linux.

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir autenticação de dois fatores, você também precisará concluir o desafio de 2FA.

Depois de autenticado com sucesso, as suas credenciais serão armazenadas no seu sistema e serão usadas toda vez que você clonar uma URL de HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.

Para obter mais opções para armazenar suas credenciais no Linux, confira Armazenamento de Credencial no Pro Git.


Para obter mais informações ou relatar problemas com o GCM, veja os documentos oficiais do GCM em Gerenciador de Credenciais do Git.