# Excluir um codespace

Você pode excluir um codespace de que você não precisa mais.

## Visão geral

Os GitHub Codespaces são excluídos automaticamente depois que são parados e ficam inativos por um número definido de dias. O período de retenção de cada codespace é definido quando o codespace é criado e não é alterado. O período de retenção padrão é de 30 dias. Veja [Como configurar a exclusão automática de seus codespaces](/pt/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces?tool=webui).

Um codespace pode ser excluído manualmente de várias maneiras:

* No terminal, ao usar GitHub CLI
* Em Visual Studio Code
* No navegador da Web

Utilize as abas no topo deste artigo para exibir instruções para cada uma dessas maneiras de excluir um codespace.

> \[!NOTE]
> Você não pode excluir um codespace de dentro do JupyterLab.

## Por que você deve excluir codespaces não utilizados

Há custos associados ao armazenamento de codespaces. Portanto, você deve excluir os codespaces de que não precisa mais. Confira [Cobrança do GitHub Codespaces](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).

Há limites para o número de codespaces que você pode criar e o que você pode executar ao mesmo tempo. Esses limites variam de acordo com uma série de fatores. Se você atingir o número máximo de codespaces e tentar criar outro, uma mensagem será exibida informando que você deverá remover um codespace antes de criar um novo.

## Excluir um codespace

<div class="ghd-tool webui">

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).
2. À direita do codespace que deseja excluir, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Codespace configuration" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg> e em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-trash" aria-label="trash" role="img"><path d="M11 1.75V3h2.25a.75.75 0 0 1 0 1.5H2.75a.75.75 0 0 1 0-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75ZM4.496 6.675l.66 6.6a.25.25 0 0 0 .249.225h5.19a.25.25 0 0 0 .249-.225l.66-6.6a.75.75 0 0 1 1.492.149l-.66 6.6A1.748 1.748 0 0 1 10.595 15h-5.19a1.75 1.75 0 0 1-1.741-1.575l-.66-6.6a.75.75 0 1 1 1.492-.15ZM6.5 1.75V3h3V1.75a.25.25 0 0 0-.25-.25h-2.5a.25.25 0 0 0-.25.25Z"></path></svg> Delete**.

   ![Captura de tela de uma lista de codespaces com o menu suspenso de um deles exibido, mostrando a opção "Excluir".](/assets/images/help/codespaces/delete-codespace.png)

</div>

> \[!NOTE]
> Você pode ter codespaces predefinidos que estão consumindo armazenamento adicional e que não são exibidos neste painel. Para excluí-los, siga as etapas para "[Excluir uma configuração de pré-compilação](/pt/codespaces/prebuilding-your-codespaces/managing-prebuilds#deleting-a-prebuild-configuration)".

<div class="ghd-tool vscode">

Você pode excluir codespaces de dentro do VS Code quando você não estiver trabalhando no codespace.

1. No VS Code, na barra de Atividades, clique no ícone do Gerenciador Remoto.

   ![Captura de tela da Barra de Atividades. O ícone da barra lateral do "Gerenciador Remoto" (um retângulo sobreposto por um círculo) está realçado com um contorno laranja.](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.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**.
2. Em "GitHub Codespaces", clique com o botão direito do mouse no codespace que você deseja excluir.
3. Clique em **Excluir Codespace**.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).

Para excluir um codespace, use o subcomando `gh codespace delete` e escolha um codespace na lista exibida.

```shell
gh codespace delete
```

Se você tiver alterações não salvas, será solicitado que você confirme a exclusão. Use o sinalizador `--force` para forçar a exclusão, evitando esse prompt.

Para obter mais informações sobre esse comando, confira [o manual da GitHub CLI](https://cli.github.com/manual/gh_codespace_delete).

</div>

## Como excluir codespaces em massa

<div class="ghd-tool webui">

Você pode usar GitHub CLI para excluir vários dos seus codespaces, ou todos, usando um único comando. Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

</div>

<div class="ghd-tool vscode">

Você pode usar GitHub CLI para excluir vários dos seus codespaces, ou todos, usando um único comando. Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

</div>

<div class="ghd-tool cli">

Você pode excluir vários ou todos os seus codespaces com um único comando, usando `gh codespace delete` seguido por um destes sinalizadores:

```
          `--all` - Exclua todos os seus codespaces.

          `--repo REPOSITORY` - exclua todos os seus codespaces para este repositório. Ou use junto com o sinalizador `--days` para filtrar por idade do codespace.

          `--days NUMBER` - Exclua todos os seus codespaces que tenham mais dias do que o número especificado. Pode ser usado junto com o sinalizador `--repo`.
```

Por padrão, você será solicitado a confirmar a exclusão de todos os codespaces que contenham alterações não salvas. Você pode usar o sinalizador `--force` para ignorar essa confirmação.

### Exemplo

Exclua todos os codespaces do repositório `octo-org/octo-repo` criados há mais de 7 dias.

```shell
gh codespace delete --repo octo-org/octo-repo --days 7
```

</div>

## Como excluir codespaces em sua organização

Como proprietário de uma organização, você pode usar GitHub CLI para excluir qualquer codespace em sua organização.

<div class="ghd-tool webui">

Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

</div>

<div class="ghd-tool vscode">

Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

</div>

<div class="ghd-tool cli">

1. Insira um desses comandos para exibir uma lista de codespaces.
   * `gh codespace delete --org ORGANIZATION` – lista os codespaces atuais na organização especificada.
   * `gh codespace delete --org ORGANIZATION --user USER` – lista apenas os codespaces criados pelo usuário especificado.
     Você deve ser um proprietário da organização especificada.
2. Na lista de codespaces, navegue até o codespace que você deseja excluir.
3. Para excluir o codespace selecionado, pressione <kbd>Enter</kbd>.

   Se o codespace contiver alterações não salvas, será solicitado que você confirme a exclusão.

</div>

Você também pode usar a API REST para excluir codespaces de sua organização. Confira [Pontos de acesso da API REST para organizações Codespaces](/pt/rest/codespaces/organizations#delete-a-codespace-from-the-organization).

## Leitura adicional

* [Noções básicas sobre o ciclo de vida do codespace](/pt/codespaces/about-codespaces/understanding-the-codespace-lifecycle)
* [Como configurar a exclusão automática de seus codespaces](/pt/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces)
* [Como restringir o período de retenção de codespaces](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)