Memória do Claude: Memory, CLAUDE.md e Auto Memory

O que é a memória do Claude e porque tem três camadas?#

Na terça-feira, abre o Claude.ai e fala-lhe do seu público, do formato das respostas e do estilo de escrita. Na quinta-feira, regressa numa nova conversa — e o Claude já se lembra. É a Memory em ação.

Abre o Claude Code no terminal, passa duas semanas a conhecer um projeto e explica a estrutura das pastas, as regras de implementação e as bibliotecas preferidas. Fecha a sessão e volta a abri-la uma hora depois — e o agente começa novamente do zero. A Memory não funciona aqui. Para mudar isso, precisa do CLAUDE.md.

Em 2026, surgiu uma terceira camada. A Auto Memory no Claude Code significa que o próprio agente escreve notas sobre o seu projeto: quais os comandos que funcionam, quais os testes que passam e quais os caminhos no repositório que são sensíveis. Estas notas ficam guardadas localmente no seu disco e são carregadas automaticamente na sessão seguinte.

A principal confusão: as pessoas ouvem dizer que «o Claude agora se lembra» e pensam que funciona automaticamente em todo o lado. Não funciona. A Memory do claude.ai não passa para o Claude Code — a documentação oficial do Claude Code descreve dois mecanismos de memória, e a Chat Memory não é um deles. O CLAUDE.md e a Auto Memory funcionam no Claude Code — são sistemas completamente diferentes. O mesmo se aplica à API da Anthropic: tem uma ferramenta Memory separada, que não está relacionada com a memória do chat.

Este guia aborda os três sistemas para saber o que colocar em cada um e por que razão o Claude, de repente, se «esquece» de um projeto, apesar de ter «configurado a memória».

O que é a Memory no Claude.ai e quem a tem gratuitamente em 2026?#

Como a Memory recolhe informações

A Anthropic chama a este processo Memory Synthesis. Cerca de uma vez por dia, o Claude processa as suas conversas recentes, identifica o que será útil a longo prazo e escreve breves blocos de resumo no seu perfil de Memory. Não são citações literais das suas mensagens — são afirmações condensadas, como «o utilizador é profissional de marketing, gere um projeto online e prefere respostas curtas e sem palha».

Na conversa seguinte, estes resumos são adicionados automaticamente ao início do contexto. O Claude sabe quem é, o que faz e de que estilo de resposta gosta — sem ter de repetir tudo em cada conversa.

Que planos são compatíveis com a Memory

A Anthropic lançou a Memory por etapas: 11 de setembro de 2025 — Team e Enterprise; 23 de outubro de 2025 — Pro e Max; 2 de março de 2026 — gratuita em todos os planos, juntamente com a ferramenta Import do ChatGPT, Gemini e Grok.

Isto é importante: a Memory funciona onde há uma interface Web do Claude.ai ou uma aplicação móvel. Sempre que utilizar o Claude através do seu próprio código ou da CLI, a Memory não está disponível.

Onde a consultar e editar

No claude.ai: Settings → Capabilities → Memory. URL direta: claude.ai/settings/capabilities?modal=memory. É apresentada uma lista de tudo o que o Claude guardou sobre si. Há três botões:

• Pause — o Claude mantém a memória acumulada, mas deixa de a usar e de a acrescentar.
• Reset memory — apaga tudo.

  Depois de selecionar esta opção e clicar em 'Reset memory', não é possível anulá-la.

• Editar entradas individuais — pode apagar manualmente entradas específicas.

Também há controlos diretamente no chat: diga ao Claude «lembra-te de X» ou «esquece Y» — e a Memory será atualizada sem ter de ir a Settings.

Mais uma coisa importante: os projetos no Claude.ai têm memória separada.

Isto significa que as conversas dentro de um projeto não passam para a Memory geral, nem o contrário.

Pode perguntar diretamente ao Claude

Em qualquer conversa, escreva: «O que te lembras sobre mim?» O Claude vai enumerar aquilo de que se lembra para esta conversa. É a forma mais rápida de confirmar o que entrou no seu perfil de Memory.

Privacidade

A Anthropic afirma explicitamente que a sua memória é privada e não é partilhada com outros utilizadores. Por predefinição, a Anthropic pode utilizar as suas conversas (incluindo as que entram na Memory) para melhorar os seus modelos. Pode desativar esta opção nas definições de Privacy — em Data Controls.

O que é o CLAUDE.md no Claude Code e em que difere da Memory?#

A Memory recolhe informações sobre si enquanto pessoa — o seu estilo, as suas preferências e a sua profissão. O CLAUDE.md diz respeito a um projeto específico: este repositório, estes comandos, estas regras de trabalho com código. A diferença é fundamental: a Memory reúne informações sobre «quem sou em geral», enquanto o CLAUDE.md indica «como este trabalho está organizado».

Onde o Claude Code procura o CLAUDE.md

Em quatro locais ao mesmo tempo, por ordem de prioridade crescente:

Os quatro ficheiros são carregados ao mesmo tempo e concatenados; não se sobrepõem uns aos outros.

A ordem vai do âmbito mais abrangente ao mais específico. Project e Local ficam no fim — por isso, aparecem no final do contexto, mais perto do pedido. É por isso que deve manter tudo o que é essencial no CLAUDE.md do projeto.

O que as pessoas costumam incluir

• Stack do projeto — Next.js / Prisma / PostgreSQL / Redis
• Comandos — como executar testes, compilar e implementar
• Caminhos sensíveis — que pastas não devem ser alteradas sem um pedido explícito
• Convenções — estilo dos commits, formato dos nomes de ficheiros
• Regras de negócio — o que é importante para o projeto (por exemplo, nunca codificar preços diretamente)
• Referências de contexto — «para a lógica de negócio, consulte docs/business/; para o sistema de design, consulte docs/design/» (os nomes das pastas ficam ao seu critério; o importante é não colocar tudo num único ficheiro)

Para uma análise completa, consulte o guia do CLAUDE.md, com um modelo pronto a usar.

Como o CLAUDE.md DIFERE da Memory

Numa frase: a Memory é a sua cabeça; o CLAUDE.md são as instruções do projeto afixadas na parede do escritório.

O que é a Auto Memory no Claude Code e onde fica guardada?#

Em que difere a Auto Memory do CLAUDE.md

O CLAUDE.md contém as suas instruções. A Auto Memory contém notas que o agente escreve para si próprio. São tipos de conteúdo diferentes.

Escreve o CLAUDE.md manualmente: «responde sempre no idioma preferido do utilizador», «faz a implementação com npm run deploy», «não mexas na pasta legacy/». Estas são regras definidas antecipadamente.

A Auto Memory é aquilo que o Claude aprende à medida que trabalha. Executa um teste, que falha porque falta um pacote — e o Claude regista: «neste projeto, executa npm install antes dos testes». Assim, não repete o mesmo erro na sessão seguinte.

Onde fica guardada

Localmente no seu disco, numa pasta separada para cada projeto:

~/.claude/projects/[project-name]/memory/

O ficheiro principal chama-se MEMORY.md. Um pormenor importante: o Claude Code carrega o CLAUDE.md na íntegra, mas o MEMORY.md tem um limite — só são carregadas as primeiras 200 linhas ou 25KB, consoante o limite que for atingido primeiro. Isto impede que o Claude fique soterrado pelas próprias notas acumuladas ao longo de meses de trabalho. As notas persistem numa pasta local fora do repositório do projeto. O texto carregado passa a integrar o contexto da conversa enviado ao serviço de modelos configurado; persistência local não promete processamento offline. Não guarde segredos nestes ficheiros.

Quando funciona

A Auto Memory funciona no Claude Code a partir da versão v2.1.59+ e está ativada por predefinição em novas instalações. Para verificar o estado e geri-la, utilize o comando:

/memory

Este comando abre um editor para todas as camadas de memória — tanto o CLAUDE.md como o MEMORY.md. Pode ver o que o Claude já registou sobre o seu projeto, editar ou apagar essas informações. Para desativar completamente a Auto Memory, defina autoMemoryEnabled: false em ~/.claude/settings.json ou utilize a variável de ambiente CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

O que costuma ficar registado

• Comandos que funcionaram ou falharam
• A estrutura do projeto descoberta pelo agente
• Antipadrões encontrados
• Nomes de ficheiros e funções importantes

A documentação oficial do Claude Code da Anthropic explica diretamente a diferença:

Por outras palavras: CLAUDE.md = instruções que escreve. Auto Memory = notas que o Claude escreve para si próprio, com base nas suas correções e preferências.

Memory ou CLAUDE.md: que sistema trata de cada tarefa?#

Matriz de decisão

A Memory e o CLAUDE.md não se duplicam. Funcionam em produtos diferentes e guardam informações diferentes. São como um calendário pessoal e uma política da empresa — ambos são úteis, mas ninguém os confunde.

Quando ativar a Memory: 3 cenários em que é realmente útil#

Cenário 1. Usa o claude.ai como assistente pessoal

Escreve ao Claude todos os dias: reformula um e-mail, analisa uma folha de cálculo, sugere uma ideia. Os temas variam, mas continua a ser a mesma pessoa. A Memory evita que tenha de dizer: «Olá, sou profissional de marketing, tenho um projeto online e gosto deste estilo de resposta.»

Depois de uma semana de utilização, o Claude sabe a sua profissão, o formato das respostas, os formatos preferidos, o comprimento e o tom. Cada nova conversa começa com essas informações. Poupa 30–60 segundos por conversa.

Cenário 2. Escreve muitos conteúdos no mesmo estilo

Anúncios, publicações nas redes sociais, newsletters por e-mail — sempre a mesma voz da marca. A Memory aprende o seu estilo: que palavras evitar, que tom usar e qual deve ser o comprimento dos parágrafos.

Uma vez, ao longo de algumas semanas, diga ao Claude: «nos nossos textos, não uses travessões, mantém um tom amigável e escreve no máximo 3 parágrafos». A informação será registada. Depois, cada novo texto já seguirá o seu estilo sem precisar de lembretes.

Cenário 3. Precisa de contexto sobre a sua função

É designer e usa uma stack específica — Figma + Sketch, não Photoshop. É gestor de produto SaaS, não de comércio eletrónico.

A Memory vai captar este contexto profissional e adaptar automaticamente as respostas. Menos respostas genéricas e mais respostas adequadas ao seu trabalho específico.

Quando não precisa da Memory

Se trabalha principalmente com o Claude Code no terminal, a Memory não lhe traz nada. Simplesmente não funciona aí. Use o CLAUDE.md e não confunda os dois sistemas.

Se utiliza o Claude através da API no seu código, também não funciona aí. Adicione as instruções manualmente ao system prompt.

Se tem apenas um tipo de tarefa e não se importa de repetir o contexto no início de cada conversa, a Memory não é essencial. É uma conveniência, não um requisito.

O que deve ficar no CLAUDE.md e o que a Auto Memory recolhe automaticamente?#

O que tem de ficar no CLAUDE.md

1. Descrição do projeto num parágrafo — o que é, para quem se destina e porquê.
2. Tecnologias do projeto — que frameworks, bibliotecas e bases de dados utiliza.
3. Comandos — testes, compilação, publicação. Os comandos exatos.
4. Diretórios sensíveis — o que não deve ser alterado sem um pedido explícito.
5. Convenções — estilo dos commits, formato dos nomes de ficheiros, idioma das respostas.
6. Referências de contexto — por exemplo, «a lógica de negócio está em docs/business/; o design está em docs/design/». Os nomes das pastas ficam ao seu critério.

O que deixar para a Auto Memory

1. Detalhes do ambiente local — neste computador, o Python está em /usr/local/bin/python3.11.
2. Alterações no projeto — que comando falhou ontem e porquê.
3. Descobertas provisórias — onde se encontram os testes de um determinado módulo.
4. Dicas de fluxo de trabalho — que script executar depois de cada etapa.

O que não deve ficar em nenhum dos dois

• Chaves de API, palavras-passe e tokens — pertencem ao .env, não aos ficheiros de memória.
• Dados pessoais de clientes.
• Informações que podem ficar desatualizadas em breve (preços, datas de coortes, campanhas temporárias).
• Prompts para tarefas pontuais — sobrecarregam o contexto.

A regra das 200 linhas

A Anthropic recomenda na documentação que o CLAUDE.md tenha cerca de 100–200 linhas. Depois das 200 linhas, o Claude começa a lê-lo com menos eficácia — um contexto extenso consome recursos e reduz a precisão. Quando o ficheiro crescer, transfira secções para ficheiros .md separados nas proximidades e deixe referências curtas no CLAUDE.md: «para ver o estilo do código, consulte docs/code-style.md».

Para uma análise detalhada da estrutura do ficheiro, consulte o guia para criar um segundo cérebro no Claude Code, que explica como a estrutura passa do CLAUDE.md para cinco pastas de contexto.

Quais são os 5 erros que comprometem a memória do Claude e como evitá-los?#

Erro 1. Confundir a Memory com o CLAUDE.md

O erro mais comum. Alguém ouve dizer que «o Claude agora se lembra», ativa a Memory no claude.ai, depois abre o Claude Code no terminal e pergunta-se porque é que o agente voltou a «esquecer-se».

A Memory no claude.ai não passa para o Claude Code. São produtos diferentes com arquiteturas diferentes. Se quer que o Claude se lembre de um projeto no terminal, escreva o CLAUDE.md. Se quer que o Claude se lembre de si no browser, ative a Memory.

Como evitar. Antes de configurar a memória, decida onde trabalha principalmente. Se for no claude.ai, utilize a Memory. Se for no Claude Code, utilize o CLAUDE.md e a Auto Memory. Se usar ambos, configure os dois sistemas em vez de tentar combiná-los.

Erro 2. Esquecer que os nomes dos ficheiros diferenciam maiúsculas de minúsculas

O nome do ficheiro CLAUDE.md diferencia maiúsculas de minúsculas. O agente lê CLAUDE.md, com letras maiúsculas. Não lê claude.md nem Claude.md. O mesmo se aplica a CLAUDE.local.md. É um erro típico de quem está a configurar o Claude Code pela primeira vez: cria um ficheiro, escreve as instruções e pergunta-se porque não funcionam — mas o nome do ficheiro está em minúsculas.

Como evitar. Confirme as maiúsculas e minúsculas antes de guardar. Num Mac, selecione o ficheiro no Finder e prima Enter — o nome completo ficará visível. No terminal: ls -la CLAUDE*. Se aparecer claude.md, mude o nome: mv claude.md CLAUDE.md.

Erro 3. O CLAUDE.md cresceu até às 800 linhas

Obtém um modelo pronto, acrescenta todas as regras que parecem importantes e acaba com um ficheiro de 800 linhas. Agora o Claude demora mais a lê-lo, mas a qualidade das respostas diminui. Um contexto extenso consome a atenção do modelo.

Como evitar. Mantenha o CLAUDE.md com cerca de 100–200 linhas. Depois das 200, transfira secções para ficheiros .md separados e deixe referências no CLAUDE.md: «para ver o estilo do código, consulte docs/code-style.md». É o mesmo princípio de qualquer documentação para pessoas — não coloque tudo num único ficheiro.

Erro 4. Guardar segredos no CLAUDE.md ou na Auto Memory

Chaves de API, palavras-passe e tokens não devem constar de ficheiros de memória. O CLAUDE.md costuma ser submetido ao git, por isso os segredos acabam por ser expostos no repositório. A Auto Memory fica guardada localmente, mas o conteúdo pode aparecer numa captura de ecrã, numa conversa partilhada ou numa fuga de dados através de um servidor MCP com acesso ao disco.

Como evitar. Guarde os segredos no .env (e inclua .env no .gitignore). Mencione apenas os nomes das variáveis no CLAUDE.md: «a chave de API está em STRIPE_KEY; obtenha-a no .env».

Erro 5. Esperar que a Auto Memory descubra sozinha a lógica de negócio

A Auto Memory recolhe observações técnicas — comandos, erros, estrutura. Não aprende sozinha as regras de negócio («uma agência imobiliária não deve aceitar encomendas abaixo de determinado limite», «não utilize certas palavras nos textos»). Estas regras devem ficar no CLAUDE.md ou em ficheiros .md separados, referenciados pelo CLAUDE.md.

Como evitar. Separe as informações: os detalhes técnicos vão automaticamente para a Auto Memory. Escreva manualmente no CLAUDE.md as regras de negócio, o estilo e as convenções. Não espere que um sistema substitua o outro.

Como configurar a Memory + o CLAUDE.md numa noite (guia passo a passo)?#

1. Ative a Memory no Claude.ai. Abra Settings → Capabilities → Memory. Ative o interruptor. Verifique imediatamente as definições de Privacy — decida se permite que a Anthropic utilize as suas conversas para treinar modelos. A decisão é sua.

2. Fale com o Claude como se fosse você. Nas próximas 2–3 conversas, diga-lhe quem é, o que faz e de que estilo de resposta gosta. A Memory Synthesis regista essas informações no prazo de um dia.

3. No dia seguinte, confirme o que foi registado. Em qualquer conversa, escreva: «O que te lembras sobre mim?» O Claude enumera as suas memórias. Se não gostar de alguma, apague-a através de Settings → Memory ou peça ao Claude para a esquecer.

4. Crie o CLAUDE.md no seu projeto. Na raiz do projeto principal, crie um ficheiro chamado CLAUDE.md (com letras maiúsculas). Obtenha o modelo pronto no guia do CLAUDE.md — tem 6 secções e, segundo a Anthropic, o comprimento recomendado é de cerca de 200 linhas.

5. Preencha as secções do seu projeto. Descreva a stack, os comandos, os caminhos sensíveis e as convenções. Não ultrapasse 200 linhas — a partir daí, o Claude lê o ficheiro com menos eficácia.

6. Verifique a Auto Memory. No Claude Code, introduza o comando /memory. Abre-se um editor para todas as camadas. A Auto Memory é uma delas. Leia o que o Claude já sabe sobre o seu projeto.

7. Submeta o CLAUDE.md ao git. Faz parte do projeto. Se trabalhar em equipa, todos verão as regras.

8. Continue a trabalhar como habitualmente. Após cada erro do agente, acrescente uma linha ao CLAUDE.md a dizer «não faças isso». Ao fim de um mês, terá um conjunto de regras dinâmico e o Claude deixará de cair nas armadilhas habituais.

O que não funciona: 3 padrões que a memória do Claude não retém#

O estado da sessão não se mantém ao mudar de modelo

Trabalha no Claude Code com Opus 4.8 e depois muda para Sonnet 4.6 — o contexto da sessão pode ser reposto porque os modelos têm janelas de contexto diferentes. O CLAUDE.md e a Auto Memory serão carregados automaticamente na nova sessão, mas a conversa ativa não.

Os ficheiros que não mostrou não são carregados

O Claude só vê o que está no CLAUDE.md, o que está na Auto Memory e o que abriu explicitamente na sessão atual. Se o seu projeto tiver 500 ficheiros e escrever «vê como trato os pagamentos», o agente não sabe que ficheiro deve consultar. Tem de indicar o caminho explicitamente ou acrescentar uma referência ao CLAUDE.md.

A Memory não funciona em conversas pontuais através da API

Cada pedido à API do Claude é isolado. Não é carregada nenhuma memória. Se criar um chatbot através da API, tem de passar manualmente o system prompt e o histórico de mensagens. A Memory, o CLAUDE.md e a Auto Memory não ajudam neste caso.

O que se segue: a memória como ponto de partida para um Second Brain#

O CLAUDE.md e a Auto Memory dão ao Claude informações sobre a organização do código. Isso basta para tarefas técnicas: refatorações, erros, migrações e testes.

Mas, assim que precisa de tomar decisões de negócio — a quem enviar um e-mail, como formular uma oferta, que preço definir — a memória técnica não chega. Precisa de contexto: quem são os seus clientes, como tomam decisões e como funciona a economia do seu negócio.

Esse é o Second Brain — uma pasta de conhecimento empresarial junto ao projeto, a que o Claude acede através das referências no CLAUDE.md. Conhecimento do código e do negócio — e o agente deixa de ser «um assistente inteligente que alucina» para se tornar seu coautor.