O Claude Code pode ler arquivos. O Obsidian armazena arquivos. Junte-os e você tem um assistente de pesquisa com IA que sabe tudo no seu vault --- cada nota, cada web clip, cada artigo salvo.

Este guia mostra como conectar o Claude Code ao seu vault Obsidian e começar a fazer perguntas em toda a sua base de conhecimento.

Por Que Esta Combinação Funciona

O Obsidian armazena tudo como arquivos Markdown em uma pasta no seu computador. O Claude Code pode ler qualquer pasta a que você der acesso. Quando você aponta o Claude Code para o seu vault Obsidian:

O Claude pode pesquisar em milhares de notas
Ele entende Markdown nativamente (títulos, links, tags, frontmatter)
Pode fazer referências cruzadas entre fontes e encontrar conexões que você perderia
Pode escrever novas notas e atualizar existentes
Tem o contexto completo do seu conhecimento, não apenas o que cabe em uma janela de chat

Esta é a configuração que Andrej Karpathy descreveu para pesquisa com IA --- um wiki pessoal que um LLM pode pesquisar. Obsidian + Claude Code é a implementação mais prática.

Passo 1: Configure Seu Vault para IA

Seu vault Obsidian existente provavelmente funciona como está. Mas algumas dicas de organização ajudam o Claude a trabalhar melhor:

Use nomes de arquivo descritivos. meeting-notes-2026-04-12.md é melhor que untitled-3.md. O Claude escaneia nomes de arquivo ao pesquisar.

Use frontmatter. Tags, datas e descrições no frontmatter YAML ajudam o Claude a entender sobre o que é cada nota:

---
title: React Server Components Deep Dive
tags: [react, architecture, frontend]
date: 2026-04-10
source: https://example.com/article
---

Organize por tópico, não por data. Pastas como research/, projects/, references/ são mais úteis para o Claude do que ordenação cronológica.

Passo 2: Alimente Seu Vault com Conteúdo Web Usando Save

A maior limitação da maioria dos vaults Obsidian é que contêm apenas o que você digitou manualmente. Seu melhor conhecimento está espalhado pela web --- artigos, documentação, vídeos do YouTube, tweets, threads do Reddit.

O Save é uma extensão Chrome que converte qualquer página web para Markdown limpo. Salve uma página, e o arquivo Markdown vai para a sua pasta Save Vault. Faça um symlink dessa pasta no seu vault Obsidian, e toda página web que você salva se torna uma nota Obsidian pesquisável.

O Save captura:

Artigos e posts de blog
Vídeos do YouTube (transcrições completas)
Threads do Twitter/X
Posts e discussões do Reddit
Documentação e referências de API
Artigos acadêmicos
Páginas do Confluence e wikis

Cada save é um arquivo .md limpo com frontmatter adequado --- pronto para Obsidian e Claude.

Passo 3: Conecte o Claude Code

Abra seu terminal e inicie o Claude Code no diretório do seu vault:

cd /path/to/your/obsidian-vault
claude

Só isso. O Claude Code agora tem acesso a cada arquivo no seu vault. Pergunte qualquer coisa:

“Quais são os principais pontos dos artigos que salvei sobre estratégia de distribuição?”
“Encontre todas as notas relacionadas ao desempenho do React e resuma os padrões principais”
“Que conexões existem entre minhas notas de reunião da semana passada e o roadmap do produto?”
“Crie um documento de resumo de tudo que salvei sobre frameworks de precificação”

Passo 4: Use MCP para Acesso Sempre Ativo

Se você usa Claude Desktop em vez de Claude Code, configure o servidor MCP de filesystem:

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/obsidian-vault"
      ]
    }
  }
}

Agora o Claude Desktop pode ler seu vault sob demanda durante qualquer conversa. O Save também tem seu próprio servidor MCP que dá ao Claude acesso direto às suas páginas web salvas.

Como Parece na Prática

Segunda-feira: Você salva 3 artigos sobre estratégias de precificação de concorrentes usando o Save. Eles pousam automaticamente no seu vault Obsidian.

Quarta-feira: Você salva uma transcrição de vídeo do YouTube de uma conferência sobre go-to-market. Ela se junta à coleção.

Sexta-feira: Você abre o Claude Code no seu vault e pergunta: “Com base em tudo que salvei esta semana, que estratégia de precificação devemos considerar para nosso novo produto?”

O Claude lê todos os 4 documentos, faz referências cruzadas, e dá uma resposta fundamentada na sua pesquisa curada --- não em dados de treinamento genéricos.

Com o tempo: Seu vault cresce para centenas de notas e páginas salvas. O Claude se torna um assistente de pesquisa que conhece todo o seu domínio. Quanto mais você salva, mais inteligente fica.

O Efeito Composto

Esta configuração compõe. Cada nova nota e cada página web salva torna o Claude mais útil. Depois de alguns meses:

Você tem um arquivo pesquisável de tudo que leu
O Claude pode responder perguntas sintetizando toda a sua coleção
Seu vault Obsidian se torna um segundo cérebro genuíno --- que uma IA pode realmente ler
Você para de perder conhecimento para favoritos esquecidos e acumulação de abas

Começando

Instale o Save para começar a clipar páginas web como Markdown
Configure a pasta Save Vault dentro ou ao lado do seu vault Obsidian
Abra o Claude Code no seu vault: cd vault && claude
Comece a fazer perguntas na sua base de conhecimento

A melhor base de conhecimento com IA é a que você realmente constrói. Save + Obsidian + Claude Code torna isso sem esforço.