Crea un enjambre de investigación con Obsidian y Claude Code: 6 pasos para guardar automáticamente las conclusiones de la investigación en tu base de conocimiento

Estos últimos días, una publicación en X ha acumulado muchas visualizaciones: un «desarrollador chino de 23 años» ejecutó 300 instancias de Claude Code en paralelo, contrastó cada resultado con los archivos fuente en unos 100 milisegundos y guardó más de 100 perfiles de empresas en Obsidian «sin un solo error».

La idea que realmente vale la pena aprender de esa publicación es esta: el modelo caro hace el trabajo; el modelo barato verifica si es correcto. Si no cumple, se devuelve para que lo rehaga; solo lo que pasa la revisión se guarda en la base de conocimiento.

Una guía que puedes seguir paso a paso para ponerlo en marcha. El proceso se basa principalmente en usar una interfaz gráfica y en «hablarle a Claude Code con naturalidad»: no necesitas saber programar.

Valor principal: al terminar de leer, tendrás montado en tu computadora un pequeño enjambre de investigación. La sesión principal se encarga de dividir el tema; varios subagentes de investigación buscan información en paralelo, mientras que un subagente de verificación, más económico, revisa cada punto con lupa. Las conclusiones que superan la revisión se guardan automáticamente en tu bóveda de Obsidian, junto con sus fuentes y una marca de verificación.

Obsidian y Claude Code para crear un enjambre de investigación: antes de empezar

Antes de ponerte manos a la obra, comprueba que cumples estos requisitos.

• Objetivo: la sesión principal (Opus) divide el tema y resume los resultados; entre 2 y 3 subagentes de investigación (Sonnet) consultan fuentes en paralelo; un subagente de verificación (Haiku) comprueba cada afirmación. Las conclusiones aprobadas se guardan en la carpeta «Notas de investigación» de Obsidian.
• Tiempo: reserva una tarde para la configuración inicial. Después, para cada investigación solo tendrás que preparar una lista de tareas y dar una instrucción para ponerla en marcha.
• Requisitos previos: tener instalados Obsidian para escritorio y Claude Code, disponer de una cuenta de APIYI y contar con acceso a Internet para consultar los enlaces de las fuentes.
• Dificultad: nivel inicial. No hace falta escribir código; los archivos de configuración solo aparecen en bloques desplegables opcionales.

Esta es la hoja de ruta completa. Cada paso incluye un criterio de aceptación. Completa cada paso y comprueba que cumple el criterio antes de continuar.

Puntos clave de la investigación sobre enjambres

Por qué el enjambre de investigación debe dividirse en dos roles: «investigar» y «verificar»

Si solo aumentas el número de agentes sin añadir verificación, cuanto más paralelismo haya, más alucinaciones se colarán. Al separar la investigación y la verificación entre dos modelos, el verificador solo tiene que responder a una pregunta: ¿se puede encontrar respaldo para esta conclusión en el fragmento original? Esta tarea es mucho más sencilla que hacer la investigación, así que basta con asignársela al económico Haiku.

En los comentarios también apareció una sugerencia muy práctica: el verificador no debe ver el proceso de razonamiento del investigador; solo debe consultar las conclusiones y el texto original. De lo contrario, puede dejarse influir por lo que diga el investigador. Además, el verificador solo debe responder «aprobado» o «rechazado + motivo» y no puede modificar nada por su cuenta. Si también empieza a editar el contenido, sus responsabilidades se mezclan con las del investigador. La configuración de este artículo sigue estas dos reglas al pie de la letra.

Por qué para empezar con Obsidian no hace falta instalar complementos ni MCP

Una bóveda de Obsidian es básicamente una carpeta. Las herramientas de lectura y escritura incluidas en Claude Code pueden trabajar directamente con los archivos .md, y Obsidian actualiza la vista automáticamente. En la prueba de terceros mencionada antes (una bóveda pequeña con 560 notas y una sola ejecución por herramienta), el grupo de control que no instaló nada fue el que menos tokens consumió. Por eso, para empezar no hace falta complicarse con complementos. Todavía no hay datos sobre cómo se comporta con bóvedas más grandes.

Guía rápida para usar Obsidian con Claude Code en un enjambre de investigación

Paso ①: Crea una bóveda en Obsidian y configura CLAUDE.md

Abre Obsidian y selecciona «Nueva bóveda» (para crear una bóveda vacía). Llámala 调研库 y guárdala en una ubicación fácil de encontrar, como «Documentos». No coloques esta bóveda dentro de la carpeta de otra bóveda, ya que las bóvedas anidadas pueden hacer que los enlaces internos dejen de funcionar.

Haz clic derecho en el panel de archivos de la izquierda, selecciona «Nueva carpeta» y crea estas cuatro carpetas: 任务清单, 原始资料, 调研笔记 y 打回记录.

Después, crea una nota en la raíz de la bóveda llamada CLAUDE.md y escribe las reglas para guardar el contenido. Claude Code leerá este archivo cada vez que se inicie desde este directorio:

# 调研库入库规则
1. 只读写这 4 个文件夹：任务清单、原始资料、调研笔记、打回记录。绝不读写 .obsidian 文件夹。
2. 每条结论必须附来源链接和原文摘录（引号原样摘抄）。
3. 没有通过核查员核查的内容，不得写入「调研笔记」。
4. 打回超过 3 轮仍不通过的，写入「打回记录」并注明理由，等人工处理。
5. 调研笔记顶部写属性：status、来源、核查模型、日期。

Al terminar, verás cuatro carpetas y un archivo CLAUDE.md en el panel izquierdo de Obsidian. En la raíz también hay una carpeta de configuración .obsidian, que Obsidian oculta de forma predeterminada. Ahí se guardan los ajustes de Obsidian y ningún agente debería modificarla.

Paso ②: Configura el token de APIYI en Claude Code

En este paso no repetiremos los detalles de configuración. Sigue este tutorial: Cómo conectar Claude Code, Codex, Pi, Hermes y otras herramientas desde una ventana con magpie. Configura el token de APIYI desde la interfaz gráfica y luego vuelve aquí.

Solo debes tener en cuenta dos cosas:

• Al crear el token en la consola de APIYI, selecciona el grupo ClaudeCode.
• La dirección de la API debe ser https://api.apiyi.com; no añadas /v1 al final.

Cuando termines, abre una terminal en la carpeta 调研库, escribe claude para iniciar Claude Code y hazle cualquier pregunta. Si responde con normalidad, la conexión está lista.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_AUTH_TOKEN": "你的 APIYI 令牌"
  }
}

Al terminar, verás que Claude Code responde con normalidad. También aparecerá un registro de uso de este token en la consola de APIYI, lo que confirma que las solicitudes se enviaron con él.

Paso ③: Pídele a Claude Code en una frase que cree los subagentes de investigación y verificación

Los subagentes son archivos Markdown con encabezados YAML. No hace falta que los escribas tú: pídele a Claude que los cree. En Claude Code, envíale este mensaje:

请在当前项目的 .claude/agents/ 下创建两个子代理：
1. researcher（调研员）：模型 claude-sonnet-5-5。只用 WebFetch 读任务清单里给的链接，
   每条结论附来源链接和原文摘录，把结果写到「原始资料」文件夹。不给 Agent 工具。
2. fact-checker（核查员）：模型 claude-haiku-5-5。只给 Read、Grep、Glob，
   不给 Write、Edit、Agent。它只接收“结论 + 原文摘录 + 来源文件路径”，
   不看调研员的推理过程，只输出「通过」或「打回 + 理由」，不得自己修改任何内容。

La sesión principal usa claude-opus-5-5 y se encarga de dividir las preguntas, asignar las tareas y reunir los resultados. Puedes cambiar el modelo después de iniciar con /model o configurarlo directamente en la herramienta del paso ②.

---
name: researcher
description: 按任务清单读取给定链接，产出带来源和原文摘录的调研结论
tools: Read, Grep, Glob, WebFetch, Write
model: claude-sonnet-5-5
maxTurns: 20
---
你是调研员。只读取任务里给出的链接。每条结论格式：
结论 / 来源链接 / 原文摘录（原样引用）。写入「原始资料」文件夹，不碰其他目录。

---
name: fact-checker
description: 逐条核对结论是否被原文摘录支持，只判定不修改
tools: Read, Grep, Glob
model: claude-haiku-5-5
maxTurns: 8
---
你是核查员。只看结论和原文，不接受任何推理说明。
每条输出「通过」或「打回：理由」。摘录不支持、数字对不上、来源缺失一律打回。
你没有写权限，也不得建议替换措辞以外的任何修改。

Ten en cuenta que, después de crear por primera vez la carpeta .claude/agents/, tienes que cerrar y volver a abrir la sesión de Claude Code. A partir de entonces, los cambios en los archivos de los subagentes se aplicarán automáticamente en unos segundos. Los subagentes sin la herramienta Agent no pueden delegar tareas a otros subagentes, lo que evita que se formen cadenas de agentes difíciles de controlar.

Al terminar, verás que al escribir /agents aparecen researcher y fact-checker, cada uno con el modelo correspondiente.

Paso ④: Escribe la lista de tareas y asigna la investigación en paralelo con una frase

En la carpeta «任务清单» de Obsidian, crea 第一批.md. El ejemplo siguiente investiga cinco productos e incluye directamente el enlace que hay que consultar para cada uno. El motivo es que la documentación oficial no especifica si WebSearch está disponible cuando se llama a través de una pasarela de terceros. Lo más fiable es darles directamente los enlaces a los subagentes para que los consulten con WebFetch.

# 第一批：5 个产品定价与功能
1. 产品 A：定价页 https://example-a.com/pricing ，功能页 https://example-a.com/features
2. 产品 B：https://example-b.com/pricing
3. 产品 C：https://example-c.com/docs/plans
4. 产品 D：https://example-d.com/pricing
5. 产品 E：https://example-e.com/changelog
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

Vuelve a Claude Code y envíale este mensaje:

读取 任务清单/第一批.md，把 5 条任务分给 researcher 子代理并行调研，
各自写入「原始资料」。全部完成后告诉我每条的结论数量。

Los cinco productos son solo un ejemplo. El proceso es el mismo para hacer seguimiento de competidores, resumir puntos clave de artículos académicos o investigar noticias del sector: incluye un enlace en cada tarea y especifica qué preguntas hay que responder.

Al terminar, verás que van apareciendo cinco archivos en «原始资料» de Obsidian. Cada uno contiene entradas con el formato «conclusión / enlace de origen / fragmento original».

Paso ⑤: Configura el ciclo de verificación, con un máximo de tres rondas de revisión

Dile lo siguiente a la sesión principal:

对「原始资料」里的每条结论，只把“结论 + 原文摘录 + 来源路径”交给 fact-checker。
通过的，由你写入「调研笔记」，顶部属性填 status: 已核查、来源、核查模型: claude-haiku-5-5、日期。
打回的，把理由交给 researcher 重写后再核查，最多 3 轮；
3 轮仍不过的，写入「打回记录」并附理由，不要放进调研笔记。

Esto es lo que la documentación oficial llama «subagentes en cadena»: primero se encarga la tarea al subagente A y, cuando termina, se pasa el resultado al subagente B. Aquí, la sesión principal actúa como coordinadora y controla estrictamente lo que puede ver el verificador: solo recibe las conclusiones y el texto original, no el proceso de razonamiento.

Al terminar, verás conclusiones verificadas en «调研笔记» y quizá algunas entradas con sus motivos en «打回记录». Es normal que haya registros de rechazo: significa que el verificador está haciendo su trabajo.

Paso ⑥: Revisa las conclusiones verificadas en Obsidian

Abre cualquier nota de investigación. Las propiedades de la parte superior deberían tener un aspecto parecido a este:

---
status: 已核查
来源: https://example-a.com/pricing
核查模型: claude-haiku-5-5
日期: 2026-10-21
---

Escribe [status:已核查] en el cuadro de búsqueda de Obsidian para filtrar todas las notas que han superado la verificación. Para revisarlas, te recomendamos seleccionar al azar dos o tres, abrir los enlaces de origen y comprobar el texto original por tu cuenta.

Al terminar, verás que cada conclusión de los resultados de búsqueda se puede rastrear hasta el texto original. El contenido sospechoso queda agrupado en «打回记录», a la espera de que lo evalúes manualmente.

Reparto de tareas y precios de los tres modelos del enjambre

Los tres roles usan el mismo token de APIYI; lo único que cambia es el nombre del modelo. Los precios de la tabla proceden de la interfaz de precios de APIYI del 21 de octubre de 2026 (grupo default). En el grupo ClaudeCode se aplica además un descuento del 5 %.

Sobre los costos, hay varios puntos que conviene tener claros. Cuantos más subagentes haya, más extensos serán los resultados que devuelvan y más espacio ocuparán en la ventana de contexto de la sesión principal. Además, cada subagente consume tokens por separado mientras se ejecuta.

Tabla de solución de problemas frecuentes del enjambre de investigación

Si no sabes qué herramientas están disponibles en la sesión actual, pregúntale directamente a Claude «¿Qué herramientas tienes disponibles?» y te las enumerará.

Cuándo no conviene usar Obsidian con Claude Code para crear un enjambre de investigación

Este método tiene un costo fijo y no es adecuado para todos los casos. En las siguientes situaciones, será más sencillo hablar directamente con Claude:

• Solo necesitas consultar uno o dos datos: el proceso de desglosar la tarea, asignarla y verificarla supone más trabajo que la propia investigación.
• Todo el material está en un solo artículo: basta con pedirle a Claude que lo lea y lo resuma; no hace falta trabajar en paralelo.
• Necesitas datos en tiempo real: por ejemplo, cotizaciones bursátiles o tipos de cambio actuales. Para este tipo de datos es mejor usar una interfaz de datos especializada, ya que el contenido de las páginas web puede estar desactualizado.
• Tienes un presupuesto muy ajustado: varios subagentes pueden multiplicar el consumo de tokens. Primero resulta más rentable resolver la necesidad en una sola sesión.

Hoja de consulta rápida para investigar en equipo con Obsidian y Claude Code

Guarda esta tabla y consúltala cada vez que empieces una nueva tanda de investigación.

Preguntas frecuentes

Puntos clave del enjambre de investigación

• La estrategia importa más que la cantidad: los modelos más potentes hacen el trabajo y los más económicos verifican la información. El número de agentes no es lo importante.
• La biblioteca es solo una carpeta: Claude Code lee y escribe archivos Markdown directamente; para empezar no necesitas complementos.
• El revisor debe tener acceso de solo lectura: no le des permisos de escritura, edición ni de agente; solo debe aprobar o devolver el trabajo.
• Aísla el proceso de razonamiento: el revisor solo debe ver las conclusiones y las fuentes originales para evitar que la influencia del investigador sesgue su criterio.
• Usa WebFetch para los enlaces: así evitas el límite de WebSearch y no tienes que preocuparte por si la pasarela lo admite.
• Si no se aprueba tras 3 rondas, pásalo a una persona: deja constancia en el registro de devoluciones y no fuerces su incorporación a la biblioteca.
• Primero haz una prueba para calcular el costo: con el mismo token de APIYI, consulta el uso real en la consola.

Resumen

Para crear un enjambre de investigación con Obsidian y Claude Code, hay tres aspectos clave:

1. Estructura clara: cuatro carpetas y un archivo CLAUDE.md que especifique quién puede escribir en cada lugar.
2. Funciones diferenciadas: Sonnet investiga, Haiku verifica y Opus coordina. El revisor no tiene permisos de escritura.
3. Un flujo cerrado para incorporar el contenido: lo aprobado pasa a las notas de investigación; lo que no, se devuelve para corregir. Si no se aprueba tras 3 rondas, se deriva a una persona.

Te recomendamos empezar con tres tareas pequeñas para probar todo el flujo y confirmar que la ubicación de los archivos, los resultados de la verificación y los costos sean los esperados. Después, reemplaza los ejemplos por tus propios casos de seguimiento de competidores, artículos académicos o noticias del sector. Para conectar los modelos, puedes usar directamente un token de grupo de Claude Code de APIYI, apiyi.com. Los tres modelos comparten el mismo token, lo que facilita cambiar de uno a otro.

📚 Referencias

1. Documentación de subagentes de Claude Code: creación de subagentes, permisos de herramientas, campo de modelo e investigación en paralelo
2. Enlace: code.claude.com/docs/en/sub-agents

3. Nota: principal referencia para la configuración de subagentes de este artículo

4. Referencia de herramientas de Claude Code: comportamiento y límites de uso de WebSearch y WebFetch

5. Enlace: code.claude.com/docs/en/tools-reference

6. Nota: explica por qué se recomienda incluir los enlaces directamente en la lista de tareas

7. Configuración de modelos de Claude Code: alias y nombres completos de los modelos

8. Enlace: code.claude.com/docs/en/model-config

9. Nota: confirma a qué versiones corresponden opus, sonnet y haiku

10. Documentación de ayuda de Obsidian: bóvedas y almacenamiento de archivos

11. Enlace: obsidian.md/help

12. Nota: confirma que una bóveda es simplemente una carpeta normal y que los cambios externos se actualizan automáticamente

13. Prueba de un tercero: comparación de herramientas de IA para Obsidian (biblioteca pequeña con 560 artículos, una sola prueba)

14. Enlace: agentskillshub.top/best/obsidian-second-brain/

15. Nota: referencia para empezar sin instalar complementos

16. Documentación de integración de Claude Code de APIYI

17. Enlace: docs.apiyi.com/scenarios/programming/claude-code
18. Nota: explica los grupos de Claude Code, las direcciones y las variables de entorno

Autor: equipo técnico de APIYI
Consultas técnicas: Si tienes algún problema durante la configuración, déjanos un comentario. Encontrarás más instrucciones de integración en el centro de documentación de APIYI: docs.apiyi.com.

Artículos relacionados

• Tutorial paso a paso: conecta todos los agentes con una sola clave y usa magpie, de código abierto, para unificar el acceso a la pasarela de API (con Claude Code, Codex, Pi y Hermes como ejemplos): Un tutorial práctico que puedes completar siguiendo los pasos: en unos 30 minutos, todos los agentes de programación de tu máquina (como Claude Code, Codex, Pi y Hermes) compartirán una clave API y una dirección de pasarela; incluye capturas de la interfaz de magpie, el proceso de configuración paso a paso, una comparación de las configuraciones nativas y una tabla para solucionar errores.