Claude Code ou plugin de IA no Obsidian: qual usar no seu second brain?

Fala aí, beleza? Se teu vault já tem nota demais e tu quer IA trabalhando ali dentro, a pergunta não é qual modelo é mais esperto

É ONDE ele roda

De um lado, um agente de terminal que abre a pasta do cofre e edita os arquivos por fora do app

Do outro, um plugin que vive dentro da interface do Obsidian, no mesmo painel onde tu lê a nota

E tem um detalhe que destrava a discussão inteira: um vault do Obsidian é só uma pasta local do teu computador, com os arquivos .md e uma subpasta de configuração .obsidian

Ou seja, qualquer agente que saiba ler e escrever arquivo já consegue trabalhar ali, sem plugin nenhum no meio

A escolha, então, é sobre FLUXO de trabalho, não sobre acesso 🙂

Claude Code x plugin de IA no Obsidian: comparação direta

Do lado dos plugins, o licenciamento também entra na conta: o Copilot for Obsidian tem front-end open source e back-end proprietário

A licença do Smart Connections merece um parágrafo à parte, porque virou discussão pública: a MIT com cláusula de não concorrência não atende à definição de código aberto

Se isso importa pro teu caso (empresa, fork, produto em cima), vale ler antes de adotar

O que cada caminho exige antes de você escolher

Antes do gosto pessoal, tem o custo de entrada de cada lado

Lado Claude Code:

Os requisitos de sistema oficiais são macOS 10.15+, Ubuntu 20.04+ ou Debian 10+, ou Windows 10+ (WSL 1, WSL 2 ou Git for Windows), 4 GB de RAM e Node.js 18+

A instalação recomendada é o instalador nativo:

curl -fsSL https://claude.ai/install.sh | bash

E a documentação desaconselha o caminho que muita gente tenta primeiro, o sudo npm install -g

Tome cuidado no Windows: o Git precisa estar instalado pras sessões locais do app de desktop funcionarem

Se a sessão local simplesmente não sobe na tua máquina, esse é o primeiro suspeito, antes de sair reinstalando tudo

Já dentro do app de desktop, a pasta do cofre é apontada na aba Code, opção Local, botão Select folder

É literalmente escolher a pasta do vault e pronto, o agente passa a enxergar teus .md

Se tu quer o caminho detalhado, eu já mostrei o Claude Code com Obsidian por aqui

Lado plugin:

Aqui o custo de entrada é bem menor, porque a instalação acontece dentro do próprio Obsidian

O Smart Connections (brianpetro/obsidian-smart-connections) roda com um modelo de embeddings local, sem chave de API

O Copilot for Obsidian tem plano gratuito que funciona com a assinatura ou as chaves de API do próprio usuário

Ou seja: dá pra experimentar os dois lados sem pagar nada de cara, só com o que tu já tem

E uma nota pra quem usa o Obsidian no trabalho: a licença comercial não é obrigatória, a compra é incentivada de forma voluntária

Escrita em lote, revisão e uso diário: onde cada um ganha

Escrita em lote:

Esse é o ponto onde o agente de terminal abre vantagem, e não é sutil

Ele enxerga a pasta inteira, cria arquivo novo, reescreve arquivo velho e atualiza índice geral na mesma rodada

No app de desktop ainda dá pra manter múltiplas sessões em paralelo, com editor e terminal integrados, então tu toca uma reorganização enquanto acompanha outra

Plugin dentro do app não nasceu pra isso: ele nasceu pra te ajudar NA nota

Revisão do que foi alterado:

Aqui mora a parte que quase ninguém olha antes de dar permissão pra uma IA mexer em anos de anotação

O Claude Code tem revisão visual de diff e checkpoints

O menu de rewind abre com o comando /rewind ou apertando Esc duas vezes com o campo de prompt vazio, e ele lista os prompts da sessão com quatro ações: Restaurar código e conversa, Restaurar conversa, Restaurar código e Resumir a partir daqui

Agora os limites, porque isso é importante e raramente é dito:

• os checkpoints só registram alterações feitas pelas ferramentas de edição de arquivo do Claude, então mudança feita por comando Bash ou por processo externo NÃO é capturada
• symlink e hard link ficam de fora da restauração: esses caminhos são pulados e aparece um aviso
• os checkpoints ficam salvos junto com a conversa e são apagados com as sessões depois de 30 dias, período ajustável na configuração cleanupPeriodDays

Do lado dos plugins, não existe uma camada de diff nativa equivalente documentada, o que muda o jeito de trabalhar: tu revisa a nota, não a rodada

Conforto no dia a dia:

E aqui o plugin devolve o golpe

Perguntar pras tuas notas sem trocar de janela é uma diferença pequena que aparece o dia inteiro

Busca por similaridade com embedding local, resposta no mesmo painel onde a nota vive, zero context switch

Se teu uso é consultar e conectar ideia, isso vale mais do que qualquer poder de edição em massa

Como isso funcionou no meu vault

Eu mantenho 2 cofres do Obsidian só pros tutoriais, justamente pra não brincar de IA no cofre que importa

No vídeo eu sigo um passo a passo de um Gist que transforma o cofre numa base de conhecimento consultada por LLM

A configuração é quase constrangedora de simples: abro o Claude Code na pasta do cofre, colo o conteúdo do Gist e peço pra ele configurar o vault

Ele mesmo montou a estrutura de pastas, uma pra conteúdo cru e outra pra wiki com o conteúdo já processado, sem eu criar nada na mão

Pra encher a pasta de conteúdo cru eu usei o Web Clipper no Chrome, que converte o artigo do site em markdown e joga direto no cofre

(quando o envio direto pro Obsidian aberto não rolar, salva o arquivo markdown e move pra pasta na mão, resolve)

Depois foi só pedir pra compilar o conteúdo cru pra wiki seguindo o esquema do método

O Claude Code identificou 4 fontes na pasta e gerou 19 páginas na wiki a partir desses artigos, separando por fontes, modelos, entidades e conceitos, e ainda atualizou os arquivos gerais do cofre

Isso é escrita em lote na prática: eu acompanhei os arquivos nascendo em tempo real dentro do Obsidian, com o grafo se conectando sozinho conforme os pontos em comum apareciam

Durante a configuração e durante a compilação ele pediu confirmação e permissão em vários momentos, e é EXATAMENTE aí que a camada de revisão importa

O que eu sinto na prática é o que o método promete: tudo em markdown local, sem banco vetorial, sem servidor, sem infra, e portátil (dá pra versionar em Git ou salvar na nuvem)

O loop é adicionar fonte nova, mandar compilar, consultar

A base vai condensando e ficando mais refinada, e o que sobra pra mim é a curadoria

Veja o método rodando no vídeo

No vídeo abaixo eu mostro a coisa inteira acontecendo: a configuração pelo Gist, o clip dos artigos, o comando de compilação e a wiki sendo escrita ao vivo dentro do Obsidian

Dá pra ver o momento em que ele pede permissão e o momento em que o grafo começa a conectar os conceitos entre si

Se tu é do time que só acredita vendo, é esse pedaço aí 😀

Veredito: qual escolher pelo seu perfil de uso

Não tem vencedor único aqui, tem perfil

Tu produz conteúdo e reorganiza muito arquivo? Agente de terminal, sem dúvida

A edição em lote e a camada de revisão (diff visual + checkpoints) resolvem o problema real de mexer em dezenas de notas de uma vez sem perder o controle

Tu consulta e conecta notas ao longo do dia? Plugin dentro do app

O ganho tá no conforto, e Smart Connections com embedding local não te cobra chave de API pra isso

Tu quer os dois? As pontes existem, os plugins de comunidade fazem esse meio de campo

Só registra na cabeça: Claude Code IDE, Claude Code IDE Pro e o obsidian-claude-code-mcp são de desenvolvedores independentes, não da Anthropic nem da equipe do Obsidian

Isso não é demérito, é só um fator a pesar junto com licenciamento e custo antes de colocar no fluxo principal

Eu já falei sobre os limites de usar IA no segundo cérebro em outro post, e eles continuam valendo

E fecha com o alerta que eu faço questão de repetir: checkpoint NÃO é backup

Ele some junto com a sessão em 30 dias, não pega o que foi feito por Bash ou processo externo, e não reverte symlink nem hard link

Backup de verdade é Git ou cópia do cofre, ponto

Próximo passo

A melhor forma de decidir isso não é lendo comparativo (nem o meu, haha), é fazendo um teste barato e reversível

Pega um cofre de rascunho, NUNCA o teu vault principal

Roda uma tarefa pequena pelo caminho que te pareceu mais a tua cara, tipo reorganizar cinco notas ou gerar um índice

E revisa o diff antes de aceitar qualquer coisa

Se o resultado te agradar, tu escala pro cofre de verdade já sabendo onde o agente erra

Se não agradar, tu perdeu 20 minutos e um cofre de mentira, beleza?

Dá uma olhada no vídeo pra ver o fluxo completo, e fica de olho por aqui que esse assunto ainda rende…

até o próximo post!