Como Retomar Sessão do Claude Code

Fechou o terminal no meio de uma sessão longa do Claude Code e agora não sabe como recuperar o que estava fazendo? Isso acontece com frequência em rotinas de desenvolvimento, e o Claude Code tem comandos específicos para retomar exatamente de onde você parou, sem precisar reexplicar o projeto do zero.

O que significa “retomar uma sessão” no Claude Code

Toda vez que você usa o Claude Code em um diretório, a ferramenta grava a conversa em um arquivo de sessão vinculado àquele projeto. “Retomar” significa reabrir esse histórico salvo — arquivos lidos, decisões tomadas, código escrito — em vez de começar uma conversa nova do zero.

Existem duas formas principais de fazer isso: continuar a sessão mais recente automaticamente, ou escolher uma sessão específica entre várias já existentes.

Comando claude –continue

Para continuar a conversa mais recente no diretório atual, use:

claude --continue

Existe também o atalho equivalente:

claude -c

Se quiser continuar já enviando um novo comando em modo de impressão (sem abrir o modo interativo), combine as flags:

claude -c -p "verifique erros de tipo"

Comando claude –resume

Quando você quer escolher entre várias sessões salvas, ou retomar uma sessão específica pelo identificador, use:

claude --resume

Sem argumentos, esse comando abre um seletor interativo com a lista de sessões disponíveis no diretório (ou repositório) atual. Para ir direto a uma sessão conhecida, informe o ID ou o nome dela:

claude --resume abc123
claude --resume auth-refactor

Diferença entre –continue e –resume

--continue é o caminho rápido: sempre pega a última conversa, sem perguntar nada. --resume é o caminho de escolha: mostra uma lista (ou aceita um ID específico) quando você trabalhou em mais de uma sessão e precisa voltar a uma delas em particular, não necessariamente a mais recente.

Como funciona o seletor interativo (/resume)

Dentro do próprio Claude Code, o comando /resume abre o mesmo seletor interativo acessível via claude --resume. A lista mostra sessões do mesmo repositório Git, incluindo as criadas em worktrees diferentes, o que ajuda quem alterna entre branches de um mesmo projeto.

Vale registrar um ponto relatado por usuários: em algumas versões, retomar uma sessão pelo seletor interativo não atualizou o arquivo de histórico usado pelo --continue, fazendo esse comando não localizar a sessão retomada em seguida. Se isso acontecer, prefira usar --resume novamente em vez de --continue para voltar àquela mesma sessão, e verifique se há atualização disponível para o Claude Code.

Retomando sessões headless e via Agent SDK

Sessões criadas com claude -p (modo de impressão, sem interface interativa) ou por integrações com o Agent SDK não aparecem no seletor interativo. Para continuá-las, use:

claude -p --continue
claude -p --resume <id-da-sessao>

Esse fluxo é programático por natureza: pense em scripts de automação ou pipelines que precisam retomar uma conversa sem abrir uma tela interativa.

Limitações conhecidas

Por padrão, tanto --continue quanto --resume ficam restritos ao diretório de trabalho em que a sessão foi criada. Tentar retomar a partir de outro diretório pode resultar em erro de sessão “inválida ou expirada”, mesmo que o arquivo da sessão ainda exista. Há uma solicitação da comunidade para adicionar uma flag --cwd que permitiria apontar para outro diretório (por exemplo, após mover um worktree), mas até o momento isso é um pedido de recurso, não uma funcionalidade confirmada — verifique a documentação oficial antes de contar com ela.

Também existem relatos pontuais, em versões específicas, de que retomar uma sessão longa não restaurou todo o contexto anterior, fazendo a conversa recomeçar como se fosse nova. Não é um comportamento documentado como padrão, mas, se você notar perda de contexto após retomar, vale conferir se há uma atualização do Claude Code disponível.

Boas práticas para não perder contexto

Algumas ações do dia a dia ajudam a manter sessões organizadas e reduzem o risco de perda de histórico:

• Use /clear para começar uma conversa nova sem apagar a sessão anterior — ela continua disponível para retomada depois
• Use /compact quando o histórico estiver muito longo, para resumir o contexto e liberar espaço
• Use /context para visualizar quanto do limite de contexto já foi consumido antes que isso vire um problema
• Ao trabalhar com múltiplos projetos, prefira --resume com ID em vez de --continue, para ter certeza de qual sessão está sendo retomada

Critério	claude –continue	claude –resume
Quando usar	Retomar rapidamente a última conversa	Escolher uma sessão específica entre várias
Exige ID da sessão	Não	Opcional (sem ID abre seletor)
Funciona em modo headless	Sim, com claude -p --continue	Sim, com claude -p --resume <id>
Depende do diretório original	Sim	Sim

Tabela comparativa de comandos de retomada

A tabela acima resume a decisão prática: use --continue quando só existe uma linha de trabalho em andamento naquele projeto, e --resume quando há mais de uma sessão e você precisa escolher exatamente qual retomar.

Perguntas frequentes

Meu histórico anterior some depois que eu fecho o terminal?
Não, o histórico fica salvo por diretório de projeto. O que pode acontecer, em casos relatados e pontuais, é o comando de retomada não recuperar 100% do contexto acumulado — mas o arquivo da sessão em si não é apagado.

Retomar uma sessão funciona em outro projeto ou pasta?
Não por padrão. Os comandos de retomada são filtrados pelo diretório em que a sessão foi criada, e tentar retomar de outro lugar costuma gerar erro, mesmo com o ID correto.

Sessões criadas em modo headless aparecem no seletor /resume?
Não. Sessões de claude -p ou do Agent SDK precisam ser retomadas programaticamente, com claude -p --continue ou claude -p --resume <id>.

Existe uma forma oficial de retomar uma sessão em outro diretório?
Até o momento, isso é apenas uma solicitação de recurso da comunidade (proposta de flag --cwd), sem confirmação de lançamento. Consulte a documentação oficial para verificar o status atual.

Junte-se à nossa comunidade