Como transformar seu Obsidian num segundo cérebro consultável pelo Claude Code

Você já anotou algo genial e nunca mais releu?

A gente acumula nota em cima de nota achando que um dia aquilo vira conhecimento, e no fim é só um cemitério de arquivos que ninguém abre

Segundo cérebro é uma ideia bonita, mas ela só sai do papel quando alguém (ou alguma coisa) consegue de fato navegar suas notas conectadas e responder a partir do que você escreveu

É aí que entra o Claude Code lendo o seu cofre do Obsidian

O cofre nada mais é que uma pasta local cheia de arquivos Markdown (.md) em texto puro, no seu próprio computador, sem nuvem obrigatória e sem formato proprietário

Esse é o material bruto

O Claude Code é o cara que vai ler esse material, ligar os pontos e te devolver resposta com citação da própria nota

Bora montar isso?

O que você precisa antes de começar

Antes de sair rodando comando, se liga no que precisa estar na mesa

• Obsidian instalado com um cofre de notas: o Obsidian é gratuito para uso pessoal, e o cofre é só aquela pasta de arquivos .md no seu disco. Não precisa de nuvem, não precisa de conta, os arquivos são seus e ficam locais
• Acesso ao Claude Code: ele está incluído no plano Claude Pro, que custa US$20 por mês na cobrança mês a mês (ou cerca de US$17 por mês se você pagar no anual)
• Uma decisão de arquitetura: você vai dar acesso direto à pasta do cofre ou vai passar por um servidor MCP? As duas funcionam, e eu explico cada uma no passo a passo

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

O ponto importante aqui é que o cofre é local

Nada disso exige subir suas notas pra lugar nenhum

O Claude Code lê o arquivo .md que já está no seu computador, e pronto

Se você conhece a ideia de apontar uma ferramenta pra uma pasta de projeto, é exatamente o mesmo espírito

Passo a passo: transformando o cofre em base consultável

A sequência abaixo vai do mais simples (acesso direto) até a opção mais parruda (MCP)

Não precisa fazer tudo: o passo 1 e o 2 já te dão um segundo cérebro funcional

1. Aponte o Claude Code para o diretório do cofre

Esse é o pulo do gato e o mais subestimado

Você não precisa configurar MCP nenhum pra começar

Basta abrir (ou rodar) o Claude Code de dentro da pasta do cofre, e ele passa a ler os arquivos .md diretamente

cd /caminho/do/seu/cofre
claude

A partir daí, quando você pergunta algo, ele tem acesso ao conteúdo das suas notas

O erro comum deste passo: rodar o Claude Code de fora da pasta e depois estranhar que ele não acha suas notas. Ele lê o diretório onde você o abriu, então abra dentro do cofre

2. Crie um CLAUDE.md na raiz do cofre

O Claude Code lê automaticamente um arquivo chamado CLAUDE.md na raiz do diretório no começo de toda sessão, e usa aquilo como contexto

É o lugar perfeito pra ensinar ele a navegar suas notas: onde ficam as coisas, como você nomeia os arquivos, quais pastas servem pra quê

# Contexto do cofre

Este cofre e meu segundo cerebro no Obsidian.

- inbox/ = notas cruas ainda nao organizadas
- projetos/ = um arquivo por projeto ativo
- pesquisa/ = notas de estudo com tags e wikilinks
- diario/ = notas diarias

Ao criar notas, use wikilinks para conectar ao que ja existe
e nomes de arquivo sem acento e sem espaco, separados por hifen.

O erro comum deste passo: escrever um CLAUDE.md genérico que não diz nada sobre a SUA estrutura. Quanto mais específico você for sobre suas pastas e convenções, melhor ele navega

3. Se quiser mais poder, use a alternativa via MCP

O acesso direto já resolve leitura

Mas existe a rota via Model Context Protocol, com servidores mantidos pela comunidade que expõem o cofre pra clientes MCP (ler, buscar e escrever notas de forma mais estruturada)

Dois exemplos de servidores comunitários são o MarkusPfundstein/mcp-obsidian e o cyanheads/obsidian-mcp-server, cada um com o próprio jeito de rodar descrito na documentação do repositório

Tem também o plugin obsidian-claude-code-mcp, do iansinnott, que conecta o Claude Code e outras ferramentas de IA às notas do Obsidian via MCP

O erro comum deste passo: partir direto pro MCP achando que é obrigatório. Não é. Comece pelo acesso direto, e só migre pro MCP quando sentir falta de busca e escrita mais sofisticadas. Os detalhes finos de configuração de cada servidor ficam na documentação de cada repositório

4. Entenda o fluxo de uso

Com o acesso montado, o padrão de trabalho é sempre o mesmo

O Claude lê a fonte, extrai as entidades e conceitos, liga ao que já existe no cofre e arquiva tudo em Markdown conectado

Depois você pergunta, e ele responde a partir do que já leu, com citações às notas

É esse ciclo de ler, extrair, linkar e arquivar que transforma um monte de .md solto numa base de conhecimento que responde

O que dá para fazer com o segundo cérebro consultável

Com a base ligada, o que muda no dia a dia?

Muita coisa

• Perguntar e receber resposta citando suas próprias notas: em vez de caçar no buscador do Obsidian, você pergunta em linguagem natural e ele te devolve a resposta apontando de qual nota tirou aquilo
• Ligar ideias dispersas: aquela anotação de três meses atrás que conversa com o que você escreveu ontem e você nem lembrava. O Claude cruza e conecta
• Transformar fonte nova em nota conectada: joga um artigo ou uma transcrição, e ele extrai o essencial, cria a nota no seu formato e amarra por wikilink ao que já existe

É o mesmo princípio de quando você monta uma base de conhecimento pra um agente responder de forma confiável

Inclusive, se você curte a ideia de dados que alimentam respostas, vale ver como estruturar uma base de conhecimento inteligente em outro contexto: a lógica de organizar antes pra consultar depois é a mesma

Se quiser um ponto de partida mais completo pra esse setup, dá uma olhada no claude-obsidian, do AgriciDaniel

É um projeto de comunidade, open-source, que propõe um segundo cérebro auto-organizável para Obsidian mais Claude Code, seguindo justamente esse fluxo de ler, extrair, linkar e arquivar

Como ficou na prática

Vou ser honesto: eu desisti do Obsidian várias vezes

Achava a ferramenta complicada demais, muita configuração pra pouco resultado, mesmo depois de ver vários tutoriais

O que virou a chave pra mim foi justamente o que mostrei no passo a passo: apontar o Claude Code direto pra pasta do cofre e deixar a IA cuidar da organização

Foi aí que eu finalmente enxerguei valor real na coisa

No vídeo abaixo eu mostro o setup completo

A integração que eu apresento é basicamente abrir a pasta do cofre dentro do Claude Code, dando à IA acesso pleno a todos os arquivos markdown

Eu criei um cofre novo do zero pelo próprio Obsidian, batizei de ‘meu segundo cérebro’, mas se você já tem um cofre, dá pra usar o seu de boa

Daí eu parto pra criar um CLAUDE.md como contexto do projeto Obsidian, do mesmo jeito que a gente faz nos projetos web, pra amarrar tudo

No prompt eu descrevi a estrutura de pastas que eu queria (inbox, projetos, pesquisa, roteiros, referência, diário, templates) e pedi templates reutilizáveis pra cada tipo de nota

Uma coisa que eu bato o pé: nomes de arquivo sem acento e sem espaço, com hífens

Isso evita um monte de dor de cabeça de acesso e edição por qualquer das partes

Já me poupou de treta

Pra conferir se a estrutura funcionava, eu ainda pedi dados de exemplo: projetos fictícios em status diferentes, notas de pesquisa e notas diárias com referências cruzadas

Fui confirmando as ações no Claude Code enquanto os arquivos apareciam, e depois validei no próprio Obsidian que os projetos, referências e roteiros de exemplo estavam lá

No fim, foi ligar o Claude Code direto no cofre e deixar ele organizar que me fez ver valor no Obsidian e montar um segundo cérebro consultável de verdade, sem a fricção que antes me afastava

Próximo passo

O recado que fica é simples: o valor não está em arquivar, está em consultar

Um cofre gigante que ninguém pergunta nada continua sendo um cemitério de notas, por mais bonito que seja o graph view

Começa pequeno

Aponta o Claude Code pra um cofre que você já tem e escreve seu primeiro CLAUDE.md explicando como ele deve navegar suas notas

Faz uma pergunta boba, dessas que você sabe que a resposta está em algum arquivo perdido, e vê ele te responder citando a própria nota

Quando isso acontecer, você vai entender na prática o que é ter um segundo cérebro com IA de verdade…