> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciamento de sessões

Uma “sessão” é o contêiner para suas conversas com o Claude Code, e seu conceito é consistente com o Conversation History (“histórico de conversas”) do Claude Code. Cada projeto pode conter várias sessões, e os contextos de sessões diferentes são isolados entre si, o que é ideal para lidar com diferentes tarefas ou temas no mesmo projeto sem interferência mútua.

## Visão geral das sessões

Cada sessão contém:

* **Histórico de conversas** — Suas conversas com o Claude Code, chamadas de ferramentas/comandos e principais resultados de saída, usados para manter o contexto (por exemplo, lembrar caminhos de arquivos com erro, soluções já discutidas etc.).
* **Informações do projeto** — Informações relacionadas ao projeto que o Claude Code lembra.
* **Registros de chamadas de ferramentas** — Todas as chamadas de ferramentas/comandos e seus resultados de saída executados pelo Claude Code ao realizar tarefas.

<Info>
  O contexto da sessão afeta as respostas do Claude Code. Se você quiser começar uma tarefa completamente nova do zero, recomendamos criar uma nova sessão.
</Info>

### Criar uma sessão

<Steps>
  <Step title="Certifique-se de que um projeto esteja selecionado">
    Selecione um projeto na barra lateral esquerda
  </Step>

  <Step title="Clique em novo">
    Na área da lista de sessões, clique no botão **+ Nova sessão**
  </Step>

  <Step title="Comece a conversa">
    Depois que a nova sessão for criada, você poderá começar a conversar com o Claude Code na caixa de chat à direita
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/jiekou/pt/docs/cc/assets/cc-new-session.png" alt="Criar nova sessão" />
</Frame>

### Alternar sessões

Clique em qualquer sessão na lista de sessões para alternar. Ao alternar sessões:

* O conteúdo da conversa atual será salvo automaticamente
* O histórico da nova sessão será carregado e exibido
* O contexto do Claude Code será alternado para a sessão de destino

### Excluir sessão

<Steps>
  <Step title="Encontre a sessão">
    Encontre na lista de sessões a sessão que deseja excluir
  </Step>

  <Step title="Clique com o botão direito ou clique no menu">
    Clique com o botão direito na sessão ou clique no ícone de menu
  </Step>

  <Step title="Selecione excluir">
    Confirme a operação de exclusão
  </Step>
</Steps>

<Warning>
  Excluir uma sessão removerá permanentemente todo o histórico de conversas dessa sessão. Esta operação não pode ser desfeita.
</Warning>

## Boas práticas para sessões

### Quando criar uma nova sessão

* **Começar uma nova tarefa** — Quando você for iniciar uma tarefa completamente nova e sem relação com as anteriores
* **Contexto longo demais** — Quando a conversa ficar muito longa e a velocidade de resposta diminuir
* **Recomeçar** — Quando houver desvios na compreensão do Claude Code e for necessário recomeçar
* **Separar focos** — Quando você quiser gerenciar separadamente o desenvolvimento de diferentes funcionalidades ou módulos

### Quando continuar uma sessão existente

* **Desenvolvimento iterativo** — Para continuar iterando e melhorando a mesma funcionalidade
* **Correção de erros** — Para corrigir erros no código anterior do Claude Code ou em outros artefatos
* **Expansão de funcionalidades** — Para adicionar novas funcionalidades com base em uma implementação existente
* **Contexto relacionado** — Quando a nova questão estiver intimamente relacionada à conversa anterior

## Armazenamento de sessões

Os dados da sessão são armazenados no sandbox em nuvem correspondente ao projeto, com as seguintes características:

| Característica                | Descrição                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------- |
| **Salvamento automático**     | O conteúdo da conversa é salvo automaticamente em tempo real                      |
| **Acesso entre dispositivos** | Pode ser acessado em qualquer dispositivo após fazer login com a mesma API Key    |
| **Vinculado ao projeto**      | As sessões são associadas ao projeto; excluir o projeto excluirá todas as sessões |

<Tip>
  Recomendamos exportar ou copiar localmente conteúdos importantes das conversas.
</Tip>

## Documentação relacionada

<Columns cols={2}>
  <Card title="Gerenciamento de projetos" icon="folder" href="/pt/docs/cc/project">
    Gerencie e organize seus projetos
  </Card>

  <Card title="Modo Chat" icon="message-bot" href="/pt/docs/cc/chat-mode">
    No modo Chat, você pode permitir que o Claude Code ajude a concluir tarefas por meio de uma caixa de diálogo.
  </Card>
</Columns>