Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Comenzar con GitHub Desktop

Aprende cómo ajustar, autenticar y configurar GitHub Desktop para permitirte contribuir en proyectos directamente desde tu máquina.

En este artículo

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.

Introducción

GitHub Desktop es una aplicación que te habilita para interactuar con GitHub utilizando una GUI en vez de la línea de comandos o de un buscador web. GitHub Desktop fomenta que tú y tu equipo colaboren utilizando las mejoras prácticas con Git y GitHub. Puedes utilizar GitHub Desktop para completar la mayoría de los comandos de Git desde tu computadora de escritorio con confirmaciones visuales para los cambios. Puedes subir, extraer y clonar repositorios remotos con GitHub Desktop y utilizar herramientas colaborativas tales como atribuir confirmaciones y crear solicitudes de extracción.

Esta guía te ayudará a iniciar con GitHub Desktop mediante la configuración de la aplicación, la autenticación en tu cuenta, la configuración de ajustes básicos y la introducción de las bases fundamentales para administrar los proyectos con GitHub Desktop. Podrás utilizar GitHub Desktop para colaborar en proyectos y conectarte a repositorios remotos después de seguir esta guía.

Puede que te sea útil el entender los conceptos básicos de Git y de GitHub antes de comenzar a utilizar GitHub Desktop. Para obtener más información, consulta los siguientes artículos.

GitHub Desktop es un proyecto de código abierto. Puedes ver el itinerario, contribuir con el proyecto, o abrir un informe de problemas para proporcionar retroalimentación o solicitudes de características. Para obtener más información, consulta el repositorio desktop/desktop.

Parte 1: Instalación y autenticación

Puedes instalar GitHub Desktop o cualquier sistema operativo compatible. Para obtener más información, consulta la sección "Sistemas operativos compatibles".

Para instalar GitHub Desktop, visita la página de descargas para GitHub Desktop. Para obtener más información, consulta la sección "Instalar GitHub Desktop".

Después de que hayas instalado GitHub Desktop, puedes autenticar la aplicación con tu cuenta en GitHub o en GitHub Enterprise. Esta autenticación te permite conectarte remotamente a los repositorios en GitHub o en GitHub Enterprise.

  1. Antes de que te puedas autenticar en GitHub o en GitHub Enterprise, necesitarás una cuenta. Para obtener más información acerca de cómo crear una cuenta, consulta la sección "Registrar una cuenta de GitHub nueva" o contacta a tu administrador de stio de GitHub Enterprise.

  2. En el menú desplegable de GitHub Desktop, da clic en Preferencias. En la ventana de preferencias, da clic en Cuentas y sigue los pasos para iniciar sesión. Para obtener más información sobre la autenticación, consulta la sección "Autenticarte en GitHub".

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

  1. Antes de que te puedas autenticar en GitHub o en GitHub Enterprise, necesitarás una cuenta. Para obtener más información acerca de cómo crear una cuenta, consulta la sección "Registrar una cuenta de GitHub nueva" o contacta a tu administrador de stio de GitHub Enterprise.

  2. En el menú desplegable de archivo, da clic en Opciones. En la ventana de opciones, da clic en Cuentas y sigue los pasos para iniciar sesión. Para obtener más información sobre la autenticación, consulta la sección "Autenticarte en GitHub".

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

Parte 2: Configurar y personalizar GitHub Desktop

Después de que instales GitHub Desktop, puedes configurar y personalizar la app para que se adapte mejor a tus necesidades.

Puedes conectar o eliminar cuentas en GitHub o en GitHub Enterprise, elegir un editor de texto o shell predeterminado, editar tu configuración de Git, cambiar la apariencia de GitHub Desktop, personalizar los diálogos de sistema y configurar las preferencias de privacidad en la ventana de Preferencias de GitHub Desktop. Para obtener más información, consulta la sección "Configurar los ajustes básicos".

Los ajustes básicos en la ventana de Preferencias

Puedes conectar o eliminar cuentas en GitHub o en GitHub Enterprise, elegir un editor de texto o shell predeterminado, editar tu configuración de Git, cambiar la apariencia de GitHub Desktop, personalizar los diálogos de sistema y configurar las preferencias de privacidad en la ventana de Opciones de GitHub Desktop. Para obtener más información, consulta la sección "Configurar los ajustes básicos".

Los ajustes básicos en la ventana de Opciones

Parte 3: Colaborar en proyectos con GitHub Desktop

Después deinstalar, autenticarte y configurar la app, estás listo para comenzar a utilizar GitHub Desktop. Puedes crear, agregar, o clonar los repositorios y utilizar GitHub Desktop para administrar las contribuciones a tus repositorios.

Crear, agregar y clonar repositorios

Puedes crear un repositorio nuevo si seleccionas el menú de archivo y das clic en Repositorio nuevo.... Para obtener más información, consulta la sección "Crear tu primer repositorio utilizando GitHub Desktop".

Puedes agregar un repositorio desde tu computadora local si seleccionas el menú de Archivo y das clic en Agregar Repositorio Local.... Para obtener más información, consulta la sección Agregar un repositorio a GitHub Desktop desde tu computadora local".

Puedes clonar un repositorio desde GitHub si seleccionas el menú de Archivo y das clic en Clonar Repositorio.... Para obtener más información, consulta la sección "Clonar y Bifurcar Repositorios desde GitHub Desktop".

Las opciones del menú de Archivo para crear, agregar, y clonar repositorios

Las opciones del menú de Archivo para crear, agregar, y clonar repositorios

Realizar cambios en una rama

Puedes utilizar GitHub Desktop para crearuna rama de un proyecto. Las ramas aislan tu trabajo de desarrollo de otras ramas en el repositorio para que puedas experimentar con varios cambios de manera segura. Para obtener más información, consulta la sección "Administrar ramas".

El botón de Rama Nueva

Después de que hagas cambios a una rama, puedes revisarlos en GitHub Desktop y hacer una confirmación para controlar dichos cambios. Para obtener más información, consulta la sección "Confirmar y revisar cambios hechos a tu proyecto".

Viualizar y hacer confirmaciones

Si quieres acceder a tus cambios de manera remota o si quieres compartirlos con otras personas, puedes cargar tus confirmaciones en GitHub. Para obtener más información, consulta la sección "Subir los cambios a GitHub".

Colaborar con GitHub Desktop

Puedes utilizar GitHub Desktop para crear informes de problemas o solicitudes de extracción para colaborar en proyectos con otras personas. Los informes de problemas te ayudan a llevar un seguimiento de las ideas y debatir los posibles cambios a los proyectos. Las solicitudes de extracción te permiten compartir tus cambios propuestos con los demás, recibir retroalimentación y fusionar los cambios en un proyecto. Para obtener más información, consulta la sección "Crear un informe de problemas o solicitud de extracción."''

Puedes ver tus propias solicitudes de extracción o las de tus colaboradores en GitHub Desktop. El visualizar una solicitud de extracción en GitHub Desktop te permite ver cualquier cambio propuesto y hacer cambios adicionales si abres los repositorios y archivos del proyecto en tu editor de texto predeterminado. Para obtener más información, consulta la sección "Visualizar una solicitud de extracción en GitHub Desktop".

Mantener tu repositorio local sincronizado

Cuando haces cambios a tus repositorios locales o cuando otros hacen cambios a los repositorios remotos, necesitarás sincronizar tu copia local del proyecto con el repositorio remoto. GitHub Desktop puede mantener sincronizada tu copia local de un proyecto con la versión remota al subir y extraer las confirmaciones. Para obtener más información, consulta la sección "Sincronizar tu rama".

Leer más

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.