Claude Code auto memory ou Obsidian: contexto verificável

Para preferências pessoais, comece pela auto memory do Claude Code. Para decisões que a equipe precisa discutir e levar entre ferramentas, use notas Markdown separadas, com responsável e fonte. Obsidian pode editar esse acervo; instalá-lo não conecta as notas ao agente por si só.

Não é preciso escolher um único método para tudo. Separe o contexto conforme quem responde pela correção do registro. Uma preferência pessoal pode ficar na memória; uma decisão de migração da equipe deve ficar numa nota comum com vínculo à decisão. Confirme no repositório os caminhos e comandos que já aparecem no código atual, em vez de manter cópias extras dos fatos.

O que fica guardado

A documentação do Claude Code descreve a auto memory como arquivos Markdown locais do projeto. Eles podem ser abertos, editados e removidos por /memory. Worktrees do mesmo repositório Git compartilham memória, mas ela não é transferida automaticamente entre máquinas. Use /context para verificar os memory files carregados. Uma nota no disco não prova que seu conteúdo entrou na sessão atual.

Um vault do Obsidian é uma pasta de notas e configurações. Os arquivos Markdown continuam acessíveis fora do aplicativo. Para o agente usá-los, indique os arquivos a ler e conceda acesso. Essa abordagem não exige plugin do Obsidian nem servidor MCP.

Pergunta	Auto memory	Vault Markdown separado
Quem propõe o registro?	Claude durante o trabalho; pessoa revisa	Autor da nota ou agente com tarefa explícita
Quem corrige um fato contestado?	Usuário do projeto	Responsável designado pela decisão
Como mostrar mudança ao colega?	Compartilhe a entrada escolhida	Compartilhe o arquivo ou Git diff acordado
Como levar a outra máquina?	Organize a transferência	Organize acesso ou sincronização da pasta
Onde procurar desatualização?	Nas notas salvas	Na fonte e na próxima data de revisão

A coluna da direita descreve uma organização proposta. Abrir uma pasta no Obsidian não cria automaticamente Git, responsável ou prazo de revisão.

Prepare a conexão de modelo para testar a memória

Para testar as duas formas no Claude Code via API, BetterToken oferece uma conexão compatível com Anthropic. Configure primeiro o cliente pelo guia BetterToken para Claude Code: use sua própria API Key e a Base URL https://bettertoken.ai sem /v1; reinicie o cliente e obtenha resposta a uma mensagem curta. Isso testa o acesso ao modelo; os passos seguintes testam as notas.

Na comparação, mantenha a mesma model e a mesma tarefa: peça para ler o registro, altere-o e repita a pergunta numa nova sessão. Assim, mudar a conexão não vira outra variável. BetterToken fornece chamadas de API; auto memory e vault continuam sob controle da sua ferramenta. Trechos lidos pelo agente podem ir para o pedido ao modelo, portanto use uma nota didática não secreta e não guarde a API Key no vault.

Configure Claude Code pelo BetterToken e teste uma nota antes de seguir para o exemplo.

Dê a cada fato um local principal

Comece com uma nota não secreta. No exemplo, a equipe discute o formato de exportação; nomes e valores são fictícios. Salve decisions/report-export.md:

# Report export decision

Status: proposed
Owner: reporting-team
Verified: 2026-09-08
Review-by: 2026-09-22
Source: team decision record to be attached

The proposed export format is CSV.
This is not an approved production requirement.
Before implementation, ask the owner for the approved decision.

O registro separa proposta de requisito obrigatório. Num projeto real, indique a fonte disponível: tarefa, ata ou documento de decisão. Sem confirmação, o agente precisa preservar a incerteza.

Envie uma tarefa específica numa nova sessão:

Read decisions/report-export.md.
What export format is proposed, and is it approved for production?
Cite the file and identify the missing evidence.
Do not change code or infer approval from the proposal.

O resultado esperado é: CSV foi proposto, não há aprovação de produção e falta a fonte da decisão. É um critério de teste, não promessa de resposta correta. Se o agente disser para implementar CSV, veja qual arquivo leu e citou; pode haver nota duplicada, conversa antiga ou interpretação errada do status.

Teste atualização e exclusão

Altere a nota: o formato passa a ser JSONL e o status continua proposed. Abra uma nova sessão e repita a pergunta. O agente deve informar JSONL e a mesma limitação. Se voltar CSV, não acrescente regra contraditória: encontre a fonte do valor antigo.

Depois exclua a nota pelo gerenciador de arquivos e, em outra sessão nova, pergunte onde fica a decisão confirmada. Sem outra fonte, a resposta útil é que faltam dados. Uma resposta com o valor antigo indica outra cópia ou fonte; revise /memory, os arquivos do projeto e as instruções.

Excluir uma nota não a remove automaticamente do Git history, backups, dispositivos sincronizados ou conversa já aberta. O teste cobre uma nova sessão, não a eliminação completa dos dados. Não inclua API keys, senhas ou dados pessoais no exercício.

Ajuste o modo ao custo do erro

Se você trabalha sozinho e a memória contém principalmente preferências, mantenha a auto memory e revise as entradas após mudanças relevantes. Quando uma ação da equipe depende de um fato, mova sua versão principal para um documento controlado. Na auto memory, deixe apenas onde encontrar a fonte atual, sem copiar a decisão.

Se necessário, desative a auto memory por /memory; o parâmetro oficial autoMemoryEnabled controla o recurso. Desativar não substitui verificar arquivos existentes nem o contexto já carregado.

No vault de equipe, atribua responsável aos registros importantes e um evento de revisão: mudança de API, cancelamento do projeto ou fim da migração. A data ajuda a encontrar notas esquecidas, mas não cria validade automática. Com Git, revise os arquivos exatos antes do commit; não adicione a pasta inteira junto de configurações pessoais e anexos.

Comece com uma decisão e três perguntas em novas sessões: o que se sabe, o que mudou e o que deixou de estar confirmado. Se as respostas citarem arquivos atuais e mantiverem a incerteza, o método escolhido atende ao objetivo. Caso contrário, corrija primeiro a fonte e a ordem de leitura; trocar apenas o editor não elimina contradições.