O Claude Code esquece tudo? claude-mem, CLAUDE.md e cada cliente

Quem já tentou tocar dois ou três projetos de clientes ao mesmo tempo no chat puro sabe onde a paciência acaba. Você passa uma hora explicando o nicho da empresa, as cores da marca, o preço combinado na reunião e o que o empresário pediu. No dia seguinte, quando abre outra conversa para ajustar o site ou montar a proposta, a inteligência artificial age como se nunca tivesse visto aquele negócio.

Um aluno da comunidade começou um projeto apressado e esqueceu de abrir a pasta do MazyOS. Poucas horas depois, mandou mensagem no grupo dizendo que sentiu na pele como o Claude puro fica perdido sem a memória da pasta. É essa dor que leva tanta gente a buscar por claude-mem, claude code memory e arquivo claude.md. Abaixo eu mostro o que cada peça faz e como organizar a memória de cada cliente no seu computador.

O que é o claude-mem (e como instalar)

Quem pesquisa por claude-mem ou claude mem está procurando um plugin de código aberto criado por um desenvolvedor independente da comunidade (fora da Anthropic). Ele observa as ferramentas e edições que o Claude Code rodou na sessão, guarda esse registro num banco local e devolve um resumo quando você abre a conversa seguinte.

Para testar esse plugin no terminal, a instalação usa o instalador de pacotes que mostro em como instalar skills no Claude Code:

Agora vem a pergunta prática: você precisa instalar o claude-mem para vender sites para empresas? Não. Ele foi feito para programadores que passam semanas depurando o mesmo sistema e querem lembrar qual linha técnica mexeram ontem. Para quem atende clientes, o que vale dinheiro é a memória comercial do negócio.

Ele lembra do código. E do seu cliente?

Lembrar que um botão mudou de cor no código é bem diferente de lembrar quem é o dono da empresa, qual pacote ele comprou, qual é o diferencial dele na cidade e o que ficou combinado na chamada de vídeo.

Nos comentários do YouTube, muita gente pergunta como os sites e sistemas que eu entrego não ficam com cara de robô. Eu respondi direto ao ponto explicando que a inteligência artificial só acerta a mão quando lê o contexto certo organizado na pasta:

Faça o teste com uma pergunta simples: qual foi o preço e o prazo que combinei com a clínica odontológica na reunião de ontem? No Claude Code cru, mesmo com plugins técnicos, ele responde que não sabe. Já quando você trabalha na pasta do MazyOS (_contexto/ com os dados da sua agência e clientes/nome-do-cliente/ com a ficha da empresa), o Claude lê a transcrição da reunião na hora e devolve o valor, o parcelamento e o escopo combinado.

Por que o Claude Code esquece tudo quando a conversa fecha?

Perceber que o claude code esquece tudo de uma janela para outra não é defeito; é como qualquer agente de código funciona, por quatro motivos:

• A janela de contexto tem limite. Nos planos pagos, a leitura de uma sessão vai até 1 milhão de tokens nos modelos atuais (pra ter ideia, 200 mil tokens dão cerca de 500 páginas de texto). Quando enche, aparece o aviso Prompt is too long.
• Fechar a sessão limpa a memória temporária. Ao contrário do chat web (claude.ai), o Claude Code abre cada sessão do zero para não misturar projetos.
• Os comandos `/clear` e `/compact` enxugam a conversa. Você usa /compact para resumir o papo ou /clear para esvaziar a tela ao trocar de tarefa.
• Conversa longa gasta a franquia mais rápido. A cada mensagem nova numa sessão enorme, o Claude relê todo o histórico e consome mais da sua janela de 5 horas (veja a conta em quantos tokens tem o Claude Pro).

Resumo prático: conversa de chat é rascunho. O que você não quer repetir amanhã precisa morar em arquivos .md na pasta.

O que é o CLAUDE.md (e o comando /memory)

Se você já viu o que é o Claude Code e procurou por claude.md o que é, arquivo claude.md ou claude code /memory, esse é o recurso nativo principal da ferramenta. O CLAUDE.md é um arquivo Markdown na raiz do projeto que o Claude Code lê inteiro no primeiro segundo de toda conversa.

Você cria esse arquivo rodando /init e pode abri-lo para edição a qualquer momento digitando /memory (no terminal ou no Claude Code no VS Code). Veja todos os atalhos que trabalham com ele na lista de comandos do Claude Code.

Para aplicar as melhores práticas de claude.md best practices, siga estas cinco regras:

• Deixe o `CLAUDE.md` enxuto: como ele entra inteiro em toda sessão, guarde só o mapa das pastas e regras gerais.
• Separe regra geral de tarefa: o método de criar site ou orçamento vai nas Claude Skills (ou no Skill Creator), e ferramentas externas entram via MCP.
• Nunca salve senhas no arquivo: o CLAUDE.md é texto aberto de instrução.
• Aponte para as pastas dos clientes: indique que cada contratante fica em clientes/nome-da-empresa/.
• Use o arquivo global (`~/.claude/CLAUDE.md`) só para preferências pessoais: como responder sempre em português.

Como fazer o Claude lembrar do seu cliente todos os dias

No MazyOS, essa memória já vem pronta para como fazer o claude lembrar do cliente sem configurar nada na mão:

1. 1Rode `/instalar` no primeiro dia: o comando entrevista você em português sobre seus serviços e preços e salva tudo em _contexto/.
2. 2Crie cada cliente com `/novo-projeto`: o atalho monta a pasta exclusiva da empresa dentro de clientes/.
3. 3Salve a transcrição da reunião na pasta: grave a chamada com o empresário e jogue o texto lá dentro (veja como transcrever) para o Claude montar o site e a proposta comercial.
4. 4Feche o dia com `/atualizar`, `/clear` e `/salvar`: o /atualizar registra tudo o que mudou na ficha do cliente, o /clear limpa a conversa e o /salvar guarda o backup.

Se um dia o Claude perguntar do zero o que o seu cliente vende, você abriu o editor fora da pasta raiz (veja como confirmar se está no MazyOS). O aluno Nicolas resumiu bem esse ganho: alimentando a memória viva da pasta, ele baixou a entrega de um site de quinze dias para dois dias, mesmo trabalhando CLT.

Essa memória funciona no Codex e no Antigravity?

Sim, funciona sem mudar uma vírgula. Como a memória mora em arquivos .md abertos dentro da pasta do seu computador e o MazyOS roda no Claude Code, no Codex e no Antigravity, você nunca fica preso a uma única empresa de inteligência artificial. Todo o histórico comercial que você construiu para os seus clientes pertence a você e fica salvo na sua máquina.

Na prática, o comando /instalar prepara o arquivo CLAUDE.md para o Claude Code, o arquivo AGENTS.md para usar com skills no Codex e a estrutura lida por skills no Antigravity. Se num dia de entrega o servidor do Claude oscilar ou a sua cota de cinco horas encher, basta abrir a mesma pasta na ferramenta vizinha e continuar exatamente da linha em que parou (veja o que fazer se o Claude cair).

Perguntas rápidas sobre a memória do Claude Code

O claude-mem é oficial da Anthropic? Não. O claude-mem é um plugin independente de código aberto criado pela comunidade no GitHub. Os recursos oficiais e nativos da Anthropic para memória no Claude Code são o arquivo CLAUDE.md, o comando /memory e o comando /init.

O Claude Code é gratuito? Não. Na conta gratuita do Claude, o Claude Code não vem, e vem incluso a partir do plano Pro, que custa R$ 110 por mês no site oficial. Veja tudo o que é liberado sem custo no guia sobre o Claude gratuito.

Preciso instalar o claude-mem se já tenho o MazyOS? Não precisa. A estrutura de pastas do MazyOS (_contexto/ e clientes/) somada ao comando /atualizar já registra toda a memória comercial e técnica das suas entregas.

Onde fica salvo o arquivo CLAUDE.md? O arquivo principal de cada projeto fica na raiz da pasta aberta no editor (./CLAUDE.md ou ./.claude/CLAUDE.md), e as preferências pessoais para todos os projetos ficam em ~/.claude/CLAUDE.md.