Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
 

 

Clonar um repositório

In this article

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

Sobre clonagem de 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.

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 obter mais informações, confira "Como 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. No GitHub.com, navegue até a página principal do repositório. 1. Acima da lista de arquivos, clique em Código. Botão "Código"

  2. 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 GitHub CLI, clique em GitHub CLI e selecione . O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub 1. 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.

Para saber mais sobre a GitHub CLI, confira "Sobre a 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.

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. No GitHub.com, navegue até a página principal do repositório. 1. Acima da lista de arquivos, clique em Código. Botão "Código"
  2. Clique em Abrir com o GitHub Desktop para clonar e abrir o repositório com o GitHub Desktop. Botão "Abrir com o GitHub Desktop"
  3. Siga as solicitações no GitHub Desktop para concluir o clone.

Para obter mais informações, confira "Como 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. No GitHub.com, navegue até a página principal do repositório.

  2. Para clonar seu repositório usando a linha de comando por 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 . Botão usado para clonar o repositório vazio por meio da URL

    Como alternativa, para clonar seu repositório no Desktop, clique em Configurar no Desktop e siga os prompts para concluir o clone. Botão usado para clonar o repositório vazio no Desktop

  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