A memória que o Claude Code escreve sozinho

Você escreve, ele também aprende

O Claude Code tem dois sistemas de memória que se completam. O primeiro você já conhece: o CLAUDE.md, escrito por você, com instruções e regras. O segundo e a memória automática, escrita pelo próprio agente. Enquanto trabalha, ele observa as suas correções e preferências e, quando percebe algo que seria útil em sessões futuras, guarda uma nota para si mesmo, sem você pedir. Por exemplo, se você corrige o comando de build uma vez, ele pode anotar o comando certo para não errar de novo. E como um colega que aprende os seus jeitos com o convívio.

A divisão de trabalho entre os dois e clara. O CLAUDE.md e para o que você quer garantir de forma deliberada: as regras que você decide que valem. A memória automática e para o aprendizado que emerge do uso, aquelas descobertas práticas, como um comando, um detalhe de configuração, uma preferência sua, que apareceram no dia a dia e valem a pena reter. Ele não guarda algo a cada sessão; ele decide o que merece com base na utilidade futura. Assim, com o tempo, o agente vai ficando mais afinado ao seu projeto e ao seu jeito, além do que você escreveu a mão.

Você continua no controle: auditar e editar

A ideia de o agente guardar notas sozinho pode soar como perda de controle, mas e o contrario: você continua no comando. As notas da memória automática são arquivos de texto simples, e você pode ver todos eles, editar o que quiser e apagar qualquer um a qualquer momento. Existe um comando na ferramenta que lista os arquivos de memória carregados e da acesso a pasta da memória automática, para você navegar pelo que foi guardado. Nada fica escondido: se o agente anotou algo errado ou que você prefere que ele esqueca, e só abrir e apagar.

Esse hábito de auditar de vez em quando e saudavel. Assim como o CLAUDE.md pode acumular instruções velhas, a memória automática pode guardar algo que fez sentido um dia e não faz mais, ou uma preferência que mudou. Dar uma olhada no que ele reteve, principalmente se o agente começa a agir de um jeito que você não entende, ajuda a achar a origem. Muitas vezes um comportamento estranho tem raiz numa nota antiga puxando para um lado. Ler, corrigir ou apagar resolve, e você sai com o agente lembrando só do que ainda vale.

Se você preferir não usar a memória automática, da para desliga-la, tanto nas configurações quanto pelo comando de memória. Alguns preferem controlar tudo a mão, só pelo CLAUDE.md; outros gostam do aprendizado emergente. Não ha certo ou errado: e uma escolha de estilo. O importante e saber que o recurso existe, que vem ligado, e que você tem total acesso e controle sobre o que ele guarda. Transparencia e controle são o que tornam a memória automática uma ajuda, e não uma caixa preta.

Pedindo ao agente para lembrar

Ha um jeito prático de alimentar a memória de propósito, sem abrir arquivo nenhum: pedir ao agente para lembrar. Se você disser algo como lembre que este projeto usa determinado gerenciador de pacotes, ou que os testes precisam de um serviço rodando, o Claude Code guarda isso na memória automática. E, se você quiser que uma instrução va especificamente para o CLAUDE.md, e só pedir de forma explicita, algo como adicione isto ao CLAUDE.md, ou editar o arquivo você mesmo pelo comando de memória. Você escolhe o canal: aprendizado solto na memória automática ou regra deliberada no CLAUDE.md.

Com este módulo, você fecha o tema da memória, que é um dos maiores saltos de qualidade no uso do Claude Code. Você sabe o que é o CLAUDE.md, onde colocar cada instrução pela hierarquia, como escrever de um jeito que o agente segue, como organizar projetos grandes com regras e imports e como a memória automática aprende sozinha sob o seu controle. O agente agora pode chegar em toda sessão já alinhado ao seu projeto. O próximo módulo entra num tema critico que a memória toca de leve: permissões e segurança, o controle fino sobre o que o agente pode fazer.