Saltar para o conteúdo principal
Trabalhe em um projeto no seu próprio computador com Git. As alterações só são transferidas quando você executa git pull ou git push.
Um administrador precisa ativar primeiro a integração com Git.

Criar um token

O Git faz login com um token de autenticação do Git, não com a senha da sua conta.
1

Abra as configurações da conta

Clique em Account e depois em Account settings. Em Git integration, clique em Generate token. Depois que você tiver um token, esse botão passa a se chamar Add another token.
A seção Git integration das configurações da conta com um botão Generate token

A integração com Git nas configurações da conta

2

Copie o token

Clique em Copy e guarde o token em um lugar seguro. Você só o vê uma vez. Depois clique em Close.
A caixa de diálogo do token de autenticação do Git com um botão Copy

Seu novo token

3

Verifique o token

A lista agora mostra o início do token, quando ele foi criado e quando foi usado pela última vez. Ele expira após um ano. Você pode ter até 10 tokens.
A lista de tokens com um token

Seus tokens

Clonar um projeto

1

Abra a integração com Git no editor

Abra o projeto. Na barra à esquerda, clique em Integrations e depois em Git integration.
O painel Integrations com o cartão Git integration

O painel Integrations

2

Copie o comando

A caixa de diálogo Clone with Git mostra o comando, com o endereço do seu site e o ID do projeto. Clique em Copy. Se você ainda não tiver um token, Go to settings abre as configurações da sua conta em uma nova aba.
A caixa de diálogo Clone with Git com o comando git clone

O comando de clonagem

3

Execute o comando

Cole o comando em um terminal. Quando o Git pedir uma senha, cole seu token.
Uma pasta com o nome do ID do projeto agora contém os arquivos do projeto, no branch main. Para escolher o nome da pasta, adicione-o ao final do comando.
O Git pede o token toda vez que se conecta ao site. Para que ele seja lembrado, ative um credential helper: o Git pede mais uma vez e depois guarda o token. O helper store o guarda sem criptografia em ~/.git-credentials.

Trazer as alterações do editor

Dentro da pasta, execute:
O Git lista os arquivos que mudaram. As alterações feitas no editor chegam como commits chamados Update on Overleaf..

Enviar suas alterações

Faça commit das suas alterações e depois envie-as com push:
A última linha da saída mostra o branch que avançou:
As alterações aparecem no editor, e um editor aberto se atualiza sozinho. Novos arquivos, pastas e renomeações aparecem na árvore de arquivos. Em History, sua alteração aparece marcada como You (via Git). Sua mensagem de commit não é mostrada ali.
O histórico do projeto mostrando a linha enviada, marcada como You (via Git)

Um push no histórico do projeto

Se o Git recusar seu push

Se o projeto mudou nesse meio-tempo, o Git rejeita o push:
Traga essas alterações primeiro e depois faça push de novo:
Um git pull simples pode parar com fatal: Need to specify how to reconcile divergent branches. A opção --no-rebase acima resolve isso: ela mescla os dois lados. Se as mesmas linhas mudaram dos dois lados, o pull para com CONFLICT (content): Merge conflict in main.tex. Corrija o arquivo e depois execute:
Há duas coisas que o site não aceita:
  • Outros branches: ! [remote rejected] feature -> feature (wrong branch). Só existe main, então envie seu trabalho para ele.
  • Force push: ! [remote rejected] main -> main (forced push prohibited). Em vez disso, coloque suas alterações sobre o main atual.

Se o Git disser Authentication failed

O token está errado ou foi excluído, ou você digitou a senha da sua conta. Crie um novo token se não tiver mais o antigo, porque não é possível ver um token existente de novo.

Excluir um token

Em Account settings, em Git integration, clique no ícone de exclusão ao lado do token e depois em Delete na caixa de diálogo. A partir daí, o Git responde Authentication failed para esse token.
A caixa de diálogo Delete Authentication token

Excluir um token

Para saber o que colaboradores com acesso somente leitura podem fazer, consulte o Q&A da integração com Git.
Última modificação em 20 de novembro de 2026