Programação e agentes de IA

[Claude Code #4] /resume, /branch e /fork: continuar e dividir

As sessões do Claude Code são retomadas com /resume, divididas com /branch e clonadas com /fork. Este resumo reúne os comandos de gerenciamento de conversas, desde o atalho do seletor de sessões e a definição de nomes até o diálogo de retomada com resumo.

5 min de leitura
Imagem de capa de [Claude Code #4] /resume, /branch e /fork: continuar e dividir

É fácil pensar que, ao fechar o terminal, a conversa com a IA também desaparece. No dia seguinte, você precisa inserir novamente, desde o início, todo o contexto que explicou por horas.

No Claude Code, isso não é necessário. Todas as conversas são salvas localmente como sessões e podem ser recuperadas e continuadas a qualquer momento.

Esta edição organiza /resume para continuar uma conversa, /branch para dividi-la e /fork para cloná-la e delegar outra tarefa.

Assim como as permissões de Claude Code, parte 3, as sessões são uma função básica usada todos os dias. Vamos começar pelos pontos de entrada.

Continuar: resumo dos pontos de entrada

Com base em Documentação oficial sobre sessões, as formas de retomar se dividem da seguinte maneira.

claude --continue        # Retomar a sessão mais recente do diretório atual
claude --resume          # Abrir a tela de seleção de sessões
claude --resume nome     # Retomar diretamente pelo nome
claude --from-pr 1234    # correspondente PRVer apenas as sessões vinculadas

Se você já estiver dentro de uma sessão, poderá mudar para outra conversa usando /resume.

Ao retomar, não volta apenas o conteúdo da conversa. O histórico de chamadas de ferramentas, o modelo usado e o modo de permissões também são restaurados.

Há exceções. O modo plan precisa ser ativado novamente de forma manual após a retomada, e bypassPermissions deve ser especificado outra vez por uma flag ou configuração durante a execução.

Flags de execução como --mcp-config e --add-dir também não são restauradas, então você precisa passá-las novamente ao retomar.

Como usar o seletor de sessões

Ao executar /resume sem argumentos, a lista de sessões é exibida. Há alguns atalhos disponíveis dentro dela.

  • Space: visualizar uma prévia do conteúdo da sessão
  • Ctrl+R: renomear
  • Ctrl+W: ampliar o escopo para todas as worktrees do mesmo repositório (exibido apenas quando há múltiplas worktrees)
  • Ctrl+A: ampliar para todos os projetos deste computador
  • Ctrl+B: filtrar apenas as sessões da branch git atual

Se você colar no campo de busca a URL de um PR do GitHub, GitLab ou outro serviço, ele também pode encontrar a sessão que criou esse PR.

Dar nomes facilita encontrar as sessões

Quando as sessões se acumulam, encontrar “aquele trabalho de anteontem” vira uma tarefa. Se você der um nome a elas, basta claude --resume 이름 em uma linha.

No início, use claude -n auth-refactor; durante o trabalho, /rename auth-refactor.

Se você não der um nome, um título que resume o primeiro prompt será atribuído automaticamente. Porém, embora esse título automático apareça na busca, ele não pode ser alvo de --resume 이름.

/branch: quando testar outra abordagem

Se até aqui falamos em “continuar”, /branch significa “dividir”.

Ele cria uma nova sessão copiando a conversa até o momento e muda para ela. A original permanece intacta.

/branch try-streaming-approach

É útil quando uma refatoração pode seguir dois caminhos. Você testa a opção A em uma branch e, se não gostar, volta à original para seguir com a opção B.

Diagrama da divisão e clonagem de sessões com Claude Code /branch e /fork
/branch muda a sessão em que trabalho; /fork envia o clone para o segundo plano

Para dividir a sessão ao iniciar pelo terminal, use --fork-session.

claude --continue --fork-session

Não retome a mesma sessão simultaneamente em dois terminais sem fork. As mensagens dos dois lados acabam misturadas em um único histórico.

/fork: clonar para delegar outra tarefa

Se /branch é a branch para a qual eu mudo, /fork é o clone que cria um trabalhador em segundo plano.

Como explica Documentação oficial de comandos, uma sessão em segundo plano que herda toda a conversa atual é criada, enquanto você continua na conversa original. É como delegar uma tarefa paralela a um assistente que já conhece todo o contexto.

/fork Escreva também o código de testes usando esta abordagem

Use isso para deixar investigações longas ou tarefas repetitivas em andamento enquanto você continua o trabalho principal. Quando o clone altera código, ele cria sua própria worktree, evitando conflitos com os seus arquivos.

Sessões grandes que ficaram inativas por muito tempo perguntam se você quer retomá-las com um resumo

Com base em Documentação oficial sobre sessões, ao retomar, nos planos Pro e Max, uma sessão com mais de 100 mil tokens que ficou inativa por mais de uma hora, algumas opções são exibidas.

Ao retomar com um resumo, você continua com uma versão resumida em vez do histórico completo, deixando as solicitações seguintes mais leves. Ao retomar sem alterações, todos os detalhes permanecem, mas cada solicitação custa mais.

O critério é saber se a tarefa precisa de mais detalhes. Apenas considere que o que o resumo deixar de fora desaparece do contexto.

Ilustração de uma pessoa colocando etiquetas com nomes em um pergaminho de sessões salvas, junto da frase NAME YOUR SESSIONS
Dar nomes é metade do trabalho paralelo

Resumo

O essencial do gerenciamento de sessões são três verbos. Continuar com --resume, dividir com /branch e clonar com /fork.

Se você também transformar em hábito dar nomes (-n, /rename), o trabalho paralelo fica muito mais fácil.

Na próxima edição, veremos o checkpoint /rewind, que permite rebobinar o código e a conversa inteiros. Saber como voltar atrás antes de dividir uma sessão traz mais segurança.

Fontes e critérios de verificação

Continue lendo

Série Claude Code

Tópicos relacionados