Código Claude Memória de sessão

Problema: Abres uma nova sessão do Claude Code e passas os primeiros cinco minutos a recapitular o que criaste ontem. O fluxo de autenticação já está concluído. O esquema da base de dados já foi escolhido. A forma do «API» já está definida. Nada disso está na cabeça do modelo.

Solução rápida: Verifica se a Memória de Sessão já está ativada na tua configuração. Quando o Claude Code arrancar, observa no terminal se aparece uma linha parecida com esta:

Recalled 3 memories (ctrl+o to expand)

Se isso aparecer, os resumos do trabalho anterior neste projeto foram carregados automaticamente. Clica em «ctrl+o» e podes ver exatamente o que foi carregado. Se ainda não vires essa linha, o resto deste guia explica quando e como a funcionalidade entra em ação.

O que é realmente a Memória de Sessão

Pensa na Memória de Sessão como um assistente em segundo plano. Ela funciona sozinha durante cada sessão, presta atenção ao que está a acontecer, extrai as partes úteis da tua conversa e regista-as como resumos estruturados no disco. O CLAUDE.md é o oposto. Escreves e manténs o CLAUDE.md manualmente. A Memória de Sessão não precisa de nada da tua parte.

Dois tipos de mensagens no terminal indicam que está a funcionar:

• "Recalled X memories" aparece no início de uma sessão. Os resumos de trabalhos anteriores no mesmo projeto acabaram de ser carregados no contexto do Claude.
• "Gravei X memórias" aparece enquanto trabalhas. O Claude acabou de guardar um instantâneo recente da sessão atual.

Qualquer uma das linhas vem acompanhada de um(ctrl+o to expand), para que possas abrir o que quer que tenha sido recuperado ou gravado.

Como funciona nos bastidores

Um processo em segundo plano gere a Memória de Sessão em todas as sessões que abrires. Vale a pena compreender como tudo funciona.

Local de armazenamento

Os resumos ficam armazenados como ficheiros Markdown estruturados, um por sessão, num caminho previsível:

~/.claude/projects/<project-hash>/<session-id>/session-memory/summary.md

Cada sessão tem a sua própria pasta e o seu próprio resumo dentro dela. As pastas vão-se acumulando ao longo do tempo e formam um registo de tudo em que trabalhaste dentro de um determinado projeto.

Frequência de extração

O salvamento não ocorre em todas as mensagens. O calendário é deliberado:

• Primeira extração: é acionada após cerca de 10 000 tokens de conversa
• Atualizações subsequentes: A cada ~5.000 tokens ou após cada 3 chamadas da ferramenta, o que ocorrer primeiro

Esse ritmo mantém os resumos úteis e evita o desperdício de recursos em trocas de mensagens triviais. Uma correção de erro ortográfico de cinco minutos não rende quase nada. Uma discussão profunda sobre arquitetura rende muito.

Recuperação entre sessões

Inicia uma nova sessão e o Claude vai trazer resumos relevantes do passado para o contexto por ti. Cada um vem marcado com uma nota: "de sessões PASSADAS que podem não estar relacionadas com a tarefa atual." O Claude lê-os como referência de contexto, não como ordens a seguir.

A marcação é importante. As decisões que tomaste há três semanas não voltam como regras rígidas. Obténs a continuidade sem ficares preso a escolhas ultrapassadas.

O que fica na memória

Todos os resumos seguem o mesmo formato:

• Título da sessão: Uma descrição gerada automaticamente do que trabalhaste (por exemplo, "Implementar painel do utilizador com acesso baseado em funções")
• Estado atual: Itens concluídos, pontos de discussão, questões em aberto
• Resultados-chave: Resultados importantes, decisões tomadas, padrões escolhidos
• Registo de trabalho: Um registo cronológico das ações realizadas durante a sessão

Um resumo abrange o que foi feito e porquê, não uma repetição palavra por palavra das mensagens. A compressão é o objetivo principal. Horas de trabalho reduzem-se a um resumo conciso que o Claude obtém quase instantaneamente.

O comando /remember

A Memória de Sessão guarda o histórico bruto. O comando /remember é o que transforma esse histórico em conhecimento duradouro do projeto.

Executa o /remember e o Claude percorre os resumos das sessões no caminho acima, procura padrões que se repetem ao longo das sessões e redige atualizações para o CLAUDE.local.md. Tens a palavra final sobre cada adição antes de ser escrita.

Digamos que o Claude tenha notado, ao longo de três sessões, que estás sempre a insistir na mesma regra: «usa sempre ações do servidor em vez de rotas API». O /remember marca essa linha como um bom alvo para a memória permanente. Assim que ela chega ao CLAUDE.local.md, o Claude pega no padrão a partir da primeira mensagem da sessão seguinte, sem necessidade de correção.

Pensa nisso como a passagem entre a memória automática e a configuração deliberada.

Compactação instantânea

Antes da Memória de Sessão existir, executar "/compact" podia custar-te até dois minutos de tempo morto. O Claude relia toda a conversa e elaborava um resumo manualmente naquele momento. Agora, "/compact" retorna instantaneamente.

A razão é que o resumo já está no disco. A compactação já não precisa de escrever um novo do zero. Ela pega no resumo mais recente, coloca-o numa janela de contexto nova e devolve-te o controlo. O teu fluxo de trabalho de contexto acaba por ser mais rápido e mais previsível.

Essa diferença é mais importante em sessões longas. Em vez de te preocupares com a pausa aos 80% do contexto, podes compactar quando quiseres. O resumo está sempre pronto.

Disponibilidade e requisitos

O Session Memory está disponível na plataforma de desenvolvimento da Anthropic (API). Se o Claude Code estiver a comunicar com o modelo através de uma subscrição do Claude Pro ou Max, a funcionalidade está ativada por predefinição.

Algumas coisas a saber sobre a disponibilidade:

• API fornecedores: os utilizadores do Bedrock, Vertex e Foundry não têm acesso à Memória de Sessão. A funcionalidade requer a infraestrutura nativa da Anthropic API.
• Controlo de funcionalidades: A Session Memory está controlada pelo sinalizador de funcionalidade Statsig do tengu_session_memory. Um sinalizador relacionado, tengu_sm_compact, ativa o comportamento de compactação instantânea.
• Cronograma: O sistema subjacente existe desde aproximadamente a v2.0.64, no final de 2025. As mensagens visíveis no terminal ("Recalled/Wrote memories") tornaram-se proeminentes por volta das versões v2.1.30 e v2.1.31, no início de fevereiro de 2026.

Tens um plano compatível e ainda não vês a linha de recuperação? Provavelmente a tua conta ainda não foi atualizada. A implementação está a ser feita gradualmente.

Trabalhar com a Memória de Sessão

Inspeciona as tuas memórias armazenadas

Navega diretamente pelas tuas memórias de sessão:

# Find your project's memory directory
ls ~/.claude/projects/
 
# List all sessions for a specific project
ls ~/.claude/projects/<project-hash>/
 
# Read a specific session's summary
cat ~/.claude/projects/<project-hash>/<session-id>/session-memory/summary.md

Maximiza o que é capturado

Quanto mais clara for a estrutura de uma sessão, mais detalhado será o resumo gerado:

• Define a tua intenção logo no início: «Estou a criar a integração de pagamentos usando o Stripe» dá ao Claude um título de sessão claro
• Resume as decisões explicitamente: «Decidimos pela sincronização baseada em webhooks em vez de polling» torna-se um resultado-chave
• Pede ao Claude para documentar: «Documenta as decisões de arquitetura que acabámos de tomar» desencadeia uma extração mais rica

Compreende a relação com o CLAUDE.md

Os dois sistemas têm funções diferentes e funcionam bem em conjunto:

Uma configuração que use ambos é a mais forte. O sistema automático dá-te continuidade entre sessões. O CLAUDE.md dá-te as regras que o Claude tem de seguir. O comando /remember é a ponte, promovendo padrões de um lado para o outro.

Próximos passos

• Configura o teu sistema de memória CLAUDE.md para instruções de projeto persistentes
• Explora a memória automática para permitir que o Claude tome as suas próprias notas sobre o teu projeto
• Aprende estratégias de gestão de contexto para trabalhar dentro dos limites de tokens
• Explora a gestão de contexto para fluxos de trabalho avançados entre sessões
• Compreende a engenharia de contexto para sistemas de produção AI

O melhor tipo de funcionalidade é aquela que deixas de notar. A Memória de Sessão fica por trás da sessão, captura as partes que merecem ser capturadas e coloca-as de volta ao teu alcance na próxima vez que forem importantes. Abre uma nova sessão e descobre que o Claude já está a par do trabalho de ontem. Essa é a funcionalidade a fazer o seu trabalho discretamente.