Como organizar o vault do Obsidian para o Claude Code achar a nota certa

Vault grande sem estrutura vira busca cega: o agente varre dezenas de notas e volta com a errada, ou pior, volta com três candidatas e te pede pra escolher 😅

A raiz do problema é simples: o Obsidian guarda tudo como arquivos Markdown comuns numa pasta local, acessíveis pelo sistema de arquivos

Ou seja: pro Claude Code, teu segundo cérebro é uma pasta de texto igual a qualquer repositório

E ele acha nota do mesmo jeito que acha código, com as ferramentas Glob e Grep: nome de arquivo e conteúdo do arquivo

Quer dizer que a tua estrutura não é enfeite, ela é o índice de busca do agente

Se o nome do arquivo não diz nada e o texto de dentro usa cinco palavras diferentes pra mesma coisa, o agente não tem por onde acertar

Bora arrumar isso?

O que você precisa antes de começar

Pouca coisa, na real

• Um vault do Obsidian em pasta local, acessível pelo sistema de arquivos (as notas são .md comuns, então isso já vem de graça)
• O Claude Code iniciado de dentro do vault, pra ele enxergar os arquivos das notas (pode ser da raiz, pode ser de uma subpasta, e o passo 10 explica quando cada um faz sentido)
• Disposição pra renomear arquivo, porque metade do ganho tá no nome
• Backup ou versionamento antes de mexer em massa, e isso não é frescura

Se tu ainda não ligou as duas pontas, dá pra começar pelo básico de rodar o Claude Code dentro do cofre e voltar aqui pra organizar

Um detalhe que quase ninguém liga na hora certa: se tu versiona o vault com git, se liga que o Grep respeita o .gitignore e pula os arquivos ignorados

Já o Glob, por padrão, não respeita

Então se tu jogou uma pasta inteira de notas no .gitignore, a busca de conteúdo simplesmente não vai olhar lá dentro

Tome cuidado! Pra ler um arquivo ignorado, o jeito é passar o caminho direto

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Passo a passo: organizando o vault para a busca do agente

Cada passo aqui tem um porquê técnico, não é gosto pessoal

1. Nomes de arquivo descritivos e específicos

O Glob acha arquivo por nome, aceita pra busca recursiva, ordena o resultado por data de modificação e limita a 100 arquivos**

Junta isso com o fato de que o modo padrão de saída do Grep é files_with_matches, que devolve só os caminhos dos arquivos que casaram

Ou seja: em muitos momentos o agente decide o que abrir olhando apenas pro caminho

Nome genérico some no ruído

notas 3.md                                  <- não diz nada
ideias.md                                   <- não diz nada
projeto-video-claude-code-obsidian.md       <- diz tudo
pesquisa-ripgrep-busca-de-conteudo.md       <- diz tudo

Eu ainda exijo nome sem acento e sem espaço, separado por hífen, pra não dar problema de acesso e de edição por nenhuma das partes

O erro comum deste passo: renomear um monte de arquivo e não conferir o caminho de volta

Depois de renomear, passa o olho no painel de backlinks das notas mais linkadas pra ver se as referências continuam de pé

2. Hierarquia rasa e temática

Pasta boa é a que serve de recorte de caminho, porque o Grep aceita restringir a busca por padrão de arquivo (parâmetro glob) ou por linguagem (parâmetro type)

Num vault, quem trabalha é o glob

pesquisa/**/*.md        <- busca só na pesquisa
projetos/**/*.md        <- busca só nos projetos

Isso só funciona se a pasta for temática

A estrutura que eu uso é ditada pela demanda: inbox pra tudo que entra, projetos (cada vídeo ou curso é um projeto com status), pesquisa, roteiros, referencias, diario e templates

O erro comum deste passo: pasta com sete níveis e nome de data no meio do caminho

2026/08/10/nota.md não diz assunto nenhum

Data é ótima pra diário e péssima pra tudo o resto

3. Vocabulário consistente dentro das notas

Agora o pulo do gato: o Grep é busca de conteúdo construída sobre o ripgrep, usando a sintaxe de regex do ripgrep (não a do grep POSIX)

Isso é busca de TEXTO

Se metade das tuas notas escreve "roteiro" e a outra metade escreve "script", a busca por roteiro traz metade do teu vault e tu nem fica sabendo do resto

Escolhe o termo e repete ele

De quebra, vale lembrar dos outros dois modos de saída do Grep: content (linhas com arquivo e número da linha) e count (contagem por arquivo)

Quando tu pede a contagem por arquivo, dá pra sacar na hora qual nota é a densa no assunto e qual só cita de passagem

O erro comum deste passo: escrever bonito demais e variar sinônimo dentro da mesma nota, achando que é estilo

Aqui, repetição é feature

4. Tags com padrão único

Tag ajuda muito, desde que exista UM padrão

As regras reais do Obsidian são estas:

• aceita letras, números, _, -, / e caracteres Unicode, inclusive emoji
• não pode ter espaço
• precisa de pelo menos um caractere não numérico (#1984 é inválido, #y1984 é válido)
• não diferencia maiúscula de minúscula: #tag e #TAG são a mesma tag
• a barra cria tag aninhada, tipo #project/active

A barra é a parte mais subestimada: ela te dá hierarquia dentro da tag, sem precisar de mais uma pasta

E dá pra declarar as tags como propriedade no frontmatter da nota, que é uma propriedade documentada do Obsidian e funciona como lista:

---
tags:
  - projeto/gravando
  - claude-code
  - obsidian
---

O erro comum deste passo: criar tag com espaço e achar que o Obsidian resolve, ou manter #ClaudeCode e #claudecode como se fossem duas coisas

Não são, é a mesma tag

5. Aliases pros nomes que tu realmente usa na hora de procurar

O Obsidian documenta a propriedade aliases pra dar nomes alternativos a uma nota

Isso é ouro pro agente, porque tu quase nunca lembra do título oficial

Tu lembra do apelido

---
aliases:
  - segundo cerebro
  - setup do vault
---

O alias fica escrito dentro do arquivo, então ele entra na busca de conteúdo junto com o resto

O erro comum deste passo: encher de alias

Coloca os dois ou três nomes que tu de fato digita quando vai procurar, não um dicionário

6. Notas de índice por área

Essa é a que mais muda o jogo em vault grande

Uma nota de índice é um mapa curto que o agente lê ANTES de sair varrendo, listando as notas filhas com o status de cada uma:

# Indice de Projetos

- projeto-video-claude-code-obsidian, status: gravando
- projeto-curso-vibe-coding, status: pesquisando
- projeto-video-mcp-na-pratica, status: ideia

Cada item desses entra como link interno de verdade, na sintaxe de colchetes duplos com o nome da nota, que é como o Obsidian liga uma nota na outra

Se você conhece um README.md de repositório, é exatamente a mesma ideia, só que por área do teu conhecimento

O agente abre um arquivo e já sabe o que existe e onde mora, em vez de listar cem caminhos e chutar

E o painel de backlinks te mostra o caminho de volta, quem aponta pra quem

O erro comum deste passo: criar índice e nunca atualizar

Índice desatualizado é pior que índice nenhum, porque manda o agente pra nota que não existe mais

7. Um CLAUDE.md na raiz do vault

Esse é o passo que eu considero mais importante de todos

O Claude Code lê arquivos CLAUDE.md subindo a árvore de diretórios a partir do diretório de trabalho atual, procurando CLAUDE.md e CLAUDE.local.md em cada nível

O que estiver acima do diretório de trabalho é carregado por inteiro no início da sessão

Então é ali que tu escreve o mapa da casa:

# Cofre: segundo cerebro

Propósito: pesquisa, roteiro e producao de conteudo

## Onde cada coisa mora
- inbox/ tudo que entra, sem tratamento
- projetos/ um arquivo por video ou curso, com status
- pesquisa/ notas de fonte, uma fonte por nota
- roteiros/ organizados por data
- referencias/ material salvo de fora
- diario/ano/mes/dia
- templates/ modelos reutilizaveis

## Convencoes
- responder e escrever sempre em portugues do Brasil
- nome de arquivo sem acento e sem espaco, separado por hifen
- link interno sempre em wikilink (colchetes duplos com o nome da nota)
- todo arquivo comeca com frontmatter contendo tags e data
- status de projeto: ideia, pesquisando, roteiro, gravando, editando, publicando

Essa regra do português não é enfeite: as skills e boa parte do material são em inglês, e sem deixar explícito o assistente tende a produzir em inglês mesmo com prompt em português

Pra conferir o que realmente entrou na sessão, roda /context e olha a seção Memory files

E se tu quer um ponto de partida, o /init gera um CLAUDE.md e, se já existir um AGENTS.md, incorpora as partes relevantes dele (ele também lê configs de outras ferramentas, tipo .cursorrules e .windsurfrules)

Vale o aviso honesto: a documentação descreve esse comando no contexto de repositório de código, então trata o resultado como rascunho e ajusta na mão

O erro comum deste passo: achar que quebrar o arquivão em imports @caminho economiza contexto

Não economiza

Os arquivos importados carregam na inicialização e continuam consumindo contexto do mesmo jeito

Organiza a leitura pra ti, não a memória dele 🙂

8. CLAUDE.md em subpasta pras regras locais

Aqui muda o comportamento: CLAUDE.md em subpasta não carrega no início da sessão

Ele carrega sob demanda, quando o Claude lê um arquivo daquela pasta com a ferramenta Read

Isso é perfeito pra regra que só interessa num canto do vault

Um CLAUDE.md dentro de roteiros/ explicando o formato do roteiro, por exemplo

O erro comum deste passo: colocar regra crítica (tipo "escreva sempre em português") numa subpasta e esperar que ela valha desde o primeiro prompt

Regra que vale pro cofre inteiro vai na raiz, ponto

9. Tira o entulho da raiz do vault

Por padrão, os anexos novos do Obsidian vão pra raiz do vault

Deu três meses de uso e a raiz vira um depósito de imagem e PDF misturado com as tuas notas de índice

Dá pra ajustar em Settings > Files & Links > Default location for new attachments

Raiz limpa é raiz legível, e é a primeira coisa que o agente enxerga

O erro comum deste passo: arrumar a bagunça só no explorador de arquivos e esquecer de mudar a configuração

Aí em uma semana tá tudo lá de novo haha

10. Inicia o Claude Code da pasta certa

Aqui eu volto no pré-requisito lá do começo e refino ele

A documentação oficial reconhece o problema de base grande: conforme a coisa cresce, os padrões pensados pra projeto pequeno enchem a janela de contexto com instrução e leitura de arquivo sem relação com a tarefa, gastando token e degradando o desempenho

A recomendação é escopar o Claude pra parte da base que a tarefa toca

Vault grande é exatamente isso

Então a régua fica assim: pra montar e reorganizar o cofre, tu abre da raiz, porque a tarefa toca o vault inteiro

Pra tarefa de um canto só, tu abre de dentro daquele canto: se hoje é só roteiro, inicia dentro de roteiros/

Dois efeitos práticos: o CLAUDE.md da raiz continua sendo carregado (porque a busca sobe a árvore de diretórios), e o escopo das Skills passa a valer pela hierarquia do ponto de partida, ou seja, as skills daquela pasta, de cada pasta pai até a raiz, mais os níveis de usuário e enterprise

O erro comum deste passo: abrir tudo sempre da raiz por preguiça e depois reclamar que o agente se perdeu

Resumo do que ajuda e do que atrapalha

O que aconteceu no meu vault de teste

Confissão: eu desisti do Obsidian várias vezes

Achava muita configuração pra pouco resultado, mesmo depois de ver tutorial

O que virou a chave foi parar de montar a estrutura na mão e delegar a montagem E a manutenção pro Claude Code

No vídeo eu crio um cofre novo pelo gerenciador de cofres do Obsidian, apago a nota de boas-vindas pra começar limpo (quem já tem cofre pode usar o existente), abro a pasta do cofre e inicio o Claude Code dentro dela, justamente porque ali a tarefa era montar o vault todo

Aí escrevi o CLAUDE.md com o propósito do cofre, ditei a estrutura de pastas e pedi templates reutilizáveis: projeto de vídeo (tema, status, pesquisa, roteiro, thumbnail e links), nota de pesquisa (fonte, resumo, pontos principais e como usar no conteúdo), nota diária e referência

E fiz o teste que eu recomendo pra qualquer um: pedi dados fictícios de exemplo junto da estrutura, com referência cruzada entre eles, só pra conferir se a organização funcionava do jeito que eu queria

Foram 3 projetos de vídeo em status diferentes, 5 notas de pesquisa e 3 notas diárias dos últimos dias

Parece bobagem, mas é aí que tu descobre se o teu esquema presta ou não

Com os exemplos no lugar, dá pra abrir o Obsidian e navegar de verdade pelos projetos, anotações, links, referências e roteiros, em vez de imaginar como ficaria

Duas coisas que eu não esperava

Uma: tive que aprovar várias confirmações enquanto o agente criava os arquivos, então não é aquele negócio de sentar e virar as costas

Duas: criei uma skill própria de pesquisa como skill local do projeto, e não global, justamente pra não poluir as minhas skills globais

E olha, essa estratégia rende dos dois lados: pra quem já vive no Obsidian e não conhece Claude Code, e pra quem vive no Claude Code e nunca viu graça no Obsidian

Veja o setup completo em vídeo

No vídeo abaixo eu mostro o caminho inteiro, do cofre vazio até a estrutura navegável com os dados de exemplo dentro

Como a estrutura se paga no dia a dia

Organização só vale se ela aparece na tarefa real, então se liga em quatro situações

Puxar o histórico de um projeto específico

Com pasta temática e status controlado, tu pede o estado de um projeto e o agente restringe a busca de conteúdo ao caminho de projetos, em vez de passear pelo vault inteiro

Quem faz o trabalho aqui é o passo 2 (pasta) somado ao passo 1 (nome de arquivo que diz o que é)

Cruzar notas de pesquisa do mesmo tema

Esse é o passo 4 (tag no padrão) com o passo 3 (vocabulário repetido)

Se todas as notas daquele assunto carregam a mesma tag aninhada no frontmatter e usam o mesmo termo no corpo, o cruzamento sai completo

Se cada nota inventou um nome, sai pela metade e tu nem percebe o que ficou de fora

Retomar as notas diárias da semana

Aqui o caminho fixo por ano, mês e dia é o que salva, porque vira um padrão previsível pro glob

É o único lugar do vault onde data no caminho é boa ideia

Achar a nota que tu lembra pelo apelido

Passo 5: alias

Tu não lembra que a nota chama pesquisa-modelos-open-weight-2026, tu lembra de "aquela dos modelos abertos"

Com o alias escrito dentro do arquivo, o termo que tu digita existe no texto e a busca acha

E quando a estrutura já tá de pé, o vault deixa de ser arquivo morto e vira material de trabalho: dá pra partir pros casos de resumir, conectar e revisar notas sem medo de o agente voltar com a nota errada

Próximo passo

Não reorganiza o vault inteiro num domingo, isso não termina bem

Começa pelo mais barato: renomeia os arquivos que tu mais consulta e escreve a nota de índice de UMA área só

Depois roda uma sessão de teste pedindo algo específico, do tipo "me traz o status do projeto X e as notas de pesquisa ligadas a ele"

O que o agente errar ali é a tua lista de tarefas

Faltou convenção? Escreve no CLAUDE.md do cofre

Buscou na pasta errada? O nome da pasta tá vago

Trouxe nota pela metade? Teu vocabulário tá inconsistente

Aí repete o ciclo na próxima área

É assim que o cofre vai ficando afiado sem tu perder um fim de semana nisso 😀

Até o próximo post!