01 Qué es y qué problema resuelve
Cada conversación con Claude empieza en blanco. Lo que investigaste la semana pasada, las conclusiones de una reunión o el resumen de un informe se pierden si no los guardas en algún sitio que Claude pueda leer después. Obsidian es una aplicación gratuita que trata una carpeta de archivos Markdown como un cuaderno con enlaces entre notas, y claude-obsidian le enseña a Claude Code a mantener esa carpeta.
El enfoque sigue el patrón de «wiki gestionada por un modelo»: tú aportas material en bruto, Claude lo digiere en páginas enlazadas que citan su origen, y cuando preguntas responde con tus propias notas, no con lo que recuerda de su entrenamiento. Todo son archivos normales en tu disco; nada se sube a una base de datos en la nube.
02 Instalación
-
1
Instala Obsidian
Desde su web oficial. No necesitas cuenta ni plugins de la comunidad.
-
2
Comprueba Python y Claude Code
python3 --version debe devolver 3.11 o más. Actualiza Claude Code a la última versión, porque el plugin usa ganchos (hooks) recientes.
-
3
Añade el marketplace e instala el plugin
Son dos comandos en la terminal; el tercero confirma que aparece en la lista.
-
4
Crea una carpeta para tu vault
Distinta de cualquier repositorio. El plugin nunca usa su propia carpeta de instalación como vault.
-
5
Arranca Claude Code dentro del vault y ejecuta el comando wiki
Prepara o adopta la estructura, comprueba que todo está listo y te orienta sobre el siguiente paso.
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian
claude plugin listmkdir -p ~/Documents/MiConocimiento && cd ~/Documents/MiConocimiento
claude
# ya dentro de Claude Code:
/claude-obsidian:wikiAbre después esa carpeta en Obsidian con «Abrir carpeta como vault». Verás inbox/ (bandeja de entrada de fuentes), .raw/ (copias inmutables de cada fuente), wiki/ (índice, registro, memoria rápida y las notas generadas) y un archivo .claude-obsidian.json que identifica el vault. Si ya tienes un vault de Obsidian, el flujo adopt del repositorio lo integra sin tocar tus notas.
03 Las skills que usarás a diario
| Skill en Claude Code | Qué hace |
|---|---|
| /claude-obsidian:wiki-ingest | Convierte lo que hay en inbox/ en páginas enlazadas y registros de procedencia. |
| /claude-obsidian:wiki-query | Responde solo leyendo el vault, sin modificarlo. |
| /claude-obsidian:save | Guarda una respuesta o conclusión concreta de la conversación (no la transcripción entera). |
| /claude-obsidian:autoresearch | Investigación web acotada sobre un tema, con permiso explícito para salir a internet. |
| /claude-obsidian:canvas | Crea mapas visuales en Obsidian Canvas a partir de partes del wiki. |
| /claude-obsidian:wiki-lint | Detecta enlaces rotos, notas huérfanas, metadatos que faltan e índices desactualizados. |
| /claude-obsidian:wiki-mode | Cambia la forma de archivar las notas nuevas: genérica, PARA, Zettelkasten o LYT. |
04 El ciclo de trabajo
-
1
Captura
Deja en inbox/ el PDF, el artículo limpio o las notas de la reunión.
-
2
Ingiere
Ejecuta wiki-ingest. Claude crea o actualiza conceptos, entidades y fuentes, y los enlaza con lo que ya había.
-
3
Consulta
Pregunta con wiki-query antes de investigar de nuevo: quizá ya lo sabías.
-
4
Guarda lo valioso
Cuando una conversación produzca una conclusión útil, guárdala con save.
-
5
Mantén
Pasa wiki-lint de vez en cuando para que el vault no se degrade.
/claude-obsidian:wiki-ingest He dejado en inbox/ tres documentos del cliente [nombre]: la propuesta firmada, el acta de arranque y su guía de marca. Crea una entidad para el cliente, conceptos para cada línea de trabajo y enlaza las decisiones del acta con la propuesta. Señala cualquier contradicción entre documentos en lugar de resolverla tú./claude-obsidian:wiki-query ¿Qué hemos decidido sobre [tema] en los últimos proyectos? Responde solo con lo que esté en el vault, cita las notas de las que sale cada punto y dime qué falta por documentar.05 Seguridad y buenas prácticas
- ✓Usa un vault separado por ámbito (personal, empresa, cliente sensible) para no mezclar información confidencial.
- ✓Versiona el vault con Git o haz copias de seguridad: el plugin protege cada operación, pero no sustituye a un backup.
- ✓La salida a internet (autoresearch, modelos remotos) requiere consentimiento explícito; revisa qué se envía antes de aceptarlo con documentos confidenciales.
- ✓Las operaciones que escriben se aplican como una transacción recuperable: si algo falla, se restaura el estado anterior.
- ✓PDF y EPUB se capturan con metadatos, pero el plugin no extrae su texto por sí solo: pásalos antes a Markdown o texto si quieres que se analicen a fondo.
- ✓En Windows nativo solo funcionan las consultas y simulaciones; para escribir en el vault usa WSL.
Preguntas frecuentes
No. Obsidian es gratuito y el plugin tiene licencia MIT. Solo pagas el uso de Claude que ya tengas.
Sí. El flujo adopt del repositorio analiza tu vault y propone solo los archivos que faltan, sin reescribir tus notas ni la configuración de Obsidian.
Sí. Sus skills siguen el estándar Agent Skills y el repositorio incluye un script para enlazarlas en Codex, OpenCode, Gemini, Cursor y otros.
La memoria guarda preferencias y contexto breve. Aquí construyes una base de conocimiento completa, con fuentes citadas y enlaces, que puedes leer y editar tú mismo en Obsidian.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.