> 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-hello-world/clonando-o-repositorio-hello-world.md).

# Clonando o Repositório hello-world

Quando você cria um repositório no GitHub, ele existe apenas como um **repositório remoto** na plataforma. Para trabalhar no código de forma eficiente, é essencial ter uma **cópia local** no seu computador, permitindo que você faça edições, testes e commits antes de enviá-las de volta para o GitHub.

Isso significa que, neste momento, o seu projeto **hello-world** só existe no GitHub — ele ainda não está no seu computador.

Agora, vamos ao primeiro passo do nosso novo fluxo de trabalho: **clonar o repositório** para o seu computador.

## Passo a Passo

### Copiar URL do Repositório

Acesse a página principal do projeto no GitHub e clique no botão **Code**.

<figure><img src="/files/STfSB85HTIwkcShGlnZt" alt="" width="147"><figcaption><p>Botão code.</p></figcaption></figure>

<figure><img src="/files/ZgAlA7skFV5js0v6GF6U" alt=""><figcaption><p>Página principal do repositório após o clique no botão code.</p></figcaption></figure>

Na janela de diálogo que irá se abrir, clique em **SSH.**

<figure><img src="/files/v9k0DNdB9cMbO2Gg6SaL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tpwsG42K72s4wxIH1oYV" alt=""><figcaption></figcaption></figure>

Em seguida, clique no botão de copiar que aparecerá ao lado da URL do repositório.

<figure><img src="/files/0svUBTiu8vnJPqH2UZav" alt="" width="108"><figcaption><p>Botão "copiar".</p></figcaption></figure>

<figure><img src="/files/fHBu8ji5qVikqaS2CC6I" alt=""><figcaption><p>Copiar link do repositório remoto</p></figcaption></figure>

Agora, a URL para o seu repositório remoto **hello-world** está copiada. Iremos utilizá-la no terminal para clonar o projeto localmente a seguir.

### Clonar o Repositório Localmente

Agora execute no terminal o seguinte comando - substituindo `<URL-COPIADA>` pelo valor correspondente.

```bash
git clone <URL-COPIADA>
```

Exemplo:

```bash
git clone git@github.com:aprendizCumbucaDev/hello-world.git
▶ Cloning into 'hello-world'...
remote: Enumerating objects: 6, done.
remote: Counting objects: 100% (6/6), done.
remote: Compressing objects: 100% (4/4), done.
Receiving objects: 100% (6/6), done.
remote: Total 6 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
```

Para verificar se o projeto foi clonado com sucesso, use o comando `dir` (no Windows) ou `ls` (no Linux/macOS) para listar os arquivos do diretório atual. Você deverá ver a pasta **hello-world** na lista.

O próximo passo será começar a fazer edições no repositório local.


---

# 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-hello-world/clonando-o-repositorio-hello-world.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.