Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Uma sessão é uma conversa salva vinculada a um diretório de projeto. Claude Code a armazena localmente conforme você trabalha, para que você possa retomar de onde parou, ramificar para tentar uma abordagem diferente ou alternar entre tarefas.
O aplicativo desktop, Claude Code na web e a extensão VS Code mantêm seu próprio histórico de sessões. Esta página abrange a CLI:
- Retomar uma conversa anterior por sinalizador, nome ou PR
- Nomear sessões para que você possa encontrá-las depois
- Procurar sessões com o seletor
/resume
- Ramificar uma conversa para tentar uma abordagem diferente
- Exportar transcritos e encontrá-los no disco
Retomar uma sessão
As sessões são salvas continuamente em arquivos de transcrição locais conforme você trabalha, para que você possa retornar a uma após sair ou executar /clear. Use estes pontos de entrada:
| Comando | O que faz |
|---|
claude --continue | Retoma a sessão mais recente no diretório atual |
claude --resume | Abre o seletor de sessão |
claude --resume <name> | Retoma a sessão nomeada diretamente |
claude --from-pr <number> | Retoma a sessão vinculada a esse pull request |
/resume | Alterna para uma conversa diferente de dentro de uma sessão ativa |
claude -p ou o Agent SDK não aparecem no seletor de sessão, mas você ainda pode retomar uma passando seu ID de sessão para claude --resume <session-id>.
Onde o seletor de sessão procura
As sessões são armazenadas por diretório de projeto. Por padrão, o seletor de sessão mostra sessões interativas da worktree atual, além de sessões iniciadas em outro lugar que adicionaram o diretório atual com /add-dir. Use Ctrl+W para expandir para todas as worktrees do repositório ou Ctrl+A para expandir para cada projeto nesta máquina.
Selecionar uma sessão de outra worktree do mesmo repositório a retoma no local. Selecionar uma sessão de um projeto não relacionado copia um comando cd e retoma para sua área de transferência.
Retomar por nome resolve no repositório atual e suas worktrees. Ambas as formas procuram por uma correspondência exata e a retomam diretamente mesmo que resida em uma worktree diferente:
| Comando | Correspondência exata | Nome ambíguo |
|---|
claude --resume <name> | Retoma diretamente | Abre o seletor de sessão com o nome pré-preenchido como termo de pesquisa |
/resume <name> | Retoma diretamente | Relata um erro; execute /resume sem argumentos para abrir o seletor de sessão |
Nomeie suas sessões
Dê às sessões nomes descritivos para que sejam encontráveis no seletor de sessão e retomáveis por nome. Isso é mais importante quando você está trabalhando em várias tarefas em paralelo.
| Quando | Como definir o nome |
|---|
| Na inicialização | claude -n auth-refactor |
| Durante uma sessão | /rename auth-refactor. O nome também aparece na barra de prompt |
| Do seletor de sessão | Destaque uma sessão e pressione Ctrl+R |
| Na aceitação do plano | Aceitar um plano no modo plano nomeia a sessão a partir do conteúdo do plano, a menos que você já tenha definido um |
claude --resume <name> ou /resume <name>. Veja Retomar uma sessão para saber como a resolução de nomes se comporta entre worktrees.
Use o seletor de sessão
Execute /resume dentro de uma sessão ou claude --resume sem argumentos para abrir o seletor de sessão interativo. Use estes atalhos de teclado para navegar, pesquisar e expandir a lista:
| Atalho | Ação |
|---|
↑ / ↓ | Navegar entre sessões |
→ / ← | Expandir ou recolher sessões agrupadas |
Enter | Retomar a sessão destacada |
Space | Visualizar o conteúdo da sessão. Ctrl+V também funciona em terminais que não o capturam como colar |
Ctrl+R | Renomear a sessão destacada |
/ ou qualquer caractere imprimível diferente de Space | Entrar no modo de pesquisa e filtrar sessões. Cole uma URL de pull ou merge request do GitHub, GitHub Enterprise, GitLab ou Bitbucket para encontrar a sessão que a criou |
Ctrl+A | Mostrar sessões de todos os projetos nesta máquina. Pressione novamente para retornar ao repositório atual |
Ctrl+W | Mostrar sessões de todas as worktrees do repositório atual. Pressione novamente para retornar à worktree atual. Mostrado apenas em repositórios com múltiplas worktrees |
Ctrl+B | Filtrar para sessões do branch git atual. Pressione novamente para mostrar todos os branches |
Esc | Sair do seletor de sessão ou modo de pesquisa |
Ctrl+A.
As sessões bifurcadas criadas com /branch, /rewind ou --fork-session são agrupadas sob sua sessão raiz. Pressione → para expandir um grupo.
Ramificar uma sessão
Ramificar cria uma cópia da conversa até agora e o coloca nela, deixando o original intacto. Use-o para tentar uma abordagem diferente sem perder o caminho em que você estava.
De dentro de uma sessão, execute /branch com um nome opcional:
/branch try-streaming-approach
--continue ou --resume com --fork-session:
claude --continue --fork-session
/branch imprime dois IDs de sessão: o novo branch em que você está agora e o original. Para retornar ao original, passe seu ID para /resume, use o seletor de sessão ou execute /resume <original-name>. As permissões que você aprovou com “permitir para esta sessão” não são transferidas para o novo branch. Se você retomar a mesma sessão em dois terminais sem bifurcar, as mensagens de ambos se intercalam em um transcrição.
Para rewind baseado em checkpoint dentro de uma única sessão, veja Checkpointing.
Gerenciar contexto dentro de uma sessão
Estes comandos controlam o que está na janela de contexto sem deixar a sessão:
/clear: comece do zero com um contexto vazio. A conversa anterior é salva e retomável/compact [instructions]: substitua o histórico por um resumo, opcionalmente focado no que você especificar/context: mostrar o que está consumindo contexto atualmente
Para saber como a compactação interage com CLAUDE.md, skills e regras, veja o guia de janela de contexto. Para estratégias sobre quando limpar versus compactar, veja Melhores práticas.
Exportar e localizar dados de sessão
Execute /export para copiar a conversa atual para sua área de transferência ou salvá-la como um arquivo de texto simples, com mensagens e saídas de ferramentas renderizadas como texto legível. Passe um nome de arquivo para escrever diretamente nesse arquivo.
Os transcritos são armazenados como JSONL em ~/.claude/projects/<project>/<session-id>.jsonl, onde <project> é derivado do caminho do seu diretório de trabalho. Cada linha é um objeto JSON para uma mensagem, uso de ferramenta ou entrada de metadados. Para armazenar sessões em algum lugar diferente de ~/.claude, defina CLAUDE_CONFIG_DIR. Esses arquivos locais são removidos após 30 dias por padrão; altere isso com cleanupPeriodDays.
Para suprimir gravações de transcrição inteiramente, defina CLAUDE_CODE_SKIP_PROMPT_HISTORY ou no modo não interativo use --no-session-persistence.
Veja também
Estas páginas cobrem mecânicas relacionadas de sessão e paralelismo:
