¿Qué es claude-obsidian?
claude-obsidian es un plugin de Claude Code y una CLI de Python que convierte las fuentes dejadas en una carpeta de entrada en páginas de Obsidian enlazadas y con citas, y luego responde preguntas a partir de lo que ya contiene el vault. Sigue el patrón "LLM Wiki" de Andrej Karpathy y archiva las notas en una de cuatro estructuras: genérica, LYT, PARA o Zettelkasten.
Incluye 15 skills y 3 agentes, entre ellos wiki, wiki-ingest, wiki-query, wiki-lint y una skill autoresearch que requiere consentimiento. Cada escritura se muestra como un plan y solo se aplica con el hash de ese plan, dentro de una transacción registrada en un diario que puede deshacerse. Las mismas skills funcionan en Codex, OpenCode, Gemini, ZCode, Cursor y Windsurf mediante un script de configuración.
La versión 3.0.0 cambió brevemente el nombre del plugin a agricidaniel-obsidian porque Claude Code reserva los nombres que empiezan por claude-; la v3.0.1 recuperó el nombre original el mismo día.
¿Merece la pena claude-obsidian?
Es la forma más centrada en la seguridad que hemos encontrado de dejar que Claude Code mantenga un vault de Obsidian, y esa seguridad es también lo que lo hace lento de configurar. El repositorio tiene unas 15.700 estrellas y publicó la v3.0.0 y la v3.0.1 el 21 de octubre de 2026. La primera cambió el nombre del plugin porque Claude Code ahora reserva los nombres que empiezan por claude-; la segunda recuperó el nombre anterior como excepción deliberada. Sus propias notas de versión admiten que el validador de Claude Code sigue marcando el nombre como reservado y que claude plugin tag lo rechaza, así que una versión futura de Claude Code podría forzar otra vez el cambio de nombre. Varios proyectos usan nombres parecidos; esta reseña trata el de AgriciDaniel.
El camino de escritura está construido como el de una base de datos. El vault se elige de forma explícita, con una variable de entorno o un archivo .claude-obsidian.json, y la herramienta sale sin escribir si tiene dudas. Los cambios se planifican, se aprueban por hash y se registran en un diario, y una edición hecha en Obsidian a mitad del plan detiene la escritura con un conflicto. El README admite con honestidad que su bloqueo solo coordina escritores locales que cooperan: los dispositivos sincronizados quedan fuera, así que las copias de seguridad siguen importando.
Lo que lee es más limitado de lo que sugiere su presentación. Los PDF y EPUB reciben metadatos y un hash, sin extracción de texto. Las páginas web y YouTube se convierten en un plan que necesita un ejecutor aparte, el OCR necesita una herramienta externa y Windows nativo se niega a escribir, así que los usuarios de Windows necesitan WSL. Desde la 3.0.0, los prefijos contextuales ya no recurren a claude -p; sin un proveedor de API o un Ollama local configurado se quedan sintéticos.
Dos incidencias abiertas apuntan a la escala. Una pregunta cómo encaja un corpus creciente en el límite estricto de lectura de 16 MB de los registros de fuentes y afirmaciones; otra informa de que los hooks de sesión en Windows alcanzan su tiempo de espera de 5 segundos. Ninguna tiene respuesta todavía en la documentación, y las reseñas independientes siguen siendo escasas, sobre todo el blog del autor y breves fichas de directorios como la de Heatdrop.
En cuanto a datos, está limpio: sin telemetría, Markdown plano en disco y nada sale de la máquina salvo lo que el propio Claude Code envía a Anthropic. Frente a claude-mem, que registra sesiones de programación, esto es una biblioteca de investigación, y solo compensa la configuración cuando las fuentes que lees son lo que quieres conservar.
Dónde se gana su sitio
Una doctoranda con unos cientos de artículos ya anotados en Obsidian
Hacer preguntas sobre la bibliografía y obtener respuestas citadas a sus fuentes
Adopta el vault existente sin mover notas, deja el material nuevo en inbox/ y ejecuta wiki-ingest y wiki-query. Los PDF solo aportan metadatos, así que antes hay que extraer o pegar el texto; el único coste es el plan de Claude Code.
Una consultora de investigación de dos personas que comparte un vault mediante un servicio de sincronización
Mantener la investigación de clientes enlazada y sin enlaces rotos
wiki-lint informa de enlaces rotos, páginas huérfanas y secciones vacías. El bloqueo de escritura no cubre otros dispositivos, así que cada persona necesita copias de seguridad, y una incidencia abierta informa de carpetas fantasma cuando las transacciones se ejecutan en iCloud Drive bajo WSL.
Un gestor del conocimiento en una empresa que prohíbe las bases de datos de notas en la nube
Usar un asistente de IA con notas internas manteniendo los archivos en disco
El vault sigue siendo Markdown local sin telemetría, y la investigación web necesita consentimiento por tarea. Las notas que lee Claude siguen yendo a Anthropic según las condiciones del plan de Claude de la empresa, y el personal con Windows necesita WSL para escribir.
Antes de decidirte
- Puesta en marcha
- claude plugin marketplace add AgriciDaniel/claude-obsidian, y luego claude plugin install claude-obsidian@agricidaniel-claude-obsidian; requiere Python 3.11+ y Obsidian para ver el resultado. /claude-obsidian:wiki muestra una vista previa del plan del vault y solo lo crea tras la aprobación.
- Integraciones
- Plugin completo para Claude Code; las mismas Agent Skills se enlazan en Codex, OpenCode, Gemini, ZCode, Cursor y Windsurf mediante scripts/setup-multi-agent.sh. Obsidian CLI opcional para buscar; todavía sin servidor MCP (hay una petición de función abierta).
- Datos y privacidad
- El vault es Markdown local; el README afirma que no hay telemetría ni base de datos en la nube. Las notas que lee Claude se envían a Anthropic como en cualquier sesión de Claude Code; la investigación web y los modelos remotos necesitan consentimiento por tarea. MIT; sin avisos de seguridad publicados.
- Coste a escala
- No hay edición de pago. El coste es el plan del agente, y crece con cuántas notas mete en el contexto cada ingesta o consulta, no con ninguna tarifa de claude-obsidian.
- Límites
- Solo metadatos para PDF y EPUB; las URL y el OCR necesitan ejecutores externos; Windows nativo es de solo lectura; límite de lectura de 16 MB en los registros; dos cambios de nombre del plugin en un día muestran que la cuestión del nombre no está resuelta.
Lo bueno
- Vault en Markdown plano que es tuyo, sin telemetría
- Escrituras planificadas, aprobadas por hash y reversibles
- Afirmaciones enlazadas a copias guardadas de las fuentes
- Investigación web y modelos remotos desactivados por defecto
Lo malo
- Sin extracción de texto de PDF ni EPUB
- Windows nativo no puede escribir; necesita WSL
- Claude Code marca el nombre del plugin como reservado
- El límite de 16 MB en los registros se ha planteado como problema de escala
Ideal para
Usuarios de Obsidian que quieren que Claude Code construya y consulte una wiki de investigación con citas.
Alternativas a claude-obsidian
claude-obsidian: preguntas frecuentes
- ¿Merece la pena claude-obsidian?
- claude-obsidian trata un vault de notas como una base de datos, con transacciones y citas, lo que lo hace fiable y lento de adoptar. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta claude-obsidian?
- Gratuito y de código abierto (MIT). Pagas el uso de modelo de tu agente.
- ¿Qué inconvenientes tiene claude-obsidian?
- Sin extracción de texto de PDF ni EPUB; windows nativo no puede escribir; necesita WSL; claude Code marca el nombre del plugin como reservado; el límite de 16 MB en los registros se ha planteado como problema de escala.
- ¿Para quién es claude-obsidian?
- Usuarios de Obsidian que quieren que Claude Code construya y consulte una wiki de investigación con citas.
- ¿Cuánto cuesta claude-obsidian para un equipo o en producción?
- No hay edición de pago. El coste es el plan del agente, y crece con cuántas notas mete en el contexto cada ingesta o consulta, no con ninguna tarifa de claude-obsidian.
- ¿Es claude-obsidian seguro para los datos de la empresa?
- El vault es Markdown local; el README afirma que no hay telemetría ni base de datos en la nube. Las notas que lee Claude se envían a Anthropic como en cualquier sesión de Claude Code; la investigación web y los modelos remotos necesitan consentimiento por tarea. MIT; sin avisos de seguridad publicados.
- ¿Cuáles son las mejores alternativas a claude-obsidian?
- Las alternativas más cercanas que hemos analizado son claude-mem, notebooklm-py y Graphify.
Respuestas comprobadas el 26 oct 2026.