O Claude Code esquece o que foi alterado na sessão anterior sempre que você o fecha e abre de novo. Por isso, muita gente instala o claude-mem, que tem 100 mil estrelas no GitHub. Ele pode ser instalado, mas não saia apertando Enter em todas as etapas. Em outubro de 2026, o instalador da versão v15 selecionava por padrão o observador hospedado CMEM Pro, que cobra US$ 30 por mês após um teste de 30 dias. Para evitar a mensalidade, instale com --provider claude ou, depois da instalação, configure o observador para usar sua própria chave.
Este não é um texto promocional do tipo “instale e ele vai lembrar de tudo para sempre”. A seguir, separamos as informações em “dados oficiais / caso isolado de terceiros / meus testes / desconhecido”. Todos os dados foram verificados em 30/10/2026.
Pontos principais do claude-mem
Comece pela tabela para decidir se vale a pena continuar lendo.
| Ponto | Descrição | Impacto para você |
|---|---|---|
| Popularidade | GitHub thedotmack/claude-mem, 105.017 estrelas, Apache-2.0 (dados da API do GitHub em 30/10/2026) |
O número de estrelas indica popularidade; se a ferramenta é boa, você precisa avaliar por conta própria |
| Versão | A versão mais recente no npm e nos releases do GitHub é a 15.6.0 (29/10/2026); o badge do README mostra 15.7.0 | Use a versão do npm como referência e não se deixe enganar pelo badge |
| Pago por padrão | O instalador seleciona o CMEM Pro por padrão, com teste de 30 dias e cobrança de US$ 30/mês depois | Se não quiser assinar, escolha outra opção |
| Opção sem mensalidade | Use --provider claude com seu próprio plano Claude ou configure sua própria chave após a instalação |
O consumo sai da cota do plano ou do saldo da API |
| Não é totalmente local | O modelo observer lê o conteúdo das suas chamadas de ferramentas | Pense bem antes de usá-lo com repositórios sensíveis |
📷 Espaço para captura de tela, adicionar na edição: página inicial do repositório GitHub (
thedotmack/claude-mem, mostrando o número de estrelas e o release mais recente)
O que o claude-mem realmente lembra
Em resumo: o claude-mem é uma camada de memória executada na sua máquina. Não é um novo modelo de chat nem um bloco de notas na nuvem. Ele captura o que aconteceu durante a sessão, comprime essas informações e as armazena para enviá-las de volta ao Claude na próxima sessão.
O fluxo tem 5 etapas:
- hooks (gatilhos de ciclo de vida): o Claude Code dispara eventos no início da sessão, no envio de um comando, antes e depois de chamadas de ferramentas, na interrupção e no encerramento. O claude-mem usa hooks nesses pontos.
- worker: um serviço HTTP executado localmente com Bun, responsável por receber os eventos dos hooks. A porta padrão é
37700 + (uid % 100), então nem sempre será 37700. - observer (modelo observador): o worker envia as chamadas de ferramentas originais a um modelo, que as comprime em observations estruturadas.
- observation (registro de observação): cada registro contém tipo, título, descrição e arquivos envolvidos. Os dados são gravados em
~/.claude-mem/claude-mem.db(SQLite), e o índice vetorial fica em~/.claude-mem/chroma/(Chroma é um banco de dados vetorial usado para busca semântica). - Injeção no próximo SessionStart: ao iniciar uma nova sessão, as observations recentes e relevantes do projeto atual são injetadas automaticamente, com limite padrão de 50 registros. O Claude também pode recuperar memórias mais antigas conforme necessário, usando três camadas de ferramentas MCP:
search→timeline→get_observations.
Vale lembrar: ele só registra o que os hooks capturam. Ideias que você teve fora da sessão e discussões que não passaram por chamadas de ferramentas não entram automaticamente no banco. Além disso, a memória nativa do Claude Code (MEMORY.md) e o claude-mem são sistemas separados que, por padrão, funcionam em paralelo.
3 requisitos para instalar o claude-mem
Se você não atender a qualquer um destes requisitos, espere antes de instalar:
- Claude Code ≥ 2.1.139: em versões anteriores, os
argsdos hooks são ignorados, e o resultado é que nada é registrado, sem aviso — um problema difícil de diagnosticar. Primeiro, executeclaude --version. Se a versão for antiga, executeclaude update. - Node 20+: o pacote npm declara
^20.19.0 || >=22.12.0; confirme comnode -v. O instalador cuida automaticamente do Bun (≥1.1.31) e do uv. Em um teste independente no Ubuntu 26.04, Bun, uv e Chroma ocuparam juntos cerca de 1,2 GB de disco. - Aceitar que o observer veja o conteúdo das chamadas de ferramentas: qualquer que seja a rota escolhida, suas chamadas de ferramentas, comandos e materiais usados nos resumos serão enviados ao provedor de observer selecionado. Se o repositório contiver chaves, dados de clientes ou código ainda não divulgado, não ative o recurso antes de avaliar o risco.
No Windows, os hooks não precisam do Git Bash, mas é necessário reiniciar o terminal ou a IDE após a instalação para que o novo PATH entre em vigor.
Como escolher entre as 3 rotas de instalação do claude-mem
| Rota | Precisa de conta cmem? | De onde vem o pagamento | Para quem o conteúdo é enviado | Para quem é indicada |
|---|---|---|---|---|
| A: CMEM Pro padrão | Sim, e o período de teste exige cartão | A partir de US$ 30/mês, com teste de 30 dias | Observer hospedado pelo cmem.ai | Quem não quer configurar uma chave ou precisa de sincronização na nuvem e uso em várias máquinas |
B: --provider claude |
Não | Consome a cota do plano Claude | Anthropic | Quem já tem uma assinatura Claude |
| C: instalar pela rota B e trocar para uma chave própria | Não | Cobrança pelo uso do provedor | O endpoint que você configurar, como APIYI apiyi.com | Quem quer controlar custos ou já tem saldo de API |
O marketplace de plugins é outra opção de instalação, apresentada separadamente abaixo como rota C’. Para seguir a terceira rota, é preciso começar pela B: openai-compatible não é uma opção de --provider no instalador e só pode ser configurado manualmente após a instalação.
Opção A: CMEM Pro padrão (opção padrão do instalador do claude-mem)
- Execute
npx claude-mem install. - O que você verá: na primeira etapa, o instalador pré-seleciona o agente detectado e instala o runtime. Na segunda, exibe um código de dispositivo
XXXX-XXXXe abre o navegador para a autorização via OAuth. Não pule a etapa de login. Na terceira, o provedor de memória CMEM Pro vem selecionado por padrão; ao confirmá-lo, o instalador abre a página de pagamento ou de teste. - Termos que merecem atenção (página oficial de preços, verificada em 30/10/2026):
- O período de teste exige cartão de crédito ou débito; cartões pré-pagos não são aceitos.
- A cobrança começa quando o período de teste termina ou quando a cota incluída se esgota, o que acontecer primeiro.
- A configuração de upgrade automático pode elevar a assinatura do Pro para o Heavy (US$ 70/mês) ou Max (US$ 100/mês). Muitos tutoriais dizem apenas “no card required” e deixam essa etapa de fora.
- Como saber se deu certo: ao fim da instalação, serão exibidos Version, Plugin dir, IDEs, Account, Cloud sync e Worker URL. Depois, execute as 5 verificações abaixo.
Opção B: --provider claude, instale o claude-mem sem mensalidade
- Execute
npx claude-mem install --provider claude. - Se quiser manter apenas um sistema de memória, use
npx claude-mem install --provider claude --disable-auto-memory. Esse parâmetro defineCLAUDE_CODE_DISABLE_AUTO_MEMORY=1, desativando o auto-memory nativo do Claude Code. - O que você verá:
Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan.,Cloud sync: OFF (local)eAuto-memory: left enabled(quando o parâmetro de desativação não é usado). O instalador também pedirá que você escolha um modelo observer: escolha o Haiku, não o Opus. - Como saber se deu certo: nenhuma página de login do cmem ou de pagamento apareceu durante a instalação, e todas as verificações de
npx claude-mem doctorforam aprovadas.
No código-fonte, apenas os provedores claude e host dispensam login. Em um teste independente, --provider openrouter ficou parado em Waiting for OAuth login in the browser…. Portanto, se quiser usar uma chave de terceiros, a ordem correta é concluir a instalação pela opção B e depois alterar a configuração.
Caminho C’: marketplace de plugins do Claude Code
- No Claude Code, digite
/plugin marketplace add thedotmack/claude-mem. - Depois, digite
/plugin install claude-meme reinicie o Claude Code. - O que você vai ver: na primeira sessão, o launcher ainda estará compilando, então talvez não haja nenhuma memória disponível. Para evitar essa lacuna, execute também
npx claude-mem install --provider claude. - Nunca use
npm install -g claude-mem: esse comando instala apenas a biblioteca SDK, não registra os hooks nem inicia o worker e ainda pode ocultar o launcher correto.
Como verificar a instalação do claude-mem: 5 itens
Primeiro, lembre-se: a primeira sessão é a de coleta. Ainda não há histórico para injetar; as memórias só aparecem na segunda sessão. Se você esperar que ele “se lembre de mim” logo na primeira, pode achar, por engano, que a instalação falhou.
| # | Item | Comando / operação | Critério de aprovação |
|---|---|---|---|
| 1 | doctor | npx claude-mem doctor |
Bun, uv, Plugin, Hook launcher, Worker, Claude Code version (2.1.139+) e Chroma, todos com ✓ |
| 2 | status | npx claude-mem status |
O worker está funcionando e o número da porta é exibido |
| 3 | viewer | Abra http://127.0.0.1:<PORT>/ no navegador; as memórias ficam em /viewer |
A página abre e, depois de uma sessão, exibe registros |
| 4 | sqlite count | sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;" |
O valor retornado é maior que 0 após o fim da primeira sessão |
| 5 | context inject | curl "http://127.0.0.1:<PORT>/api/context/inject?project=<nome-do-projeto>" |
O conteúdo retornado corresponde às memórias que serão injetadas na próxima sessão |
A porta pode ser consultada em CLAUDE_MEM_WORKER_PORT, no arquivo ~/.claude-mem/settings.json. Você também pode confirmá-la com curl http://127.0.0.1:<PORT>/api/health. Na saída do doctor, a linha que mais costuma apresentar problemas é a de Hook launcher. Se aparecer not on PATH ou is not the claude-mem hook launcher, resolva isso antes de verificar os outros itens.
📷 Espaço para captura de tela, adicionar na edição: página do worker viewer (
/viewer, exibindo a lista de observações)
Custo do claude-mem: os «96% de economia» oficiais e os «+4.226 tokens» de terceiros
Os dois números estão corretos, mas medem coisas diferentes. Não dá para usá-los como se fossem equivalentes.
- Estimativa oficial: 4 observações ocupam cerca de 1.093 tokens, contra 26.447 tokens do conteúdo original — daí a «economia de cerca de 96%». A busca MCP em três camadas «economiza cerca de 10 vezes em relação à injeção de todo o conteúdo». São estimativas dos responsáveis pelo projeto, não uma auditoria independente.
- Teste isolado de terceiros (ComputingForGeeks, 24/10/2026, claude-mem 15.0.2, Sonnet via OpenRouter): para a mesma frase, «Reply with the single word ready», a entrada consumiu 28.489 tokens com o claude-mem desativado. Com ele ativado, mesmo com a memória vazia, a entrada chegou a 32.715 tokens: 4.226 tokens a mais (cerca de +14,8%), com custo adicional de US$ 0,010. É apenas um teste em uma máquina, uma execução e um projeto; não representa necessariamente a sua conta.
A conclusão, logo de cara: a «economia» significa que a memória é mais compacta que os registros originais; o «aumento» é a sobrecarga fixa adicionada a cada sessão. Quanto mais movimentado o projeto e mais itens forem injetados, maior será a sobrecarga. Nas Issues #618 e #2469, do primeiro semestre de 2026, usuários relataram que os tokens se esgotavam rapidamente. Esses relatos são de versões antigas e não equivalem à situação da 15.6.0, mas mostram que a memória nunca foi gratuita.
5 ajustes de controle de custos do claude-mem
CLAUDE_MEM_CONTEXT_OBSERVATIONS: o padrão é 50; reduzir para 10–20 diminui diretamente a quantidade de informações injetadas.CLAUDE_MEM_SEMANTIC_INJECT: mantenha o padrãofalse. Se ativado, acrescenta memórias relevantes a cada comando.CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: mantenha o padrãofalse; caso contrário, as memórias de todos os hosts serão injetadas.CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: desativa as observações por chamada de ferramenta e mantém apenas os resumos de sessão. Isso economiza tokens e reduz a sobrecarga de processos.CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: o padrão é 1. Aumente gradualmente se houver acúmulo de eventos; não comece definindo 32.
Comparação de custos das três opções
| Opção | Forma de cobrança | Preço (dólares) | Ideal para |
|---|---|---|---|
| CMEM Pro | Assinatura | US$ 30/mês, teste de 30 dias (Heavy US$ 70, Max US$ 100) | Usuários intensivos que precisam de sincronização na nuvem |
| Plano Claude | Consumo da cota da assinatura | Sem cobrança separada, mas compartilha a cota com a escrita de código | Quem já tem uma assinatura Claude |
APIYI claude-haiku-5-5 |
Por uso | Entrada US$ 0,1 / saída US$ 0,5 / leitura de cache US$ 0,01 por milhão de tokens (por chamada ≤100.000 tokens; acima de 100.000 tokens, entrada a US$ 0,5/1M, com cobrança por faixas) | Usuários de baixa ou média frequência |
Os preços foram extraídos da tabela geral da APIYI em apiyi.com (página atualizada em 2026-10-27 às 14:50 UTC+8). Consulte a lista de modelos da plataforma para confirmar os modelos e preços; o valor efetivamente cobrado é o exibido no console. Para referência, na mesma plataforma, o claude-haiku-4-5-20251001 custa US$ 1 para entrada / US$ 5 para saída / US$ 0,1 para leitura de cache; o claude-sonnet-5-5, US$ 2 / US$ 10 / US$ 0,1; e o claude-opus-5-5, US$ 4 / US$ 20 / US$ 0,2. O observer executa tarefas pequenas, estruturadas e frequentes, para as quais um modelo da linha Haiku é suficiente. A cobrança por uso é adequada para quem usa com baixa ou média frequência. Se você usa intensivamente, calcule o custo com base em uma semana de uso real e compare com os US$ 30/mês.
Troque o observer do claude-mem pela APIYI
Este é o passo a passo completo da rota C, ideal para desenvolvedores na China que já têm saldo de API e não querem contratar uma assinatura separada para memória. A APIYI aceita recargas em yuan e usa uma taxa de câmbio fixa de 1:7, conforme a página oficial de preços.
- Primeiro, instale seguindo a rota B:
npx claude-mem install --provider claude. - Abra
~/.claude-mem/settings.jsone adicione estas quatro chaves: "CLAUDE_MEM_PROVIDER": "openai-compatible""CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1""CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5""CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-sua-chave-APIYI"- Se não quiser deixar a chave em texto puro nas configurações, coloque-a em
~/.claude-mem/.env:OPENAI_COMPAT_API_KEY=sk-sua-chave-APIYI(permissões 0700 para o diretório e 0600 para o arquivo). - Execute
npx claude-mem restart. As credenciais só são lidas quando o worker inicia, então é preciso reiniciá-lo para que a alteração entre em vigor. - Como saber se funcionou:
npx claude-mem doctormostra o provider como openai-compatible. A próxima observation gerada em uma nova sessão aparece no viewer.
Há duas armadilhas que vale evitar. Primeiro, a base URL precisa incluir /v1, sem barra no final. Caso contrário, a URL montada terá uma barra dupla e causará um erro 404. Para entender a diferença entre os três tipos de base URL, consulte: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. Segundo, se faltar qualquer uma das quatro chaves, o claude-mem voltará silenciosamente para a rota Claude. Tudo parecerá normal, mas o consumo será cobrado do seu plano.
Teste das APIs (usei uma chave da APIYI em 2026-10-30):
GET /v1/modelsretornou 200 e um total de 259 modelos, incluindoclaude-haiku-5-5.POST /v1/chat/completions, usandoclaude-haiku-5-5eresponse_format: {type: "json_object"}, retornou 200 em cerca de 2,0 segundos, com JSON válido e consumo de 59 tokens.- Ao incluir o campo
reasoning: {enabled: false}, que o claude-mem envia, a resposta também foi 200, sem erro 400. - O endpoint nativo da Anthropic,
/v1/messages, também retornou 200.
Limites da conclusão: os testes acima verificaram apenas que o endpoint da APIYI aceita o formato de requisição exigido pelo claude-mem. Não executei o fluxo completo de observation do claude-mem na minha máquina; o fato de a API ter passado no teste não significa que todo o fluxo do plugin tenha sido validado.
🚀 Dica para começar: crie uma chave separada no console da APIYI em apiyi.com, exclusivamente para o claude-mem. Assim, depois de uma semana, você poderá consultar o consumo dessa chave e avaliar se o pagamento por uso compensa mais do que uma assinatura. Se também quiser conectar o próprio Claude Code, consulte: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.
Privacidade no claude-mem: o que fica local e o que é enviado
Armazenamento local (tudo em ~/.claude-mem/; é possível mudar o local com CLAUDE_MEM_DATA_DIR): claude-mem.db (sessões, observações, resumos e comandos), índice vetorial chroma/, logs/, settings.json e o diretório de capturas de tela media-v1/, desativado por padrão.
Conteúdo que sai do computador:
- Chamadas do observer: o conteúdo das chamadas de ferramentas, os comandos e o material usado nos resumos são enviados ao provedor escolhido. Se você escolher Anthropic, os dados vão para a Anthropic; se escolher CMEM, vão para cmem.ai; se escolher APIYI, vão para APIYI.
- Telemetria ativada por padrão: os dados são enviados ao PostHog com um UUID de instalação aleatório, e as informações de erro passam por mascaramento. Para desativar, execute
npx claude-mem telemetry disableou definaDO_NOT_TRACK=1. O instalador também pergunta sobre isso ao final. - A sincronização na nuvem exige ativação manual: ela fica desativada por padrão. Quando ativada, envia observações, resumos de sessões e o texto completo dos comandos para cmem.ai.
Controles disponíveis:
- O conteúdo envolvido em
<private>...</private>é removido na camada de hooks e não entra no banco de dados. - O mascaramento automático fica desativado por padrão. É preciso definir
CLAUDE_MEM_REDACT_ENABLED=truepara ativar os 16 padrões integrados de chaves e credenciais (AWS, GitHub PAT, chaves da OpenAI/Anthropic, JWT, PEM etc.). AcrescenteCLAUDE_MEM_REDACT_GENERIC_ENABLED=truepara habilitar mais 3 padrões genéricos. Não presuma que o mascaramento acontece automaticamente.
Tabela de solução de problemas comuns do claude-mem
| Sintoma | Causa | Solução |
|---|---|---|
Todos os hooks exibem Executable not found in $PATH: "claude-mem" |
O launcher não está no PATH | Execute npx claude-mem install para reinstalar e reinicie o terminal, a IDE e o Claude Code |
A sessão exibe memory hooks are not active |
O launcher não está funcionando | Faça o mesmo acima e use npx claude-mem doctor para verificar a linha Hook launcher |
| Nada é registrado e nenhum erro aparece | Versão do Claude Code anterior à 2.1.139 | Execute claude update |
O comando claude-mem está sendo encoberto por outro programa |
O comando npm install -g claude-mem foi executado anteriormente |
Use which -a claude-mem para localizar o comando e depois execute npm uninstall -g claude-mem |
| O viewer não abre | A porta não é 37700 ou o worker não foi iniciado | Confira a porta em settings e execute curl http://127.0.0.1:<PORT>/health |
| A porta está ocupada | Conflito com outro processo | Defina export CLAUDE_MEM_WORKER_PORT=38000 e reinicie o worker |
| O endpoint personalizado retorna 404 | A URL base está incorreta | Para endpoints compatíveis com OpenAI, use /v1; para a API nativa da Anthropic, use o domínio raiz. Confirme que o ID do modelo aparece em /v1/models |
| Uma chave de terceiros foi configurada, mas o Claude continua sendo usado | As quatro chaves de configuração não foram preenchidas, causando um fallback silencioso | Complete settings e execute npx claude-mem restart |
| A observation está vazia ou truncada | O modelo menor não segue a estrutura JSON ou atingiu o limite de saída | Aumente CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS (padrão: 4096) ou troque por um modelo mais estável |
| Timeouts frequentes | A solicitação em streaming é interrompida após 90 segundos sem receber tokens | Aumente CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS ou use um modelo menor |
| O hook encerra o worker repetidamente | As versões do plugin e do worker são incompatíveis (#3857, #3940, já corrigidos) | Execute npx claude-mem update e, se necessário, npx claude-mem@latest install |
| Dois sistemas de memória entram em conflito | O auto-memory nativo e o claude-mem estão ativos ao mesmo tempo | Adicione --disable-auto-memory ao reinstalar |
Riscos do claude-mem: bloqueios de conta são de sua responsabilidade
Leia esta seção antes de instalar.
- Projeto da comunidade, sem endosso: o claude-mem é um projeto de código aberto da comunidade, não um produto oficial da APIYI. A APIYI não o endossa nem oferece SLA para ele.
- Envio de conteúdo a terceiros: o conteúdo das chamadas de ferramentas será enviado ao observer escolhido. Não ative o recurso em repositórios que contenham chaves, dados de clientes ou código não publicado.
- Consumo de cota: ele pode consumir muitos tokens ou uma parte significativa da cota do seu plano. Teste primeiro em um projeto pequeno por uma semana e confira a cobrança antes de decidir.
- Controles de segurança e limites de taxa: hooks acionados com frequência, contas compartilhadas e chaves de serviços proxy de API podem ativar controles de segurança ou limites de taxa da plataforma. Recomendamos testar com uma chave API separada, uma conta secundária e um único projeto. As consequências são de responsabilidade do leitor. Em relação à APIYI, este artigo confirma apenas que a interface passou nos testes práticos; não há garantia de que não haverá limites de taxa.
- A desinstalação deixa arquivos: depois de executar
npx claude-mem uninstall, o diretório~/.claude-mempermanece no sistema, com o banco de dados e possíveis chaves salvas. Para removê-lo, execute manualmenterm -rf ~/.claude-mem. Além disso, em testes de terceiros,~/.bune~/.cache/uvocuparam cerca de 1,1 GB. Se nenhum outro projeto os estiver usando, você também pode excluí-los.
Perguntas frequentes sobre claude-mem
P1: As 100 mil estrelas garantem que o claude-mem é bom?
Não. O número de estrelas indica apenas popularidade. Você precisa avaliar por conta própria o consumo de tokens, os limites de privacidade e o ritmo das versões. Também não há auditoria independente que confirme a autenticidade do crescimento das estrelas.
P2: O claude-mem é a mesma coisa que a memória nativa do Claude Code?
Não. A memória nativa usa o arquivo MEMORY.md, enquanto o claude-mem usa hooks e um banco de dados independentes. Por padrão, os dois funcionam em paralelo. Se quiser manter apenas o claude-mem, adicione `–disable-auto-memory` na instalação.
P3: A memória já funciona na primeira sessão após a instalação?
Não. A primeira sessão coleta e comprime as informações; a memória só é injetada na segunda. Para confirmar, use os itens 4 (`sqlite count`) e 5 (`context inject`) da verificação.
P4: Posso usar o claude-mem sem cadastrar cartão ou fazer assinatura?
Sim. Instale com `–provider claude` para usar a cota do seu plano Claude. Outra opção é, após a instalação, configurar o observer com uma chave de pagamento por uso da APIYI apiyi.com. A cobrança é feita pelos tokens consumidos, e novos usuários recebem créditos gratuitos para testar.
P5: Qual modelo é adequado para o observer?
Use um modelo da categoria Haiku, como `claude-haiku-5-5`. As observações são tarefas pequenas, frequentes e estruturadas. Um modelo de ponta como o Opus sai mais caro e pode gastar boa parte do orçamento de saída com raciocínio.
P6: Posso usar apenas modelos locais?
Sim. Basta apontar `openai-compatible` para Ollama, LM Studio ou vLLM. Mas o modelo menor precisa gerar a estrutura JSON das observações de forma consistente; caso contrário, produzirá registros vazios.
P7: Como ativar observações em chinês?
Nas configurações, defina `”CLAUDE_MEM_MODE”: “code–zh”` (é um modo integrado, sem necessidade de instalação adicional) e reinicie o Claude Code.
Pontos principais do claude-mem
- Como funciona: hooks capturam chamadas de ferramentas, enviam o conteúdo a um observer para compactação e o armazenam em SQLite. Na sessão seguinte, as memórias são inseridas no contexto.
- Armadilha padrão: o instalador v15 seleciona o CMEM Pro por padrão. O teste exige cartão e, depois, custa US$ 30/mês.
- Sem mensalidade: instale com
--provider claudee, se necessário, altere as configurações para usar sua própria chave. - Custo: o projeto informa uma economia de 96%; um teste independente registrou “+4.226 tokens”. Os números usam critérios diferentes.
- Privacidade: o observer envia conteúdo para fora da máquina; a telemetria vem ativada por padrão; a anonimização e a sincronização na nuvem precisam ser ativadas manualmente.
- Como começar: crie uma chave separada na APIYI apiyi.com, use
claude-haiku-5-5com cobrança por uso durante uma semana e depois avalie o custo.
Resumo: para quem vale a pena instalar o claude-mem
Três perfis para quem vale a pena instalar:
- Quem mantém o mesmo projeto por muito tempo e fecha e reabre sessões do Claude Code com frequência.
- Quem precisa responder com frequência a perguntas como “por que fizemos essa mudança?” ou “como aquele bug foi corrigido?”.
- Quem aceita gastar 10 minutos na configuração inicial e permitir que o observer leia o conteúdo das chamadas de ferramentas.
Três perfis para quem não vale a pena instalar:
- Quem só executa scripts pontuais e não trabalha em projetos contínuos. Usar CLAUDE.md e anotações próprias sai mais barato.
- Quem trabalha com código ou dados que não podem sair da máquina local ou de uma região específica por requisitos de conformidade.
- Quem usa uma máquina com pouco espaço em disco ou capacidade de CPU, ou espera que o Claude Code “fique mais inteligente imediatamente” após a instalação.
Se decidir instalar, siga esta ordem para evitar problemas: “rota B → 5 verificações de aceitação → reduzir o número de memórias inseridas → trocar o observer, se necessário”. Para testar o custo do observer com cobrança por uso, você pode usar os créditos gratuitos da APIYI apiyi.com em um projeto pequeno.
📚 Referências
- Repositório do claude-mem no GitHub: código-fonte, releases e issues
- Link:
github.com/thedotmack/claude-mem -
Detalhes: estrelas, versões e registros das issues #618, #2469, #3857 e #3940
-
Documentação oficial do claude-mem: instalação, configuração e solução de problemas
- Link:
docs.claude-mem.ai/installation -
Detalhes: requisitos do sistema, valores padrão das configurações e configuração do provedor compatível com OpenAI
-
Página de preços do CMEM: condições dos planos CMEM Pro / Heavy / Max
- Link:
cmem.ai/pricing -
Detalhes: teste de 30 dias, exigência de cadastro de cartão e início da cobrança (verificado em 30/10/2026)
-
Teste independente do ComputingForGeeks: instalação da versão 15.0.2 e consumo de tokens
- Link:
computingforgeeks.com/claude-mem-claude-code -
Detalhes: fonte do dado de +4.226 tokens em um único caso (24/10/2026)
-
Documentação de modelos da APIYI: lista de modelos e preços
- Link:
docs.apiyi.com/models - Detalhes: consulte a lista de modelos da plataforma para conhecer os modelos e preços atuais
Autor: Equipe técnica da APIYI
Dúvidas técnicas: se encontrar problemas com endpoints ou modelos durante a configuração, entre em contato conosco pela página inicial do site oficial da APIYI. Para mais informações sobre integração, acesse a documentação em docs.apiyi.com
