Cómo Convertí Obsidian y Claude Code en Mi Cerebro de IA

Cómo convertí Obsidian y Claude Code en mi cerebro de IA

Hace tres meses, le hice una pregunta a Claude Code sobre un proyecto paralelo que había estado construyendo. Me dio una respuesta decente. Genérico, pero decente. Luego apunté a mi bóveda de Obsidian: 847 archivos de rebajas que abarcan dos años de notas diarias, especificaciones de proyectos, transcripciones de reuniones e ideas a medias garabateadas a la 1 de la madrugada.

La respuesta que me dio a continuación me hizo recostarme en mi silla.

Conectó un concepto de una nota cinematográfica que escribí en marzo de 2024 con una idea de inicio que había abandonado en noviembre, y luego asignó ambos a un patrón en mis notas diarias que no había notado conscientemente. Había estado dando vueltas al mismo problema desde tres dominios diferentes durante ocho meses sin darme cuenta.

Ese momento cambió mi forma de pensar sobre las herramientas de inteligencia artificial. No como contestadores automáticos. Como socios pensantes que conocen su contexto lo suficientemente profundo como para mostrarle lo que se ha estado perdiendo acerca de sus propias ideas.

Esta es la cuestión: la mayoría de los desarrolladores usan la IA de la misma manera en cada sesión: explican el proyecto, reafirman las restricciones, vuelven a describir lo que ya han probado. Es como tener un colega brillante con amnesia. Cada mañana empiezas desde cero. Me cansé de ese ciclo y lo que construí para reemplazarlo se ha convertido en la herramienta más valiosa de mi flujo de trabajo. Pero la configuración requiere un cambio mental para el que la mayoría de la gente no está preparada, y explicaré por qué eso es más importante que los detalles técnicos.

Por qué sus conversaciones sobre IA siguen empezando desde cero

El problema es universal si ha pasado tiempo real con Claude, ChatGPT o cualquier herramienta basada en LLM. Abres una nueva sesión. Escribe tres párrafos de contexto. Obtienes una respuesta. Mañana lo harás de nuevo. Y otra vez. Y otra vez.

Las herramientas de inteligencia artificial basadas en la web ahora tienen funciones de "memoria", por supuesto. Pero esto es de lo que nadie habla: no se puede controlar completamente lo que hay en esa memoria. No puede inspeccionarlo, editarlo ni estructurarlo. La IA decide qué recordar basándose en su propia heurística. Esa es una caja negra que se interpone entre usted y sus proyectos más importantes.

Llevo más de dos años creando agentes de IA y sistemas de automatización. El mayor desbloqueo de productividad no fue un modelo mejor ni un mensaje más sofisticado. Estaba resolviendo el problema del contexto. Cuando su socio de IA tiene un contexto persistente, estructurado y organizado a su manera, la calidad de todo lo que hace aumenta en un orden de magnitud.

Obsidian y Claude Code resuelven este problema juntos de una manera que nada más que he probado se acerca a igualar. La idea clave es engañosamente simple: sus archivos de rebajas se convierten en la memoria a largo plazo de la IA y usted controla cada byte de ella.

La integración técnica es sencilla, pero el poder real aparece cuando comienzas a crear comandos personalizados que aprovechan el gráfico de relaciones entre tus notas. Ahí es donde las cosas dejan de ser "un truco genial" y empiezan a ser genuinamente transformadoras.

The Obsidian Foundation: más que una aplicación para tomar notas

Si no está familiarizado con Obsidian, aquí tiene la versión corta: es una herramienta para tomar notas basada en rebajas que administra una bóveda, que en realidad es solo una carpeta de archivos .md en su máquina local. Eres dueño de los archivos. Sin bloqueo de la nube. Sin formato propietario. Solo envía un mensaje de texto.

Empecé a usar Obsidian con escepticismo. Otra aplicación para tomar notas, ¿verdad? Había revisado Notion, Roam Research, Bear, Apple Notes: el cementerio completo de herramientas de productividad que prometen cambiar tu forma de pensar y terminan siendo otra suscripción abandonada.

Lo que hizo que Obsidian se pegara fue una característica: enlace bidireccional con un gráfico visual.

Cuando escribes [[idea-proyecto]] dentro de una nota diaria, Obsidian crea un enlace. Cuando abres project-idea.md, puedes ver cada nota que hace referencia a él. La vista de gráfico muestra estas conexiones como una red interactiva: nodos y bordes que mapean cómo sus ideas se relacionan entre sí.

Esto suena académico hasta que lo has usado durante tres meses. Luego abres el gráfico y ves que tus notas sobre el "agotamiento del desarrollador" se conectan con tus notas sobre la "ansiedad por la automatización", que a su vez se conectan con tus notas sobre un proyecto de cliente que salió mal, y de repente ves un patrón en tu propio pensamiento que nunca habrías detectado al desplazarte por una carpeta.

El cerebro humano es terrible a la hora de rastrear estas conexiones a través de cientos de notas escritas a lo largo de meses. La obsidiana los hace visibles. Esa es la base. Pero la bóveda en sí misma sigue siendo pasiva: espera a que la explores manualmente.

Eso cambia cuando Claude Code entra en escena.

Claude Code: su computadora ahora escucha inglés

Claude Code es una interfaz de agente que le permite controlar su computadora mediante comandos de lenguaje natural en una terminal. Escribe lo que quiere en inglés sencillo y se ejecuta.

"Cree un nuevo archivo llamado project-spec.md con estas secciones". Hecho. "Lea mis últimas tres notas diarias y resuma los elementos de acción". Hecho. "Encuentre cada mención de 'autenticación' en mi bóveda y enumere los archivos". Hecho.

Esto no es un chatbot. Es un agente con acceso a herramientas: puede leer archivos, escribir archivos, ejecutar comandos y encadenar operaciones. Cuanto más contexto le dé, más sofisticadas serán las tareas que podrá realizar de forma autónoma.

Utilicé Claude Code durante meses antes de conectarlo a Obsidian, principalmente para tareas de codificación y gestión de archivos. Útil, pero limitado. El verdadero avance se produjo cuando me di cuenta de que el agente podía consumir toda mi bóveda como contexto: no sólo el texto sin formato, sino también la estructura de relaciones entre las notas.

Aquí es donde Obsidian CLI entra en escena y donde la mayoría de los tutoriales sobre este tema dejan de ser útiles porque se centran en la configuración y omiten por completo el diseño del flujo de trabajo. Cubriré ambos, pero el diseño del flujo de trabajo es donde reside el 90% del valor.

La integración que lo cambió todo

Obsidian lanzó Obsidian CLI, una herramienta que expone su bóveda a interfaces de línea de comandos. Cuando Claude Code se conecta a través de él, el agente no solo ve un montón de archivos de rebajas. Ve el gráfico de enlaces completo: qué notas hacen referencia a cuáles, qué está conectado a qué, dónde se forman los grupos y dónde se encuentran solas las notas huérfanas.

Imagínese entregarle a alguien una caja de 800 notas adhesivas en lugar de entregarle un mapa mental con las 800 notas ya organizadas por relación. Misma información, utilidad tremendamente diferente. Esa es la diferencia que hace Obsidian CLI.

La primera vez que ejecuté un comando que le pedía a Claude Code que "analizara mi bóveda e identificara temas que podría estar pasando por alto", devolvió un informe que incluía:

• 14 notas huérfanas: ideas que escribí una vez y nunca las relacioné con nada
• 3 enlaces sin resolver: notas a las que hice referencia pero que nunca creé
• Un grupo de 23 notas sobre "creatividad asistida por IA" que no había etiquetado como categoría
• Una contradicción entre lo que escribí sobre el equilibrio entre vida personal y laboral en junio y lo que mis notas diarias mostraban que estaba haciendo en julio.

Ese último fue diferente. La IA no me estaba diciendo algo que no sabía en abstracto: me estaba mostrando evidencia de mis propios escritos de que mis creencias y comportamientos estaban desalineados. Ninguna aplicación de productividad había hecho eso jamás.

Pero generar un informe único no es un flujo de trabajo. El sistema real surgió cuando comencé a crear comandos personalizados.

Construyendo comandos que piensen contigo

Aquí es donde esto pasa de "experimento interesante" a "No puedo imaginarme trabajando sin él". Los comandos personalizados en Claude Code le permiten crear operaciones reutilizables que cargan archivos específicos, aplican una lógica específica y producen resultados específicos.

Creé cinco comandos que ahora ejecuto casi a diario. Cada uno aprovecha el contexto de la bóveda de manera diferente.

1. Revisión de la mañana

Este comando lee la integración de mi calendario, las notas diarias recientes, cualquier elemento de acción no resuelto y el estado actual de los proyectos activos. Luego produce una lista de tareas priorizadas, no genérica, sino que da cuenta en qué he estado trabajando, qué está estancado y qué fechas límite se acercan.

La diferencia crucial con respecto a cualquier administrador de tareas: detecta patrones. "Ha tenido el 'módulo de autenticación de refactorización' en su lista durante 9 días. Según sus notas, el bloqueador parece ser la migración de API que mencionó el martes. ¿Deberíamos abordar eso primero?"

Ninguna aplicación de tareas ha conectado esos puntos por mí.

2. Procesamiento al final del día

Antes de cerrar mi computadora portátil, este comando escanea las notas del día, extrae elementos de acción que podría haber enterrado en notas de reuniones o sesiones de lluvia de ideas, muestra cualquier conexión de la bóveda con lo que trabajé y califica mi nivel de confianza en las decisiones que tomé en función de cómo se alinean con mi pensamiento documentado.

Esa última parte suena rara hasta que la experimentas. Escribí una nota en enero diciendo que "los microservicios son excesivos para proyectos de menos de 50.000 usuarios". En marzo, comencé a diseñar una configuración de microservicios para un proyecto con 12.000 usuarios. El procesador del final del día lo marcó. "Su bóveda contiene una fuerte opinión en contra de este enfoque para proyectos de esta escala. ¿Ha cambiado algo o debería reconsiderarlo?"

Lo reconsideré. Fue la decisión correcta.

3. Desafío de creencias

Este es el comando que incomoda a la gente cuando se lo muestro. Toma una declaración en la que estoy operando actualmente: "Deberíamos crear el MVP en React Native", y busca en mi bóveda notas, decisiones pasadas o experiencias registradas que la contradigan.

A veces no encuentra nada. Eso es generar confianza. A veces aparece una nota de hace ocho meses en la que escribí sobre los puntos débiles exactos en los que estoy a punto de entrar. Eso es invaluable.

Aprendí esto de la manera más difícil en el proyecto de un cliente en el que defendía una arquitectura de base de datos específica. Mi bóveda tenía tres notas separadas, repartidas en cinco meses, que documentaban problemas con ese enfoque exacto en contextos similares. Lo había olvidado. La IA no lo hizo.

4. Seguimiento de la evolución de ideas

Éste muestra cómo un concepto ha cambiado en mi bóveda a lo largo del tiempo. Le pedí que rastreara mi pensamiento sobre los "agentes de IA en producción" y obtuve una línea de tiempo:

• Mes 1: Escéptico. Las notas se centraron en las limitaciones y los riesgos de alucinaciones.
• Mes 4: Experimentando con cautela. Primera automatización exitosa documentada.
• Mes 7: Construcción diaria. Las notas cambian de "¿puede funcionar esto?" a "¿cómo puedo escalar esto?"
• Mes 10: Evangelizando. Escribir sobre ello, enseñarlo, construir herramientas en torno a ello.

Ver esa evolución trazada (con marcas de tiempo y citas de mis propias notas) fue realmente conmovedor. No te das cuenta de cuánto cambia tu forma de pensar hasta que alguien (o algo) te muestra la trayectoria.

5. Buscador de patrones entre dominios

Mi bóveda abarca ingeniería de software, ciberseguridad, pensamiento de diseño, estrategia empresarial y desarrollo personal. Este comando busca conceptos que aparecen en dos o más dominios no relacionados y genera conexiones que no he realizado explícitamente.

Resultado de ejemplo: "Sus notas sobre 'patrones de codificación defensiva' comparten similitudes estructurales con sus notas sobre 'consistencia de identidad de marca'. Ambos enfatizan el establecimiento temprano de límites, la creación de comportamientos predecibles y la generación de confianza a través de la confiabilidad. Puede haber un marco que unifique estas ideas".

Por mi cuenta, nunca habría conectado la codificación defensiva con la identidad de marca. Pero la conexión es real y generó una publicación en el blog y un nuevo enfoque sobre cómo estructuro los proyectos de los clientes.

Si ha llegado hasta aquí, ya comprende por qué esta no es simplemente otra integración de herramientas. La siguiente sección cubre la configuración exacta para que pueda crearla usted mismo.

Configuración del proceso completo

Aquí está el paso a paso. Supongo que tiene Obsidian instalado con una bóveda activa y familiaridad básica con los comandos del terminal.

Paso 1: Instalar Claude Code

Si aún no lo has hecho, instala Claude Code a través del canal oficial. Necesitará una clave API de Anthropic o una suscripción a Claude que incluya acceso CLI. La instalación es sencilla: siga los documentos en la página oficial de Claude Code. Asegúrese de que esté funcionando ejecutando un comando simple como "enumerar los archivos en este directorio".

Paso 2: Instale la CLI de Obsidian

Obsidian CLI es el puente. Instálelo siguiendo la documentación oficial de Obsidian CLI. Una vez instalado, verifique que pueda ver su bóveda ejecutando el comando de listado de bóvedas. Deberías ver el nombre y la ruta de tu bóveda.

Paso 3: cree su archivo contextual

Antes de crear comandos, cree un único archivo de rebajas en su bóveda llamado _context.md (le prefijo un guión bajo para que se ordene en la parte superior). Este archivo debe contener:

# Acerca de mí: contexto para agentes de IA

## Rol actual
Ingeniero de software, desarrollador de IA. Edificio [proyectos actuales].

## Proyectos activos
- Proyecto A: [descripción de una línea y estado]
- Proyecto B: [descripción de una línea y estado]

## Prioridades actuales
1. [Prioridad con fecha límite]
2. [Prioridad con fecha límite]

## Cómo trabajo
- Prefiero [herramientas, marcos, enfoques]
- Evito [las cosas que has aprendido no te funcionan]

## Registro de decisiones
- [Fecha]: Decidió [X] porque [motivo]
- [Fecha]: cambió de [Y] a [Z] después de [lo que pasó]

Este archivo se convierte en el contexto básico para cada comando que cree. Actualízalo semanalmente. Cinco minutos de mantenimiento ahorran horas de volver a explicar.

Paso 4: construye tu primer comando

Comience con la revisión de la mañana. Cree un archivo de comando que le indique a Claude Code que:

1. Lea _context.md para conocer su estado actual
2. Lee las últimas 3 notas diarias.
3. Verifique si hay notas etiquetadas como #action-item o #todo
4. Haz referencias cruzadas con tus proyectos activos
5. Elaborar una lista priorizada con razonamiento

La estructura del comando se verá así en la configuración de Claude Code:

Lea mi archivo de contexto en [vault-path]/_context.md, luego lea mis últimos 3 diariamente
notas. Identificar todos los elementos de acción, hacer referencias cruzadas con mis proyectos activos,
y producir una lista de tareas prioritarias para hoy. Marca cualquier artículo que tenga
estado pendiente por más de 5 días.

Consejo profesional: Empiece de forma sencilla. Mi comando de revisión matutina comenzó con tres líneas y creció hasta convertirse en una página completa durante dos meses a medida que descubría qué información era más útil. No diseñe demasiado la primera versión.

Paso 5: itere según lo que realmente usa

Esto es lo que la mayoría de los tutoriales no le dirán: sus primeros comandos serán incorrectos. No roto, mal. Solicitarás cosas que crees que quieres y descubrirás que el resultado no es tan útil. Eso es normal.

Después de la primera semana, reescribí por completo mi procesador de fin de día porque la versión original resumía mis notas (aburrida) en lugar de desafiarlas (valiosa). El ciclo de iteración es el sistema. No te lo saltes.

Errores comunes y cómo solucionarlos:

• "Claude Code no puede encontrar mi bóveda": compruebe que la CLI de Obsidian apunte a la ruta correcta de la bóveda. Ejecute el comando de listado de bóveda para verificar.
• "El resultado es demasiado genérico": su archivo de contexto necesita más detalles. Una entrada vaga produce una salida vaga. Agregue detalles reales del proyecto, no texto de marcador de posición.
• "Los comandos tardan demasiado": las bóvedas grandes con miles de notas ralentizarán el proceso. Utilice etiquetas o consultas específicas de carpetas para limitar el alcance.
• "La IA alucina conexiones que no existen" — Esto sucede ocasionalmente. Agregue una línea a sus comandos: "Cite únicamente conexiones que pueda rastrear hasta notas específicas. Si no está seguro, dígalo". La instrucción de honestidad marca una diferencia mensurable.

Lo que la mayoría de la gente no le dirá sobre esta configuración

Quiero ser honesto acerca de las partes que no son mágicas.

La privacidad es una preocupación real. Le estás dando acceso a un agente de IA a tu segundo cerebro. Notas diarias, especificaciones de proyectos, transcripciones de reuniones, reflexiones personales: lo que sea que haya en su bóveda. Mantengo una bóveda separada para contenido verdaderamente privado que nunca toca ninguna herramienta de inteligencia artificial. Mi "bóveda accesible por IA" contiene contenido profesional, notas de proyectos y reflexiones personales seleccionadas. Nunca las cosas sin filtrar.

Debes pensar en esto antes de comenzar. ¿Con qué se siente cómodo con un procesamiento de IA? ¿Dónde está tu línea? No hay una respuesta correcta, pero sí un enfoque equivocado: pretender que la pregunta no importa.

El hábito de "escribir para pensar" no es negociable. Todo este sistema se desmorona si no escribes notas con regularidad. La IA sólo puede funcionar con lo que existe en su bóveda. Si toma notas escasas y con viñetas una vez a la semana, las conexiones serán escasas y los conocimientos superficiales. La escritura diaria, aunque sea de 200 palabras, es el combustible que hace funcionar este motor.

Solía ​​​​pensar que las notas diarias eran un culto a la productividad. Ahora lo entiendo: no se trata de productividad. Se trata de crear un registro persistente y consultable de su pensamiento que se agrava con el tiempo. La IA consume lo que produce. Escribe más, obtén más.

Te resistirás a dejar que la IA desafíe tus ideas. El comando de desafío de creencias me hizo sentir incómodo las primeras docenas de veces que lo usé. A nadie le gusta que le demuestren que su plan actual contradice su propia experiencia documentada. La tentación es descartar los hallazgos de la IA o dejar de usar el comando.

No. La incomodidad es el punto. Un socio pensante que sólo está de acuerdo contigo es inútil.

El contenido generado por IA debe permanecer separado de tus notas originales. Mantengo una regla estricta: la salida de IA va en una carpeta dedicada, nunca mezclada con mis notas personales. Si una IA genera una sugerencia o un borrador, lo edito manualmente antes de que toque mi bóveda principal. La bóveda es mi pensamiento, no el de la IA. Mezclarlos corrompe la señal con el tiempo.

Esto puede parecer paranoico, pero después de ver crecer la bóveda durante meses, puedo decirles: saber que cada nota en su bóveda principal es genuinamente suya crea una capa de confianza que es imposible de replicar si se esparce texto generado por IA.

Lo que realmente cambia cuando trabajas de esta manera

Después de tres meses de uso diario, esto es lo que es notablemente diferente.

La velocidad de decisión aumentó. No porque la IA tome decisiones por mí, sino porque muestra un contexto relevante que de otro modo pasaría 20 minutos buscando. Cuando un cliente pregunta "¿hemos lidiado con esto antes?" Puedo responder en 30 segundos en lugar de buscar en notas antiguas.

Calidad de la idea mejorada. El buscador de patrones entre dominios produce constantemente conexiones que no habría hecho por mi cuenta. No todos son útiles; tal vez el 30% conduzca a algún lugar interesante. Pero el 30% de las conexiones a través de más de 800 notas corresponden a muchos lugares interesantes.

Menos errores repetidos. El desafiador de creencias me sorprendió cayendo en la misma trampa tres veces distintas. Cada vez, mi bóveda tenía evidencia de que el enfoque era arriesgado. Cada vez lo había olvidado. La IA no olvida.

La escritura se volvió más intencional. Saber que mis notas alimentan un sistema de inteligencia artificial que las analizará más tarde cambió mi forma de escribir. Soy más específico acerca de las decisiones, más honesto acerca de las incertidumbres y más consistente a la hora de vincular ideas relacionadas. El circuito de retroalimentación entre la calidad de la escritura y la calidad de la salida de la IA es real y motivador.

El tiempo ahorrado es significativo, pero no como cabría esperar. No ahorro mucho tiempo en la interacción real de la IA: los comandos tardan unos minutos en ejecutarse. Los ahorros provienen de no volver a explicar el contexto, de no volver a investigar mis propias decisiones y de no perder ideas que habrían desaparecido en una nota olvidada.

Las ganancias rápidas aparecen en la primera semana. El valor real se acumula a lo largo de los meses a medida que la bóveda crece y el gráfico de conexión se vuelve más denso. El primer mes es útil. El sexto mes es transformador.

El panorama general: archivos Markdown como sistema operativo

He aquí un pensamiento que me mantiene despierto por la noche de la mejor manera posible.

Sus archivos de rebajas son una representación más precisa de su pensamiento que su propia memoria. La memoria humana es reconstructiva: no recordamos eventos, los reconstruimos, a menudo de manera inexacta, coloreados por emociones y creencias actuales. Tus notas de hace seis meses capturan lo que realmente pensaste en ese momento, no lo que recuerdas haber pensado.

Cuando un agente de IA tiene acceso a ese registro preciso y puede atravesar las conexiones entre miles de notas, logra algo que antes solo era posible con un terapeuta o colaborador a largo plazo que haya estado prestando atención durante años. Puede mostrarle patrones en su propio pensamiento. Puede identificar cuándo sus creencias actuales contradicen sus experiencias pasadas. Puede encontrar el hilo que conecta las ideas que has estado dando vueltas sin reconocer que son la misma idea.

Mis archivos de rebajas son, literalmente, los recuerdos que impulsan a mi compañero de pensamiento de IA. No datos de entrenamiento. No es un aviso. Recuerdos. Contexto persistente, estructurado e interconectado que convierte un modelo de lenguaje sin estado en algo que comprende mi trabajo, mis patrones y mis puntos ciegos.

Las personas que inviertan en construir y mantener este tipo de sistema de conocimiento personal tendrán una ventaja acumulada durante los próximos cinco años. No porque la tecnología sea exclusiva: está disponible para cualquier persona que tenga Obsidian y una suscripción a Claude. Sino porque el hábito de la escritura reflexiva, la toma constante de notas y la autodocumentación honesta es difícil. La mayoría de la gente no lo hará.

Aquellos que lo hagan tendrán un socio de IA que se volverá más inteligente, no porque el modelo mejore, sino porque el contexto se profundiza. Cada nota que escribe hace que el sistema sea más valioso. Cada conexión que creas le da a la IA más con qué trabajar. La bóveda crece. Las ideas se multiplican. Y alrededor del tercer mes, te das cuenta de que ya no estás simplemente tomando notas.

Estás construyendo una segunda mente que realmente piensa contigo.

Así que aquí está mi desafío: abre Obsidian esta noche. Escribe una nota diaria. No es perfecto, solo un registro honesto de en qué trabajaste, en qué estás estancado y una idea que se te pasó por la cabeza hoy. Hazlo de nuevo mañana. Y al día siguiente.

En treinta días, apunta a Claude Code a esa bóveda y pregúntale qué patrones ve.

Lo prometo: lo que encuentre le sorprenderá.

Trabajemos juntos

¿Quiere crear sistemas de inteligencia artificial, automatizar flujos de trabajo o ampliar su infraestructura tecnológica? Me encantaría ayudar.

• Fiverr (compilaciones e integraciones personalizadas): fiverr.com/s/EgxYmWD
• Portafolio: mejba.me
• Ramlit Limited (soluciones empresariales): ramlit.com
• ColorPark (diseño y marca): colorpark.io
• xCyberSecurity (servicios de seguridad): xcybersecurity.io