> 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/git-remote.md).

# Git Remote

Agora que já entendemos a diferença entre um repositório local e um repositório remoto, vamos ver como o Git faz essa conexão. Para que seu repositório local saiba **onde** está o repositório remoto e consiga se comunicar com ele, o Git utiliza algo chamado **remote**, que funciona como um identificador apontando para o repositório central do projeto.

## O que é um Remote?

Um *remote* é um nome que o Git usa para guardar e identificar o endereço de um repositório remoto. Ele funciona como um pequeno registro que sempre contém duas informações essenciais: `Nome` e `Endereço (URL)` .

Pense nele como salvar um contato no celular: você armazena um nome e o número de telefone correspondente. Depois disso, sempre usa o nome, não precisa digitar o número inteiro. No Git acontece a mesma coisa: em vez de lidar com um endereço longo e completo do repositório remoto, você usa um nome curto e simples.

O nome mais comum é **origin**, que significa *origem*. Ele representa o repositório remoto principal daquele projeto, o lugar de onde a sua cópia local veio ou virá.

## O endereço de um Remote (URL)

Um remote sempre aponta para um **endereço**, que o Git chama de **URL**. Esse endereço diz exatamente onde o repositório remoto está armazenado no servidor.

Essas URLs podem aparecer em dois formatos mais comuns:

* **HTTPS:** Parece um endereço de site normal.
* **SSH:** Tem um formato um pouco diferente, mas serve para fazer a mesma coisa.

{% hint style="info" %}
A URL deve corresponder ao tipo de conexão que você escolheu. Neste curso, sempre usaremos **SSH**, então você deve usar a URL **SSH**.
{% endhint %}

### Entendendo os formatos das URLs

Para ajudar você a reconhecer esses endereços, vamos ver exemplos e explicar cada parte deles.

#### URL HTTPS

```
https://github.com/cumbucadev/meu-projeto.git
```

Vamos entender cada pedaço:

* **https\://:** tipo de comunicação
* **github.com:** servidor onde o repositório está hospedado.
* **cumbucadev:** nome do usuário ou organização no servidor.
* **meu-projeto.git:** nome do repositório. A terminação `.git` indica que é um repositório Git.

#### URL SSH

```
maria@exemplo.com:/caminho/para/meu-projeto.git
```

Vamos dividir em partes:

* [**maria@exemplo.com**](mailto:maria@exemplo.com)\
  “maria” é a usuária que você usa para entrar no servidor (que nada mais é que um computador acessado pela internet).\
  “exemplo.com” é o endereço desse servidor — como se fosse o “nome” dele na internet.\
  Juntos, eles dizem: **conectar como a usuária maria no computador-servidor exemplo.com**.
* **:/caminho/para/meu-projeto.git**\
  Esse é o **caminho das pastas dentro do servidor**, igual aos caminhos de pastas no seu próprio computador.\
  Ele mostra exatamente onde o repositório está guardado lá dentro.\
  É como o “endereço interno” do projeto dentro do servidor.
* **.git**\
  Indica que esse caminho aponta para um **repositório Git**, assim como no caso do HTTPS.

#### Você não precisa decorar nada disso

O importante por enquanto é:

* O Git precisa de um **endereço** para se conectar ao repositório remoto.
* Esse endereço pode estar no formato **HTTPS** ou **SSH**.
* Neste curso, iremos utilizar sempre a URL **SSH**.
* O nome do remote (como `origin`) é apenas uma forma de facilitar a referência a esse endereço.

Você não precisa criar essas URLs manualmente. No GitHub, elas já são fornecidas prontas para copiar — basta escolher o método de conexão correto (SSH, neste curso). O importante aqui é apenas entender que o **remote aponta para um endereço**, e que essa URL é a base da comunicação entre o seu Git local e o repositório remoto.

Em seguida, vamos aprender como conectar repositórios local e remotamente.


---

# 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/git-remote.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.