Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Resumen de GitHub Codespaces

En esta guía se presenta GitHub Codespaces y se proporcionan detalles de cómo funciona y cómo usarlo.

¿Qué es un codespace?

Un codespace es un ambiente de desarrollo que se hospeda en la nube. Puedes personalizar tu proyecto para GitHub Codespaces confirmando los archivos de configuración en el repositorio (lo que se conoce a menudo como configuración como código). Esta acción crea una configuración de codespace repetible para todos los usuarios del proyecto.

Cada codespace que creas se hospeda en GitHub en un contenedor Docker, el cual se ejecuta en una máquina virtual. Puedes elegir entre una selección de tipos de máquina virtual que tienen desde 2 núcleos, 8 GB de RAM y 32 GB de almacenamiento hasta 32 núcleos, 64 GB de RAM y 128 GB de almacenamiento.

De forma predeterminada, los codespaces se crean a partir de una imagen de Ubuntu Linux que incluye una selección de lenguajes y herramientas populares, pero puedes usar una imagen basada en cualquier distribución de Linux y configurarla según tus requisitos específicos. Independientemente de tu sistema operativo local, el codespace se ejecutará en un entorno de Linux. Windows y MacOS no son sistemas operativos compatibles con el contenedor remoto.

Puedes conectarte a tus codespaces desde el explorador, desde Visual Studio Code, desde la aplicación de puerta de enlace de JetBrains o mediante GitHub CLI. Al conectarte, accedes directamente al contenedor Docker. No tienes acceso al host de máquina virtual de Linux externo.

Un diagrama que muestra cómo funciona GitHub Codespaces

Uso de GitHub Codespaces

Para comenzar a desarrollar utilizando recursos de cómputo basados en la nube, puedes crear un codespace desde una plantilla o cualquier rama o confirmación en un repositorio. Al crear un codespace a partir de una plantilla, puedes empezar desde una plantilla en blanco o elegir una plantilla adecuada para el trabajo que estás haciendo.

Para empezar a trabajar con GitHub Codespaces, consulta "Inicio rápido de GitHub Codespaces". Para obtener más información sobre cómo crear un codespace, consulta "Creación de un codespace para un repositorio" o "Creación de un codespace a partir de una plantilla". Si quieres volver a un codespace que has creado, consulta "Apertura de un codespace existente". Para obtener más información sobre cómo funciona GitHub Codespaces, consulta "Profundización en GitHub Codespaces".

Uso de codespaces propiedad de tu cuenta personal

Todas las cuentas de GitHub.com tienen una cuota mensual de uso gratuito de GitHub Codespaces incluida en el plan Gratis o Pro. Puedes empezar a usar GitHub Codespaces en tu cuenta personal sin cambiar ninguna configuración ni proporcionar detalles de pago.

Puedes crear y usar un codespace para cualquier repositorio que puedas clonar. También puedes usar una plantilla para crear codespaces que no estén asociados inicialmente a un repositorio. Si creas un codespace desde un repositorio propiedad de la organización, el uso del codespace se cobrará a la organización (si la organización está configurada para ello) o a tu cuenta personal. Los codespaces creados a partir de plantillas siempre se cobran a tu cuenta personal.

Para seguir usando GitHub Codespaces más allá del almacenamiento y del uso de proceso mensuales incluidos, proporciona la información de pago y establece un límite de gasto. Para más información, consulta "Acerca de la facturación de GitHub Codespaces".

Uso de codespaces propiedad de la organización

Los propietarios de la organización pueden habilitar el uso de GitHub Codespaces, facturables a la organización o a la cuenta de empresa. Esto se aplica a codespaces creados a partir de repositorios propiedad de la organización. Para más información, consulta "Habilitación de GitHub Codespaces para la organización". Puedes establecer un límite de gasto para el uso de GitHub Codespaces en tu organización o cuenta empresarial. Para más información, consulta "Administración de los límites de gasto para GitHub Codespaces".

Si el uso de un codespace va a facturarse a una organización o empresa, se muestra cuando se crea el codespace. Para obtener más información, consulta "Creación de un codespace para un repositorio". Los codespaces que se facturan a una organización, o a su empresa matriz, son propiedad de la organización y pueden ser eliminados por un propietario de esta. Para más información, vea "Eliminación de un codespace".

Personalización de GitHub Codespaces

Para personalizar los runtimes y las herramientas del codespace, puedes crear una o varias configuraciones de contenedor de desarrollo para el repositorio. Agregar configuraciones de contenedor de desarrollo al repositorio permite definir una elección de diferentes entornos de desarrollo que sean adecuados para el trabajo que harán las personas en el repositorio.

Si creas un codespace desde un repositorio sin configuraciones de contenedor de desarrollo, GitHub Codespaces clonará tu repositorio en un entorno con la imagen de codespace predeterminada que incluye muchas herramientas, lenguajes y entornos en tiempo de ejecución. Si creas un codespace a partir de una plantilla, puedes empezar con alguna configuración inicial sobre la imagen predeterminada. Para obtener más información, consulte "Introducción a los contenedores de desarrollo".

Puedes personalizar aspectos del entorno de codespace mediante un repositorio de dotfiles público. Puedes usar dotfiles para establecer alias y preferencias de shell, o para instalar tus preferencias personales de las herramientas que quieras usar. Si usas GitHub Codespaces en el explorador o en Visual Studio Code, puedes usar Settings Sync para proporcionar al editor de codespace la misma configuración, métodos abreviados de teclado, fragmentos de código y extensiones que has configurado en la instalación local de Visual Studio Code.

Para más información, vea "Personalización del codespace".

Facturación para Codespaces

Para obtener más información sobre los precios, el almacenamiento y el uso de GitHub Codespaces, consulta "Acerca de la facturación de GitHub Codespaces".

Nota: Debes establecer un límite de gasto distinto de cero en tu cuenta personal, de organización o de empresa para que se pueda facturar a la cuenta por el uso de GitHub Codespaces.

De forma predeterminada, todas las cuentas tienen un límite de gasto de GitHub Codespaces de 0 USD. Esto impide que se creen codespaces o que se abran codespaces existentes, si esto supone que se incurra en un costo facturable para la cuenta personal, de organización o de empresa. En el caso de las cuentas personales, siempre se pueden crear y usar codespaces si la cuenta no ha alcanzado el límite de uso mensual incluido. En el caso de las organizaciones y las empresas, el límite de gasto predeterminado significa que, para que los usuarios puedan crear codespaces que se facturan a la organización, o a su empresa matriz, el límite debe cambiarse a un valor superior a 0 USD.

Los costes de GitHub Codespaces siempre se facturan mensualmente, incluso si la cuenta se factura anualmente. Para obtener información sobre cómo los propietarios de las organizaciones y los administradores de facturación pueden controlar el límite de gasto de GitHub Codespaces en una organización, consulta "Administración de los límites de gasto de GitHub Codespaces".