Eu combinei tudo o que realmente funciona sobre a memória do Claude — documentação oficial, a prévia de pesquisa do Dreaming, configurações reais de produção — em um único guia.
Siga meu Substack para receber novidades frescas sobre IA: movez.substack.com
Marque isto. Salve isto. Ao final, você terá um agente que se lembra permanentemente — não "dentro de um chat", mas por semanas.
Isso não é exagero. Até março de 2026, isso era impossível para usuários comuns. Agora são 12 passos.
Por que todo agente que você construiu é um peixinho dourado.
Toda vez que você abre um novo chat no Claude, ele começa do zero.
Ele não sabe seu nome. Não se lembra das três correções que você fez ontem, da solução alternativa que descobriu na semana passada, ou do fato de que você odeia resumos em tópicos.
A cada sessão, ele redescobre as mesmas coisas, comete os mesmos erros e faz as mesmas perguntas que você já respondeu.
Isso não é uma falha na forma como o Claude é comercializado. É uma propriedade fundamental de como os modelos de linguagem funcionam: cada sessão começa do zero, a menos que você forneça contexto explicitamente.
Para um chatbot, isso é aceitável. Para um agente executando tarefas reais e repetitivas, é o maior motivo pelo qual sua configuração estagna. Um agente sem memória é exatamente tão útil na execução 100 quanto foi na execução 1.
A Camada 1 é um bilhete adesivo. A Camada 4 é um funcionário que reflete sobre a semana toda sexta-feira e volta mais afiado. Estes 12 passos constroem todas as quatro, em três partes.
Fundação — Camadas 1 e 2
01. Ative a memória integrada do Claude
Comece com algo que a maioria das pessoas nem sabe que já existe. Em março de 2026, a Anthropic lançou a memória persistente, chamada "Chat Memory" — para todas as contas do Claude, gratuitas e Pro.
O Claude agora lembra suas preferências, projetos em andamento e estilo de trabalho em todas as conversas, automaticamente, até que você peça para esquecer.
Clique no ícone do seu perfil → Configurações → Capacidades → role até a seção Memória e confirme se "Gerar memória a partir do histórico do chat" está ativado.
Por baixo dos panos, ele executa a Síntese de Memória — o Claude destila suas conversas em um perfil aproximadamente a cada 24 horas. Esta é a base sobre a qual tudo o mais é construído.
02. Alimente sua memória deliberadamente, em vez de esperar
A parte contraintuitiva que a documentação deixa explícita: não espere o Claude inferir suas preferências do histórico — essa síntese só é executada cerca de uma vez a cada 24 horas.
Diga diretamente em uma conversa nova. O explícito sempre vence o implícito, e chega imediatamente, em vez de um dia depois.
O Claude escreve isso na memória. A próxima conversa já começa sabendo. Uma mensagem elimina uma categoria inteira de explicações repetidas.
03. Crie um Projeto como a base do seu agente
Um Projeto é um espaço de trabalho persistente onde as instruções permanecem carregadas em todas as conversas dentro dele. Esta é a Camada 1 em sua forma mais forte.
Vá para Projetos → Novo Projeto. Dê a ele o nome da função, não do tópico. Em seguida, preencha a caixa de instruções personalizadas com a função, os padrões e as restrições do agente. Cada chat dentro desse Projeto as herda.
04. Entenda o que os Projetos NÃO lembram
É aqui que a maioria das pessoas se queima. Projetos persistem instruções. Eles não persistem a memória da conversa por padrão.
Você configura um Projeto, fornece contexto detalhado, trabalha por algumas conversas — então inicia um novo chat no mesmo Projeto, e tudo o que você discutiu antes se foi.
As decisões de arquitetura, a tarefa pela metade, a sessão de depuração — desapareceram. O Projeto lembra suas instruções, não seu histórico.
Memória Persistente — Camada 3 (para programadores)
05. Adicione um arquivo de memória vivo
A memória persistente mais simples que realmente funciona é um único arquivo que o agente lê no início e anexa no final.
No Claude Code, isso é o CLAUDE.md; para qualquer agente, pode ser um memory.md no Conhecimento do Projeto.
A regra que a documentação enfatiza: mantenha-o enxuto. Uma sessão nova pode gastar aproximadamente 20.000 tokens carregando instruções antes que você digite qualquer coisa.
Não trate este arquivo como um despejo de wiki. Se você usar o /init do Claude Code para gerar um arquivo inicial, o próximo passo contraintuitivo é excluir a maior parte do que ele gera — ele afirma coisas óbvias que o modelo já vê.
06. Ative a memória automática
O Claude Code tem um mecanismo de memória automática: ele escreve notas para si mesmo com base em suas correções e preferências e as carrega no início de cada sessão.
Agora o agente faz uma autodocumentação leve. Quando você o corrige, a correção pode sobreviver até a próxima sessão, em vez de evaporar.
07. Estruture o arquivo de memória para que ele permaneça útil
Um arquivo de memória que cresce sem estrutura se torna ruído. Dê a ele seções:
Cada entrada ganha seu lugar. Este é o arquivo que o agente consulta para parar de repetir os erros de ontem.
08. Decida o que vale a pena lembrar
Nem tudo deve ser salvo. A disciplina aqui é o jogo todo. Após cada sessão significativa, o agente revisa o que aconteceu e extrai apenas o que vale a pena manter: uma decisão, uma solução alternativa, uma preferência, um modo de falha. Todo o resto é esquecido de propósito.
Um bom filtro: isso mudaria a forma como o agente age da próxima vez? Se sim, armazene. Se não, deixe pra lá. Memória que armazena tudo é tão inútil quanto memória que não armazena nada.
Memória Auto-Aprimorável — Camada 4: Dreaming
09. Entenda o que Dreaming realmente é
Em 6 de maio de 2026, no Code with Claude, a Anthropic lançou o Dreaming como uma prévia de pesquisa para Agentes Gerenciados. O nome é emprestado da neurociência de propósito: quando os humanos dormem, o cérebro consolida as experiências do dia na memória de longo prazo. O Dreaming faz o mesmo para um agente.
É um processo de fundo agendado. Ele lê o armazenamento de memória existente do agente mais as transcrições de sessões passadas e, em seguida, produz um novo armazenamento de memória reorganizado: duplicatas mescladas, entradas desatualizadas substituídas pelo valor mais recente e novos insights genuínos trazidos à tona.
Uma condição importa antes de você se preocupar: o Dreaming só ajuda agentes que executam o mesmo tipo de tarefa repetidamente. Ele consolida padrões em várias sessões, então um agente único não tem nada para consolidar. Execute-o em um cavalo de batalha, não em um turista.
10. Execute um dream — o procedimento exato da API
O Dreaming é uma prévia de pesquisa, então há três pré-requisitos antes de você escrever qualquer código: uma chave de API de Agente Gerenciado, acesso ao Dreaming solicitado através do formulário da Anthropic (ele é liberado com restrições) e um ambiente Python ou TypeScript com o SDK mais recente da Anthropic.
Toda chamada de dream precisa de dois cabeçalhos beta empilhados juntos — o SDK os define automaticamente se você estiver na versão com suporte a dreaming:
A chamada em si recebe dois tipos de entrada: o armazenamento de memória existente que você deseja consolidar e até 100 IDs de sessão — execuções recentes do agente que o Claude irá minerar em busca de padrões.
Você também pode passar instruções para direcionar o foco do dream:
Os modelos suportados durante a prévia são claude-opus-4-7 e claude-sonnet-4-6. Os dreams são cobrados pelas taxas de token padrão da API para o modelo escolhido, e o custo escala aproximadamente de forma linear com o número e a duração das sessões de entrada.
A documentação é explícita: comece com um pequeno lote de sessões e aumente a escala depois que estiver satisfeito com a qualidade da curadoria.
11. Inspecione o armazenamento de saída antes de confirmar
O armazenamento de memória de entrada permanece somente leitura o tempo todo. O dream produz um armazenamento de saída separado, e seu ID aparece no array outputs[] do dream assim que a execução começa:
Agora leia-o. Verifique se as entradas mescladas estão corretas, se as entradas substituídas estavam realmente desatualizadas, se os insights trazidos à tona são reais e não ruído.
Esta etapa de revisão é a diferença entre um agente que fica mais inteligente e um que deriva silenciosamente. Como a saída é um armazenamento totalmente novo no qual você opta por entrar, um dream nunca pode corromper silenciosamente o que você já tem.
12. Substitua, agende e deixe acumular
Depois de confiar na saída, a mudança para produção é uma alteração de uma linha — aponte seu agente para o novo ID de armazenamento em vez do antigo.
Em seguida, coloque o dreaming em um cronograma: noturno ou semanal, dependendo de quanto o agente executa.
Agora o ciclo está fechado. O agente trabalha durante o dia, sonha entre as execuções e volta mais afiado a cada ciclo, sem retreinamento e sem reconfiguração manual.
Arquivar um dream antigo nunca toca em seu armazenamento de saída — você os gerencia separadamente através da API de Armazenamentos de Memória.
A prova de que funciona em escala: a empresa de IA jurídica Harvey relatou um aumento de aproximadamente 6x nas taxas de conclusão de tarefas do agente após ativar o Dreaming para fluxos de trabalho de redação jurídica.
Os mesmos trabalhos que costumavam falhar porque o Claude esquecia peculiaridades de tipo de arquivo e soluções alternativas de ferramentas entre as sessões de repente começaram a terminar de forma confiável.
Os erros que quebram a memória do agente.
- Tratar Projetos como memória. Projetos persistem instruções, não histórico de conversas. Presuma o contrário e você perderá contexto sem entender o porquê.
- Despejar tudo no CLAUDE.md. Um arquivo de memória inchado desperdiça tokens e enterra o sinal. Enxuto e estruturado vence longo e completo.
- Armazenar memória sem filtro. Se tudo vale a pena ser lembrado, nada vale. Salve apenas o que mudaria o comportamento futuro.
- Implantar automaticamente a saída do dream. O objetivo do armazenamento de saída separado é a revisão. Pule isso e você perde a rede de segurança.
- Executar o Dreaming em um agente de baixa frequência. O Dreaming consolida padrões em várias sessões. Um agente que executa duas vezes por mês nunca acumula o suficiente.
Conclusão:
A maioria das pessoas continuará abrindo o Claude como sempre fizeram — um chat novo e esquecido a cada vez, se reexplicando em cada execução, se perguntando por que seu agente nunca melhora.
Aqueles que construírem as quatro camadas terão algo diferente: um agente que os conhece, acumula o que aprende e reescreve sua própria memória para ficar mais afiado a cada semana.
Escolha os primeiros quatro passos. Configure-os esta noite. Só isso já mudará como sua próxima sessão será.
