# Clonar um repositório Quando você cria um repositório no GitHub, ele existe como um repositório remoto. É possível clonar o repositório para criar uma cópia local no seu computador e sincronizar entre os dois locais. ## Sobre clonagem de um repositório

Você pode clonar um repositório do GitHub.com para seu computador local ou para um codespace, para facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e enviar commits maiores. Ao clonar um repositório, você copia o repositório de GitHub.com seu computador local ou para uma máquina virtual remota ao criar um codespace. Para obter mais informações sobre clonagem em um codespace, consulte [Como criar um codespace para um repositório](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository).

É possível clonar um repositório do GitHub.com em seu computador local para facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e enviar commits maiores. Ao clonar um repositório, ele é copiado do GitHub.com para seu computador local.

A clonagem de um repositório retira uma cópia completa de todos os dados do repositório que GitHub.com têm naquele momento, incluindo todas as versões de cada arquivo e pasta do projeto. Você pode enviar suas alterações para o repositório remoto em GitHub.com ou baixar as alterações de outras pessoas de GitHub.com. Para saber mais, confira [Usar o Git](/pt/get-started/using-git). É possível clonar o repositório existente ou clonar o repositório existente de outra pessoa para contribuir para um projeto. ## Clonar um repositório

1. Em GitHub, acesse a página principal do repositório. 2. Acima da lista de arquivos, clique em ** Code**. ![Captura de tela da lista de arquivos na página de aterrissagem de um repositório. O botão "Código" está realçado com um contorno laranja escuro.](/assets/images/help/repository/code-button.png) 3. Copie a URL do repositório. * Para clonar o repositório usando HTTPS, em "HTTPS", clique em . * Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em **SSH** e em . * Para clonar um repositório usando a GitHub CLI, clique em **GitHub CLI** e em . ![Captura de tela do menu suspenso "Código". À direita da URL HTTPS do repositório, um ícone de cópia está contornado em laranja escuro.](/assets/images/help/repository/https-url-clone-cli.png) 4. Abra TerminalTerminalGit Bash. 5. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado. 6. Digite `git clone` e cole a URL já copiada. ```shell git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY ``` 7. Pressione **ENTER** para criar seu clone local. ```shell $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY > Cloning into `Spoon-Knife`... > remote: Counting objects: 10, done. > remote: Compressing objects: 100% (8/8), done. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done. ```

> \[!NOTE] > Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli). Para clonar um repositório localmente, use o subcomando `repo clone`. Substitua o parâmetro `repository` pelo nome do repositório. Por exemplo, `octo-org/octo-repo`, `monalisa/octo-repo` ou `octo-repo`. Se a parte `OWNER/` do argumento do repositório `OWNER/REPO` for omitida, ele usará como padrão o nome do usuário autenticador. ```shell gh repo clone REPOSITORY ``` Você também pode usar a URL GitHub para clonar um repositório. ```shell gh repo clone https://github.com/PATH-TO/REPOSITORY ```

## Clonar um repositório vazio Um repositório vazio não contém arquivos. Muitas vezes, isso é feito se você não inicializar o repositório com um README ao criá-lo. 1. Em GitHub, acesse a página principal do repositório. 2. Para clonar seu repositório pela linha de comando com HTTPS, em "Configuração rápida", clique em . Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em **SSH** e clique em . ![Captura de tela das notas de configuração rápida de um repositório vazio. À direita da URL HTTPS do repositório, um ícone de cópia está destacado em laranja.](/assets/images/help/repository/empty-https-url-clone-button.png) Como alternativa, para clonar o repositório na Área de Trabalho, clique ** em Configurar na Área de Trabalho** e siga os prompts para concluir o clone. ![Captura de tela das notas de configuração rápida de um repositório vazio. O botão "Configurar no Computador" está contornado em laranja escuro.](/assets/images/help/repository/empty-desktop-clone-button.png) 3. Abra TerminalTerminalGit Bash. 4. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado. 5. Digite `git clone` e cole a URL já copiada. ```shell git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY ``` 6. Pressione **ENTER** para criar seu clone local. ```shell $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY > Cloning into `Spoon-Knife`... > remote: Counting objects: 10, done. > remote: Compressing objects: 100% (8/8), done. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done. ``` ## Solucionar problemas de erros de clonagem Ao clonar um repositório, é possível que você encontre alguns erros. Se você não conseguir clonar um repositório, verifique se: * Você consegue conectar-se usando HTTPS. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors). * Você tem permissão para acessar o repositório que você deseja clonar. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors#check-your-permissions). * O ramo padrão que você deseja clonar ainda existe. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors#error-remote-head-refers-to-nonexistent-ref-unable-to-checkout). ## Leitura adicional * [Solucionar problemas de conectividade](/pt/get-started/using-github/troubleshooting-connectivity-problems)