Como retomar uma sessão do Claude Code com --continue, --resume ou /resume

Retomar uma sessão pela linha de comando

A documentação de sessões da Anthropic lista estes comandos:

claude --continue          # most recent session in this folder
claude --resume            # open the session picker
claude --resume auth-fix   # resume a named session
claude --from-pr 123       # sessions linked to a pull request

-c e -r são as formas curtas de --continue e --resume. Você também pode passar um ID de sessão para --resume; o Claude Code procura primeiro no projeto atual e nas worktrees git dele e, depois, em outros projetos do Mac (referência da CLI).

Adicione --fork-session para retomar uma cópia com um novo ID de sessão e deixar a original como estava.

Trocar de sessão dentro do Claude Code

Digite /resume (ou o alias /continue) no prompt para abrir o mesmo seletor sem sair do Claude Code. /resume seguido de um nome ou ID vai direto para aquela sessão (referência de comandos).

Atalhos úteis do seletor:

Space (barra de espaço) mostra uma prévia da sessão.
Ctrl+A mostra as sessões de todos os projetos deste Mac.
Ctrl+W amplia a lista para todas as worktrees do repositório.
Ctrl+B filtra pela branch git atual.
Ctrl+R renomeia a sessão destacada.

Dê nomes às sessões para encontrá-las

Sessões sem nome mostram um título gerado ou o primeiro prompt, o que dificulta percorrer a lista. Dê um nome às mais importantes ao iniciar, com claude -n auth-fix, ou durante a sessão, com /rename auth-fix. Depois, claude --resume auth-fix leva você direto de volta.

Para testar outra abordagem sem perder a atual, execute /branch. Ele copia a conversa até aquele ponto e coloca você na cópia. Evite retomar a mesma sessão em dois terminais sem fazer um fork: a Anthropic observa que as mensagens dos dois se intercalam em uma única transcrição.

Por que uma sessão não aparece

O Claude Code guarda as transcrições em ~/.claude/projects/<project>/<session-id>.jsonl, agrupadas por pasta de projeto. Motivos comuns para uma sessão estar faltando:

Outra pasta. O seletor começa pelo projeto atual. Pressione Ctrl+A para ver tudo.
Outro diretório de configuração. Com CLAUDE_CONFIG_DIR definida, as transcrições ficam nesse diretório, então cada conta tem sua própria lista de sessões.
Execuções por script. Sessões de claude -p ou do Agent SDK, e sessões que começaram com /loop, ficam fora do seletor e do --continue. Retome uma sessão de -p ou do SDK pelo ID.
Idade. Em outubro de 2026, transcrições mais antigas que cleanupPeriodDays são apagadas; o padrão é 30 dias (documentação do diretório .claude).

Sessões iniciadas no app Claude Desktop são retomadas no próprio app desktop.

As sessões ficam com a conta que as criou

Como o histórico fica guardado no diretório de configuração, uma sessão pertence à configuração de conta que a criou. Se sua conta de trabalho usa claude-work e a pessoal usa o claude simples, cada seletor mostra só as próprias sessões. O que o CLAUDE_CONFIG_DIR faz explica o motivo. Sair e entrar com outra conta no mesmo diretório é diferente: veja como trocar de conta no Claude Code.

Quando um checkpoint local é melhor

Retomar recarrega a conversa inteira. Isso é o certo para continuar de onde você parou na mesma conta. Funciona menos bem para continuar o trabalho em outra conta, ou para uma conversa muito longa: a Anthropic observa que retomar uma conversa longa depois de uma pausa pode mostrar uma caixa de diálogo estimando quanto do seu limite de uso só a conversa salva consumiria.

Um checkpoint local curto costuma ser melhor. Registre a tarefa, o que mudou, o que foi verificado e o próximo passo; depois, inicie um chat novo na mesma pasta do projeto e aponte-o para o checkpoint. O Switch oferece isso como uma passagem manual de contexto; ele não transfere transcrições automaticamente. Continue um projeto do Claude Code com um checkpoint local.