# Como renomear um codespace

Você pode alterar o nome de exibição do codespace para uma escolha sua por meio do GitHub ou usando a GitHub CLI.

## Como renomear um codespace

Quando você cria um codespace, ele recebe um nome de exibição gerado automaticamente. Se você tiver vários codespaces, o nome de exibição ajudará você a diferenciar entre eles. Por exemplo: `literate space parakeet`. Você pode alterar o nome de exibição do seu codespace.

Para encontrar o nome de exibição de um codespace:

* No GitHub, exiba a sua lista de codespaces em <https://github.com/codespaces>.

  ![Captura de tela de uma lista de três codespaces na página https://github.com/codespaces."](/assets/images/help/codespaces/your-codespaces-list.png)

* No aplicativo da área de trabalho Visual Studio Code, ou no cliente Web VS Code, clique no Gerenciador Remoto. O nome de exibição é o segundo item na lista. Por exemplo: `psychic chainsaw` na captura de tela abaixo.

  ![Captura de tela do "Explorador Remoto" em VS Code. O nome de exibição do codespace, "motosserra psíquica", é realçado com um contorno laranja escuro.](/assets/images/help/codespaces/codespaces-remote-explorer.png)

  > \[!NOTE]
  > Se o Remote Explorer não for exibido na barra Activity:
  >
  > 1. Abra a paleta de comandos. Por exemplo, pressionando <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (no Mac) / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (no Windows/Linux).
  > 2. Digite: `details`.
  > 3. Clique em **Codespaces: detalhes**.

* Em uma janela de terminal em seu computador local, use este comando GitHub CLI: `gh codespace list`.

### Nomes de codespace permanentes

Além de um nome de exibição, cada codespace também tem um nome exclusivo e permanente. O nome permanente é uma combinação do nome de exibição inicial, seguido por alguns caracteres aleatórios: por exemplo, `literate-space-parakeet-w5vg5ww5p793g7g9`. Você não pode alterar o nome permanente.

Ocasionalmente, você precisará saber o nome permanente de um codespace. Por exemplo, quando você usa alguns comandos do GitHub CLI ou quando discute um codespace específico com o suporte do GitHub.

Para encontrar o nome permanente de um codespace, faça o seguinte:

* Abra o codespace no navegador. O subdomínio da URL é o nome do codespace. Por exemplo: `https://obscure-space-engine-grx7rgg6qp43v9j5.github.dev` é a URL do codespace `obscure-space-engine-grx7rgg6qp43v9j5`.
* Se não for possível abrir um codespace, você poderá acessar o nome da sua lista de codespaces em <https://github.com/codespaces>. Clique com o botão direito do mouse no nome de exibição do codespace e selecione a opção do navegador para copiar o endereço do link. A parte final da URL copiada é o nome permanente do codespace.
* Em um codespace, use este comando no terminal: `echo $CODESPACE_NAME`.
* Se a GitHub CLI estiver instalada, localmente ou em um codespace, use este comando no terminal para listar todos os seus codespaces: `gh codespace list`.

O nome permanente do codespace também está incluído em muitos dos arquivos de registro. Por exemplo, no log de extensão do GitHub Codespaces após `fetching codespace` e no log do console do navegador após `Connecting to codespace`. Para saber mais, confira [Logs do GitHub Codespaces](/pt/codespaces/troubleshooting/github-codespaces-logs).

## Como renomear um codespace

Alterar o nome de exibição de um codespace poderá ser útil se você tiver vários codespaces que usará por um período estendido. Um nome apropriado ajuda você a identificar um codespace que você usa para uma finalidade específica.

<div class="ghd-tool cli">

Se você instalou a GitHub CLI, use-a para trabalhar com o GitHub Codespaces. Para obter instruções de instalação para GitHub CLI, veja o [repositório GitHub CLI](https://github.com/cli/cli#installation).

Para alterar o nome de exibição de um codespace, use o subcomando `gh codespace edit`:

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

Neste exemplo, substitua `PERMANENT-CODESPACE-NAME` pelo nome permanente do codespace cujo nome de exibição você deseja alterar. Substitua `NEW-DISPLAY-NAME` pelo nome de exibição que você deseja usar para este codespace.

Os nomes de exibição podem ter até 48 caracteres. O nome de exibição pode conter qualquer combinação de caracteres, incluindo espaços, desde que você o coloque entre aspas simples.

Para saber mais, confira [Usando GitHub Codespaces com o GitHub CLI](/pt/codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli#rename-a-codespace).

</div>

<div class="ghd-tool webui">

Você pode alterar o nome de exibição do seu codespace no GitHub.

1. No canto superior esquerdo de GitHub, selecione <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-three-bars" aria-label="Open global navigation menu" role="img"><path d="M1 2.75A.75.75 0 0 1 1.75 2h12.5a.75.75 0 0 1 0 1.5H1.75A.75.75 0 0 1 1 2.75Zm0 5A.75.75 0 0 1 1.75 7h12.5a.75.75 0 0 1 0 1.5H1.75A.75.75 0 0 1 1 7.75ZM1.75 12h12.5a.75.75 0 0 1 0 1.5H1.75a.75.75 0 0 1 0-1.5Z"></path></svg> e clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-codespaces" aria-label="codespaces" role="img"><path d="M0 11.25c0-.966.784-1.75 1.75-1.75h12.5c.966 0 1.75.784 1.75 1.75v3A1.75 1.75 0 0 1 14.25 16H1.75A1.75 1.75 0 0 1 0 14.25Zm2-9.5C2 .784 2.784 0 3.75 0h8.5C13.216 0 14 .784 14 1.75v5a1.75 1.75 0 0 1-1.75 1.75h-8.5A1.75 1.75 0 0 1 2 6.75Zm1.75-.25a.25.25 0 0 0-.25.25v5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-5a.25.25 0 0 0-.25-.25Zm-2 9.5a.25.25 0 0 0-.25.25v3c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-3a.25.25 0 0 0-.25-.25Z"></path><path d="M7 12.75a.75.75 0 0 1 .75-.75h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1-.75-.75Zm-4 0a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1-.75-.75Z"></path></svg> Codespaces** para levar você até a página "Your codespaces" em [github.com/codespaces](https://github.com/codespaces).

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

2. Clique nas reticências ( **…** ) à direita do codespace que deseja modificar.

3. Clique em **Renomear**.

4. No prompt, em "Alterar nome de exibição para..." digite o nome de exibição desejado e clique em **OK**.

</div>

## Leitura adicional

* [Definir as preferências de usuário](/pt/codespaces/setting-your-user-preferences)
* [Gerenciar seus codespaces](/pt/codespaces/managing-your-codespaces)