Eu combinei tudo o que realmente funciona sobre a memória do Claude — documentação oficial, a prévia de pesquisa do Dreaming e configurações reais de produção — em um único guia completo.
Siga meu Substack para receber novidades de IA em primeira mão: movez.substack.com
Marque esta página. Salve-a. Ao final, você terá um agente que se lembra permanentemente — não "dentro de um chat", mas por semanas a fio.
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 gambiarra que descobriu na semana passada, nem 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 é divulgado. É uma propriedade fundamental de como os modelos de linguagem funcionam: cada sessão começa do zero, a menos que você alimente explicitamente o contexto de volta.
Para um chatbot, isso é ok. Para um agente que executa trabalhos reais e repetitivos, é o maior motivo pelo qual sua configuração estaciona. Um agente sem memória é exatamente tão útil na execução 100 quanto foi na execução 1.
A Camada 1 é um post-it. 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 não 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ê mande esquecer.
Clique no ícone do seu perfil → Configurações → Capacidades → role até a seção Memória e confirme que "Gerar memória a partir do histórico do chat" está ativado.
Por baixo dos panos, 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 se constrói.
02. Alimente sua memória deliberadamente, em vez de esperar
A parte contraintuitiva que a documentação explicita: não espere o Claude inferir suas preferências do histórico — essa síntese só roda cerca de uma vez a cada 24 horas.
Diga a ele diretamente em uma conversa nova. O explícito sempre vence o implícito, e chega na hora, 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á em 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. Todo 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, dá a ele um 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 ao 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 martela: mantenha-o enxuto. Uma sessão nova pode gastar cerca de 20.000 tokens carregando instruções antes de você digitar qualquer coisa.
Não trate este arquivo como um dump de wiki. Se você usar o /init do Claude Code para gerar um arquivo inicial, o próximo passo contraintuitivo é deletar 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 toda 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 vira 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 inteiro. 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 gambiarra, 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 na 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 o 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 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 dar ao trabalho: o Dreaming só ajuda agentes que executam o mesmo tipo de tarefa repetidamente. Ele consolida padrões em muitas sessões, então um agente pontual não tem nada para consolidar. Execute-o em um cavalo de batalha, não em um turista.
10. Execute um sonho — 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 gradualmente) e um ambiente Python ou TypeScript com o SDK mais recente da Anthropic.
Toda chamada de sonho precisa de dois cabeçalhos beta empilhados — o SDK define ambos 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 sonho:
Os modelos suportados durante a prévia são claude-opus-4-7 e claude-sonnet-4-6. Os sonhos são cobrados às taxas padrão de token 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, aumente a escala assim 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 sonho produz um armazenamento de saída separado, e seu ID aparece no array outputs[] do sonho 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 sonho nunca pode corromper silenciosamente o que você já tem.
12. Substitua, agende e deixe acumular
Assim que você 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 sonho em um agendamento: 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 nenhum retreinamento ou reconfiguração manual.
Arquivar um sonho antigo nunca toca em seu armazenamento de saída — você gerencia esses 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 aproximadamente um aumento de 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 continuava esquecendo peculiaridades de tipo de arquivo e gambiarras 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 sonho. 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 muitas 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 toda 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 hoje à noite. Só isso já mudará como sua próxima sessão será.
