Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

Análises Programação

Memória do Claude Code ou uma wiki em Markdown: onde cada uma para

Por ReviewRamble editors ·

A memória do Claude Code é um conjunto de notas que o modelo lê, não um conjunto de regras que ele precisa obedecer. O CLAUDE.md guarda suas instruções, o Auto Memory guarda o que o Claude aprendeu sobre você, e nenhum dos dois consegue impedir uma ação. Quando o trabalho cresce para muitas fontes que você quer guardar, citar e conferir, uma wiki em Markdown é o formato melhor, e hooks que a preenchem automaticamente são uma opção para acrescentar por último, com cuidado.

Este artigo traça a linha entre essas camadas. Cada afirmação sobre o Claude Code vem da documentação da Anthropic sobre memória, hooks e o Agent SDK; o padrão de wiki vem do gist LLM Wiki de Andrej Karpathy, e a automação, do README do claude-memory-compiler. Não rodamos essas configurações nós mesmos.

CLAUDE.md: as instruções que você escreve

O CLAUDE.md é um arquivo Markdown que você escreve e que o Claude Code lê no início de cada sessão. Ele pode ficar em um projeto, na sua pasta pessoal ou no nível da organização, e pode puxar outros arquivos com importações @path, até quatro níveis de profundidade. A Anthropic sugere manter cada arquivo abaixo de 200 linhas, porque arquivos longos ocupam mais contexto e são seguidos com menos confiabilidade, e oferece .claude/rules/ para instruções que só importam em alguns tipos de arquivo.

Captura de tela do site de Claude Code
Claude Code, site oficial

Pense nele como as orientações que você daria a um colega novo: comandos de build, estilo da casa, a pasta que ninguém deve mexer. Não é lugar para uma pilha crescente de fatos.

Auto Memory: as notas que o Claude guarda para si

O Auto Memory vem ligado por padrão nas sessões locais. O Claude escreve as próprias notas enquanto trabalha, a partir das suas correções e preferências, em ~/.claude/projects/<project>/memory/. Um arquivo MEMORY.md as indexa, uma linha por memória, e cada memória fica em seu próprio arquivo de tema. Só as primeiras 200 linhas ou 25KB do MEMORY.md, o que vier primeiro, são carregadas no início de uma sessão; os arquivos de tema são lidos quando o Claude decide que precisa deles.

Dois detalhes importam. A memória é local da máquina, então não acompanha você para outro computador nem para uma sessão na nuvem. E é Markdown puro, então você pode abrir /memory, ler o que o Claude concluiu sobre você e apagar o que estiver errado. Dá para desligá-la por projeto definindo autoMemoryEnabled como false.

Contexto não é imposição

A página de memória da Anthropic diz isso com todas as letras: o Claude trata tanto o CLAUDE.md quanto o Auto Memory como contexto, não como configuração imposta. Uma linha dizendo "nunca apague a pasta de migrations" é um conselho que o modelo costuma seguir. Se duas instruções se contradizem, a documentação avisa que o Claude pode escolher uma de forma arbitrária.

O que de fato bloqueia uma ação é um hook PreToolUse. Ele roda antes de uma chamada de ferramenta, e se terminar com o código 2, ou devolver um permissionDecision igual a deny, o Claude Code interrompe a chamada. A divisão, então, é simples: preferências vão para a memória, e tudo o que nunca pode acontecer vai para um hook ou para as configurações de permissão.

Onde uma wiki assume

A memória responde a "como eu gosto de trabalhar". Ela é ruim para "o que dizem estes quarenta artigos, atas de reunião e páginas de fornecedores, e de onde veio cada afirmação". Esse é o trabalho do padrão LLM Wiki de Karpathy, publicado em abril de 2026 como um arquivo de ideias para colar no seu próprio agente.

Ele tem três camadas. Uma pasta raw/ guarda suas fontes, que o modelo lê mas nunca altera, para que continuem sendo a fonte da verdade. Uma pasta wiki/ guarda páginas Markdown que o modelo escreve e mantém: resumos, páginas de pessoas e conceitos, comparações. Um arquivo de esquema, o CLAUDE.md no Claude Code, define a estrutura e os passos para adicionar uma fonte, responder a uma pergunta e arrumar a casa. Dois arquivos a tornam navegável: o index.md lista cada página com um link e um resumo de uma linha, e o log.md é um registro que só recebe acréscimos, com cada ingestão, consulta e verificação.

A arrumação é o que transforma notas em conhecimento confiável. Karpathy chama isso de lint: uma passada periódica que procura contradições entre páginas, afirmações que uma fonte mais nova substituiu, páginas para as quais nada aponta, conceitos que merecem página própria e referências cruzadas que faltam. Uma única fonte nova, observa ele, pode mexer em 10 a 15 páginas.

Duas das nossas análises mostram o padrão na prática. O claude-obsidian (3.8) monta uma wiki do Obsidian com citações a partir da ideia de Karpathy, com gravações planejadas e registradas que o tornam confiável e lento de adotar. O OpenWiki (4.2) aplica o mesmo raciocínio a uma base de código e acompanha quais das suas próprias frases ficaram desatualizadas quando o código muda. Para um mapa pontual de um repositório desconhecido, o Understand Anything (3.5) monta um grafo de conhecimento, com alto custo em tokens na primeira execução.

Captura de tela do site de OpenWiki
OpenWiki, site oficial

Hooks que preenchem a wiki por você

O passo seguinte é parar de fazer a curadoria à mão. O claude-memory-compiler adapta o padrão de Karpathy para que a matéria-prima sejam suas próprias sessões do Claude Code. Um hook SessionEnd captura a transcrição quando uma sessão fecha, um hook PreCompact a captura de novo antes que a compactação automática resuma a parte do meio, e um script em segundo plano pede ao modelo que extraia decisões, lições e armadilhas para um registro diário. Uma etapa de compilação transforma esses registros em artigos de conceitos interligados, e um hook SessionStart coloca o índice na sua próxima sessão. Um script de lint faz sete verificações.

É um ciclo engenhoso, e traz riscos reais nos quais o README não se demora.

  • Hooks executam código de shell. Um hook é um comando que o Claude Code executa com o próprio ambiente, ou seja, com o acesso da sua conta de usuário. Copiar o .claude/settings.json de outra pessoa para o seu projeto, como a instalação pede, significa rodar os scripts dela toda vez que uma sessão começa ou termina. Leia-os antes.
  • Transcrições guardam segredos. Uma transcrição de sessão contém tudo o que passou por ela: chaves coladas, o conteúdo de um arquivo .env que o Claude leu, dados de clientes de um log. O compilador envia esse texto ao modelo e grava os trechos em arquivos Markdown, e na nossa leitura do README e do AGENTS.md não há nenhuma etapa que oculte dados sensíveis.
  • A etapa de compilação grava sem perguntar. O AGENTS.md mostra o compile.py rodando com permission_mode em acceptEdits, o que aprova automaticamente toda operação de arquivo dentro da pasta dele.
  • A afirmação sobre cobrança conflita com a documentação da Anthropic. O README diz que a Anthropic "has clarified that personal use of the Claude Agent SDK is covered under your existing Claude subscription", e o AGENTS.md diz que não é preciso chave de API porque ele usa as credenciais salvas do Claude Code. Não cita nenhuma fonte. A visão geral e o guia de início do Agent SDK da Anthropic mandam configurar uma chave de API e dizem que, salvo aprovação prévia, desenvolvedores terceiros não podem oferecer o login do claude.ai nem seus limites de uso em agentes feitos com o SDK. Trate a afirmação sobre a assinatura como não confirmada e reserve orçamento para a API; a própria tabela do projeto coloca a compilação de um registro diário entre $0.45 e $0.65.

O repositório também é novo e parado: criado em 6 de abril de 2026, dois commits, cerca de 1.300 estrelas e nenhum arquivo de licença, o que significa que você não tem nenhum direito declarado de reutilizar o código.

Não existe tamanho mágico para RAG

Cada fonte aqui cita um limite, e elas não batem. Karpathy diz que ler o índice funciona bem com cerca de 100 fontes e centenas de páginas, e depois sugere uma ferramenta de busca de verdade. As notas do compilador dizem que ler o índice supera a busca vetorial entre 50 e 500 artigos e que a busca híbrida se torna necessária por volta de 2.000 artigos ou 2 milhões de tokens. Nenhuma das duas traz uma medição.

O número útil é o seu. Mantenha uma lista de vinte perguntas cujas respostas você conhece, faça-as a cada poucas semanas e anote quais páginas o modelo abriu e se citou a fonte certa. Quando as respostas começarem a deixar de fora páginas que existem, ou o índice não couber mais com folga em uma sessão, acrescente busca. Uma memória hospedada como o Supermemory (4.0) ou um grafo local como o servidor de referência Memory (3.5) são ferramentas diferentes para esse ponto; o MemoryBase (3.2) resolve outro problema: levar o contexto das conversas entre o ChatGPT e o Claude.

Qual camada faz qual trabalho

CamadaQuem escrevePara que serveConsegue impedir uma ação
CLAUDE.mdVocêInstruções de trabalho e regras da casaNão, é contexto
Auto MemoryClaudePreferências e correções aprendidasNão, é contexto
Hook PreToolUseVocêRegras que precisam valerSim
LLM WikiClaude, a partir das suas fontesConhecimento curado com procedênciaNão
Hooks de captura de transcriçõesScripts, automaticamentePreencher a wiki a partir das suas sessõesNão, e executam código

Uma implantação em etapas

  1. Comece pelo CLAUDE.md. Escreva as instruções que você mais repete, mantenha o arquivo abaixo de 200 linhas e passe as regras específicas de arquivos para .claude/rules/.
  2. Deixe o Auto Memory rodar, e leia-o. Abra /memory a cada uma ou duas semanas e apague o que estiver errado ou desatualizado.
  3. Leve as regras rígidas para hooks. Tudo o que você ficaria chateado de ver descumprido vira um hook PreToolUse ou uma negação de permissão, não uma frase.
  4. Comece uma wiki à mão. Crie raw/, wiki/, index.md e log.md, coloque as regras no CLAUDE.md, faça a ingestão de uma fonte por vez e agende uma passada de lint.
  5. Meça antes de acrescentar busca. Guarde suas perguntas de teste e acrescente recuperação só quando elas começarem a falhar.
  6. Automatize a captura por último, se for o caso. Leia cada script de hook, mantenha a wiki fora de pastas compartilhadas, confira o que vai parar nos registros e use uma chave de API com limite de gastos.

O porém: uma wiki mantida por um modelo só é tão boa quanto suas passadas de lint e a sua leitura delas. O lint pode apontar uma contradição, mas não sabe qual lado está certo, e um resumo confiante de uma fonte mal lida parece exatamente igual a um correto. Manter raw/ sem alterações é o que permite conferir, e isso só ajuda se alguém conferir.

Nossa opinião: trate o CLAUDE.md como o bilhete na geladeira, o Auto Memory como os hábitos que um colega de casa pega, um hook como a fechadura da porta e a wiki como o arquivo com os comprovantes. A maioria precisa dos três primeiros esta semana e do arquivo só quando os comprovantes se acumularem. O robô que arquiva tudo por você pode esperar até você ler o código dele.

A newsletter da ReviewRamble

IA, analisada. Uma vez por semana, na sua caixa de entrada.

Os veredictos que importam em IA, robótica e tecnologia, com o que usar e o que evitar. Sem exagero, sem resumo de tudo.

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail