Clonar um repositório

Ao criar um repositório no GitHub, ele existirá 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.

Platform navigation

Neste artigo

Sobre clonagem de um repositório

É possível clonar um repositório do GitHub.com no computador local ou em um codespace para facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e efetuar push de commits maiores. Ao clonar um repositório, você copia o repositório do GitHub.com para o computador local ou para uma máquina virtual remota ao criar um codespace. Para obter mais informações sobre a clonagem em um codespace, confira Como criar um codespace para um repositório.

É 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.

É 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 baixa uma cópia completa de todos os dados dele que o GitHub.com tem no momento, incluindo todas as versões de cada arquivo e pasta do projeto. É possível enviar suas alterações ao repositório remoto no GitHub.com ou extrair as alterações de outras pessoas no GitHub.com. Para saber mais, confira Usar o 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 Código.

    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.

  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.

  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.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

  7. Pressione ENTER para criar seu clone local.

    $ 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.

Observação

Para saber mais sobre GitHub CLI, confira Sobre o a CLI do GitHub.

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.

gh repo clone REPOSITORY

Você também pode usar o URL do GitHub para clonar um repositório.

gh repo clone https://github.com/PATH-TO/REPOSITORY

  1. Em GitHub, acesse a página principal do repositório.

  2. Acima da lista de arquivos, clique em Código.

    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.

  3. Clique em Abrir com o GitHub Desktop para clonar e abrir o repositório com o GitHub Desktop.

    Captura de tela do menu suspenso "Código" de um repositório. Um botão, rotulado como "Abrir com GitHub Desktop" tem um contorno laranja escuro.

  4. Siga as solicitações no GitHub Desktop para concluir o clone.

Para saber mais, confira Clonar um repositório do GitHub para o GitHub Desktop.

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 usando a linha de comando via 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 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á contornado em laranja.

    Como alternativa, para clonar seu repositório no Desktop, clique em Configurar no Desktop e siga os avisos para concluir o clone.

    Captura de tela das notas de configuração rápida de um repositório vazio. O botão "Set up in Desktop" está contornado em laranja escuro.

  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.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

  6. Pressione ENTER para criar seu clone local.

    $ 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:

Leitura adicional