Conteúdo detalhado
🧠 Os três níveis de memória
A ideia é simples: quanto mais contexto certo o Claude tem sobre você e seu projeto, melhores são as respostas e o código. Mas nem todo dado é igual — alguns mudam o tempo todo, outros quase nunca. Por isso separamos a memória em três níveis, cada um com uma "taxa de mudança" diferente.
O modelo mental de memória curta, média e longa — e como os três se encaixam num só sistema.
Sem esse mapa, as pessoas jogam tudo na conversa e sofrem com respostas que pioram. Com ele, você sabe onde cada informação mora.
Curta = sessão · Média = CLAUDE.md · Longa = base de conhecimento em disco · cada nível tem sua taxa de mudança.
Curta — o agora
O que você falou nesta conversa. Vive dentro da sessão; some ao abrir um chat novo. Muda toda hora.
Média — o manual do projeto
Um CLAUDE.md na raiz da pasta diz o que é o projeto, o objetivo, o stack e as decisões. Muda às vezes, mas tem estabilidade.
Longa — o arquivo morto vivo
Notas, decisões e aprendizados guardados em disco para consultar meses adiante. Quase nunca muda; só cresce.
🏢 Analogia do escritório
A memória curta é o que está espalhado na sua mesa agora. O CLAUDE.md é o quadro fixo na parede com as regras do projeto — quem entra na sala lê primeiro. A base de conhecimento é o arquivo de gavetas atrás de você: não olha toda hora, mas sabe onde achar.
⭐ A regra de ouro
O melhor sistema de memória é aquele que não exige que você esteja num chat específico para funcionar. Se você abrir uma conversa nova do zero, o Claude deveria render quase igual — porque o que importa está escrito em arquivo, não preso na conversa anterior.
⏱️ Memória curta e o context rot
A memória curta é o estado da conversa atual mais o básico sobre você. É o nível mais frágil: desaparece a cada chat novo. E tem um efeito traiçoeiro — quando a conversa fica longa demais, a qualidade cai. É o context rot. Por isso recomeçar é saudável, não desperdício.
O estado da conversa atual mais instruções gerais sobre você.
É o nível mais frágil — saber disso evita frustração e ensina quando recomeçar.
Contexto de sessão · instruções gerais · context rot (a qualidade cai quando a conversa fica longa demais).
✓ Conversa enxuta
- ✓Foco num assunto por vez — respostas afiadas.
- ✓Recomeça sem medo quando trocar de tema.
- ✓O contexto durável já está em arquivo, não na conversa.
✗ Sessão eterna
- ✗Arrasta tudo num chat só — a qualidade vai caindo.
- ✗Acha que conversa longa = mais memória (é o oposto).
- ✗Perde tudo quando o chat fecha, sem nada salvo.
💡 Dica prática
Quando sentir a conversa "pesada" ou notar respostas piores, abra um chat novo. Se o seu CLAUDE.md e a base de conhecimento estiverem em ordem, você não perde nada — recomeçar é parte do método.
🪣 Organize sua vida em "baldes"
Antes de escrever um CLAUDE.md, você precisa de onde colocá-lo. A base da memória média é dividir tudo o que você faz em 5–8 grandes áreas — os baldes (buckets) — e transformar cada uma numa pasta.
Dividir suas frentes de trabalho em 5–8 baldes, cada um virando uma pasta no computador.
É o alicerce da memória média. Sem baldes, não há onde morar um CLAUDE.md.
Bucket = cluster de projetos relacionados · uma pasta por bucket · comece simples (pessoal, cliente-x, estudos).
Peça ao Claude para organizar
Use o prompt de baldes (seção Prompts) para agrupar suas atividades em 5–8 áreas.
Crie uma pasta por balde
No seu computador, uma pasta com nome claro para cada balde.
Reserve um balde pessoal
Sempre tenha um balde para seus dados e documentos próprios.
💡 Dica prática
Não busque a taxonomia perfeita. Comece com poucos baldes amplos e ajuste depois — é mais fácil dividir um balde grande do que juntar dez pequenos.
📋 CLAUDE.md — o manual do projeto
O CLAUDE.md é um arquivo na raiz de cada pasta que explica o projeto ao Claude. Apenas um por pasta, curto (~200 palavras). O Claude lê esse arquivo automaticamente ao abrir a pasta — ele vira a sua "estrela-guia". É o coração da memória média.
Um arquivo CLAUDE.md na raiz da pasta, curto, que descreve o projeto ao Claude.
É o coração da memória média. Lido automaticamente, vira a referência fixa de todo o trabalho na pasta.
O que é a pasta · objetivo (north star) · stack · decisões fixas · mapa de memória · referências. Decisões viram regras (ex.: "nada de posts gerados por IA").
Template de CLAUDE.md (pronto para copiar)
# CLAUDE.md — <nome do projeto> ## O que é esta pasta <Uma frase: o que vive aqui e para quê.> ## Objetivo (north star) <O resultado que este projeto persegue. Toda decisão é medida contra isto.> ## Stack <Ferramentas, linguagens, serviços usados. Ex.: Next.js, Stripe, Supabase.> ## Decisões fixas - <Decisão 1 — ex.: tudo em português.> - <Decisão 2 — ex.: sem dependências pesadas.> - <Decisão 3 — ex.: nada de conteúdo gerado por IA sem revisão.> ## Mapa de memória - Base de conhecimento: ./conhecimento/ - Subpastas por tema: <ex.: decisoes, notas, referencias> ## Memória (memory save) Quando eu pedir para salvar/lembrar uma conversa, grave o essencial em ./conhecimento/ na subpasta mais relacionada ao tema. ## Referências - <link ou caminho de algo importante.>
Copie o template
Use o bloco acima como ponto de partida.
Preencha objetivo, stack e decisões
Específico de cada balde. Salve como CLAUDE.md na raiz da pasta.
Peça ao Claude para te entrevistar
Ele faz 3–5 perguntas e completa o que faltou, mantendo o arquivo curto.
✂️ Mantenha enxuto
Mire em ~200 palavras — algo que cabe numa tela. Se crescer demais, mova os detalhes para a base de conhecimento. O CLAUDE.md guarda "o projeto hoje", não o histórico.
🗄️ Memória longa: a base que cresce
A memória longa são notas e decisões guardadas em arquivos de texto (markdown) que você consulta no futuro. O CLAUDE.md cuida do "como o projeto é hoje"; a base de conhecimento guarda o histórico e os aprendizados.
Notas e decisões em arquivos markdown interligados, organizados em subpastas por tema.
É a memória institucional do projeto — o que você decidiu e aprendeu, disponível meses depois.
Markdown interligado · subpastas por tema · editável à mão · ferramentas como Obsidian só visualizam os arquivos (são opcionais).
✓ Vai para a memória longa
- ✓Decisões importantes (com data e motivo).
- ✓Frameworks e aprendizados que valem por meses.
- ✓Referências e notas que você vai querer reler.
✗ NÃO vai para lá
- ✗A conversa inteira copiada e colada.
- ✗Detalhes do dia que mudam toda hora.
- ✗Coisas que pertencem ao
CLAUDE.md(o "hoje").
🔭 Obsidian é opcional
A base de conhecimento são só arquivos .md em pastas — você não precisa de nenhum app. Ferramentas como o Obsidian apenas visualizam e conectam esses arquivos; o conteúdo continua sendo seu, em texto, no disco.
💾 "memory save": registre o que importa
O memory save é uma rotina: ao pedir "salve isto", o Claude grava o essencial da conversa na pasta certa da base. Transforma boas conversas em conhecimento permanente — sem copiar-e-colar manual. É o que fecha o ciclo entre os três níveis.
Uma rotina onde, ao pedir "salve", o Claude grava o essencial na pasta certa da base.
Converte boas conversas em conhecimento durável, sem trabalho manual.
Seção de memória no CLAUDE.md · escolha da subpasta certa · salvar só o que tem valor durável (decisões, frameworks).
Adicione a seção ao CLAUDE.md
Diga onde salvar quando você pedir (use a seção "Memória" do template).
Aponte o caminho da base
Ex.: ./conhecimento/ com subpastas por tema.
Peça para o Claude escolher a subpasta
Pelo tema da conversa — e salvar só decisões e aprendizados duráveis.
Indo mais fundo (opcional): por que recomeçar não perde nada
Com CLAUDE.md + base de conhecimento em ordem, abrir um chat novo é seguro: o que importa está em arquivo, não na sessão. Você evita o context rot e mantém a performance estável. A memória não pode depender da conversa anterior — esse é o teste final do sistema.
Auto-checagem (opcional): onde mora a "estrela-guia" que o Claude lê automaticamente ao abrir uma pasta?
✏️ Exercícios
1. Mapeie seus baldes (fácil)
Liste de 5 a 8 baldes da sua vida/trabalho. Critério: cada balde é uma área distinta, sem sobreposição grande.
2. Crie um CLAUDE.md de verdade (médio)
Escolha um projeto real e escreva um CLAUDE.md de no máximo ~200 palavras. Critério: tem objetivo, stack e ao menos 2 decisões; cabe numa tela.
3. Teste do chat novo (médio)
Abra uma conversa do zero e peça ao Claude para resumir o projeto só pelo CLAUDE.md. Critério: o resumo bate com o que você escreveu, sem dar contexto extra.
4. Salve na base de conhecimento (médio)
Crie uma subpasta conhecimento/ e registre 1 decisão em markdown. Critério: o arquivo existe, tem data e está na pasta certa.
5. Enxugue (médio)
Releia seu CLAUDE.md e corte tudo que não é durável. Critério: nada de detalhes de conversa do dia; só o que vale por semanas/meses.
⌨️ Prompts prontos
Estes prompts montam sua memória média e longa na prática. Copie, ajuste para o seu contexto e rode no Claude Code. O banco completo está na Biblioteca → Prompts.
Organizar em baldes (canônico)
Com base em tudo o que você sabe sobre mim e no que eu trabalho, organize minha vida em 5 a 8 "baldes". Cada projeto deve cair em um balde. Não invente fatos: se faltar informação, me pergunte. Sem enrolação.
Original (EN):
Based on everything you know about me and everything I work on, organize my life into 5 to 8 buckets. Put any project into one of those buckets. Don't invent facts — ask me if something is missing. No fluff.
Aplicar o CLAUDE.md em cada pasta
Adicione um arquivo CLAUDE.md na raiz de cada uma das pastas dos baldes, usando o template que vou te passar. Depois, me faça perguntas sobre cada projeto para preencher o briefing completo. Apenas um CLAUDE.md por pasta.
Salvar na memória longa ("memory save")
Quando eu pedir para salvar, guardar, encerrar ou lembrar uma conversa, grave o essencial em markdown na minha base de conhecimento, na subpasta mais relacionada ao tema. Salve só decisões e aprendizados duráveis, não a conversa toda.
Template de CLAUDE.md (pronto para copiar)
# CLAUDE.md — <nome do projeto> ## O que é esta pasta <Uma frase: o que vive aqui e para quê.> ## Objetivo (north star) <O resultado que este projeto persegue. Toda decisão é medida contra isto.> ## Stack <Ferramentas, linguagens, serviços usados. Ex.: Next.js, Stripe, Supabase.> ## Decisões fixas - <Decisão 1 — ex.: tudo em português.> - <Decisão 2 — ex.: sem dependências pesadas.> - <Decisão 3 — ex.: nada de conteúdo gerado por IA sem revisão.> ## Mapa de memória - Base de conhecimento: ./conhecimento/ - Subpastas por tema: <ex.: decisoes, notas, referencias> ## Memória (memory save) Quando eu pedir para salvar/lembrar uma conversa, grave o essencial em ./conhecimento/ na subpasta mais relacionada ao tema. ## Referências - <link ou caminho de algo importante.>
Dica: mantenha o CLAUDE.md em torno de ~200 palavras. Se crescer, mova detalhes para a base de conhecimento.
⚠️ Erros comuns
- ✗Deixar tudo na conversa. Confiar na memória curta e perder o contexto ao abrir um chat novo. Corrija: escreva o que importa no
CLAUDE.md. - ✗
CLAUDE.mdgigante. Encher de detalhes que mudam toda hora. Corrija: mantenha ~200 palavras; o resto vai para a base. - ✗Mais de um
CLAUDE.mdpor pasta. Gera confusão sobre qual o Claude lê. Corrija: só um por pasta, na raiz. - ✗Salvar lixo na memória longa. Jogar a conversa inteira na base. Corrija: salve só decisões e aprendizados duráveis.
- ✗Arrastar uma sessão eterna. Achar que conversa longa = mais memória. Corrija: recomece sem medo; o sistema em arquivo segura o contexto.
✅ Resumo do módulo
CLAUDE.md) e longa (base de conhecimento); cada um com sua taxa de mudança.CLAUDE.md enxuto por pasta.Checklist de conclusão
- ☐ Defini de 5 a 8 baldes para minha vida/trabalho.
- ☐ Criei uma pasta por balde.
- ☐ Cada pasta tem um
CLAUDE.mdna raiz, com ~200 palavras. - ☐ Cada
CLAUDE.mdtraz objetivo, stack e ao menos 2 decisões. - ☐ Testei um chat novo e o Claude resumiu o projeto só pelo
CLAUDE.md. - ☐ Criei a subpasta
conhecimento/e salvei ao menos 1 decisão. - ☐ Adicionei a seção de "memory save" ao
CLAUDE.md.
Próximo módulo:
1.4 — Power Features: recursos avançados para tirar mais do Claude Code