Cambio del nombre de un codespace

Puede cambiar el nombre para mostrar del codespace a uno de su elección en GitHub o mediante la GitHub CLI.

Tool navigation

En este artículo

Acerca del cambio del nombre de un codespace

Al crear un codespace, se le asigna un nombre para mostrar generado automáticamente. Si tienes varios codespaces, el nombre para mostrar te ayuda a diferenciar entre ellos. Por ejemplo: literate space parakeet. Puedes cambiar el nombre para mostrar del codespace.

Para encontrar el nombre para mostrar de un codespace:

  • En GitHub Enterprise Cloud, consulta la lista de codespaces en https://github.com/codespaces.

    Captura de pantalla de una lista de tres codespaces en la página https://github.com/codespaces".

  • En la aplicación de escritorio Visual Studio Code o el cliente web VS Code, haz clic en el Explorador remoto. El nombre para mostrar es el segundo elemento de la lista. Por ejemplo: psychic chainsaw en la captura de pantalla siguiente.

    Captura de pantalla del "Explorador remoto" in VS Code. El nombre para mostrar del codespace, "encadenamiento psíquico", está resaltado con un contorno naranja oscuro.

    Nota: Si el Explorador remoto no se muestra en la barra de actividad:

    1. Abra la paleta de comandos. Por ejemplo, presionando el Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Escriba: details.
    3. Haz clic en Codespaces: Detalles.

  • En una ventana de terminal de la máquina local, usa este comando de GitHub CLI: gh codespace list.

Nombres permanentes de codespace

Además de un nombre para mostrar, cada codespace también tiene un nombre único y permanente. El nombre permanente es una combinación del nombre para mostrar inicial, seguido de algunos caracteres aleatorios, por ejemplo, literate-space-parakeet-w5vg5ww5p793g7g9. No se puede cambiar el nombre permanente.

En ocasiones, necesitarás conocer el nombre permanente de un codespace. Por ejemplo, cuando se usan algunos comandos de GitHub CLI o cuando se describe un codespace determinado compatible con GitHub.

Para encontrar el nombre permanente de un codespace, haz lo siguiente:

  • Abre el codespace en el buscador. El subdominio de la URL es el nombre del codespace. Por ejemplo: https://obscure-space-engine-grx7rgg6qp43v9j5.github.dev es la dirección URL del URL obscure-space-engine-grx7rgg6qp43v9j5.
  • Si no puedes abrir un codespace, puedes acceder al nombre desde la lista de codespaces en https://github.com/codespaces. Haz clic con el botón derecho en el nombre para mostrar del codespace y selecciona la opción de tu navegador para copiar la dirección del vínculo. La parte final de la dirección URL que se copia es el nombre permanente del codespace.
  • En un codespace, use este comando en el terminal: echo $CODESPACE_NAME.
  • Si GitHub CLI está instalado, ya sea localmente o en un codespace, usa este comando en el terminal para enumerar todos los codespaces: gh codespace list.

El nombre permanente del codespace también se incluye en muchos de los archivos de registro. Por ejemplo, en el registro de extensión de GitHub Codespaces después de fetching codespace o Connecting to codespace, y en el registro de consola del navegador después de clientUrl. Para obtener más información, vea «Registros de GitHub Codespaces».

Cambio del nombre de un codespace

Cambiar el nombre para mostrar de un codespace puede ser útil si tienes varios codespaces que vas a usar durante un período prolongado. Un nombre adecuado te ayuda a identificar un codespace que se usa para un propósito determinado.

Si tienes GitHub CLI instalado, puedes usarlo para trabajar con GitHub Codespaces. A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.

Si quieres cambiar el nombre para mostrar de un codespace, usa el subcomando gh codespace edit:

gh codespace edit -c PERMANENT-CODESPACE-NAME -d 'NEW-DISPLAY-NAME'

En este ejemplo, reemplaza PERMANENT-CODESPACE-NAME por el nombre permanente del codespace cuyo nombre para mostrar quieres cambiar. Reemplaza NEW-DISPLAY-NAME por el nombre para mostrar que quieres usar para este codespace.

Los nombres pueden tener hasta 48 caracteres de longitud. El nombre para mostrar puede contener cualquier combinación de caracteres, incluidos los espacios, siempre que lo incluya entre comillas simples.

Para obtener más información, vea «Uso de GitHub Codespaces con la CLI de GitHub».

Puede cambiar el nombre para mostrar de su codespace en GitHub.

  1. En la esquina superior izquierda de GitHub, seleccione y haga clic en **Codespaces ** para acceder a la página de "Sus codespaces" en github.com/codespaces.

    The current display name for each of your codespaces is displayed.

  2. Haga clic en los puntos suspensivos ( … ) situados a la derecha del codespace que quiera modificar.

  3. Haga clic en Rename.

  4. En el símbolo del sistema, en "Cambiar el nombre para mostrar a…", escribe el nombre para mostrar que quieras y haz clic en Aceptar.

Información adicional