Claude Code y Obsidian: una bóveda para ti y tu agente

Por qué Claude Code y Obsidian encajan

Una bóveda de Obsidian es una carpeta normal de archivos de texto, sin base de datos de por medio. Por eso un agente puede trabajar en ella igual que tú.

Claude Code es un agente de IA que se ejecuta en el Terminal, en tu editor o en la app de escritorio, y trabaja en la carpeta donde lo inicias. Lee archivos, crea otros nuevos, modifica los existentes y ejecuta comandos. Inícialo en tu bóveda y tendrá delante todo tu segundo cerebro: resume actas de reuniones, añade enlaces que faltan, ordena una colección de fuentes o convierte tu esquema en un primer borrador que aparece como nota nueva en la carpeta correcta.

Esto no se limita a Claude Code. Codex, Cursor, Gemini CLI y otros agentes con acceso a archivos funcionan igual. Un chat en el navegador, en cambio, no ve tu bóveda a menos que copies archivos en él.

Configurar Claude Code en tu bóveda

Usa tu bóveda como directorio de trabajo

Claude Code trabaja en la carpeta donde lo inicias. Si tu bóveda está en iCloud Drive, en el Terminal queda así, por ejemplo:

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vault
claude

Decide a conciencia cuánto debe ver el agente. Para una primera prueba basta una subcarpeta, como la carpeta de un proyecto. Haz una copia de seguridad de tu bóveda antes de permitir cambios mayores: Claude Code puede deshacer sus propias ediciones de archivos, pero no los cambios hechos con comandos del Terminal. Git en tu bóveda o Time Machine cubren ese hueco.

Da acceso a las tareas de una carpeta enlazada

Si integras la carpeta de datos de TandemLoop en tu bóveda con un enlace simbólico, su ubicación real queda fuera del directorio de trabajo, y Claude Code pide permiso cada vez que escribe. Así que dale acceso también a esa carpeta: al iniciarlo con --add-dir, en una sesión en curso con /add-dir o de forma permanente en additionalDirectories de los ajustes:

claude --add-dir "<carpeta de TandemLoop>"

Cómo crear el enlace y por qué solo funciona en un Mac lo explica la guía Conecta tu segundo cerebro y tu lista de tareas.

CLAUDE.md: las reglas de tu bóveda

Al principio de cada sesión, Claude Code lee el archivo CLAUDE.md del directorio de trabajo y de las carpetas superiores. Contiene lo que el agente necesita saber de tu bóveda y lo que puede hacer. Ejecuta /init para crear un primer borrador y luego afínalo. Anthropic recomienda que el archivo sea breve, idealmente de menos de 200 líneas, y que solo recoja lo que el agente no puede averiguar por sí mismo.

# Bóveda

Bóveda de Obsidian con notas en Markdown. Enlaces como wikilinks [[Nota]].

## Carpetas
- Notas/: mis notas, cambiar solo si lo pido
- Curso online/: material y resultados del curso
- TandemLoop/: carpeta de datos de mi app de tareas (enlace)

## Reglas
- No borres ni renombres nunca una nota sin preguntar.
- Guarda los resultados como nota nueva en la carpeta que corresponda.
- No reestructures las propiedades del principio de un archivo.

## Tareas
Para las tareas, lee primero TandemLoop/AGENTS.md y sigue sus reglas.

Otros agentes suelen leer AGENTS.md en lugar de CLAUDE.md. Claude Code lee un AGENTS.md por su cuenta mientras no encuentre un CLAUDE.md. Si quieres usar ambos, incluye un archivo en el otro con @AGENTS.md. Cómo se estructuran estos manuales para agentes lo explica la guía Ingeniería agéntica.

Tareas en Obsidian: casillas y el plugin Tasks

Obsidian trata las tareas como casillas. Una línea como - [ ] Escribir el guion de la lección 2 es una tarea abierta; con [x], está hecha. Para una lista de tareas de Obsidian dentro de una sola nota, basta.

El plugin de la comunidad Tasks convierte esto en gestión de tareas para toda tu bóveda. Escribes vencimiento, prioridad y repetición como símbolos en la línea, por ejemplo 📅 2026-10-23 para el vencimiento. Al completar una tarea, el plugin añade la fecha; en las tareas recurrentes, crea la línea siguiente. Las consultas en un bloque de código reúnen tareas de todas tus notas:

```tasks
not done
due next week
```

El punto fuerte de este enfoque: las tareas viven donde surgen, en las notas de proyecto y las actas de reuniones. Para mucha gente que lleva su segundo cerebro en Obsidian, es suficiente.

Dónde llega a su límite el plugin Tasks

• Avisos: el plugin Tasks no te avisa por sí mismo. Las notificaciones vienen de otro plugin, como Reminder, y su documentación indica que las notificaciones del sistema no son posibles en iPhone ni en Android.
• Capturar sobre la marcha: desde iOS 26, Obsidian ofrece captura rápida desde la pantalla bloqueada, el centro de control y los widgets. Lo que capturas así llega como texto a una nota. Fecha, proyecto y responsable los añades después a mano.
• Asignación: una línea no tiene campo para el responsable. Puedes acordar con tu agente una etiqueta como #agent, pero no hay estado para “para revisar” ni sitio para su resultado o para vuestras preguntas.
• Tus notas, no las del agente: para completar o ampliar una tarea, el agente tiene que cambiar la línea en tu nota. Cuantas más notas contienen tareas, más archivos toca para ello.

Tareas de Obsidian con Claude Code: asígnaselas a tu agente

La alternativa a una línea es una tarea propia con estado, vencimiento y responsable. Incluye una descripción del objetivo y criterios de aceptación, y un historial donde tu agente anota lo que ha hecho.

Cuando trabajas con un agente, esto tiene ventajas concretas:

• El agente cambia una tarea sin tocar tus notas.
• Responsabilidad y estado quedan claros: asignas la tarea a tu agente y, cuando termina, la tarea vuelve a ti como “Para revisar”.
• Resultados y preguntas se quedan en la tarea, no en un historial de chat que mañana habrá desaparecido.

Nadie quiere mantener esta estructura a mano. Hacen falta un manual para el agente y una app que convierta los archivos en listas, vistas y avisos.

Dónde ayuda TandemLoop: captura, vistas, avisos

TandemLoop es una app de tareas para Mac, iPad y iPhone que funciona justo así. Su carpeta de datos, local o en iCloud Drive, puede ser una subcarpeta de tu bóveda o aparecer en ella mediante un enlace. Tu agente trabaja entonces en toda la bóveda, notas y tareas incluidas.

• Captura: la Captura rápida, el menú Compartir, el centro de control, Atajos y Siri crean una tarea de verdad, directamente para tu agente si quieres.
• Vistas: Lista, Tabla, Tablero, Agenda, Calendario, Multivista y Panel, con filtros, por ejemplo por responsable o vencimiento.
• Avisos: vencimientos con hora, notificaciones con “Completar”, “Más tarde” y “Mañana”, y widgets en la pantalla de inicio y la pantalla bloqueada.
• Agente: la carpeta de datos contiene AGENTS.md, el manual para tu agente. El agente tiene acceso a todo lo que hay en la carpeta de datos: crea tareas, proyectos, áreas y vistas, los cambia y los mueve, y trabaja en las tareas que tiene asignadas. Con las propuestas activadas, solo añade directamente elementos nuevos a la Bandeja de entrada y presenta todo lo demás como propuesta.
• Devolución: cuando termina o necesita algo de ti, te devuelve la tarea. La tarea aparece en Devueltas por el agente; en el iPhone, en la pestaña Devueltas.

Todo sobre el reparto del trabajo con tu agente, de las propuestas a las devoluciones, está en la página App de tareas para trabajar con agentes de IA. El conjunto completo de funciones sin agente está en la visión de conjunto de la app de tareas.

Flujo de ejemplo: Bandeja de entrada → agente → resultado

Un flujo del proyecto “Curso online”: el esquema es una nota en Obsidian y el agente debe redactar el guion de la lección 2.

1. Capturar. De camino al trabajo, escribes “Escribir el guion de la lección 2” en la Captura rápida y asignas la tarea a tu agente con la delegación Borrador. Llega a la Bandeja de entrada.
2. Encargo. En tu Mac, inicias Claude Code en tu bóveda y escribes: “Ocúpate de tus tareas en TandemLoop”. Lee el manual, encuentra la tarea y también el esquema de tu curso.
3. Resultado en la tarea. Guarda el guion como nota en la carpeta Curso online y anota en el historial de la tarea lo que ha hecho, con un enlace a la nota.
4. Devueltas por el agente. Como la delegación era Borrador, no completa la tarea por su cuenta, sino que te la devuelve para revisar. Lees el guion en Obsidian y eliges Aceptar en TandemLoop, o Pedir correcciones con un comentario.
5. Lo que solo puedes hacer tú. Si para la subida necesita una cuenta confirmada en la plataforma del curso, pone “Confirmar el acceso a la plataforma del curso” en tu Bandeja de entrada en lugar de mencionarlo en una respuesta larga.

Si el agente se ejecuta en bucle en tu Mac, por ejemplo con el skill de trabajo de TandemLoop y /loop 10m /tandem-worker en Claude Code, se ocupa de tareas como estas incluso cuando no estás. Solo debe escribir un agente a la vez.

Qué enfoque te conviene

Puedes combinar ambos: las listas de comprobación para cosas pequeñas se quedan en tus notas, y todo aquello en lo que trabaja tu agente recibe una tarea propia. Si organizas tus tareas con Getting Things Done, la guía del método GTD muestra qué pasos puede asumir tu agente.