# codespace を削除する

不要になった codespace を削除することができます。

## 概要

GitHub Codespaces は、停止され、非アクティブな状態が定義された日数を過ぎると、自動的に削除されます。 各 codespace の保持期間は codespace の作成時に設定し、変わることはありません。 既定の保持期間は 30 日です。「[codespace の自動削除を構成する](/ja/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces?tool=webui)」をご覧ください。

codespace を手動で削除するには、さまざまな方法があります。

* ターミナルで GitHub CLI を使う
* Visual Studio Code
  で
* Web ブラウザーで

この記事の上部にあるタブを使って、codespace を削除する各種方法の手順を表示してください。

> \[!NOTE]
> JupyterLab 内から codespace を削除することはできません。

## 未使用の codespace を削除すべき理由

codespace の格納にはコストがかかります。 そのため、不要になった codespace は削除する必要があります。 「[GitHub Codespaces の課金](/ja/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」を参照してください。

作成できる codespace の数と、同時に実行できる codespace の数には制限があります。 これらの制限は、いくつかの要因によって異なります。 codespace の最大数に達してからさらに作成しようとすると、新しい codespace を作成する前に既存のものを削除する必要があることを示すメッセージが表示されます。

## codespace を削除する

<div class="ghd-tool webui">

1. GitHub の左上隅にある <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> を選択し、**<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> コードスペース**をクリックして、[github.com/codespaces](https://github.com/codespaces) の \[Your codespaces] ページに移動します。
2. 削除しようとする codespace の右側で \[<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>] をクリックし、次に \[**<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> 削除**] をクリックします。

   ![codespace 一覧と、その 1 つのドロップダウン メニューを示すスクリーンショット。\[削除\] オプションが表示されています。](/assets/images/help/codespaces/delete-codespace.png)

</div>

> \[!NOTE]
> このダッシュボードには表示されない、追加のストレージを使っている事前ビルドの codespace が存在する場合があります。 それらを削除するには、「[事前ビルド構成を削除する](/ja/codespaces/prebuilding-your-codespaces/managing-prebuilds#deleting-a-prebuild-configuration)」を参照してください。

<div class="ghd-tool vscode">

現在 codespace で作業していない場合、VS Code 内から codespace を削除できます。

1. VS Code のアクティビティ バーで、\[リモート エクスプローラー] アイコンをクリックします。

   ![アクティビティ バーのスクリーンショット。 \[リモート エクスプローラー\] サイド バーのアイコン (四角形の上に円が重なっている) がオレンジ色の枠線で強調表示されています。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)

   > \[!NOTE]
   > リモート エクスプローラーがアクティビティ バーに表示されない場合:
   >
   > 1. コマンド パレットにアクセスします。 たとえば、<kbd>Shift</kbd> + <kbd>Command</kbd> + <kbd>P</kbd> (Mac) / <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows/Linux) を押します。
   > 2. 次のコマンドを入力します: `details`
   > 3. **\[コードスペース: 詳細]** をクリックします。
2. \[GitHub Codespaces] の下で、削除したい codespace を右クリックします。
3. **\[Codespace の削除]** をクリックします。

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> GitHub CLI の詳細については、「[GitHub CLI について](/ja/github-cli/github-cli/about-github-cli)」を参照してください。

codespace を削除するには、`gh codespace delete` サブコマンドを使用し、表示されるリストから codespace を選択します。

```shell
gh codespace delete
```

保存していない変更がある場合は、削除の確認を求めるメッセージが表示されます。
`--force` フラグを使用すると、このプロンプトを回避して強制的に削除できます。

このコマンドの詳細については、[GitHub CLI に関するマニュアル](https://cli.github.com/manual/gh_codespace_delete)を参照してください。

</div>

## codespace の一括削除

<div class="ghd-tool webui">

GitHub CLI を使用すると、1 つのコマンドで複数またはすべての codespace を削除できます。 詳細については、このページの上部にある \[GitHub CLI] タブをクリックしてください。

</div>

<div class="ghd-tool vscode">

GitHub CLI を使用すると、1 つのコマンドで複数またはすべての codespace を削除できます。 詳細については、このページの上部にある \[GitHub CLI] タブをクリックしてください。

</div>

<div class="ghd-tool cli">

```
          `gh codespace delete` の後に次のフラグのいずれかを使用すると、1 つのコマンドを使用して、複数またはすべての codespace を削除できます。

          `--all` - すべての codespace を削除します。

          `--repo REPOSITORY` - このリポジトリのすべての codespace を削除します。 または、`--days` フラグと共に使用して、codespace の経過時間でフィルターします。

          `--days NUMBER` - 指定した日数より古い codespace をすべて削除します。 
          `--repo` フラグと共に使用できます。
```

既定では、保存されていない変更を含む codespace の削除を確認するメッセージが表示されます。
`--force` フラグを使用して、この確認をスキップできます。

### 例

7 日以上前に作成した `octo-org/octo-repo` リポジトリのすべての codespace を削除します。

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

</div>

## 組織内の codespace を削除する

組織の所有者は、GitHub CLI を使用して、組織内の任意の codespace を削除できます。

<div class="ghd-tool webui">

詳細については、このページの上部にある \[GitHub CLI] タブをクリックしてください。

</div>

<div class="ghd-tool vscode">

詳細については、このページの上部にある \[GitHub CLI] タブをクリックしてください。

</div>

<div class="ghd-tool cli">

1. 次のいずれかのコマンドを入力して、codespace の一覧を表示します。
   * `gh codespace delete --org ORGANIZATION` - 指定した組織内の現在の codespace を一覧表示します。
   * `gh codespace delete --org ORGANIZATION --user USER` - 指定したユーザーが作成した codespace のみを一覧表示します。
     自分が指定した組織の所有者である必要があります。
2. codespace の一覧で、削除したい codespace に移動します。
3. 選択した codespace を削除するには、<kbd>Enter</kbd> キーを押します。

   codespace に未保存の変更が含まれている場合は、削除の確認を求めるメッセージが表示されます。

</div>

REST API を使用して組織の codespace を削除することもできます。 「[Codespaces 組織用 REST API エンドポイント](/ja/rest/codespaces/organizations#delete-a-codespace-from-the-organization)」を参照してください。

## 参考資料

* [codespace ライフサイクルについて](/ja/codespaces/about-codespaces/understanding-the-codespace-lifecycle)
* [codespace の自動削除を構成する](/ja/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces)
* [codespace の保持期間を制限する](/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)