O describe session é uma funcionalidade do Claude Code que permite que uma sessão descreva seu próprio contexto de forma estruturada — como se estivesse gerando um briefing para outro agente ou sessão.
Na prática, você pede para o Claude explicar o que está acontecendo no projeto atual, e ele gera uma descrição completa: o que foi feito, qual é o estado atual e o que a próxima sessão precisa saber para continuar o trabalho.
Isso é especialmente útil quando você trabalha com dois ou mais projetos que precisam se comunicar, como um back-end e um front-end separados.
Por que isso é útil ao trabalhar com múltiplos projetos
Quem desenvolve com projetos separados conhece o problema: você está no projeto A e precisa que o projeto B entenda exatamente o que mudou, quais endpoints estão disponíveis ou como uma integração deve funcionar.
Sem o describe session, a alternativa seria:
- Escrever manualmente um resumo do que foi feito
- Copiar trechos de código entre sessões
- Tentar explicar o contexto do zero em cada nova sessão
Com o describe session, o próprio Claude gera essa passagem de contexto de forma automática e estruturada. Ele entende o projeto, sabe o que foi implementado e consegue descrever isso como outro agente faria.
Como usar na prática
Veja um caso real: um CMS criado com Claude Code que possui um front-end separado fazendo a integração.
O front-end começou a ter dificuldades para consumir a API do CMS. Em vez de abrir a sessão do front-end e tentar explicar tudo manualmente, o caminho foi diferente:
- Abra a sessão do Claude Code no projeto do CMS (o projeto que tem o contexto que você quer compartilhar)
- Peça para o Claude descrever a sessão pensando em como outro agente usaria essa informação. Algo como: “Describe this session so another Claude session working on the front-end can understand how to integrate with this CMS”
- O Claude gera a descrição completa — endpoints disponíveis, estrutura de dados, autenticação, tudo o que a outra sessão precisa saber
- Use essa descrição na sessão do front-end como contexto inicial, colando o output ou referenciando-o
O resultado é que a sessão do front-end recebe um briefing claro e estruturado, sem perda de informação.
Indo além: passando contexto entre agentes e modelos diferentes
O describe session não se limita a conectar duas sessões do Claude Code. Você pode usar essa mesma técnica para:
- Passar contexto entre agentes diferentes — por exemplo, de um agente de código para um agente de revisão
- Gerar prompts para outros modelos — pedir para o Claude descrever a sessão em formato de prompt otimizado para outro LLM
- Criar documentação de handoff — quando outro desenvolvedor (humano ou IA) vai assumir o trabalho
A ideia central é a mesma: transformar o contexto implícito de uma sessão de trabalho em uma descrição explícita e reutilizável.
Quer dominar o Claude Code e IA na prática?
Se você quer ir além e aprender a usar o Claude Code como ferramenta principal no seu fluxo de desenvolvimento, temos um curso bônus sobre IA e Claude Code dentro do The Best Stack. Lá você aprende na prática como integrar IA no seu dia a dia como dev.
Acesse o The Best Stack e comece agora
FAQ
O describe session funciona entre projetos diferentes?
Sim. Você pode usar o describe session em um projeto e levar a descrição gerada para qualquer outro projeto ou sessão. O contexto é gerado como texto, então é portável.
Preciso usar algum comando específico?
Você pode simplesmente pedir em linguagem natural para o Claude descrever a sessão atual. Use instruções claras sobre para quem é a descrição (outro agente, outro projeto, outro modelo) para obter o melhor resultado.
Funciona com outros modelos além do Claude?
Sim. Como o output é texto estruturado, você pode usar a descrição gerada como prompt para qualquer outro modelo ou ferramenta de IA.
Qual a diferença entre describe session e os arquivos CLAUDE.md?
Os arquivos CLAUDE.md são instruções persistentes que você escreve manualmente para dar contexto ao Claude em todas as sessões de um projeto. O describe session é uma descrição gerada sob demanda do estado atual de uma sessão específica — útil para passagens pontuais de contexto.