IA by DNACX

#12 no GitHub · Economia e memória

Como usar o Claude-Mem no Claude Code: passo a passo

Guarda automaticamente o que o Claude Code fez em cada sessão, resume e devolve esse contexto nas sessões seguintes. Assim ele não começa do zero toda vez que você volta ao projeto.

Para quem
Quem trabalha nos mesmos projetos com o Claude Code ao longo de vários dias e quer que ele lembre do que já foi feito.
Estrelas (02/11/2026)
110.700, #12 no ranking
Licença
Apache 2.0
Repositório
thedotmack/claude-mem

Passo a passo

Antes de começar: Claude Code, versão recente com suporte a plugins; Node.js 20.0.0 ou mais novo; Bun e uv, que o README diz serem instalados automaticamente se faltarem.

  1. Confira o Node.js

    O README pede Node.js 20.0.0 ou mais novo. Bun e uv entram sozinhos se não estiverem na máquina.

  2. Adicione o catálogo do plugin

    Digite dentro da sessão do Claude Code. É o caminho que o README descreve como o de dentro do Claude Code.

    Comando
    /plugin marketplace add thedotmack/claude-mem

  3. Instale o plugin

    Envie o segundo comando em seguida.

    Comando
    /plugin install claude-mem

  4. Reinicie o Claude Code

    Feche e abra o Claude Code. A partir daí, o contexto de sessões anteriores aparece sozinho nas sessões novas.

  5. Trabalhe normalmente

    Não há mais nada a fazer. O README diz que a operação é automática: os hooks registram o que acontece em cada sessão e o resumo volta nas próximas. Para consultar o histórico, peça ao Claude em linguagem natural.

Primeiro teste

O README não traz um prompt de teste. Ele diz que, depois de reiniciar, o contexto de sessões anteriores aparece automaticamente em sessões novas.

Cuidados

  • Ele registra o que o Claude Code faz. Hooks em seis momentos (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop e SessionEnd) capturam o uso das ferramentas e geram resumos guardados no seu computador.
  • Roda um serviço local (worker) com API HTTP e página de visualização, gerenciado por Bun, além de um banco SQLite.
  • Dá para impedir que algo seja guardado: o README diz que as tags <private> excluem conteúdo sensível do armazenamento.
  • Existe sincronização opcional na nuvem (Cloud Sync, em cmem.ai). Capturas de tela são opcionais e vêm desligadas por padrão.
  • O outro comando de instalação, npx claude-mem install, pede login pelo navegador (link por e-mail), com 30 dias de teste grátis. Depois do teste, a memória volta a usar o seu plano da Anthropic, a menos que você assine. Não faz parte dos passos acima.
  • Não use npm install -g claude-mem. O README diz que isso instala só a biblioteca, sem registrar os hooks nem o serviço.
  • O README menciona um token de criptomoeda (CMEM), criado por terceiros e apoiado pelo autor. Ele não faz parte da instalação.

Como desfazer

O README não traz um passo de desinstalação para o caminho por plugin.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README abre o Quick Start com instalação para outras ferramentas (Grok Bot, OpenCode, T3 Code e outras). O caminho do Claude Code está mais abaixo, na linha do plugin.
  • A promessa de economia de cerca de 10 vezes em tokens na busca é do autor e não foi medida de forma independente.
  • O README não diz se o caminho pelo /plugin pede login ou qual provedor de IA faz os resumos nesse caso, nem se isso gera custo no seu plano.
  • O README não diz onde o banco de dados fica gravado.
  • O README só lista modos de idioma code, code--zh e code--ja. Não está confirmado o suporte a resumos em português.
  • O README não fala de restrição de sistema operacional, só traz notas para Windows.

Dúvidas

Preciso criar conta?

No comando npx claude-mem install, o instalador pede login por e-mail e dá para pular passando uma opção --provider ou a variável CLAUDE_MEM_ONLINE_OPTIN=false. O README não diz se o caminho pelo /plugin pede conta.

Como busco algo que já foi feito em outra sessão?

Peça ao Claude em linguagem natural. O README diz que a skill mem-search responde a consultas assim, usando as ferramentas search, timeline e get_observations.

Onde ficam as configurações?

No arquivo ~/.claude-mem/settings.json, criado com valores padrão na primeira execução, segundo o README.

A DNACX já usou o Claude-Mem?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próxima da lista

← #11 Agent Skills (Addy Osmani) · #13 Taste →

Ver as 15 skills

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de thedotmack/claude-mem, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.