Cloning a repository

When you create a repository on GitHub, it exists as a remote repository. You can clone your repository to create a local copy on your computer and sync between the two locations.

About cloning a repository

You can clone a repository from GitHub to your local computer to make it easier to fix merge conflicts, add or remove files, and push larger commits. When you clone a repository, you copy the repository from GitHub to your local machine.

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. You can push your changes to the remote repository on GitHub, or pull other people's changes from GitHub. For more information, see "Using Git".

You can clone your existing repository or clone another person's existing repository to contribute to a project.

Cloning a repository

  1. No GitHub, 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 . Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade certificada e SSH da sua organização, clique em Usar SSH e, em seguida, clique em . Para clonar um repositório usando GitHub CLI, clique em Usar GitHub CLI e, em seguida, clique em . 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.

To learn more about GitHub CLI, see "About GitHub CLI."

To clone a repository locally, use the repo clone subcommand. Replace the repository parameter with the repository name. For example, octo-org/octo-repo, monalisa/octo-repo, or octo-repo. If the OWNER/ portion of the OWNER/REPO repository argument is omitted, it defaults to the name of the authenticating user.

gh repo clone repository

You can also use the GitHub URL to clone a repository.

gh repo clone https://github.com/cli/cli
  1. No GitHub, 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. Clique em Abra com GitHub Desktop para clonar e abrir o repositório com GitHub Desktop. "Abrir com o botão GitHub Desktop"

  4. Follow the prompts in GitHub Desktop to complete the clone.

For more information, see "Cloning a repository from GitHub to 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. 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.

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:

Further reading

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.