CLAUDE.md, memória automática e Brand Brain: como dar memória de marca à IA
Toda sessão do Claude Code começa do zero. O modelo não lembra a conversa de ontem, a correção que você fez na semana passada nem o tom de voz que levou meses para acertar. Quem usa IA em marca sente isso no dia a dia: o texto sai genérico até alguém colar de novo o posicionamento, a lista de palavras proibidas e os exemplos aprovados.
O Claude Code tem dois mecanismos para levar conhecimento de uma sessão para a outra, o CLAUDE.md e a memória automática. Neste terceiro texto da série sobre agentes de IA, explicamos como os dois funcionam, com base na documentação oficial consultada em outubro de 2026, e por que, para marca, montamos uma terceira camada, o Brand Brain.
Por que a IA esquece
O modelo trabalha dentro de uma janela de contexto, que é tudo o que ele considera numa conversa. Quando a sessão termina, a janela some. Quando a conversa fica longa demais, o Claude Code compacta o histórico em um resumo, e detalhes ditos só no chat podem se perder nesse processo.
A solução é tirar o conhecimento da conversa e guardar em arquivos que o Claude lê de novo a cada sessão. Os dois mecanismos do Claude Code fazem isso de jeitos diferentes: no CLAUDE.md quem escreve é você, e na memória automática quem escreve é o Claude.
O que é o CLAUDE.md
O CLAUDE.md é um arquivo de texto com instruções que o Claude lê no começo de toda sessão. Ele pode valer para um projeto, para você em todos os projetos ou para uma organização inteira, dependendo de onde fica.
| Arquivo | Vale para | Bom para |
|---|---|---|
~/.claude/CLAUDE.md | Você, em todos os projetos | Preferências pessoais de trabalho |
CLAUDE.md na raiz do projeto | Todo mundo que trabalha no projeto | Regras do projeto, compartilhadas pelo repositório |
CLAUDE.local.md na raiz do projeto | Só você, naquele projeto | Ajustes pessoais que não devem ser compartilhados |
| Arquivo gerenciado pela empresa | Todos os usuários da organização | Políticas e padrões obrigatórios |
Quando há vários, o Claude lê todos e junta o conteúdo, do mais amplo para o mais específico. Para começar, o comando /init analisa o projeto e gera um primeiro CLAUDE.md, que você ajusta depois com o que o Claude não conseguiria descobrir sozinho.
Como escrever um CLAUDE.md que funciona
A documentação sugere ficar abaixo de 200 linhas por arquivo. Arquivo longo ocupa contexto em toda sessão e, segundo a própria Anthropic, reduz a aderência às instruções. Também pede instruções específicas: “use português do Brasil e nunca hífen como travessão” funciona melhor que “escreva bem”.
Instruções que se contradizem são um problema silencioso. Se um trecho diz “tom formal” e outro diz “tom próximo”, o Claude pode seguir qualquer um. Vale reler o arquivo de tempos em tempos e apagar o que ficou velho.
O CLAUDE.md pode puxar outros arquivos com @caminho/do/arquivo, até quatro níveis de profundidade. Isso deixa o arquivo organizado, mas o importado também carrega em toda sessão, então não sobra espaço. Para regras que só valem em parte do projeto, a pasta .claude/rules/ aceita arquivos com um campo paths, que só entram quando o Claude mexe em arquivos daquele caminho.
Um último ponto que costuma surpreender: o CLAUDE.md funciona como contexto e não consegue bloquear nada. O Claude tende a seguir, mas pode errar. Quando uma ação precisa ser impedida sempre, como apagar uma pasta de entregas, o caminho é um hook, um comando que o Claude Code executa antes da ação e que pode bloqueá-la.
O que é a memória automática
A memória automática é o caderno que o Claude escreve sozinho. Enquanto trabalha, ele registra o que pode servir numa conversa futura: quem você é e como prefere trabalhar, as correções que você fez, decisões de projeto que não estão no código e onde encontrar informação fora dele.
As notas ficam em ~/.claude/projects/<projeto>/memory/, uma por arquivo, com um índice chamado MEMORY.md. O índice entra em toda sessão, até as primeiras 200 linhas ou 25 KB. O Claude não guarda o que dá para descobrir lendo o projeto nem o que o CLAUDE.md já diz. Pelo comando /memory, você liga, desliga e confere o que foi salvo.
No projeto do nosso site, a memória automática tem 87 notas. Uma lembra que o cache do site precisa de um comando específico para a página publicada mudar de fato. Outra registra que, na tradução de um post, o idioma tem de ser gravado antes da categoria, senão o post some da listagem. Nenhuma dessas coisas estava escrita em lugar nenhum antes.
A memória automática também erra. Se o Claude anotar algo que não conferiu, a nota passa a parecer fato nas sessões seguintes. Por isso vale abrir a pasta de vez em quando e apagar o que estiver errado ou desatualizado.
O que falta para marca: o Brand Brain
CLAUDE.md e memória automática ficam presos a um projeto e a uma pessoa. Uma marca precisa de outra coisa: um conhecimento que vale em qualquer projeto, que várias pessoas usam, e em que cada afirmação tem origem. Foi para isso que montamos o Brand Brain, a memória de marca que os nossos agentes consultam antes de produzir.
O Brand Brain é uma pasta de arquivos de texto organizada por assunto. Começa por fontes e perguntas abertas, passa por estratégia (posicionamento, proposta de valor, territórios), audiência (perfil de cliente, dores, objeções, o vocabulário que o cliente usa) e voz (tom, léxico, o que a marca nunca diz e exemplos calibrados). Depois vêm o kit visual, a governança, a ativação e um registro de decisões.
Duas regras fazem diferença. A primeira: nenhuma afirmação entra sem fonte. O que o material da marca não responde vira pergunta aberta, nunca palpite escrito como fato. A segunda: quando um pedido contradiz o brain, quem está produzindo escolhe entre seguir a regra, abrir uma exceção só para aquela peça ou mudar a regra, e a escolha fica registrada com a versão.
O brain também não carrega inteiro. Na hora de produzir, o agente consulta só as seções que importam para aquela peça: uma legenda puxa voz e o que a marca nunca diz, uma peça visual puxa o kit. É a mesma lógica das skills, que só entram quando a tarefa pede.
Como as três camadas se encaixam
| CLAUDE.md | Memória automática | Brand Brain | |
|---|---|---|---|
| Quem escreve | Você | O Claude | A equipe, a partir do material da marca |
| O que guarda | Como trabalhar neste projeto | O que o Claude aprendeu com você | O que a marca é e o que ela pode dizer |
| Alcance | Um projeto, uma pessoa ou a empresa | Um projeto | Uma marca, em qualquer projeto |
| Carrega | Em toda sessão | Índice em toda sessão | Por seção, quando a peça pede |
| Fonte | Quem escreveu | A conversa | Documento citado em cada afirmação |
Um jeito de pensar: o CLAUDE.md é o manual de trabalho da equipe, a memória automática é o caderno de anotações de quem trabalha, e o Brand Brain é o livro da marca, com notas de rodapé.
Por onde começar
Rode /init no projeto e corte o arquivo gerado até ficar só o que vale para tudo. Acrescente as três ou quatro instruções que você mais repete. Deixe a memória automática ligada e, depois de duas semanas, leia o que ela guardou.
Para a marca, comece por três arquivos: o posicionamento em um parágrafo, uma lista do que a marca nunca diz e cinco exemplos de textos aprovados, com a fonte de cada um. Os exemplos costumam ensinar mais à IA do que qualquer descrição de tom. Na revisão, as regras do nosso mapa de padrões de texto de IA ajudam a montar essa lista.
Os outros textos da série tratam de subagentes, que consultam essa memória em contextos separados, e de skills e plugins, que empacotam a consulta para a equipe toda usar do mesmo jeito.
A série completa
Este texto faz parte de uma série de cinco sobre agentes de IA aplicados a marca:
- Subagentes e equipes de agentes no Claude Code
- Skills e plugins no Claude Code
- CLAUDE.md e Brand Brain: memória de marca para IA (este texto)
- Como revisar conteúdo gerado por IA
- Como usamos IA na operação da Headcore
Perguntas frequentes
Qual a diferença entre CLAUDE.md e memória automática?
Você escreve o CLAUDE.md, com instruções e regras, e ele é lido inteiro em toda sessão. A memória automática é escrita pelo próprio Claude, com o que ele aprende das suas correções e preferências, e só o índice entra em toda sessão, até 200 linhas ou 25 KB.
O CLAUDE.md garante que a IA siga as regras?
Não garante. O Claude trata o CLAUDE.md como contexto e tende a seguir, principalmente quando as instruções são curtas e específicas. Para impedir uma ação sempre, a documentação indica usar um hook, que roda antes da ação e pode bloqueá-la.
Qual o tamanho ideal de um CLAUDE.md?
A documentação sugere menos de 200 linhas por arquivo. Arquivos maiores ocupam mais contexto e reduzem a aderência. O que vale só para parte do projeto pode ir para .claude/rules/ com o campo paths, que carrega apenas quando necessário.
O que acontece com as instruções quando a conversa é compactada?
O CLAUDE.md da raiz do projeto é relido do disco depois da compactação. Instruções que foram dadas só na conversa podem se perder no resumo. Se uma instrução precisa durar, ela deve ir para o CLAUDE.md.
Dá para dar memória de marca à IA sem o Claude Code?
Dá. O Brand Brain é uma pasta de arquivos de texto, e qualquer ferramenta que leia arquivos pode consultá-lo. O que o Claude Code acrescenta é a consulta automática: os agentes leem as seções certas antes de produzir, sem alguém precisar colar o material na conversa.
Qual a diferença entre Brand Brain e brand book?
O brand book é feito para pessoas: mostra como a marca deve parecer e soar. O Brand Brain é feito para ser consultado por máquina antes de gerar qualquer coisa, com cada afirmação ligada à fonte e perguntas abertas onde o material não responde. O kit visual do brand book vive dentro do brain.
Fonte: documentação do Claude Code sobre memória, consultada em 21/10/2026.
