Skip to main content

Clonar um repositório

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

Você pode clonar um repositório do GitHub.com para o seu computador local para facilitar a correção de conflitos de merge, adicionar ou remover arquivos e fazer push de commits maiores. Ao clonar um repositório, você copia o repositório do GitHub.com para a sua máquina local.

Clonar um repositório extrai uma cópia completa de todos os dados do repositório que o GitHub.com tem nesse momento, incluindo todas as versões de cada arquivo e pasta do projeto. Você pode fazer push das alterações no 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/cli/cli
  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