O que é claude-obsidian?
O claude-obsidian é um plugin de Claude Code e uma CLI em Python que transforma fontes colocadas em uma pasta de entrada em páginas do Obsidian vinculadas e com citações, e depois responde a perguntas a partir do que o vault já contém. Ele segue o padrão "LLM Wiki" de Andrej Karpathy e arquiva as notas em um de quatro layouts: genérico, LYT, PARA ou Zettelkasten.
Traz 15 skills e 3 agentes, incluindo wiki, wiki-ingest, wiki-query, wiki-lint e uma skill de autoresearch que exige consentimento. Cada gravação é mostrada como um plano e só é aplicada com o hash desse plano, dentro de uma transação registrada em journal que pode ser revertida. As mesmas skills rodam no Codex, OpenCode, Gemini, ZCode, Cursor e Windsurf por meio de um script de configuração.
A versão 3.0.0 renomeou o plugin por um breve período para agricidaniel-obsidian, porque o Claude Code reserva nomes que começam com claude-; a v3.0.1 restaurou o nome original no mesmo dia.
claude-obsidian vale a pena?
Esta é a forma mais preocupada com segurança que encontramos de deixar o Claude Code manter um vault do Obsidian, e a segurança é também o que o torna lento de configurar. O repositório tem cerca de 15,700 estrelas e lançou a v3.0.0 e a v3.0.1 em 21 de outubro de 2026. A primeira renomeou o plugin porque o Claude Code agora reserva nomes que começam com claude-; a segunda restaurou o nome antigo como exceção deliberada. As próprias notas de versão admitem que o validador do Claude Code ainda acusa o nome como reservado e que claude plugin tag o recusa, então uma versão futura do Claude Code pode forçar a troca de novo. Vários projetos usam nomes parecidos; esta avaliação trata do de AgriciDaniel.
O caminho de gravação é construído como o de um banco de dados. O vault é escolhido explicitamente, por uma variável de ambiente ou um arquivo .claude-obsidian.json, e a ferramenta sai sem gravar se tiver dúvida. As mudanças são planejadas, aprovadas por hash e registradas em journal, e uma edição feita no Obsidian no meio de um plano interrompe a gravação com um conflito. O README é honesto ao dizer que seu lock só coordena gravadores locais cooperativos: dispositivos sincronizados ficam de fora, então backups continuam importando.
O que ele lê é mais restrito do que a proposta. PDFs e EPUBs recebem metadados e um hash, sem extração de texto. Páginas web e YouTube viram um plano que exige um executor separado, OCR exige uma ferramenta externa, e o Windows nativo se recusa a gravar, então usuários de Windows precisam do WSL. Desde a 3.0.0, os prefixos contextuais não recorrem mais ao claude -p; sem um provedor de API ou Ollama local configurado, eles ficam sintéticos.
Duas issues abertas apontam para a escala. Uma pergunta como um corpus crescente cabe no limite rígido de leitura de 16 MB dos ledgers de fontes e de afirmações; outra relata hooks de sessão no Windows batendo no timeout de 5 segundos. Nenhuma tem resposta na documentação ainda, e as avaliações independentes continuam escassas, quase só o blog do autor e textos curtos de diretórios, como o do Heatdrop.
A parte de dados é limpa: sem telemetria, Markdown simples em disco, e nada sai da máquina além do que o próprio Claude Code envia à Anthropic. Ao lado do claude-mem, que registra sessões de programação, este é uma biblioteca de pesquisa, e só compensa a configuração quando as fontes que você lê são justamente o que você quer guardar.
Onde ele se destaca
Uma doutoranda com algumas centenas de artigos já anotados no Obsidian
Fazer perguntas sobre a literatura e receber respostas citando as fontes
Adotar o vault existente sem mover notas, colocar material novo em inbox/ e rodar wiki-ingest e wiki-query. PDFs só rendem metadados, então o texto precisa ser extraído ou colado antes; o único custo é o plano do Claude Code.
Uma consultoria de pesquisa de duas pessoas que compartilha um vault por um serviço de sincronização
Manter a pesquisa dos clientes vinculada e sem links quebrados
O wiki-lint aponta links quebrados, páginas órfãs e seções vazias. O lock de gravação não cobre outros dispositivos, então cada pessoa precisa de backups, e uma issue aberta relata pastas fantasmas quando as transações rodam no iCloud Drive sob WSL.
Um gestor de conhecimento em uma empresa que proíbe bancos de notas na nuvem
Usar um assistente de IA nas notas internas mantendo os arquivos em disco
O vault continua como Markdown local sem telemetria, e a pesquisa na web exige consentimento por tarefa. As notas que o Claude lê ainda vão para a Anthropic, sob os termos do plano Claude da empresa, e funcionários no Windows precisam do WSL para gravar.
Antes de decidir
- Configuração
- claude plugin marketplace add AgriciDaniel/claude-obsidian, depois claude plugin install claude-obsidian@agricidaniel-claude-obsidian; exige Python 3.11+ e o Obsidian para visualização. /claude-obsidian:wiki mostra uma prévia do plano do vault e só o cria após aprovação.
- Integrações
- Plugin completo para o Claude Code; as mesmas Agent Skills se conectam ao Codex, OpenCode, Gemini, ZCode, Cursor e Windsurf via scripts/setup-multi-agent.sh. Obsidian CLI opcional para busca; ainda sem servidor MCP (há um pedido de recurso aberto).
- Dados e privacidade
- O vault é Markdown local; o README afirma não haver telemetria nem banco de dados na nuvem. As notas que o Claude lê são enviadas à Anthropic como em qualquer sessão do Claude Code; pesquisa na web e modelos remotos exigem consentimento por tarefa. MIT; nenhum alerta de segurança publicado.
- Custo em escala
- Não há edição paga. O custo é o plano do agente, e ele cresce com quantas notas cada ingestão ou consulta puxa para o contexto, não com alguma taxa do claude-obsidian.
- Limites
- Só metadados para PDF e EPUB; URLs e OCR exigem executores externos; o Windows nativo é só leitura; limite de leitura de 16 MB nos ledgers; duas trocas de nome do plugin em um dia mostram que a questão do nome não está resolvida.
O que é bom
- Vault em Markdown simples que é seu, sem telemetria
- Gravações planejadas, aprovadas por hash e reversíveis
- Afirmações vinculadas às cópias armazenadas das fontes
- Pesquisa na web e modelos remotos desligados por padrão
O que não é
- Sem extração de texto de PDF ou EPUB
- O Windows nativo não grava; exige WSL
- Nome do plugin acusado como reservado pelo Claude Code
- Limite de 16 MB nos ledgers levantado como problema de escala
Ideal para
Usuários do Obsidian que querem que o Claude Code construa e consulte uma wiki de pesquisa com citações.
Alternativas ao claude-obsidian
claude-obsidian: perguntas frequentes
- claude-obsidian vale a pena?
- O claude-obsidian trata um vault de notas como um banco de dados, com transações e citações, o que o torna confiável e lento de adotar. Damos nota 3.8 de 5.
- Quanto custa claude-obsidian?
- Gratuito e de código aberto (MIT). Você paga o uso de modelo do seu agente.
- Quais são as desvantagens de claude-obsidian?
- Sem extração de texto de PDF ou EPUB; o Windows nativo não grava; exige WSL; nome do plugin acusado como reservado pelo Claude Code; limite de 16 MB nos ledgers levantado como problema de escala.
- Para quem claude-obsidian é indicado?
- Usuários do Obsidian que querem que o Claude Code construa e consulte uma wiki de pesquisa com citações.
- Quanto custa claude-obsidian para uma equipe ou em produção?
- Não há edição paga. O custo é o plano do agente, e ele cresce com quantas notas cada ingestão ou consulta puxa para o contexto, não com alguma taxa do claude-obsidian.
- claude-obsidian é seguro para dados da empresa?
- O vault é Markdown local; o README afirma não haver telemetria nem banco de dados na nuvem. As notas que o Claude lê são enviadas à Anthropic como em qualquer sessão do Claude Code; pesquisa na web e modelos remotos exigem consentimento por tarefa. MIT; nenhum alerta de segurança publicado.
- Quais são as melhores alternativas ao claude-obsidian?
- As alternativas mais próximas que analisamos são claude-mem, notebooklm-py e Graphify.
Respostas verificadas em 26 de out. de 2026.