Obsidian + Claude: el setup completo

En este tutorial vas a dejar Obsidian y Claude Code trabajando juntos: tus notas viviendo en una carpeta de tu computadora y un agente de IA que las lee, las ordena y las conecta cuando se lo pedís. Es para vos si ya usás Claude Code para otras cosas y sentís que tu conocimiento personal está regado entre chats, capturas y documentos que nunca volvés a abrir.

Antes de empezar

• Obsidian instalado (la app es gratis, se descarga de su sitio oficial).
• Claude Code instalado y logueado (necesita plan de pago o créditos de API).
• Saber abrir una terminal y moverte a una carpeta. Nada más de técnica.
• Entre 30 y 45 minutos.

Paso 1 — Entendé por qué esta dupla funciona

Obsidian no guarda tus notas en una nube misteriosa ni en una base de datos cerrada: cada nota es un archivo de texto Markdown dentro de una carpeta común de tu compu (Obsidian la llama "bóveda"). Y Claude Code es un agente que lee y escribe archivos en carpetas.

¿Ves la jugada? Tu segunda memoria queda en un formato que la IA entiende de forma nativa. No hay integración que se rompa, no hay plugin que mantener: es un agente leyendo texto plano. Eso es todo el truco, y por eso es tan robusto.

Paso 2 — Creá la bóveda con estructura mínima

Abrí Obsidian, creá una bóveda nueva y armá solo estas carpetas:

mi-boveda/
├── 00-inbox/       ← todo lo nuevo cae acá
├── 10-notas/       ← notas permanentes, una idea por nota
├── 20-proyectos/   ← una nota por proyecto activo
└── 90-agente/      ← resúmenes y reportes que genera la IA

Resistí la tentación de armar veinte carpetas por tema. Cuanto más simple la estructura, mejor la navega el agente — y vos también.

Paso 3 — Abrí Claude Code dentro de la bóveda

En la terminal, entrá a la carpeta de la bóveda y lanzá el agente:

cd mi-boveda
claude

Esto importa: abrilo dentro de la bóveda, no en tu carpeta de usuario. Así el agente solo ve tus notas y nada más. Probá con algo simple:

"Leé mis notas y decime de qué temas escribo más."

Si te responde con contenido real de tus archivos, ya están conectados.

Paso 4 — Escribí el CLAUDE.md (el cerebro del setup)

En la raíz de la bóveda creá un archivo llamado CLAUDE.md. Claude Code lo lee automáticamente al arrancar: son las reglas de la casa. El mío dice algo así:

# Reglas de esta bóveda
- Todo en español, con mis palabras, sin jerga.
- Lo nuevo entra por 00-inbox; las notas definitivas van a 10-notas.
- Al conectar ideas, usá enlaces [[nombre de la nota]].
- Nunca borres una nota sin preguntarme.
- Los resúmenes que generes van a 90-agente con fecha en el nombre.

Diez o quince líneas alcanzan. Este archivo es la diferencia entre un agente que trabaja como vos querés y uno al que le repetís todo cada sesión.

Paso 5 — Ponelo a trabajar de verdad

Con el setup listo, estos son los tres pedidos que más uso:

• Ordenar: "Procesá lo que hay en 00-inbox: título claro a cada nota y movela a donde corresponde."
• Conectar: "Leé mi última nota y decime con qué notas existentes se relaciona. Agregá los enlaces."
• Resumir: "Armá un resumen de la semana con lo capturado, y guardalo en 90-agente."

Los enlaces [[así]] son la moneda de Obsidian: la vista de grafo te muestra tus ideas conectadas, y el agente es sorprendentemente bueno encontrando relaciones que vos no viste.

Paso 6 — Respaldá, porque el agente escribe

Esto no es opcional: le estás dando a una IA permiso de escribir en tu memoria personal. Un respaldo simple (copiar la carpeta a un disco externo o a tu nube de siempre) ya te salva. Si te animás a un paso más, git init dentro de la bóveda te da historial de cada cambio y podés volver atrás cualquier cosa que el agente haya tocado.

Errores comunes

• Abrir Claude Code en toda tu computadora en vez de la bóveda. Le das acceso de más y te responde con ruido de otros archivos. Siempre desde adentro de la carpeta.
• Dejar que reorganice todo el primer día. Mala idea: pedile primero "proponeme cómo ordenarías esto, sin tocar nada", revisá, y recién después que ejecute.
• CLAUDE.md kilométrico. Si las reglas ocupan tres pantallas, el agente empieza a ignorar cosas. Corto y concreto gana.
• Notas con nombres crípticos. "nota23-final-v2" no conecta con nada. Título descriptivo = mejores conexiones, para la IA y para vos.

Siguiente paso

Con la base andando, lo que sigue es el flujo de captura: cómo meter ideas al inbox en segundos desde donde estés, y armarte un ritual (diario o semanal) donde la IA procese, conecte y te devuelva un brief. Ahí es donde esto deja de ser un archivo bonito y se vuelve una memoria que trabaja para vos.