{"meta":{"title":"Clonar um repositório","intro":"Quando você cria um repositório no GitHub, ele existe 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.","product":"Repositórios","breadcrumbs":[{"href":"/pt/repositories","title":"Repositórios"},{"href":"/pt/repositories/creating-and-managing-repositories","title":"Criar e gerenciar repositórios"},{"href":"/pt/repositories/creating-and-managing-repositories/cloning-a-repository","title":"Clonar um repositório"}],"documentType":"article"},"body":"# Clonar um repositório\n\nQuando você cria um repositório no GitHub, ele existe 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.\n\n## Sobre clonagem de um repositório\n\n<div class=\"ghd-tool webui\">\n\nVocê pode clonar um repositório do GitHub.com para seu computador local ou para um codespace,\npara facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e enviar commits maiores. Ao clonar um repositório, você copia o repositório de GitHub.com seu computador local ou para uma máquina virtual remota ao criar um codespace. Para obter mais informações sobre clonagem em um codespace, consulte [Como criar um codespace para um repositório](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository).\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\nÉ possível clonar um repositório do GitHub.com em seu computador local para facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e enviar commits maiores. Ao clonar um repositório, ele é copiado do GitHub.com para seu computador local.\n\n</div>\n\n<div class=\"ghd-tool desktop\">\n\nÉ possível clonar um repositório do GitHub.com em seu computador local para facilitar a correção de conflitos de mesclagem, adicionar ou remover arquivos e enviar commits maiores. Ao clonar um repositório, ele é copiado do GitHub.com para seu computador local.\n\n</div>\n\nA clonagem de um repositório retira uma cópia completa de todos os dados do repositório que GitHub.com têm naquele momento, incluindo todas as versões de cada arquivo e pasta do projeto. Você pode enviar suas alterações para o repositório remoto em GitHub.com ou baixar as alterações de outras pessoas de GitHub.com. Para saber mais, confira [Usar o Git](/pt/get-started/using-git).\n\nÉ possível clonar o repositório existente ou clonar o repositório existente de outra pessoa para contribuir para um projeto.\n\n## Clonar um repositório\n\n<div class=\"ghd-tool webui\">\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. Acima da lista de arquivos, clique em **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Code**.\n\n   ![Captura de tela da lista de arquivos na página de aterrissagem de um repositório. O botão \"Código\" está realçado com um contorno laranja escuro.](/assets/images/help/repository/code-button.png)\n\n3. Copie a URL do repositório.\n\n   * Para clonar o repositório usando HTTPS, em \"HTTPS\", clique em <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"Copy to clipboard\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg>.\n   * 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 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"Copy to clipboard\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg>.\n   * Para clonar um repositório usando a GitHub CLI, clique em **GitHub CLI** e em <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"Copy to clipboard\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg>.\n\n     ![Captura de tela do menu suspenso \"Código\". À direita da URL HTTPS do repositório, um ícone de cópia está contornado em laranja escuro.](/assets/images/help/repository/https-url-clone-cli.png)\n\n4. Abra <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n5. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.\n\n6. Digite `git clone` e cole a URL já copiada.\n\n   ```shell\n   git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY\n   ```\n\n7. Pressione **ENTER** para criar seu clone local.\n\n   ```shell\n   $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY\n   > Cloning into `Spoon-Knife`...\n   > remote: Counting objects: 10, done.\n   > remote: Compressing objects: 100% (8/8), done.\n   > remove: Total 10 (delta 1), reused 10 (delta 1)\n   > Unpacking objects: 100% (10/10), done.\n   ```\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).\n\nPara clonar um repositório localmente, use o subcomando `repo clone`. Substitua o parâmetro `repository` pelo nome do repositório. Por exemplo, `octo-org/octo-repo`, `monalisa/octo-repo` ou `octo-repo`. Se a parte `OWNER/` do argumento do repositório `OWNER/REPO` for omitida, ele usará como padrão o nome do usuário autenticador.\n\n```shell\ngh repo clone REPOSITORY\n```\n\nVocê também pode usar a URL GitHub para clonar um repositório.\n\n```shell\ngh repo clone https://github.com/PATH-TO/REPOSITORY\n```\n\n</div>\n\n<div class=\"ghd-tool desktop\">\n\n1. Em GitHub, acesse a página principal do repositório.\n2. Acima da lista de arquivos, clique em **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Code**.\n\n   ![Captura de tela da lista de arquivos na página de aterrissagem de um repositório. O botão \"Código\" está realçado com um contorno laranja escuro.](/assets/images/help/repository/code-button.png)\n3. Para clonar e abrir o repositório com o GitHub Desktop, clique em **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-desktop-download\" aria-label=\"desktop-download\" role=\"img\"><path d=\"m4.927 5.427 2.896 2.896a.25.25 0 0 0 .354 0l2.896-2.896A.25.25 0 0 0 10.896 5H8.75V.75a.75.75 0 1 0-1.5 0V5H5.104a.25.25 0 0 0-.177.427Z\"></path><path d=\"M1.573 2.573a.25.25 0 0 0-.073.177v7.5a.25.25 0 0 0 .25.25h12.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25h-3a.75.75 0 1 1 0-1.5h3A1.75 1.75 0 0 1 16 2.75v7.5A1.75 1.75 0 0 1 14.25 12h-3.727c.099 1.041.52 1.872 1.292 2.757A.75.75 0 0 1 11.25 16h-6.5a.75.75 0 0 1-.565-1.243c.772-.885 1.192-1.716 1.292-2.757H1.75A1.75 1.75 0 0 1 0 10.25v-7.5A1.75 1.75 0 0 1 1.75 1h3a.75.75 0 0 1 0 1.5h-3a.25.25 0 0 0-.177.073ZM6.982 12a5.72 5.72 0 0 1-.765 2.5h3.566a5.72 5.72 0 0 1-.765-2.5H6.982Z\"></path></svg> Open with GitHub Desktop**.\n\n   ![Captura de tela do menu suspenso \"Código\" de um repositório. Um botão, rotulado como \"Abrir com GitHub Desktop\" tem um contorno laranja escuro.](/assets/images/help/repository/open-with-desktop.png)\n4. Siga as instruções em GitHub Desktop para concluir a clonagem.\n\nPara saber mais, confira [Clonar um repositório do GitHub para o GitHub Desktop](/pt/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop).\n\n</div>\n\n## Clonar um repositório vazio\n\nUm 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.\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. Para clonar seu repositório pela linha de comando com HTTPS, em \"Configuração rápida\", clique em <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"Copy to clipboard\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg>. 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 clique <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"Copy to clipboard\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg>em .\n\n   ![Captura de tela das notas de configuração rápida de um repositório vazio. À direita da URL HTTPS do repositório, um ícone de cópia está destacado em laranja.](/assets/images/help/repository/empty-https-url-clone-button.png)\n\n   Como alternativa, para clonar o repositório na Área de Trabalho, clique **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-desktop-download\" aria-label=\"desktop-download\" role=\"img\"><path d=\"m4.927 5.427 2.896 2.896a.25.25 0 0 0 .354 0l2.896-2.896A.25.25 0 0 0 10.896 5H8.75V.75a.75.75 0 1 0-1.5 0V5H5.104a.25.25 0 0 0-.177.427Z\"></path><path d=\"M1.573 2.573a.25.25 0 0 0-.073.177v7.5a.25.25 0 0 0 .25.25h12.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25h-3a.75.75 0 1 1 0-1.5h3A1.75 1.75 0 0 1 16 2.75v7.5A1.75 1.75 0 0 1 14.25 12h-3.727c.099 1.041.52 1.872 1.292 2.757A.75.75 0 0 1 11.25 16h-6.5a.75.75 0 0 1-.565-1.243c.772-.885 1.192-1.716 1.292-2.757H1.75A1.75 1.75 0 0 1 0 10.25v-7.5A1.75 1.75 0 0 1 1.75 1h3a.75.75 0 0 1 0 1.5h-3a.25.25 0 0 0-.177.073ZM6.982 12a5.72 5.72 0 0 1-.765 2.5h3.566a5.72 5.72 0 0 1-.765-2.5H6.982Z\"></path></svg> em Configurar na Área de Trabalho** e siga os prompts para concluir o clone.\n\n   ![Captura de tela das notas de configuração rápida de um repositório vazio. O botão \"Configurar no Computador\" está contornado em laranja escuro.](/assets/images/help/repository/empty-desktop-clone-button.png)\n\n3. Abra <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n4. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.\n\n5. Digite `git clone` e cole a URL já copiada.\n\n   ```shell\n   git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY\n   ```\n\n6. Pressione **ENTER** para criar seu clone local.\n\n   ```shell\n   $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY\n   > Cloning into `Spoon-Knife`...\n   > remote: Counting objects: 10, done.\n   > remote: Compressing objects: 100% (8/8), done.\n   > remove: Total 10 (delta 1), reused 10 (delta 1)\n   > Unpacking objects: 100% (10/10), done.\n   ```\n\n## Solucionar problemas de erros de clonagem\n\nAo clonar um repositório, é possível que você encontre alguns erros.\n\nSe você não conseguir clonar um repositório, verifique se:\n\n* Você consegue conectar-se usando HTTPS. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors).\n* Você tem permissão para acessar o repositório que você deseja clonar. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors#check-your-permissions).\n* O ramo padrão que você deseja clonar ainda existe. Para saber mais, confira [Solucionar problemas de erros de clonagem](/pt/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors#error-remote-head-refers-to-nonexistent-ref-unable-to-checkout).\n\n## Leitura adicional\n\n* [Solucionar problemas de conectividade](/pt/get-started/using-github/troubleshooting-connectivity-problems)"}