# Como abrir um codespace existente

Você pode reabrir um codespace que fechou ou parou e retornar ao trabalho.

Você pode reabrir qualquer um dos seus codespaces ativos ou interrompidos em GitHub, em Visual Studio Code ou usando GitHub CLI. Você não pode reabrir um codespace que foi excluído. Confira [Noções básicas sobre o ciclo de vida do codespace](/pt/codespaces/about-codespaces/understanding-the-codespace-lifecycle).

Você pode exibir todos os seus codespaces na página "Seus codespaces" em [github.com/codespaces](https://github.com/codespaces). Nesta página, você pode:

* Abra, interrompa ou exclua seus codespaces.
* Veja quem possui (e pode ser cobrado por) seus codespaces: sua conta pessoal ou organizações às quais você pertence. Confira [Cobrança do GitHub Codespaces](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).
* Ver o tipo de computador, o tamanho e o status dos codespaces.
* Crie um codespace escolhendo um dos modelos de GitHub ou clicando em **Novo codespace**. Confira [Como criar um codespace com base em um modelo](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template) e [Como criar um codespace para um repositório](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository).
* Impedir a exclusão automática de um codespace. Confira [Como configurar a exclusão automática de seus codespaces](/pt/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces?tool=webui#avoiding-automatic-deletion-of-codespaces).

<div class="ghd-tool webui">

## Como retomar um codespace em uma página do repositório

Você pode retomar rapidamente um codespace ao exibir um repositório no GitHub.

1. Com a guia **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code" aria-label="code" role="img"><path d="m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z"></path></svg> Code** do seu repositório exibida no GitHub, pressione <kbd>,</kbd> (a tecla vírgula).

   A página "Retomar codespace" é exibida. Isso permite que você retome o codespace usado mais recentemente para o branch do repositório selecionado no momento ou, se você estiver vendo uma solicitação de pull, para o branch do tópico da solicitação de pull.

   ![Captura de tela da página "Retomar codespace" que mostra os botões "Retomar este codespace" e "Criar um".](/assets/images/help/codespaces/resume-codespace.png)

2. Clique em **Retomar este codespace**.

   Como alternativa, caso você deseje criar um codespace para esse branch do repositório, clique em **Criar um**.

   > \[!NOTE]
   > Se você ainda não possui um codespace para esta branch, a página terá o título "Criar codespace" e um botão com o rótulo **Criar um novo codespace** será exibido.

Você pode adicionar o endereço desta página aos favoritos caso deseje voltar a ela rapidamente para retomar seu codespace. Como alternativa, você pode usar o endereço em um link para fornecer a outras pessoas uma forma rápida de criar e retomar os respectivos codespaces desse repositório.

## Como abrir um codespace existente na página "Seus codespaces"

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. Para abrir um codespace no editor padrão, clique no nome do codespace. Você pode definir seu editor padrão para Codespaces na sua página de configurações pessoais. Consulte [Definindo seu editor padrão para GitHub Codespaces](/pt/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces).

   Para abrir o codespace em um editor diferente do padrão:

   1. Clique nas reticências (**…**) à direita do codespace que você deseja abrir.
   2. Clique em **Abrir em**.
   3. Clique em **Abrir no APLICATIVO**.

   Você pode abrir o codespace no:

   * Seu navegador
   * Visual Studio Code
   * JupyterLab

   Se você escolher **Visual Studio Code** (aplicativo da área de trabalho), você deve garantir que tenha VS Code instalado em seu computador local.

   Se você escolher **JupyterLab**, o aplicativo JupyterLab deverá ser instalado no codespace. A imagem de contêiner de desenvolvimento padrão inclui o JupyterLab, portanto, os codespaces criados com base na imagem padrão sempre terão o JupyterLab instalado. Para obter mais informações sobre a imagem padrão, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-the-default-dev-container-configuration) e o repositório [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal). Se você não estiver usando a imagem padrão na configuração do contêiner de desenvolvimento, instale o JupyterLab adicionando o recurso `ghcr.io/devcontainers/features/python` ao arquivo `devcontainer.json`. Você deve incluir a opção `"installJupyterlab": true`. Para obter mais informações, confira o README do recurso [`python`](https://github.com/devcontainers/features/tree/main/src/python#python-python), no repositório `devcontainers/features`.

## Vinculando a um codespace existente

Você pode criar links para seus codespaces existentes. Isso é útil quando existe um codespace de longa duração ao qual você retorna com frequência. Você pode salvar o link em um local de sua escolha, como uma alternativa a usar o link no <https://github.com/codespaces>.

> \[!NOTE]
> Você só pode abrir seus próprios codespaces. Se alguém clicar em um link para um de seus codespaces, verá uma mensagem de erro 404.

Crie um link usando um dos seguintes padrões de URL. Nessas URLs, `CODESPACE-NAME` representa o nome permanente exclusivo do codespace, como `literate-space-parakeet-w5vg5ww5p793g7g9`, e não o nome de exibição do codespace. Você pode encontrar o nome de um codespace copiando o link para o codespace na página <https://github.com/codespaces> e extraindo o nome do codespace da URL.

| **Link abre em**                                              | \*\* Sintaxe do link\*\*                                                           |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Cliente Web do VS Code                                        | `https://CODESPACE-NAME.github.dev`                                                |
| Cliente Web do VS Code com um espaço de trabalho especificado | `https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY` |
| Aplicativo da área de trabalho do VS Code                     | `https://github.com/codespaces/CODESPACE-NAME?editor=vscode`                       |
| JupyterLab                                                    | `https://github.com/codespaces/CODESPACE-NAME?editor=jupyter`                      |

</div>

<div class="ghd-tool vscode">

## Como reabrir um codespace existente

> \[!NOTE]
> Para usar o GitHub Codespaces no VS Code, você deverá instalar a extensão do Codespaces. Consulte [Usando GitHub Codespaces no Visual Studio Code](/pt/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code).

1. No aplicativo de desktop VS Code, abra a Paleta de Comandos com <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Mac) ou <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux).
2. Digite "Codespaces" e selecione um dos comandos a seguir.
   * Para abrir um codespace em uma nova janela do VS Code, selecione **Codespaces: Abrir Codespace em Nova Janela**
   * Para abrir um codespace no editor da Web, selecione **Codespaces: Abrir no Navegador**
3. Clique no codespace que deseja alterar.

   ![Captura de tela da paleta de comandos do VS Code mostrando uma lista de codespaces disponíveis para conexão.](/assets/images/help/codespaces/open-codespace-from-vscode.png)

Você também pode acessar os comandos listados acima navegando até a exibição do Gerenciador Remoto no VS Code e clicando com o botão direito do mouse no codespace que deseja abrir.

![Captura de tela de um codespace selecionado no Gerenciador Remoto, com a opção "Abrir no Navegador" realçada no menu que é exibido ao clicar com o botão direito do mouse.](/assets/images/help/codespaces/open-codespace-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**.

## Vinculando a um codespace existente

Você pode criar links para seus codespaces existentes. Isso é útil quando existe um codespace de longa duração ao qual você retorna com frequência. Você pode salvar o link em um local de sua escolha, como uma alternativa a usar o link no <https://github.com/codespaces>.

> \[!NOTE]
> Você só pode abrir seus próprios codespaces. Se alguém clicar em um link para um de seus codespaces, verá uma mensagem de erro 404.

Crie um link usando um dos seguintes padrões de URL. Nessas URLs, `CODESPACE-NAME` representa o nome permanente exclusivo do codespace, como `literate-space-parakeet-w5vg5ww5p793g7g9`, e não o nome de exibição do codespace. Você pode encontrar o nome de um codespace copiando o link para o codespace na página <https://github.com/codespaces> e extraindo o nome do codespace da URL.

| **Link abre em**                                              | \*\* Sintaxe do link\*\*                                                           |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Cliente Web do VS Code                                        | `https://CODESPACE-NAME.github.dev`                                                |
| Cliente Web do VS Code com um espaço de trabalho especificado | `https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY` |
| Aplicativo da área de trabalho do VS Code                     | `https://github.com/codespaces/CODESPACE-NAME?editor=vscode`                       |
| JupyterLab                                                    | `https://github.com/codespaces/CODESPACE-NAME?editor=jupyter`                      |

</div>

<div class="ghd-tool cli">

## Como reabrir um codespace existente

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).

1. Em um terminal, insira um dos seguintes comandos da GitHub CLI.
   * Para abrir um codespace no VS Code, insira:

     ```shell copy
     gh codespace code
     ```

     > \[!NOTE]
     > É necessário ter o VS Code instalado no computador local. Consulte [Configurar Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview) na documentação VS Code.

   * Para abrir um codespace no navegador, insira:

     ```shell copy
     gh codespace code --web
     ```

   * Para abrir um codespace no JupyterLab, insira:

     ```shell copy
     gh codespace jupyter
     ```

     > \[!NOTE]
     > O aplicativo JupyterLab deve ser instalado no codespace que você está abrindo. A imagem de contêiner de desenvolvimento padrão inclui o JupyterLab, portanto, os codespaces criados com base na imagem padrão sempre terão o JupyterLab instalado. Para obter mais informações sobre a imagem padrão, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-the-default-dev-container-configuration) e o repositório [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal). Se você não estiver usando a imagem padrão na configuração do contêiner de desenvolvimento, instale o JupyterLab adicionando o recurso `ghcr.io/devcontainers/features/python` ao arquivo `devcontainer.json`. Você deve incluir a opção `"installJupyterlab": true`. Para obter mais informações, confira o README do recurso [`python`](https://github.com/devcontainers/features/tree/main/src/python#python-python), no repositório `devcontainers/features`.

   * Para acessar um codespace da linha de comando, por SSH, insira:

     ```shell copy
     gh codespace ssh
     ```

2. Usando as teclas de direção, navegue até o codespace que deseja abrir.

3. Para abrir o codespace, pressione <kbd>Enter</kbd>.

Consulte [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code) no manual GitHub CLI.

</div>

## Leitura adicional

* [Pontos de acesso da API REST para organizações Codespaces](/pt/rest/codespaces/organizations)