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.
Mestre em Sistemas de Informação pela USP e criador do DevPleno. Iniciou sua carreira como professor com apenas 18 anos em um curso técnico, foram 11 anos em sala de aula formando desenvolvedores fullstack no sul de Minas Gerais.