> 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-remoto-com-local.md).

# Conectando Repositório Remoto com Local

Quando um projeto já foi configurado em um repositório central, utiliza-se o comando <mark style="color:purple;">git</mark> <mark style="color:orange;">clone</mark> para obter uma cópia de desenvolvimento do projeto em seu computador.

<div><figure><img src="/files/54XQWy5okdwtvch67mBE" alt=""><figcaption><p>Funcionamento do git clone - etapa 1</p></figcaption></figure> <figure><img src="/files/4Da5Eof4BofipFMX6GXT" alt=""><figcaption><p>Funcionamento do git clone - etapa 2</p></figcaption></figure></div>

Assim como o <mark style="color:purple;">git</mark> <mark style="color:orange;">init</mark>, clonar é geralmente uma operação única. Uma vez que uma pessoa tenha obtido uma cópia de trabalho, todas as operações de controle de versão e colaborações são gerenciadas por meio do seu repositório local.

Quando você **clona** um repositório do Git, significa que está copiando todos os arquivos e o histórico do projeto que está armazenado em um servidor remoto para o seu computador. Ao fazer isso, o Git já entende que aqueles arquivos fazem parte do controle de versão. Isso significa que:

* O Git **já está monitorando** todas as alterações nesses arquivos.
* Se você modificar um arquivo, o Git será capaz de detectar essa mudança.

Ou seja, ao clonar um repositório, você não precisa executar <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> nos arquivos copiados, porque o Git já os considera parte do repositório e os está rastreando desde o início.

Além disso, quando você faz um clone, o Git cria automaticamente um remote chamado `origin`, apontando para o repositório de onde você clonou.\
Esse é o nome padrão que o Git usa para se referir ao “repositório principal” daquele projeto.

## Estrutura

O formato base do comando <mark style="color:purple;">git</mark>  <mark style="color:orange;">clone</mark> que iremos utilizar aqui é:

> <mark style="color:purple;">git</mark> <mark style="color:orange;">clone</mark> <mark style="color:green;">repositório</mark>

Em que:

* <mark style="color:green;">**repositório**</mark>: A URL do repositório que você deseja clonar, como por exemplo, a URL de um repositório remoto no GitHub.

## Exemplo de uso

Vamos analisar um exemplo que demonstra como clonar um repositório Git hospedado em um servidor remoto:

> <mark style="color:purple;">git</mark> <mark style="color:orange;">clone</mark> <mark style="color:green;">ssh://maria\@examplo.com/caminho/para/meu-projeto.git</mark>

* <mark style="color:purple;">git</mark> <mark style="color:orange;">clone</mark>: Este é o comando principal utilizado para clonar um repositório Git.
* <mark style="color:green;">ssh://</mark>: Isso indica que estamos usando o protocolo SSH para comunicar com o servidor. Não é preciso se preocupar com isso neste momento. Apenas compreender que é uma forma de comunicação segura do seu computador com o repositório central.
* <mark style="color:green;"><maria@exemplo.com></mark>:&#x20;

  * "maria"  é a usuária no servidor (o servidor é só um computador acessado pela internet).
  * "exemplo.com" é o endereço desse computador-servidor.

  Juntos, indicam: *conectar como a usuária maria no servidor exemplo.com.*
* <mark style="color:green;">:/caminho/para/meu-projeto.git</mark>: Este é o caminho para a pasta do repositório no servidor remoto. O Git clonará todo o conteúdo deste diretório para o seu computador local.

Ao executar esse comando, o Git

1. **Conecta ao servidor** usando SSH, fazendo login como a usuária *maria*.
2. **Cria uma pasta nova** no seu computador chamada **meu-projeto**.
3. **Copia tudo do repositório remoto** para dentro dessa pasta.  como baixar uma “versão completa” do projeto.
4. **Configura o remote `origin` automaticamente**, para que seu computador saiba de onde esse projeto veio e para onde enviar atualizações depois.

Para começar a trabalhar no projeto, basta entrar no novo diretório "meu-projeto" criado executando o comando `cd`&#x20;

```bash
cd meu-projeto
# Começar a trabalhar no projeto
```

***

Em seguida, vamos ver o caso contrário: como **conectar um repositório local já existente a um repositório remoto**.

{% hint style="warning" %}
Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando <mark style="color:purple;">`git`</mark><mark style="color:orange;">`clone`</mark>, consulte a [documentação oficial](https://git-scm.com/docs/git-clone/pt_BR).
{% endhint %}


---

# 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-remoto-com-local.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.