Skip to main content

Cloning and forking repositories from GitHub Desktop

You can use GitHub Desktop to clone and fork repositories that exist on GitHub.

Platform navigation

About local repositories

Repositories on GitHub are remote repositories. You can clone or fork a repository with GitHub Desktop to create a local repository on your computer.

You can create a local copy of any repository on GitHub that you have access to by cloning the repository. If you own a repository or have write permissions, you can sync between the local and remote locations. For more information, see "Syncing your branch in GitHub Desktop."

When you clone a repository, any changes you push to GitHub will affect the original repository. To make changes without affecting the original project, you can create a separate copy by forking the repository. You can create a pull request to propose that maintainers incorporate the changes in your fork into the original upstream repository. For more information, see "Sobre bifurcações."

When you try to use GitHub Desktop to clone a repository that you do not have write access to, GitHub Desktop will prompt you to create a fork automatically. You can choose to use your fork to contribute to the original upstream repository or to work independently on your own project. Any existing forks default to contributing changes to their upstream repositories. You can modify this choice at any time. For more information, see "Managing fork behavior".

You can also clone a repository directly from GitHub or GitHub Enterprise. For more information, see "Cloning a repository from GitHub to GitHub Desktop".

Cloning a repository

  1. No menu Arquivo, clique em Clonar Repositório.

    Captura de tela da barra de menus no Mac. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

  2. Clique na aba que corresponde à localização do repositório que você deseja clonar. Clique também na URL para inserir o local do repositório manualmente.

    Captura de tela da janela "Clonar um repositório". Na parte superior da janela, as guias rotuladas como "GitHub.com", "GitHub Enterprise" e "URL" são realçadas com um contorno laranja.

  3. Na lista de repositórios, clique no repositório que você deseja clonar.

    Captura de tela da janela "Clonar um repositório". O repositório "github/docs" está realçado com um contorno laranja.

  4. Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.

    Captura de tela da janela "Clonar um repositório". O botão, rotulado como "Escolher", está realçado com um contorno laranja.

  5. Na parte inferior da janela "Clonar um Repositório", clique em Clonar.

Forking a repository

You can fork a repository on GitHub.com or in GitHub Desktop. For information about forking on GitHub.com, see "Bifurcar um repositório."

No GitHub Desktop, se você tentar clonar um repositório ao qual não tem acesso de gravação, um fork será criado automaticamente para você.

  1. No menu Arquivo, clique em Clonar Repositório.

    Captura de tela da barra de menus no Mac. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

  2. Clique na aba que corresponde à localização do repositório que você deseja clonar. Clique também na URL para inserir o local do repositório manualmente.

    Captura de tela da janela "Clonar um repositório". Na parte superior da janela, as guias rotuladas como "GitHub.com", "GitHub Enterprise" e "URL" são realçadas com um contorno laranja.

  3. Na lista de repositórios, clique no repositório que você deseja clonar.

    Captura de tela da janela "Clonar um repositório". O repositório "github/docs" está realçado com um contorno laranja.

  4. Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.

    Captura de tela da janela "Clonar um repositório". O botão, rotulado como "Escolher", está realçado com um contorno laranja.

  5. Na parte inferior da janela "Clonar um Repositório", clique em Clonar.

  6. Leia as informações em "Como você está planejando usar essa bifurcação?" .

    • Se você pretende usar esse fork para contribuir com o repositório upstream original, clique em Para contribuir com o projeto pai.
    • Se você pretende usar esse fork para um projeto não conectado ao upstream, clique em Para minhas próprias finalidades.
  7. Clique em Continuar.

Managing fork behavior

You can change how a fork behaves with the upstream repository in GitHub Desktop.

  1. Na barra de menus, selecione Repositório e clique em Configurações do repositório... .

    Captura de tela da barra de menus no Mac. No menu suspenso "Repositório" que é expandido, o cursor do mouse está sobre "Configurações do repositório", realçado em azul.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Repositório" que é aberto, há uma opção rotulada "Configurações do repositório" com o contorno em laranja.

  2. Na janela "Configurações do repositório", na barra lateral esquerda, clique em Configuração do Fork.

  3. Em "Vou usar este fork...", use os botões de opção para selecionar como você deseja usar o fork.

    Captura de tela do painel "Comportamento do Fork". Dois botões de opção, rotulados como "Para contribuir com o repositório pai" e "Para meus próprios propósitos", estão contornados em laranja.

  4. Clique em Save (Salvar).

Creating an alias for a local repository

You can create an alias for a local repository to help differentiate between repositories of the same name in GitHub Desktop. Creating an alias does not affect the repository's name on GitHub. In the repositories list, aliases appear in italics.

  1. In the upper-left corner of GitHub Desktop, to the right of the current repository name, click .
  2. Right-click the repository you want to create an alias for, then click Create Alias.
  3. Type an alias for the repository.
  4. Click Create Alias.

Further reading