# Configurar o Git para o GitHub Desktop

Você pode gerenciar as configurações do Git para seus repositórios locais com GitHub Desktop.

## Sobre a configuração do Git para GitHub Desktop

GitHub Desktop usa as configurações locais do Git e fornece a opção de definir algumas dessas configurações, como as informações de autor global e o branch padrão usado ao criar um novo repositório.

GitHub Desktop permite que você defina o nome e o endereço de email que deseja associar às confirmações que você faz em seus repositórios. Se seu nome e endereço de email já tiverem sido definidos na configuração global do Git para seu computador, GitHub Desktop detectará e usará esses valores.
GitHub Desktop também permite que você defina um nome e um endereço de email diferentes para um repositório individual. Isso é útil quando você precisa usar um endereço de email de trabalho separado para um repositório específico.

Se o endereço de e-mail definido na sua configuração do Git não corresponder a um endereço de e-mail associado à conta GitHub na qual você tem sessão iniciada no momento, GitHub Desktop exibirá um aviso antes de fazer o commit.

GitHub Desktop também permite que você altere o nome de branch padrão que deseja usar ao criar novos repositórios. Por padrão, GitHub Desktop usa `main` como nome padrão da branch em todos os novos repositórios que você criar.

> \[!TIP]
> Se você fizer commits públicos, qualquer pessoa poderá ver o endereço de e-mail da sua configuração do Git. Para saber mais, confira [Configurar o endereço de e-mail do commit](/pt/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address).

## Como configurar as informações de autor global

Configurar suas informações globais de autor no GitHub Desktop atualizará o nome e o endereço de e-mail na sua configuração global do Git. Esse será o nome padrão e o endereço de email para todos os novos repositórios locais que você criar.GitHub Desktop

<div class="ghd-tool mac">

1. Na barra de menus, selecione **GitHub Desktop** e selecione **Configurações**.

   ![Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.](/assets/images/help/desktop/mac-choose-settings.png)
2. Na janela “Configurações”, selecione **Git**.

   ![Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.](/assets/images/help/desktop/mac-select-git-pane.png)
3. No campo "Nome", digite o nome que gostaria de usar para sua configuração do Git.
4. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.
5. Clique em **Salvar**.

</div>

<div class="ghd-tool windows">

1. Use o menu **Arquivo** e clique em **Opções**.

   ![Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.](/assets/images/help/desktop/windows-choose-options.png)

2. Na janela “Opções”, clique em **Git**.

   ![Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.](/assets/images/help/desktop/windows-select-git-pane.png)

3. No campo "Nome", digite o nome que gostaria de usar para sua configuração do Git.

4. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

5. Clique em **Salvar**.

</div>

## Como configurar diferentes informações de autor para um repositório individual

Você pode alterar o nome e o endereço de email usados para criar commits em um repositório específico. Essa configuração local do Git substituirá as configurações globais do Git somente para este repositório.

<div class="ghd-tool mac">

1. Para alternar para o repositório em que deseja definir uma configuração específica, use o menu suspenso "Repositório Atual".

   ![Captura de tela da barra de repositórios no GitHub Desktop. Ao lado de "Repositório Atual" há um ícone suspenso realçado com contorno laranja.](/assets/images/help/desktop/current-repo-dropdown.png)

2. Na barra de menus "GitHub Desktop", selecione **Repositório** e clique em **Configurações do repositório...** .

   ![Captura de tela da barra de menus no Mac. No menu suspenso "Repositório" que é aberto, o cursor do mouse está sobre "Configurações do repositório", realçado em azul.](/assets/images/help/desktop/repository-settings-mac.png)

3. Na janela "Configurações do Repositório", na barra lateral esquerda, clique em **Configuração do Git**.

4. Em "Para este repositório eu desejo", selecione **Usar uma configuração local do Git**. ![Captura de tela do painel "Configuração do Git" na janela "Configurações do Repositório". Um botão de opção "Use a local Git config" está selecionado e contornado em laranja.](/assets/images/help/desktop/use-local-git-config.png)

5. No campo "Nome", digite o nome que gostaria de usar na configuração do Git local.

6. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

7. Clique em **Salvar**.

</div>

<div class="ghd-tool windows">

1. No menu **Repositório**, clique em **Configurações do repositório...** .

   ![Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Repository" que é aberto, "Repository Settings" está contornado em laranja.](/assets/images/help/desktop/repository-settings-win.png)
2. Na janela "Configurações do Repositório", na barra lateral esquerda, clique em **Configuração do Git**.
3. Em "Para este repositório eu desejo", selecione **Usar uma configuração local do Git**. ![Captura de tela do painel "Configuração do Git" na janela "Configurações do Repositório". Um botão de opção "Use a local Git config" está selecionado e contornado em laranja.](/assets/images/help/desktop/use-local-git-config.png)
4. No campo "Nome", digite o nome que gostaria de usar na configuração do Git local.
5. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.
6. Clique em **Salvar**.

</div>

## Como configurar o branch padrão para novos repositórios

Você pode configurar o branch padrão que será usado ao criar um novo repositório em GitHub Desktop. Para mais informações sobre o branch padrão, confira [Branches](/pt/pull-requests/reference/branches#about-the-default-branch).

<div class="ghd-tool mac">

1. Na barra de menus, selecione **GitHub Desktop** e selecione **Configurações**.

   ![Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.](/assets/images/help/desktop/mac-choose-settings.png)
2. Na janela “Configurações”, selecione **Git**.

   ![Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.](/assets/images/help/desktop/mac-select-git-pane.png)
3. Clique na guia **Ramificação padrão**.
4. Edite o nome do branch padrão conforme necessário.
5. Clique em **Salvar**.

</div>

<div class="ghd-tool windows">

1. Use o menu **Arquivo** e clique em **Opções**.

   ![Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.](/assets/images/help/desktop/windows-choose-options.png)
2. Na janela “Opções”, clique em **Git**.

![Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.](/assets/images/help/desktop/windows-select-git-pane.png)

1. Clique na guia **Ramificação padrão**.
2. Edite o nome do branch padrão conforme necessário.
3. Clique em **Salvar**.

</div>

## Configurando seu ambiente de shell para ganchos do Git

GitHub Desktop executa hooks do Git em seu ambiente de shell configurado. Isso significa que os ganchos têm acesso às mesmas variáveis de ambiente, arquivos de configuração de shell (como `.bash_profile` ou `.zshrc`) e ferramentas como quando você executa o Git na linha de comando. As ferramentas instaladas por meio de gerenciadores de versão, como `nvm` ou `rbenv`, também estarão disponíveis para seus ganchos.

Você pode definir as configurações de ambiente de gancho na guia **Ganchos** do painel de configurações do **Git** .

<div class="ghd-tool mac">

1. Na barra de menus, selecione **GitHub Desktop** e selecione **Configurações**.

   ![Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.](/assets/images/help/desktop/mac-choose-settings.png)
2. Na janela “Configurações”, selecione **Git**.

   ![Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.](/assets/images/help/desktop/mac-select-git-pane.png)
3. Clique na guia **Hooks**.

</div>

<div class="ghd-tool windows">

1. Use o menu **Arquivo** e clique em **Opções**.

   ![Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.](/assets/images/help/desktop/windows-choose-options.png)
2. Na janela “Opções”, clique em **Git**.

![Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.](/assets/images/help/desktop/windows-select-git-pane.png)

1. Clique na guia **Hooks**.

</div>

As configurações a seguir estão disponíveis:

* **Carregar variáveis de ambiente do hook do Git a partir do shell**: quando habilitado, GitHub Desktop carrega variáveis de ambiente a partir do shell ao executar hooks do Git. Habilite isso se os ganchos dependerem das ferramentas instaladas por meio de gerenciadores de versão, como `nvm`, `rbenv` ou `asdf`.

<div class="ghd-tool mac">

* **Cache de variáveis de ambiente de gancho do Git**: armazena em cache variáveis de ambiente de gancho para melhorar o desempenho. Desabilite isso se os ganchos dependerem de variáveis de ambiente que mudam com frequência.

</div>

Para obter mais informações sobre os ganchos do Git, GitHub Desktopconsulte [Trabalhando com ganchos do Git no GitHub Desktop](/pt/desktop/making-changes-in-a-branch/working-with-git-hooks-in-github-desktop).

## Leitura adicional

* [Adicionando um endereço de email à sua conta de GitHub](/pt/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account)
* [Configurar o endereço de e-mail do commit](/pt/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address)
* [Branches](/pt/pull-requests/reference/branches)
* [Noções básicas do Git](/pt/get-started/git-basics)