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, consulte "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.
  2. Acima da lista de arquivos, clique em código. Botão de "Código"
  3. Para clonar o repositório usando HTTPS, em "Clonar com HTTPS", clique em . 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 . O ícone da área de transferência para copiar a URL para clonar um repositório O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub
  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.

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para clonar um repositório localmente, use o subcomando repo clone. Substitua o parâmetro repositório pelo nome do repositório. Por exemplo, octo-org/octo-repo, monalisa/octo-repo ou octo-repo. Se a porção OWNER/ do argumento do repositório OWNER/REPO for omitida, o padrão será 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.
  2. Acima da lista de arquivos, clique em código. Botão de "Código"
  3. Click Open with GitHub Desktop to clone and open the repository with GitHub Desktop. "Abrir com o botão GitHub Desktop"
  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 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 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 certificação 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

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.