👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


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.
Versão do artigo: GitHub.com

Clonar um repositório

Quando você cria um repositório no GitHub, ele passa a existir como um repositório remote. É possível clonar o repositório para criar uma cópia local no seu computador e sincronizar entre os dois locais.

Neste artigo

Você conseguiu encontrar o que estava procurando?

About cloning a repository

When you're working with a repository on GitHub, you might want to have it on your local machine to make it easier to work with. For example, to allow you to use your favorite editor, to add and remove files, or to fix conflicts. The process of copying the repository from GitHub to your local machine is called cloning (sometimes referred to on other version control systems as "checking out").

Cloning a repository pulls down a full copy of all the repository data that GitHub has at that point in time, including all versions of every file and folder for the project. At any point, you can push your changes to the remote repository on GitHub, or pull other people's changes from GitHub. For more information, see "Using common Git commands".

You can either clone your existing repository or, to contribute to a project, clone another person's existing repository. For more information, see "Creating a new repository".

Cloning a repository using the command line

  1. No GitHub, navegue até a página principal do repositório.
  2. Under the repository name, click Clone or download.
    Botão Clone or download (Clonar ou baixar)
  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 .
    Botão Clone URL (Clonar URL)
  4. Open TerminalTerminalGit Bash.
  5. Change the current working directory to the location where you want the cloned directory.
  6. Digite git clone (clonar git) e cole a URL que você copiou anteriormente.
    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
  7. Press Enter to create your local clone.
    $ 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. Under the repository name, click Clone or download.
    Botão Clone or download (Clonar ou baixar)
  3. To clone your repository in GitHub Desktop, under "Clone with HTTPS", click Open in 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".

Cloning an empty repository

An empty repository contains no files. It's often made if you don't initialize the repository with a README when creating it.

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

  2. To clone your repository using the command line using HTTPS, under "Quick setup", click . To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click SSH, then click .

    Empty repository clone URL button

    Alternatively, to clone your repository in Desktop, click Set up in Desktop and follow the prompts to complete the clone.

    Empty repository clone desktop button

  3. Open TerminalTerminalGit Bash.

  4. Change the current working directory to the location where you want the cloned directory.

  5. Digite git clone (clonar git) e cole a URL que você copiou anteriormente.

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
  6. Press Enter to create your local clone.

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

Troubleshooting cloning errors

When cloning a repository it's possible that you might encounter some errors.

If you're unable to clone a repository, check that:

Leia mais

Você conseguiu encontrar o que estava procurando?

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato