Obsidian + Claude Code: cómo organicé mis proyectos, agentes y skills en varias computadoras

Si llevas un tiempo programando con Claude Code, seguro te ha pasado: le pides un cambio, la IA lo hace de una manera, después le pides el mismo cambio en otro lado y lo hace diferente. Y de repente llevas dos horas peleándote contra una herramienta que se supone te debería ahorrar tiempo.

A mí me pasaba lo mismo. El problema no era Claude — era que yo no estaba haciendo planeación. La IA es una herramienta brutalmente poderosa (la uso todo el día como programador y pago la suscripción de 100 dólares), pero sin un sistema que la guíe, te lleva por todos lados.

En este post te cuento cómo organicé mi flujo con Obsidian como cerebro central, lo conecté a Claude Code, y lo sincronicé entre mis dos computadoras usando CouchDB y symlinks.

El problema: la IA sin rumbo

Cuando le pides cosas a Claude Code prompt por prompt, sin un norte claro, pasa esto:

• Hace un cambio bien, pero la segunda vez lo hace distinto
• No se acuerda de decisiones que ya habías tomado
• Te documenta cosas inconsistentes
• Cada conversación empieza desde cero

La solución no es "mejores prompts". Es darle a la IA un lugar donde vivan tus decisiones, tu contexto, tus proyectos. Y ese lugar tiene que estar en un formato que la IA pueda leer rápido y sin basura.

Ese lugar, para mí, terminó siendo Obsidian.

Por qué Obsidian (y no Notion)

Yo tenía Notion. Ahí tenía mi documentación. Pero sentía fricción — algo que no terminaba de funcionar. Cuando empecé a investigar bien, identifiqué dos cosas:

1. Obsidian corre localmente. No hay servidores en medio. Tu bóveda vive en una carpeta de tu computadora. Eso significa que cuando Claude Code escribe algo, lo ves instantáneamente. Con Notion via MCP funciona, pero hay un delay: Claude termina, y minutos después aparece el cambio. Esa milésima de fricción es la que mata el flujo.

2. Todo es Markdown. Cada nota es un archivo .md plano. Y resulta que Markdown es el formato favorito de la IA: tiene estructura clara, sin ruido tipo punto y comas, corchetes o tags XML. La IA lo lee rápido y no tiene que estar limpiando contenido basura.

Notion también puede exportar Markdown, pero el cuello de botella sigue siendo el servidor remoto.

Conectar Claude Code con Obsidian

Obsidian tiene un ecosistema enorme de plugins de la comunidad. Para conectarlo con la IA solo necesitas uno:

Local REST API — expone tu bóveda como una API local en tu computadora. Una vez instalado, cualquier agente (Claude Code, Gemini CLI, lo que uses) se puede conectar vía MCP y leer/escribir notas directamente.

Pasos básicos:

1. En Obsidian: Settings → Community plugins → Browse
2. Busca Local REST API, instálalo y actívalo
3. Copia la API key que genera
4. Configura el MCP en Claude Code apuntando al endpoint local con esa key

Listo. Desde Claude Code ya puedes decirle "lee mi nota X" o "actualiza el proyecto Y" y lo hace en tiempo real.

Archivero: mi agente curador de la bóveda

Cuando ya tenía el plumbing armado, faltaba lo más importante: decidir cómo organizar todo. Una bóveda desordenada con la IA es peor que no tener bóveda.

Lo que hice fue:

1. Pensé qué estructura quería (proyectos, agentes, skills, servidores)
2. Creé un agente en Claude Code llamado Archivero
3. Ese agente es el único que toca la bóveda

Así, cuando estoy en cualquier proyecto y quiero documentar algo, le digo:

oye, dile a Archivero que guarde esto

O:

dile a Archivero que actualice el proyecto X con estos cambios

Archivero conoce mi estructura, mis convenciones y mantiene todo consistente. Yo no tengo que pensar dónde va cada cosa.

Descarga el agente Archivero → archivero.md

Plantilla pública, sin mis datos personales. Cópialo a ~/.claude/agents/archivero.md y ajusta las rutas a tu bóveda.

El bonus: SSH al servidor desde Claude Code

Yo tengo un VPS en Digital Ocean donde corren mis proyectos. Quería que Claude Code pudiera subir cambios o revisar deploys sin que yo tuviera que ir manualmente al servidor.

No le di credenciales a Claude. Lo que hice fue configurar el SSH de mi computadora para conectarse al servidor. Claude Code usa la conexión SSH de mi máquina, no tiene llaves propias. Y le pedí a Archivero que documentara todo (IPs, puertos, paths, comandos) en mi bóveda.

Ahora cuando algo falla en un deploy, le digo:

revisa por qué está fallando el deploy del proyecto X

Y Claude entra al servidor por mi SSH, revisa logs, propone una solución. Sin que yo tenga que abrir la terminal del servidor.

Este flujo lo maneja un segundo agente llamado Alan, especializado en infra: SSH, deploys, dominios, backups, env vars.

Descarga el agente Alan → alan.md

Versión pública sin IPs ni credenciales. Tienes que rellenar los campos <...> con tus servidores, dominios y rutas antes de usarlo.

El problema real: dos computadoras

Hasta aquí todo bien... en una sola máquina. Pero yo tengo una PC de escritorio con Linux y una MacBook Pro. Y Claude Code todavía no tiene una manera oficial de tener el mismo agente en dos computadoras.

Entonces me enfrenté a dos preguntas:

1. ¿Cómo sincronizo la bóveda entre las dos máquinas?
2. ¿Cómo hago que los agentes vivan en las dos sin tener que copiarlos a mano?

Sincronización: Obsidian Sync vs CouchDB

Obsidian ofrece su propio servicio de sincronización (Obsidian Sync) por 4 USD al mes — unos 80 pesos mexicanos. Te deja sincronizar una bóveda. Funciona perfecto y sin configuración.

Al principio pensé que "una bóveda" era poco porque yo quería una por proyecto. Resulta que Obsidian no funciona así: con una sola bóveda puedes meter todos tus proyectos adentro, bien departamentados. Aprendí esto después, pero me sirvió porque al final me ahorré los 80 pesos.

Como ya pagaba el VPS de Digital Ocean, monté CouchDB ahí. CouchDB es una base de datos que el plugin Self-hosted LiveSync de Obsidian usa para replicar la bóveda entre dispositivos.

El resultado:

• Cambio algo en la MacBook → se ve en Linux en segundos
• Edito una nota desde el celular → aparece en las dos compus
• Sin servicios de terceros, todo corre en mi servidor

La configuración inicial sí cuesta un poco (Docker, certificado SSL, configurar el plugin en cada device), pero una vez armado, se olvida uno.

Recomendación honesta

En el mundo de la IA las suscripciones se van apilando: Claude, ChatGPT, Cursor, Vercel, GitHub... 4 dólares más al mes puede sumar.

Symlinks: el truco para compartir agentes

Resolver la bóveda fue la mitad del problema. Faltaba lo otro: los agentes de Claude Code tienen que estar en un directorio específico (~/.claude/agents/) para ser globales en la computadora.

Si yo creaba un agente en la MacBook, no aparecía en Linux. Tendría que copiar el archivo a mano cada vez. Inviable.

La solución son los symlinks. Si nunca los habías oído (yo tampoco los había usado), son enlaces simbólicos del sistema operativo. Le dices al SO: "este archivo que vive en X, hazle creer al sistema que también vive en Y".

En mi caso:

• El archivo real Alan.md (mi agente) vive en mi bóveda de Obsidian (que ya está sincronizada vía CouchDB)
• Creo un symlink desde ~/.claude/agents/Alan.md hacia el archivo en la bóveda
• Claude Code lo ve como si estuviera en su carpeta normal

Si edito el agente en cualquier compu, el cambio se replica vía Obsidian, y la otra compu lo ve actualizado automáticamente porque el symlink apunta al mismo archivo lógico.

El comando para crear el symlink en Mac/Linux:

ln -s ~/Obsidian/MiBoveda/Agentes/Alan.md ~/.claude/agents/Alan.md

Aplica el mismo truco para skills, comandos, lo que necesites compartir.

El resultado: un sistema portable

Hoy mi setup queda así:

• Código → repositorios en GitHub (Git sincroniza)
• Contexto / agentes / skills / docs de proyectos → bóveda de Obsidian (CouchDB sincroniza)
• Conexión a servidores → SSH desde mi máquina (Claude Code lo aprovecha)

Si compro una computadora nueva mañana:

1. Instalo Obsidian + configuro LiveSync apuntando a mi CouchDB
2. Instalo Claude Code
3. Corre un agente que recrea los symlinks de ~/.claude/agents/ y ~/.claude/skills/
4. En minutos tengo exactamente el mismo entorno que tenía en la otra máquina

Y se acabó esa barrera mental de "esto lo trabajo en la Mac, esto en la PC". Es todo el mismo cerebro, vive en mi bóveda, y se mueve conmigo.

Lo que aprendí

1. La IA sin planeación es caos productivo. Te genera código rápido pero inconsistente.
2. El formato importa. Markdown local le quita fricción a la conversación con la IA.
3. Los agentes especializados ganan. Un Archivero curador es mejor que pedirle a la IA general que "ordene la documentación".
4. Los symlinks resuelven más problemas de los que crees. Vale la pena aprenderlos.
5. Las herramientas se acomodan a ti, no al revés. Pasé de pelearme con Notion a tener un sistema que no me estorba.

Si quieres replicar esto, empieza con lo más simple: instala Obsidian, instala Local REST API, conéctalo a Claude Code y crea un agente que organice tu bóveda. La parte de CouchDB y symlinks la puedes dejar para cuando ya tengas dos máquinas y te duela copiar agentes a mano.

Si te sirvió este post, sígueme en mis redes para más contenido sobre cómo trabajar mejor con Claude Code y agentes de IA.