Como usar o Claude Code com o Obsidian: IA direto no seu cofre de notas

Suas anotações em texto puro finalmente encontraram uma IA que fala a mesma língua

O pulo do gato é bobo de tão simples: um cofre do Obsidian não é um app misterioso com banco de dados escondido, é só uma pasta no seu computador cheia de arquivos .md, mais uma subpasta .obsidian com a configuração

Como é tudo texto puro local, o Claude Code consegue ler e escrever nessas notas sem intermediário nenhum, do mesmo jeito que mexe em qualquer arquivo de um projeto

E é aí que a dupla faz sentido pra quem já vive no Markdown: você mantém o controle total das notas (elas abrem no Obsidian ou em qualquer editor de texto) e ganha uma LLM que organiza, escreve e busca dentro delas 🙂

O que você precisa antes de começar

Antes de sair digitando comando, se liga no que precisa estar de pé:

• Um cofre do Obsidian já criado, que nada mais é do que uma pasta local com seus arquivos .md em texto puro
• O Claude Code CLI instalado e já usado pelo menos uma vez na máquina (alguns fluxos, como veremos, dependem disso pra existirem os arquivos de sessão)

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

Repara numa coisa importante: pro fluxo base, não tem banco de dados hospedado nem dependência de rede

As notas do Obsidian são local-first, ou seja, Markdown que vive no seu disco e abre em qualquer editor

Então a conversa entre Claude Code e cofre acontece em cima de arquivos de texto que já estão aí, parados na sua pasta

Passo a passo: apontando o Claude Code para o cofre

Bora ver na prática? O caminho tem dois passos essenciais e um terceiro opcional pra quem quer integração mais fina com o app

1. Abra o Claude Code dentro da pasta do cofre

É o passo que destrava tudo: quando você abre o Claude Code numa pasta, ele passa a ter acesso de leitura e escrita aos arquivos daquele diretório

Como o cofre É a pasta, o Claude enxerga suas notas .md na hora

cd /caminho/do/seu/cofre
claude

O erro comum deste passo: abrir o Claude Code numa pasta acima ou ao lado do cofre e depois estranhar que ele não acha as notas

Tem que ser dentro da MESMA pasta do vault, não na pasta pai

2. Crie um CLAUDE.md com as instruções do cofre

Esse arquivo é especial: o Claude Code carrega ele automaticamente no começo de cada sessão, sem você precisar citar no prompt

É o lugar de deixar escrito como suas notas são organizadas, que pastas existem, que convenções seguir

Existe um nível global em ~/.claude/CLAUDE.md (vale pra tudo) e o nível de projeto (o CLAUDE.md na raiz do cofre)

E tem um truque massa: dá pra importar outros arquivos pra dentro do CLAUDE.md com a sintaxe @caminho/para/arquivo, então você aponta pra uma nota de convenções sem colar o conteúdo inteiro ali

# Cofre de notas

Este é um cofre do Obsidian (arquivos .md em texto puro).

- Fontes brutas ficam em RAW/
- Conhecimento processado fica em Wiki/

Convenções: @Wiki/_convencoes.md

O erro comum deste passo: escrever um CLAUDE.md gigante e vago

Instrução curta e específica funciona muito melhor do que um textão que o Claude tem que adivinhar o que é importante

3. (Opcional) Integre ao app pelo plugin Claude Code IDE

Se você quer que o Claude enxergue o que está aberto no Obsidian em tempo real, dá pra usar o plugin da comunidade Claude Code IDE

Ele roda um servidor MCP por WebSocket em localhost (127.0.0.1), com token por sessão, e o Claude Code descobre a conexão pelos arquivos em ~/.claude/ide/*.lock

Na prática: você digita /ide no Claude Code e o Obsidian aparece no seletor

A partir daí ele compartilha o arquivo ativo, os arquivos abertos e o texto selecionado, tudo em tempo real

Uma ressalva pra não te pegar de surpresa: a versão base é somente leitura

O erro comum deste passo: esperar que o plugin edite suas notas pela interface

Na versão base ele serve pra dar contexto (mostrar pro Claude o que você está olhando), não pra escrever de volta pelo diff da UI

O que dá pra fazer com a dupla no dia a dia

Ok, apontou o Claude Code pro cofre. E agora, o que rola de útil de verdade? Se liga em dois usos concretos

Espelhar suas sessões do Claude Code como notas

Tem um plugin, o Claude Code Sync, que espelha as sessões do Claude Code pra dentro do cofre como notas em Markdown

Ele lê os transcripts direto do disco, da pasta ~/.claude/projects, e transforma cada sessão numa nota

Roda localmente, sem conta e sem requisição de rede, o que combina com a filosofia local-first do Obsidian

Dois detalhes pra não se ferrar: a nota é um espelho, então se você editar direto ela é sobrescrita na próxima sincronização

E ele exige que o Claude Code CLI já tenha sido usado na máquina (senão não tem transcript pra espelhar)

Montar uma wiki a partir dos seus artigos

Existe um projeto open-source chamado claude-obsidian que abre uma pasta como cofre e usa o Claude Code na mesma pasta com um comando /wiki

O fluxo é direto: você abre a pasta como vault, abre o Claude Code na mesma pasta e digita /wiki

O resultado fica em notas Markdown local que você controla, nada trancado num serviço de terceiro

E já que falei em comando, esse /wiki é um slash command

Se você quer entender como esses comandos funcionam por baixo (e como criar e usar slash commands próprios), o assunto rende sozinho

O ponto de tudo isso: pra quem organiza conhecimento em Markdown, você deixa a IA como motor de escrita e organização, e o Obsidian como o banco de dados visual em cima dos mesmos arquivos de texto

Testando na prática: montando a wiki no cofre

Agora o relato de primeira mão, porque no vídeo abaixo eu mostro esse fluxo funcionando de ponta a ponta

O método que testei é baseado num Gist publicado no GitHub (Gist é aquele arquivinho que a galera solta no GitHub com a solução de algum problema)

Antes de tudo, instalei o Obsidian, criei um cofre numa pasta e abri o Claude Code dentro dessa MESMA pasta

Aí copiei o conteúdo do Gist (a versão RAW) e colei no Claude Code pedindo pra ele configurar o cofre seguindo o método, acrescentando no prompt o tema que eu queria (no caso, conteúdos sobre IA)

O Claude Code montou a estrutura de pastas: uma RAW (onde entram as fontes brutas) e uma Wiki (onde fica o conhecimento processado e pesquisável)

Pra abastecer a RAW sem sofrimento, usei a extensão Web Clipper pra transformar artigos e sites em arquivos Markdown e jogar direto no Obsidian

Isso poupa o trabalho chato de converter texto em MD na mão

E quando a extensão não mandava direto pro cofre aberto, dava pra guardar o ficheiro e mover o .md pra dentro da pasta RAW manualmente

Coletei artigos sobre modelos de IA diferentes (GLM, Minimax, Qwen 2.5 e Claude Opus) e joguei todos dentro da RAW

Com a base montada, dei o prompt pro Claude compilar o conteúdo de RAW pra Wiki seguindo o esquema do método

O Claude identificou 4 fontes e passou a criar páginas separadas em categorias como fontes, modelos, entidades e conceitos, além de atualizar os arquivos MD gerais do repositório

Acompanhei a criação em tempo real e fui concedendo as permissões que o Claude Code pedia durante o processo (fica de olho nesse ponto, ele pergunta)

No fim, saíram 19 páginas geradas na Wiki a partir dos artigos que mandei

A parte mais massa foi abrir o graph view do Obsidian e ver as conexões visuais se montando entre os conteúdos

Dá pra comparar modelos que têm pontos em comum (vi recurso tipo agent swarm aparecendo em mais de um modelo, por exemplo)

E o uso vira um loop contínuo: depois da primeira carga, você vai adicionando um ou outro artigo novo e recompilando pra manter a base atualizada

Depois de processado, eu consulto a base de conhecimento pelo próprio Claude Code, usando a LLM como filtro pra ir direto ao ponto em vez de ler tudo no Obsidian

Minha conclusão testando isso: o método é inteligente e bem eficiente

É 100% Markdown local, sem precisar de banco de dados vetorizado, rag, servidor ou infraestrutura nenhuma

A LLM escreve e organiza, você faz só a curadoria

E a base é portável: como é tudo arquivo de texto, dá pra versionar o cofre com Git e acompanhar cada mudança

Ela cresce de forma condensada, usando a LLM como motor e o Obsidian como banco de dados, e funciona bem sem estrutura complexa

Conclusão

No fundo a dupla faz sentido por um motivo só, e é um motivo forte: suas notas continuam sendo texto puro que você controla, e ganham uma IA que lê e escreve dentro delas sem intermediário

Nada de serviço trancado, nada de banco hospedado, só arquivos .md na sua pasta e o Claude Code apontado pra lá

O próximo passo é o mais barato de dar: crie um CLAUDE.md na raiz do seu cofre com as regras das suas notas e abra o Claude Code dentro dessa pasta

Daí é só ir testando e deixar a base crescer no seu ritmo… =)