Mit Obsidian und Claude Code einen Recherche-Schwarm aufbauen: In 6 Schritten Rechercheergebnisse automatisch in die Wissensdatenbank übertragen

In den letzten Tagen erzielte ein Beitrag auf X sehr viele Aufrufe: Ein „23-jähriger chinesischer Entwickler“ ließ 300 Claude-Code-Instanzen parallel laufen. Jede Ausgabe wurde innerhalb von etwa 100 Millisekunden mit der Quelldatei abgeglichen. So landeten über 100 Unternehmensprofile „fehlerfrei“ in Obsidian.

Der wirklich interessante Gedanke dahinter: Ein teures Modell erledigt die Arbeit, ein günstiges prüft die Ergebnisse. Was nicht überzeugt, geht zurück zur Überarbeitung – erst nach bestandener Prüfung wird es gespeichert.

Eine Anleitung, die Sie Schritt für Schritt umsetzen können. Der gesamte Ablauf erfolgt über eine grafische Oberfläche und mit natürlich formulierten Anweisungen an Claude Code. Programmierkenntnisse sind nicht erforderlich.

Der zentrale Mehrwert: Nach der Lektüre haben Sie auf Ihrem eigenen Rechner einen kleinen Recherche-Schwarm eingerichtet. Die Hauptsitzung zerlegt die Fragestellung, mehrere Recherche-Subagenten suchen parallel nach Informationen und ein günstiger Prüf-Subagent hinterfragt jede einzelne Aussage. Geprüfte Ergebnisse werden automatisch samt Quellen und Prüfvermerk in Ihrem Obsidian-Wissensspeicher abgelegt.

Obsidian mit Claude Code: Einen Recherche-Schwarm aufbauen

Bevor Sie loslegen, prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind.

• Ziel: Die Hauptsitzung (Opus) zerlegt die Fragestellung und fasst die Ergebnisse zusammen. Zwei bis drei Recherche-Subagenten (Sonnet) recherchieren parallel. Ein Prüf-Subagent (Haiku) überprüft jede Aussage einzeln. Bestätigte Erkenntnisse landen im Obsidian-Ordner „Recherche-Notizen“.
• Zeitaufwand: Planen Sie für die erstmalige Einrichtung einen Nachmittag ein. Für jede weitere Recherche müssen Sie nur noch eine Aufgabenliste erstellen und den Auftrag mit einem Satz erteilen.
• Voraussetzungen: Obsidian Desktop und Claude Code sind installiert, Sie haben ein APIYI-Konto und Ihr Computer kann über das Internet auf die relevanten Quellen zugreifen.
• Schwierigkeitsgrad: Einsteigerfreundlich. Sie müssen während des gesamten Ablaufs keinen Code schreiben. Konfigurationsdateien kommen nur in optionalen ausklappbaren Abschnitten vor.

Die folgende Übersicht zeigt den gesamten Ablauf. Zu jedem Schritt gibt es ein Abnahmekriterium. Schließen Sie einen Schritt ab und prüfen Sie, ob das Kriterium erfüllt ist, bevor Sie weitermachen.

Zentrale Erkenntnisse aus der Recherche zum Agenten-Schwarm

Warum der Recherche-Schwarm zwei Rollen braucht: „recherchieren“ und „überprüfen“

Wenn man nur die Zahl der Agenten erhöht, aber keine Prüfung einführt, schleichen sich mit zunehmender Parallelisierung auch mehr Halluzinationen ein. Teilt man Recherche und Überprüfung auf zwei Modelle auf, muss der Prüfer nur eine Frage beantworten: Wird die Aussage durch die Originalquelle belegt? Diese Aufgabe ist deutlich einfacher als die Recherche selbst – dafür reicht das günstigere Haiku-Modell.

In den Kommentaren gab es noch einen praktischen Hinweis: Der Prüfer sollte nicht den Denkprozess des Recherche-Agenten sehen, sondern nur die Aussage und den Originaltext. Sonst lässt er sich leicht von der Darstellung des Recherche-Agenten beeinflussen. Außerdem sollte der Prüfer ausschließlich „bestätigt / zurückgewiesen + Begründung“ ausgeben und keine Änderungen selbst vornehmen. Sobald er Inhalte überarbeitet, vermischen sich seine Aufgaben mit denen des Recherche-Agenten. Die Konfiguration in diesem Artikel folgt genau diesen beiden Grundsätzen.

Warum man für den Einstieg in Obsidian weder Plugins noch MCP braucht

Ein Obsidian-Vault ist im Grunde ein Ordner. Die integrierten Lese- und Schreibwerkzeuge von Claude Code können die darin enthaltenen .md-Dateien direkt bearbeiten, und Obsidian aktualisiert die Anzeige automatisch. Im zuvor erwähnten Praxistest eines Drittanbieters – ein kleiner Vault mit 560 Notizen, jedes Tool wurde nur einmal ausgeführt – verbrauchte die Vergleichsgruppe ohne zusätzliche Tools am wenigsten Tokens. Für den Einstieg sind Plugins also nicht nötig. Wie sich das bei größeren Vaults verhält, ist bislang nicht belegt.

Schnellstart: Recherche-Schwarm mit Obsidian und Claude Code

Schritt ①: Vault in Obsidian erstellen und CLAUDE.md anlegen

Öffne Obsidian und wähle „Neuen Vault erstellen“ (einen neuen, leeren Vault anlegen). Nenne ihn 调研库 und wähle einen leicht auffindbaren Speicherort, zum Beispiel den Ordner „Dokumente“. Lege den Vault nicht in den Ordner eines anderen Vaults: Verschachtelte Vaults können dazu führen, dass interne Links nicht mehr funktionieren.

Klicke in der linken Dateiansicht mit der rechten Maustaste auf „Neuer Ordner“ und erstelle nacheinander diese vier Ordner: 任务清单, 原始资料, 调研笔记 und 打回记录.

Lege anschließend im Stammverzeichnis des Vaults eine Notiz namens CLAUDE.md an und trage dort die Regeln für den Vault ein. Claude Code liest diese Datei jedes Mal, wenn es in diesem Verzeichnis gestartet wird:

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

So sieht es danach aus: In der linken Seitenleiste von Obsidian findest du vier Ordner und eine Datei namens CLAUDE.md. Im Stammverzeichnis gibt es außerdem den Ordner .obsidian, den Obsidian standardmäßig ausblendet. Darin speichert Obsidian seine eigenen Einstellungen. Kein Agent sollte diesen Ordner verändern.

Schritt ②: APIYI-Token für Claude Code einrichten

Die Konfigurationsdetails werden hier nicht noch einmal erklärt. Richte das APIYI-Token über die grafische Oberfläche ein – folge dazu dieser Anleitung: Claude Code, Codex, Pi und Hermes mit magpie über eine grafische Oberfläche verbinden. Kehre anschließend hierher zurück.

Achte nur auf zwei Punkte:

• Wähle beim Erstellen des Tokens in der APIYI-Konsole die Gruppe ClaudeCode.
• Trage als API-Adresse https://api.apiyi.com ein und hänge kein /v1 an.

Öffne nach der Einrichtung im Ordner 调研库 ein Terminal und starte Claude Code mit claude. Stelle eine beliebige Frage. Wenn eine normale Antwort kommt, ist die Verbindung hergestellt.

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

So sieht es danach aus: Claude Code beantwortet Fragen ganz normal. Gleichzeitig wird in der APIYI-Konsole für dieses Token eine Nutzung angezeigt. Das bestätigt, dass die Anfrage tatsächlich über dieses Token gesendet wurde.

Schritt ③: Claude Code mit einem Satz Recherche- und Prüf-Unteragenten erstellen lassen

Unteragenten sind Markdown-Dateien mit einem YAML-Header. Du musst sie nicht selbst schreiben – lass Claude die Arbeit erledigen. Sende Claude Code diesen Text:

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

Die Hauptsitzung verwendet selbst claude-opus-5-5 und ist für die Aufteilung der Fragen, die Zuweisung der Aufgaben und die Zusammenfassung der Ergebnisse zuständig. Du kannst das Modell nach dem Start mit /model wechseln oder es direkt im Tool aus Schritt ② festlegen.

---
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
---
你是核查员。只看结论和原文，不接受任何推理说明。
每条输出「通过」或「打回：理由」。摘录不支持、数字对不上、来源缺失一律打回。
你没有写权限，也不得建议替换措辞以外的任何修改。

Hinweis: Nachdem du den Ordner .claude/agents/ zum ersten Mal erstellt hast, musst du die Claude-Code-Sitzung beenden und neu starten. Änderungen an den Unteragenten-Dateien werden danach innerhalb weniger Sekunden automatisch übernommen. Unteragenten ohne Agent-Tool können keine weiteren Unteragenten beauftragen. So vermeidest du unkontrollierte, ineinander verschachtelte Agentenketten.

So sieht es danach aus: Gib /agents ein. In der Liste erscheinen researcher und fact-checker, jeweils mit dem zugehörigen Modell.

Schritt ④: Aufgabenliste erstellen und parallele Recherche mit einem Satz starten

Lege im Obsidian-Ordner 任务清单 eine neue Datei namens 第一批.md an. Hier ein Beispiel mit fünf Produkten. Für jedes Produkt ist direkt der Link angegeben, den der Agent lesen soll. Der Grund: In der offiziellen Dokumentation ist nicht festgehalten, ob WebSearch bei Aufrufen über Drittanbieter-Gateways verfügbar ist. Am zuverlässigsten ist es daher, dem Unteragenten die Links direkt mitzugeben und sie mit WebFetch lesen zu lassen.

# 第一批：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
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

Wechsle zurück zu Claude Code und sende diese Anweisung:

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

Die fünf Produkte sind nur ein Beispiel. Das Vorgehen ist dasselbe, wenn du Wettbewerber beobachtest, Kernaussagen aus wissenschaftlichen Arbeiten sammelst oder Branchenmeldungen recherchierst: Gib für jede Aufgabe die Links an und nenne klar die Fragen, die beantwortet werden sollen.

So sieht es danach aus: Im Obsidian-Ordner 原始资料 erscheinen nach und nach fünf Dateien. Jede enthält Einträge im Format „Aussage / Quellenlink / Originalauszug“.

Schritt ⑤: Prüfschleife einrichten und höchstens drei Überarbeitungsrunden zulassen

Sende der Hauptsitzung anschließend diese Anweisung:

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

Das ist die offiziell beschriebene Vorgehensweise mit „verketteten Unteragenten“: Zuerst erledigt Unteragent A seine Aufgabe, anschließend wird das Ergebnis an Unteragent B weitergegeben. Die Hauptsitzung übernimmt dabei die Koordination und kontrolliert genau, welche Informationen der Prüfer erhält: nur die Aussage und den Originaltext, nicht den Denkprozess.

So sieht es danach aus: Im Ordner 调研笔记 findest du geprüfte Aussagen. Im Ordner 打回记录 können einige Einträge mit Begründungen liegen. Das ist normal und zeigt, dass der Prüfer seine Arbeit macht.

Schritt ⑥: Geprüfte Aussagen in Obsidian abnehmen

Öffne eine beliebige Recherche-Notiz. Die Eigenschaften am Anfang sollten etwa so aussehen:

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

Gib [status:已核查] in das Suchfeld von Obsidian ein, um alle erfolgreich geprüften Notizen zu filtern. Bei der Abnahme empfiehlt es sich, zwei oder drei Einträge stichprobenartig auszuwählen, die Quellenlinks zu öffnen und den Originaltext selbst zu überprüfen.

So sieht es danach aus: Jede Aussage in den Suchergebnissen lässt sich bis zur Originalquelle zurückverfolgen. Verdächtige Inhalte sind im Ordner 打回记录 gesammelt und warten dort auf deine manuelle Prüfung.

Aufgabenverteilung und Preise der drei Modelle im Recherche-Schwarm

Alle drei Rollen verwenden denselben APIYI-Schlüssel. Der einzige Unterschied ist der Modellname. Die folgende Tabelle zeigt die Preise aus der APIYI-Preisschnittstelle vom 21.10.2026 (Gruppe „default“). In der Gruppe „ClaudeCode“ gibt es standardmäßig zusätzlich 5 % Rabatt.

Bei den Kosten gibt es ein paar wichtige Punkte: Je mehr Subagenten eingesetzt werden, desto länger fallen ihre Ergebnisse aus und desto mehr Kontext belegen sie in der Hauptsitzung. Außerdem verbraucht jeder Subagent während seiner Ausführung separat Tokens.

Fehlerbehebung: Häufige Probleme mit dem Recherche-Schwarm

Wenn Sie nicht sicher sind, welche Tools in der aktuellen Sitzung verfügbar sind, fragen Sie Claude einfach: „Welche Tools stehen dir gerade zur Verfügung?“ Claude listet sie dann auf.

Wann Sie Obsidian und Claude Code nicht für einen Recherche-Schwarm nutzen sollten

Diese Kombination verursacht einen gewissen Grundaufwand und eignet sich nicht für alle Situationen. In den folgenden Fällen ist ein direktes Gespräch mit Claude einfacher:

• Sie möchten nur ein oder zwei Informationen nachschlagen: Der Aufwand für Aufteilung, Zuweisung und Prüfung ist größer als der Rechercheaufwand selbst.
• Alle Informationen stehen in einem einzigen Artikel: Lassen Sie Claude den Artikel direkt lesen und zusammenfassen. Eine parallele Bearbeitung ist nicht nötig.
• Sie benötigen Echtzeitdaten: Aktienkurse oder aktuelle Wechselkurse lassen sich besser über spezielle Datenschnittstellen abrufen. Beim Lesen von Webseiten besteht die Gefahr, veraltete Informationen zu erhalten.
• Das Budget ist knapp: Mehrere Unteragenten verbrauchen entsprechend mehr Tokens. Es ist günstiger, die Anforderungen zunächst in einer einzelnen Sitzung zu klären.

Obsidian und Claude Code: Kurzreferenz für Recherche-Schwärme

Speichern Sie diese Tabelle und nutzen Sie sie als Orientierung, wenn Sie eine neue Recherche starten.

Häufige Fragen

Die wichtigsten Erkenntnisse zum Recherche-Schwarm

• Die Strategie ist wichtiger als die Anzahl: Ein leistungsstarkes Modell übernimmt die Arbeit, ein günstigeres prüft die Ergebnisse. Wie viele Agenten beteiligt sind, ist nicht entscheidend.
• Eine Wissensdatenbank ist einfach ein Ordner: Claude Code kann Markdown-Dateien direkt lesen und bearbeiten. Für den Einstieg sind keine Plugins nötig.
• Prüfer müssen schreibgeschützt arbeiten: Sie erhalten keine Write-, Edit- oder Agent-Berechtigungen und geben nur „bestanden“ oder „zur Überarbeitung“ zurück.
• Denkprozesse voneinander trennen: Der Prüfer sieht nur das Ergebnis und die Originalquelle. So lässt er sich nicht von den Recherche-Agenten beeinflussen.
• Links mit WebFetch abrufen: So umgehen Sie das Limit von WebSearch und müssen sich keine Gedanken darüber machen, ob das Gateway die Funktion unterstützt.
• Nach drei erfolglosen Runden an einen Menschen übergeben: Halten Sie die Rückläufe fest, statt unfertige Ergebnisse in die Wissensdatenbank zu übernehmen.
• Kosten erst nach einem Testlauf bewerten: Prüfen Sie im Dashboard den tatsächlichen Verbrauch desselben APIYI-Tokens.

Zusammenfassung

Für einen Recherche-Schwarm mit Obsidian und Claude Code sind drei Punkte entscheidend:

1. Klare Struktur: vier Ordner und eine CLAUDE.md-Datei, in der geregelt ist, wer wo schreiben darf.
2. Getrennte Zuständigkeiten: Sonnet recherchiert, Haiku prüft und Opus koordiniert. Der Prüfer hat keine Schreibrechte.
3. Geschlossener Freigabeprozess: Nur freigegebene Ergebnisse landen in den Recherchenotizen. Abgelehnte Ergebnisse werden zur Überarbeitung zurückgegeben. Scheitern drei Runden, übernimmt ein Mensch.

Am besten testen Sie zunächst den gesamten Ablauf mit drei kleinen Aufgaben. Prüfen Sie, ob Dateien am richtigen Ort landen, die Ergebnisse zuverlässig kontrolliert werden und die Kosten Ihren Erwartungen entsprechen. Ersetzen Sie anschließend die Beispiele durch Ihre eigenen Themen – etwa Wettbewerbsbeobachtung, Fachartikel oder Branchennews. Für die Anbindung der Modelle können Sie direkt ein Claude-Code-Gruppentoken von APIYI unter apiyi.com verwenden. Alle drei Modelle nutzen dasselbe Token, was den Wechsel erleichtert.

📚 Referenzen

1. Dokumentation zu Claude-Code-Subagenten: Erstellung von Subagenten, Tool-Berechtigungen, Modellfelder und parallele Recherche
2. Link: code.claude.com/docs/en/sub-agents

3. Hinweis: Die wichtigste Grundlage für die Konfiguration der Subagenten in diesem Artikel

4. Referenz zu Claude-Code-Tools: Funktionsweise und Nutzungslimits von WebSearch und WebFetch

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

6. Hinweis: Erklärt, warum es sinnvoll ist, Links direkt in die Aufgabenliste aufzunehmen

7. Claude-Code-Modellkonfiguration: Modell-Aliase und vollständige Modellnamen

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

9. Hinweis: Bestätigt, welche Versionen den Bezeichnungen Opus, Sonnet und Haiku entsprechen

10. Obsidian-Hilfedokumentation: Tresore und Dateispeicherung

11. Link: obsidian.md/help

12. Hinweis: Bestätigt, dass ein Tresor ein gewöhnlicher Ordner ist und externe Änderungen automatisch aktualisiert werden

13. Praxistest eines Drittanbieters: Vergleich von Obsidian-KI-Tools (kleiner Tresor mit 560 Artikeln, ein Testlauf)

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

15. Hinweis: Referenz für den Einstieg ohne Plugins

16. Dokumentation zur Anbindung von Claude Code an APIYI

17. Link: docs.apiyi.com/scenarios/programming/claude-code
18. Hinweis: Erläuterungen zu Claude-Code-Gruppen, Adressen und Umgebungsvariablen

Autor: Technisches Team von APIYI
Technischer Austausch: Wenn während der Einrichtung Fragen auftauchen, schreiben Sie gerne einen Kommentar. Weitere Informationen zur Anbindung finden Sie im Dokumentationszentrum von APIYI unter docs.apiyi.com.

Weiterführende Artikel

• Schritt-für-Schritt-Anleitung: Mit einem einzigen Schlüssel alle Agenten verbinden und mit dem Open-Source-Projekt magpie ein einheitliches API-Gateway einrichten (am Beispiel von Claude Code, Codex, Pi und Hermes): Eine Schritt-für-Schritt-Anleitung, mit der du in etwa 30 Minuten alle Coding-Agents auf deinem Rechner – etwa Claude Code, Codex, Pi und Hermes – mit einem gemeinsamen API-Schlüssel und einer Gateway-Adresse nutzt, inklusive Screenshots der magpie-Oberfläche, schrittweiser Einrichtung, Vergleich der nativen Konfigurationen und Tabelle zur Fehlerbehebung.