Clonar un repositorio

Al crear un repositorio en GitHub, existe como un repositorio remoto. Puedes clonar tu repositorio para crear una copia local en tu computadora y sincronizarla entre las dos ubicaciones.

Platform navigation

En este artículo

Acerca de clonar un repositorio

Puedes clonar un repositorio de GitHub.com en el equipo local o en un codespace, para que sea más fácil corregir conflictos de combinación, agregar o quitar archivos e insertar confirmaciones más grandes. Al clonar un repositorio, se copia el repositorio de GitHub.com en la máquina local o en una máquina virtual remota cuando se crea un codespace. Para más información sobre la clonación en un codespace, consulta Creación de un codespace para un repositorio.

Puedes clonar un repositorio desde GitHub.com a tu equipo local para que sea más fácil corregir conflictos de combinación, agregar o quitar archivos e insertar comentarios más grandes. Cuando clonas un repositorio, copias el repositorio de GitHub.com en tu máquina local.

Puedes clonar un repositorio desde GitHub.com a tu equipo local para que sea más fácil corregir conflictos de combinación, agregar o quitar archivos e insertar comentarios más grandes. Cuando clonas un repositorio, copias el repositorio de GitHub.com en tu máquina local.

Clonar un repositorio extrae una copia integral de todos los datos del repositorio que GitHub.com tiene en ese momento, incluidas todas las versiones de cada archivo y carpeta del proyecto. Puedes insertar los cambios en el repositorio remoto en GitHub.com o extraer los cambios de otras personas desde GitHub.com. Para más información, consulta Utilizar GitHub.

Puedes clonar tu repositorio existente o clonar el repositorio existente de alguien más para contribuir con un proyecto.

Clonar un repositorio

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Encima de la lista de archivos, haz clic en Código.

    Captura de pantalla de la lista de archivos en la página de aterrizaje de un repositorio. El botón "Código" está resaltado con un contorno naranja oscuro.

  3. Copia la dirección URL del repositorio.

    • Para clonar el repositorio con HTTPS, en "HTTPS", haz clic en .

    • Para clonar el repositorio mediante una clave SSH, incluido un certificado emitido por la entidad de certificación SSH de la organización, haz clic en SSH y luego en .

    • Para clonar un repositorio mediante GitHub CLI, haz clic en GitHub CLI y, después, en .

      Captura de pantalla del menú desplegable "Código". A la derecha de la dirección URL HTTPS del repositorio, hay un icono de copia resaltado en naranja oscuro.

  4. Abra TerminalTerminalGit Bash.

  5. Cambia el directorio de trabajo actual a la ubicación en donde quieres clonar el directorio.

  6. Escriba git clone y pegue la dirección URL que ha copiado antes.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

  7. Presione Entrar para crear el clon local.

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remove: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.

Note

Para más información sobre GitHub CLI, consulta Acerca del CLI de GitHub.

Para clonar un repositorio localmente, use el subcomando repo clone. Reemplace el parámetro repository con el nombre del repositorio. Por ejemplo, octo-org/octo-repo, monalisa/octo-repo o octo-repo. Si se omite la parte OWNER/ del argumento de repositorio OWNER/REPO, el valor predeterminado es el nombre del usuario que realiza la autenticación.

gh repo clone REPOSITORY

También puedes utilizar la URL de GitHub para clonar el repositorio.

gh repo clone https://github.com/PATH-TO/REPOSITORY

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Encima de la lista de archivos, haz clic en Código.

    Captura de pantalla de la lista de archivos en la página de aterrizaje de un repositorio. El botón "Código" está resaltado con un contorno naranja oscuro.

  3. Para clonar y abrir el repositorio con GitHub Desktop, haz clic en Abrir con GitHub Desktop .

    Captura de pantalla de la lista desplegable "Código" de un repositorio. Un botón con la etiqueta "Abrir con GitHub Desktop" está resaltado en naranja oscuro.

  4. Sigue las indicaciones en GitHub Desktop para completar la clonación.

Para más información, consulta Cómo clonar un repositorio desde GitHub hasta GitHub Desktop.

Clonar un repositorio vacío

Un repositorio vacío no contiene archivos. Habitualmente se hace si no inicias el repositorio con un README antes de crearlo.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Para clonar el repositorio mediante la línea de comandos con HTTPS, en "Configuración rápida", haz clic en . Para clonar el repositorio mediante una clave SSH, incluido un certificado emitido por la entidad de certificación SSH de la organización, haz clic en SSH y luego en .

    Recorte de pantalla de las notas de configuración rápida para un repositorio vacío. A la derecha de la dirección URL HTTPS del repositorio, hay un icono de copia resaltado en color naranja.

    Como alternativa, para clonar el repositorio en el escritorio, haz clic en Configurar en el Escritorio y siga las indicaciones para completar la clonación.

    Recorte de pantalla de las notas de configuración rápida para un repositorio vacío. El botón "Configurar en escritorio" está resaltado en color naranja oscuro.

  3. Abra TerminalTerminalGit Bash.

  4. Cambia el directorio de trabajo actual a la ubicación en donde quieres clonar el directorio.

  5. Escriba git clone y pegue la dirección URL que ha copiado antes.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

  6. Presione Entrar para crear el clon local.

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remove: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.

Solucionar los errores de clonado

Cuando clonas un repositorio, es posible que puedas encontrar algunos errores.

Si no puedes clonar un repositorio, revisa que:

Información adicional