Recurso de Memória de Sessão Introduzido no Claude Code

As versões mais recentes do Claude Code introduzem um novo recurso: Memória de Sessão. Projetado para auxiliar desenvolvedores no gerenciamento de sessões interativas maiores, ele gera e mantém automaticamente um arquivo summary.md em cada diretório de projeto. Embora desativado por padrão, você pode habilitá-lo e personalizá-lo usando tweakcc.

Detalhes Principais

Quando habilitada, a Memória de Sessão cria um arquivo summary.md localizado em ~/.claude/projects/{sanitized-project-path}/{session-id}/session-memory/summary.md. Este arquivo é atualizado com base em limites específicos: tamanho da sessão atingindo 10k tokens e 3 chamadas de ferramentas, com atualizações subsequentes ocorrendo após 5k tokens adicionais e mais 3 chamadas de ferramentas.

A ferramenta tweakcc permite a personalização desses limites usando variáveis de ambiente:

• CC_SM_MINIMUM_MESSAGE_TOKENS_TO_INIT=200 – Tokens necessários antes da primeira extração; padrão é 10.000.
• CC_SM_MINIMUM_TOKENS_BETWEEN_UPDATE=200 – Tokens necessários entre atualizações; padrão é 5.000.
• CC_SM_TOOL_CALLS_BETWEEN_UPDATES=0 – Chamadas de ferramentas necessárias entre atualizações; padrão é 3.
• CC_SM_PER_SECTION_TOKENS=3000 – Máximo de tokens para uma seção antes de um aviso; padrão é 2.000.
• CM_SM_TOTAL_FILE_LIMIT=12000 – Máximo de tokens para o resumo completo; padrão é 12.000.

Habilitar o recurso de memória de sessão envolve executar npx tweakcc@latest --apply e definir as variáveis de ambiente necessárias. Esta funcionalidade visa desenvolvedores que lidam com sessões interativas de médio a grande porte, onde o rastreamento abrangente de atividades é benéfico.