7. Repositórios remotos e GitHub

Adicionando o repositório do GitHub como remoto

Agora que temos um repositório no GitHub, precisamos conectá-lo ao nosso repositório local. Assim vamos poder subir nossas alterações locais para o GitHub e puxar para o repositório local as alterações feitas no GitHub.

Existem dois jeitos comuns de trabalhar com repositórios remotos:

Projetos novos. Você começa localmente e cria um repo novo com
git init
. Quando o trabalho avançar um pouco, conecte o repo local a um remoto para compartilhar seu trabalho com outras pessoas (ou simplesmente para ter um backup).
Projetos existentes. Digamos que você comprou um computador novo e quer continuar trabalhando em um projeto seu que já foi sincronizado com um repositório remoto. Nesse caso, em vez de git init, você usa
git clone https://your-repo-url
para fazer uma cópia local do repositório remoto. Depois, é só trabalhar nele como de costume.

Aqui estamos seguindo a primeira abordagem: já temos um repositório local com o nosso trabalho, e agora queremos conectá-lo ao GitHub.

Como faço isso?

Para conectar um repositório local ao GitHub, precisamos adicionar o repositório do GitHub como um remoto no nosso repositório local. Um remoto é, essencialmente, um marcador que aponta para a URL onde um repositório está hospedado.

O nome padrão do primeiro remoto costuma ser origin, mas você pode dar o nome que quiser. Mesmo assim, a convenção é usar origin para o repositório remoto principal.

Para adicionar um remoto, execute

git remote add

, seguido do nome do remoto e da URL do repositório. No nosso caso, o comando deve ficar assim:

Executar no terminal:

git remote add origin https://github.com/your-name/your-repo.git

Tarefa

Concluída

Adicione o repositório do GitHub como um remoto chamado origin no seu repositório local usando o comando acima.

Para confirmar que o remoto foi adicionado com sucesso, você pode executar

git remote -v

(-v é a forma curta de --verbose, ou seja, mostrar detalhes extras), que exibe a lista de todos os remotos e suas URLs.

Executar no terminal:

git remote -v

Você deve ver algo assim:

Resultado:

origin https://github.com/your-name/your-repo.git (fetch)
origin https://github.com/your-name/your-repo.git (push)

Se você errou a URL, pode remover um remoto com git remote remove <remote-name> (onde <remote-name> é origin ou outro nome que você tenha usado para o remoto) e depois adicioná-lo de novo com a URL correta.

Tarefa

Concluída

Verifique se o remoto origin foi adicionado com sucesso.

Ótimo! Você conectou seu repositório local ao GitHub.

Um repositório pode ter vários remotos, cada um apontando para uma URL diferente. Isso é útil se você quiser dar push para vários repositórios ou puxar alterações deles.

Next step

Quer testar o modo história?

Faça o curso do jeito que ele foi pensado: progressão em pequenas doses, ordem linear e focada, desbloqueio gradual das entradas da Gitopedia. Continue com o Git de verdade no VS Code/Cursor/Antigravity/Windsurf a qualquer momento.

Modo história

GRATUITO
mas precisa de login

Git

ByBit