Skip to main content

Using Codespaces in Visual Studio Code

You can develop in your codespace directly in Visual Studio Code by connecting the Acerca de GitHub Codespaces extension with your account on GitHub Enterprise Cloud.

Codespaces está disponible para las organizaciones que utilicen GitHub Team o Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

About Codespaces in Visual Studio Code

You can use your local install of Visual Studio Code to create, manage, work in, and delete codespaces. To use Codespaces in VS Code, you need to install the Acerca de GitHub Codespaces extension. For more information on setting up Codespaces in VS Code, see "Prerequisites."

By default, if you create a new codespace on GitHub.com, it will open in the browser. If you would prefer to open any new codespaces in VS Code automatically, you can set your default editor to be VS Code. For more information, see "Setting your default editor for Codespaces."

If you prefer to work in the browser, but want to continue using your existing VS Code extensions, themes, and shortcuts, you can turn on Settings Sync. For more information, see "Personalizing Codespaces for your account."

Prerequisites

To develop in a codespace directly in VS Code, you must install and sign into the Acerca de GitHub Codespaces extension with your GitHub Enterprise Cloud credentials. The Acerca de GitHub Codespaces extension requires VS Code October 2020 Release 1.51 or later.

Use the Mercado de Visual Studio Code to install the Acerca de GitHub Codespaces extension. For more information, see Extension Marketplace in the VS Code documentation.

  1. En VS Code, en la barra lateral izquierda, da clic en el icono de Explorador Remoto. El icono de explorador remoto en Visual Studio Code

  2. Click Sign in to view GitHub....

    Signing in to view Codespaces

  3. To authorize VS Code to access your account on GitHub Enterprise Cloud, click Allow.

  4. Sign in to GitHub Enterprise Cloud to approve the extension.

  1. En VS Code, en la barra lateral izquierda, da clic en el icono de Explorador Remoto. El icono de explorador remoto en Visual Studio Code

  2. Use the "REMOTE EXPLORER" drop-down, then click Acerca de GitHub Codespaces.

    The Codespaces header

  3. Click Sign in to view Codespaces....

    Signing in to view Codespaces

  4. To authorize VS Code to access your account on GitHub Enterprise Cloud, click Allow.

  5. Sign in to GitHub Enterprise Cloud to approve the extension.

Creating a codespace in VS Code

Después de que conectes tu cuenta de GitHub.com a la extensión de Acerca de GitHub Codespaces, puedes crear un codespace nuevo. Para obtener más información sobre la extensión de Acerca de GitHub Codespaces, consulta el Mercado de VS Code marketplace.

Nota: Actualmente, VS Code no te permite elegir una configuración de contenedor dev cuando creas un codespace. Si quieres elegir una configuración de contenedor dev específica, utiliza la interfaz web de GitHub para crear tu codespace. Para obtener más información, haz clic en la pestaña de Buscador web en la parte superior de esta página.

  1. En VS Code, en la barra lateral izquierda, da clic en el icono de Explorador Remoto. El icono de explorador remoto en Visual Studio Code

  2. Haz clic en el icono de agregar: .

    La opciòn de crear un codespace nuevo en Codespaces

  3. Escribe el nombre del repositorio en el cual quieras desarrollar y luego selecciónalo.

    Buscar un repositorio para crear un Codespaces nuevo

  4. Da clic en la rama en la que quieras desarrollar.

    Buscar una rama para crear un Codespaces nuevo

  5. Haz clic en el tipo de máquina que quieras utilizar.

    Tipos de instancia para un Codespaces nuevo

    Nota: Tu elección de tipos de máquina disponible podría verse limitada por una política que se haya configurado para tu organización o por una especificación de tipo de máquina mínima para tu repositorio. Para obtener más información, consulta las secciones "Restringir el acceso a los tipos de máquina" y "Configurar una especificación mínima para las máquinas de los codespaces".

Opening a codespace in VS Code

  1. En VS Code, en la barra lateral izquierda, da clic en el icono de Explorador Remoto. El icono de explorador remoto en Visual Studio Code

  2. Under "Codespaces", click the codespace you want to develop in.

  3. Click the Connect to Codespace icon.

    The Connect to Codespace icon in VS Code

Changing the machine type in VS Code

Habitualmente, puedes ejecutar tu codespace en una variedad de máquinas remotas, desde de 2 núcleos hasta de 32 núcleos. Cada una de estas tiene un nivel de recursos y de facturación diferentes. Para obtener más información, consulta la sección "Acerca de la facturación para los Codespaces".

Predeterminadamente, el tipo de máquina con los recursos válidos más bajos se utiliza cuando creas un codespace. You can change the machine type of your codespace at any time.

  1. In VS Code, open the Command Palette (shift command P / shift control P).

  2. Search for and select "Codespaces: Change Machine Type."

    Searching for a branch to create a new Codespaces

  3. Click the codespace that you want to change.

    Searching for a branch to create a new Codespaces

  4. Choose the machine type you want to use.

    Note: Tu elección de tipos de máquina disponible podría verse limitada por una política que se haya configurado para tu organización o por una especificación de tipo de máquina mínima para tu repositorio. Para obtener más información, consulta las secciones "Restringir el acceso a los tipos de máquina" y "Configurar una especificación mínima para las máquinas de los codespaces".

  5. If the codespace is currently running, a message is displayed asking if you would like to restart and reconnect to your codespace now.

    Click Yes if you want to change the machine type used for this codespace immediately.

    If you click No, or if the codespace is not currently running, the change will take effect the next time the codespace restarts.

Deleting a codespace in VS Code

Puedes borrar codespaces desde dentro de VS Code cuando no estés trabajando actualmente en alguno de ellos.

  1. En VS Code, en la barra lateral izquierda, da clic en el icono de Explorador Remoto. El icono de explorador remoto en Visual Studio Code

  2. Debajo de "GITHB CODESPACES", haz clic derecho en aquél que quieras borrar.

  3. Haz clic en Borrar Codespace.

    Borrar un codespace en GitHub

Switching to the Insiders build of VS Code

You can use the Insiders Build of VS Code within Codespaces.

  1. In bottom left of your Codespaces window, select Settings.

  2. From the list, select "Switch to Insiders Version".

    Clicking on "Insiders Build" in Codespaces

  3. Once selected, Codespaces will continue to open in Insiders Version.