Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Clonar um repositório

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

Neste artigo

Did this doc help you?

Sobre clonagem de um repositório

Você pode clonar um repositório do GitHub 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 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 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 ou extrair as alterações de outras pessoas no GitHub. Para obter mais informações, consulte "Usar comandos comuns do Git".

É possível clonar o repositório existente ou clonar o repositório existente de outra pessoa para contribuir para um projeto.

Dica: Você também pode clonar um repositório usando o GitHub CLI. Para obter mais informações, consulte "clone de repositório gh" na documentação do GitHub CLI.

Clonar um repositório usando a linha de comando

  1. No GitHub, navegue até a página principal do repositório.

  2. Above the list of files, click Code.

    "Code" button

  3. To clone the repository using HTTPS, under "Clone with HTTPS", click . To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click Use SSH, then click . To clone a repository using GitHub CLI, click Use GitHub CLI, then click .

    The clipboard icon for copying the URL to clone a repository

    The clipboard icon for copying the URL to clone a repository with GitHub CLI

  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 (clonar git) e cole a URL que você copiou anteriormente.

    $ 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: Contando objetos: 10, concluído.
    > remote: Compactando objetos: 100% (8/8), concluído.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.

Clonar um repositório no GitHub Desktop

  1. No GitHub, navegue até a página principal do repositório.

  2. Above the list of files, click Code.

    "Code" button

  3. Click Open with GitHub Desktop to clone and open the repository with GitHub Desktop.

    "Open with GitHub Desktop" button

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

Para obter mais informações, consulte "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 LEIAME ao criá-lo.

  1. No GitHub, navegue até a página principal do repositório.

  2. Para clonar seu repositório usando a linha de comando usando HTTPS, em "Configuração rápida", clique no . Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificado SSH da sua organização clique em SSH e, em seguida, clique em .

    Botão da URL para clonar o repositório vazio

    Como alternativa, para clonar seu repositório para área de trabalho, clique em Configurar na área de trabalho e seguir as instruções para concluir o clone.

    Botão da área de trabalho para clonar o repositório vazio

  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 (clonar git) e cole a URL que você copiou anteriormente.

    $ 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: Contando objetos: 10, concluído.
    > remote: Compactando objetos: 100% (8/8), concluído.
    > 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:

Leia mais

Did this doc help you?