> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-9/interagindo-com-o-repositorio-remoto-central-no-git/conectando-local-e-remoto/conectando-repositorio-local-com-remoto.md).

# Conectando Repositório Local com Remoto

Quando um projeto começa no seu computador, mais cedo ou mais tarde surge o momento de enviá-lo para um repositório remoto, seja para compartilhar com outras pessoas ou simplesmente para fazer um backup seguro. Felizmente, conectar um repositório local que já existe a um repositório no GitHub é bem simples. A ideia geral é: você cria um repositório vazio no GitHub, pega a URL dele e diz ao Git que aquele é o repositório remoto principal. Depois, envia seus arquivos para lá pela primeira vez.

A partir desse ponto, todo o fluxo de sincronização funciona igual ao de qualquer outro projeto: você poderá enviar mudanças (<mark style="color:purple;">git</mark> <mark style="color:orange;">push</mark>) e trazer atualizações (<mark style="color:purple;">git</mark> <mark style="color:orange;">pull</mark>), independentemente de como o projeto começou. O que é diferente é apenas esse primeiro momento de ligação entre os dois lados.

## Passo a passo

1. **Crie um repositório vazio no GitHub**\
   No GitHub, clique em **New repository** e dê um nome ao seu projeto. Deixe o repositório vazio, sem README, `.gitignore` ou licença.\
   Assim, você terá um repositório limpo, pronto para receber os arquivos que já existem no seu computador.
2. **Copie a URL do repositório remoto**\
   Após criar o repositório, o GitHub exibirá a URL.\
   Você pode escolher entre **HTTPS** ou **SSH**:

   * HTTPS: `https://github.com/seu-usuario/meu-projeto.git`
   * SSH: `git@github.com:seu-usuario/meu-projeto.git`

   Basta copiar a URL que preferir.
3. **Abra o terminal na pasta do seu projeto local**\
   Vá até a pasta onde você já criou o repositório e já rodou `git init` anteriormente:

   ```bash
   cd meu-projeto
   ```
4. **Adicione o remote origin**\
   Diga ao Git que este é o repositório remoto principal:

   ```bash
   git remote add origin <URL_DO_REPO>
   ```
5. **Envie seus arquivos para o GitHub pela primeira vez**

   ```bash
   git push -u origin main
   ```

   (Assumindo que o branch `main` é o principal do projeto)

Pronto. Seu repositório local agora está oficialmente conectado ao repositório remoto.

### Exemplo de uso

Imagine que você tem uma pasta chamada **agenda**, onde já fez `git init` e alguns commits. Veja como ficaria o processo de conectar esse projeto ao GitHub:

1. Você cria um repositório vazio no GitHub chamado **agenda**.
2. Copia a URL SSH:

   ```
   git@github.com:camila/agenda.git
   ```
3. No terminal:

   ```bash
   cd agenda
   ```
4. Adiciona o remote origin:

   ```bash
   git remote add origin git@github.com:camila/agenda.git
   ```
5. Envia os arquivos para o remoto:

   ```bash
   git push -u origin main
   ```

Depois disso, o fluxo passa a ser o normal: commits → push para enviar → pull para trazer atualizações.

***

Com a conexão entre repositório local e remoto estabelecida, seu ambiente já está pronto para começar a trabalhar com o Git de forma integrada.

Agora que sabemos como conectar repositórios, vamos aprender a **sincronizar o trabalho entre o local e o remoto**, garantindo que todas as alterações fiquem atualizadas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cumbucadev.gitbook.io/github-essentials/dia-9/interagindo-com-o-repositorio-remoto-central-no-git/conectando-local-e-remoto/conectando-repositorio-local-com-remoto.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.