Um vault do Obsidian é uma pasta de notas em Markdown que uma pessoa pode organizar e compartilhar por escolha. Ele é opcional para o Claude Code: a ferramenta já tem instruções persistentes em CLAUDE.md e memória automática. O vault acrescenta um arquivo curado por você, mas não faz com que o agente encontre ou carregue todas as notas sozinho.
Neste artigo
- O que o Claude Code já lembra
- O que um vault acrescenta
- Como tornar as notas mais fáceis de localizar
- Como controlar as alterações e as contradições
- O que significa manter os arquivos no computador
O que o Claude Code já lembra
A Anthropic descreve dois mecanismos de continuidade. O arquivo CLAUDE.md guarda instruções escritas pela pessoa usuária; a memória automática reúne notas que o próprio Claude Code produz sobre o projeto. Ambos entram como contexto nas conversas, não como regras que obrigam o agente a agir de uma determinada maneira. A documentação da Anthropic sobre memória detalha esse funcionamento.
A memória automática fica no computador, organizada por repositório Git, e não é compartilhada automaticamente entre máquinas ou ambientes em nuvem. No início da sessão, o Claude Code carrega apenas as primeiras 200 linhas ou 25 KB do índice MEMORY.md, o que acontecer primeiro. Pode consultar arquivos temáticos sob demanda, mas não registra algo em todas as sessões e deixa de lado informações que consegue deduzir do código ou de arquivos CLAUDE.md existentes.
| Abordagem | Quem mantém e onde fica | Como entra no contexto |
CLAUDE.md | Instruções escritas pela pessoa usuária para o projeto ou fluxo de trabalho | É carregado como contexto nas conversas |
| Memória automática | Notas escritas pelo Claude Code, por repositório e no computador local | O índice MEMORY.md tem limite inicial de 200 linhas ou 25 KB; arquivos temáticos podem ser lidos sob demanda |
| Vault do Obsidian | Arquivo de notas Markdown organizado por uma pessoa; pode ser compartilhado por uma configuração adicional | O agente precisa ter acesso e ser orientado a consultar o índice e as notas relevantes |
Para trabalhar em um único repositório e computador, a memória nativa pode bastar. Um vault curado passa a ser útil quando você quer organizar um acervo próprio ou compartilhar notas deliberadamente com outros ambientes. São funções diferentes: a memória automática oferece continuidade ligada ao repositório; o vault dá à pessoa mais controle sobre a organização do arquivo.
O que um vault acrescenta
Um vault pode reunir arquivos Markdown, subpastas, links entre notas, tags e metadados. Um tutorial do Journal du Net descreve um agente local lendo e editando esses arquivos sem precisar da interface do Obsidian. A interface e o grafo ajudam a pessoa a percorrer as relações entre notas; o agente, por sua vez, ainda depende de acesso aos arquivos, de instruções e de uma consulta pertinente.
Por isso, a visualização do grafo não é, sozinha, um mecanismo de busca automática. Em um relato na comunidade do Claude Code, u/botsinproduction descreveu o uso de um índice curto, com uma linha por nota, para selecionar conteúdos em um vault de cerca de 70 notas. É uma experiência individual, não uma comparação de desempenho.
Como tornar as notas mais fáceis de localizar
O fluxo descrito pelo Journal du Net começa com uma nota-índice e orienta o agente a consultá-la nas tarefas pertinentes, seguindo os links para as notas relacionadas. Um índice breve, com descrições que ajudem a identificar o assunto de cada arquivo, dá ao agente um caminho para selecionar contexto em vez de tratar todo o vault como se já estivesse carregado.
A manutenção também importa. Uma pessoa usuária do Obsidian relatou resumir notas de sessões em sínteses hierárquicas e revisar decisões antigas ou revertidas. Assim, o arquivo pode continuar útil sem perder o registro mais completo que fica nas notas originais.
Como controlar as alterações e as contradições
É possível orientar o Claude Code a pedir aprovação antes de editar o vault e a não apagar ou sobrescrever arquivos sem consentimento. O Journal du Net propõe essas salvaguardas em seu fluxo de trabalho, mas uma instrução escrita não funciona como bloqueio obrigatório. A Anthropic recomenda configurações ou hooks para controles que precisam ser aplicados independentemente da escolha do modelo.
Quando duas notas divergem, uma instrução pode pedir ao agente que sinalize a contradição em vez de escolher uma versão em silêncio. Essa orientação não garante que ele vá identificar ou resolver corretamente todo conflito; decisões importantes ainda exigem revisão humana.
O que significa manter os arquivos no computador
Armazenar o vault localmente não impede que o conteúdo acessado pelo Claude Code apareça em registros da sessão. A Anthropic informa que o conteúdo passado por ferramentas é gravado em transcrições locais em texto simples e aponta as permissões do sistema operacional como proteção desses arquivos. A documentação sobre os dados locais do Claude Code descreve esse comportamento.
Para permitir acesso remoto, o fluxo do Journal du Net também descreve caminhos como GitHub ou Obsidian Sync com um servidor MCP e um túnel. Cada configuração acrescenta um caminho de armazenamento ou transporte ao arquivo local.
