Créer un essaim de recherche avec Obsidian et Claude Code : 6 étapes pour intégrer automatiquement les conclusions de recherche à votre base de connaissances

Ces derniers jours, un post très consulté a fait le tour de X : un « développeur chinois de 23 ans » aurait lancé 300 instances de Claude Code en parallèle. Chaque réponse était comparée au fichier source en une centaine de millisecondes, et plus de 100 fiches d’entreprise auraient été ajoutées à Obsidian « sans aucune erreur ».

L’idée à retenir : les modèles coûteux font le travail, les modèles moins chers vérifient les résultats ; si une réponse ne passe pas le contrôle, elle est renvoyée pour être retravaillée, et seules les réponses validées sont ajoutées à la base de connaissances.

Voici un tutoriel que vous pouvez suivre pas à pas. Tout se fait principalement dans une interface graphique, en donnant des instructions en langage courant à Claude Code. Pas besoin de savoir coder.

L’intérêt principal : à la fin de cet article, vous aurez installé sur votre ordinateur une petite équipe d’agents de recherche. La session principale découpe le sujet, plusieurs sous-agents de recherche trouvent des informations en parallèle, et un sous-agent de vérification, moins coûteux, examine chaque point à la loupe. Les conclusions validées sont ensuite automatiquement ajoutées à votre coffre Obsidian, avec leurs sources et une mention indiquant qu’elles ont été vérifiées.

Obsidian et Claude Code : mettre en place une équipe d’agents de recherche

Avant de vous lancer, vérifiez que vous remplissez les conditions suivantes.

• Objectif : la session principale (Opus) découpe le sujet et synthétise les résultats. Deux ou trois sous-agents de recherche (Sonnet) consultent les sources en parallèle, tandis qu’un sous-agent de vérification (Haiku) vérifie chaque affirmation. Les conclusions validées sont enregistrées dans le dossier « Notes de recherche » d’Obsidian.
• Durée : prévoyez un après-midi pour la première configuration. Ensuite, il suffira de rédiger une liste de tâches et de donner une consigne pour les lancer.
• Prérequis : Obsidian pour ordinateur et Claude Code installés, un compte APIYI, et une connexion Internet permettant d’accéder aux sources visées.
• Difficulté : débutant. Aucune ligne de code à écrire ; les fichiers de configuration ne figurent que dans des blocs repliables facultatifs.

Voici le plan général, avec un critère de validation pour chaque étape. Une fois une étape terminée, vérifiez le résultat attendu avant de passer à la suivante.

Points clés de l’étude sur l’essaim d’agents de recherche

Pourquoi répartir l’essaim de recherche entre deux rôles : « chercher » et « vérifier »

Augmenter le nombre d’agents sans ajouter de vérification, c’est aussi augmenter le risque de laisser passer des hallucinations. En confiant la recherche et la vérification à deux modèles différents, le vérificateur n’a qu’une seule question à trancher : cette conclusion est-elle étayée par un extrait du texte source ? Cette tâche étant bien plus simple que la recherche elle-même, un modèle Haiku, moins coûteux, suffit.

Un conseil très utile a aussi été partagé dans les commentaires : le vérificateur ne doit pas voir le raisonnement de l’agent de recherche. Il ne doit consulter que la conclusion et le texte source, sinon il risque d’être influencé par les affirmations de l’agent. De plus, il doit uniquement répondre « validé » ou « refusé », avec une justification, et ne jamais modifier lui-même le contenu. Dès qu’il se met lui aussi à éditer, les rôles du vérificateur et de l’agent de recherche se confondent. La configuration présentée ici respecte ces deux principes.

Pourquoi on peut débuter avec Obsidian sans installer de plugin ni de MCP

Un coffre Obsidian est en réalité un simple dossier. Les outils de lecture et d’écriture intégrés à Claude Code peuvent directement manipuler les fichiers .md qu’il contient, et Obsidian actualise automatiquement leur affichage. Dans le test ponctuel par un tiers mentionné plus haut (un petit coffre de 560 notes, avec une seule exécution par outil), le groupe témoin sans aucun outil supplémentaire a consommé le moins de jetons. Il n’est donc pas nécessaire de s’embêter avec des plugins pour débuter. On ne dispose toutefois pas encore de données sur les performances avec des coffres plus volumineux.

Bien démarrer avec un essaim de recherche associant Obsidian et Claude Code

Étape ① : créer un coffre Obsidian et rédiger le fichier CLAUDE.md

Ouvrez Obsidian, choisissez « Créer un nouveau coffre » (pour créer un coffre vide), nommez-le 调研库 et choisissez un emplacement facile à retrouver, comme le dossier « Documents ». Ne placez pas ce coffre dans un autre coffre : les liens internes risqueraient de ne plus fonctionner.

Dans le panneau des fichiers, faites un clic droit et choisissez « Nouveau dossier ». Créez ces quatre dossiers : 任务清单, 原始资料, 调研笔记 et 打回记录.

Créez ensuite une note à la racine du coffre, nommez-la CLAUDE.md et indiquez-y les règles d’ajout de contenu. Claude Code lira ce fichier à chaque démarrage depuis ce dossier :

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

Une fois cette étape terminée : le panneau de gauche d’Obsidian affiche les quatre dossiers et le fichier CLAUDE.md. À la racine se trouve aussi un dossier de configuration .obsidian, masqué par défaut par Obsidian. Il contient les paramètres propres à l’application et aucun agent ne doit y toucher.

Étape ② : configurer le jeton APIYI dans Claude Code

Nous ne détaillons pas à nouveau la configuration ici. Suivez le tutoriel Utiliser magpie pour configurer Claude Code, Codex, Pi, Hermes et d’autres outils depuis une interface graphique pour configurer le jeton APIYI dans l’interface graphique, puis revenez ici.

Voici les deux points à retenir :

• Lors de la création du jeton dans la console APIYI, choisissez le groupe ClaudeCode.
• Saisissez https://api.apiyi.com comme adresse de l’API, sans ajouter /v1 à la fin.

Une fois la configuration terminée, ouvrez un terminal dans le dossier 调研库, saisissez claude pour démarrer Claude Code et posez-lui une question au hasard. S’il répond normalement, la connexion fonctionne.

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

Une fois cette étape terminée : Claude Code répond normalement à vos questions. Dans la console APIYI, vous devriez aussi voir apparaître une consommation associée à ce jeton, ce qui confirme que les requêtes passent bien par lui.

Étape ③ : demander à Claude Code de créer les sous-agents de recherche et de vérification

Un sous-agent est un fichier Markdown avec un en-tête YAML. Pas besoin de le rédiger vous-même : demandez à Claude de s’en charger. Dans Claude Code, envoyez-lui le texte suivant :

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

La session principale utilise claude-opus-5-5 et se charge de découper les questions, de distribuer les tâches et de regrouper les résultats. Vous pouvez changer de modèle après le démarrage avec /model, ou le définir directement dans l’outil utilisé à l’étape ②.

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

À noter : après avoir créé le dossier .claude/agents/ pour la première fois, vous devez quitter Claude Code et relancer une session. Par la suite, les modifications apportées aux fichiers des sous-agents sont prises en compte automatiquement en quelques secondes. Un sous-agent qui ne dispose pas de l’outil Agent ne peut pas en déléguer à son tour : cela évite les chaînes de sous-agents incontrôlables.

Une fois cette étape terminée : saisissez /agents. La liste doit afficher researcher et fact-checker, chacun avec le modèle correspondant.

Étape ④ : rédiger une liste de tâches et lancer la recherche en parallèle en une phrase

Dans le dossier « 任务清单 » d’Obsidian, créez le fichier 第一批.md. Voici un exemple de recherche sur cinq produits, avec les liens à consulter pour chacun. En effet, la documentation officielle ne précise pas si WebSearch est disponible lors d’un appel via une passerelle tierce. Le plus sûr est donc de fournir directement les liens pour que les sous-agents les consultent avec 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
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

Retournez dans Claude Code et envoyez-lui cette instruction :

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

Les cinq produits ne sont qu’un exemple. La méthode est la même pour surveiller des concurrents, résumer des articles scientifiques ou suivre l’actualité d’un secteur : indiquez un lien pour chaque tâche et précisez les questions auxquelles il faut répondre.

Une fois cette étape terminée : cinq fichiers apparaissent progressivement dans « 原始资料 » d’Obsidian, chacun contenant des éléments au format « conclusion / lien source / extrait du texte original ».

Étape ⑤ : configurer la boucle de vérification, avec un maximum de trois refus

Envoyez ensuite cette instruction à la session principale :

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

C’est ce que la documentation officielle appelle des « sous-agents en chaîne » : on demande d’abord à un sous-agent A de terminer sa tâche, puis on transmet le résultat à un sous-agent B. La session principale joue ici le rôle de coordinateur. Elle contrôle strictement les informations visibles par le vérificateur et ne lui transmet que la conclusion et le texte source, sans le raisonnement.

Une fois cette étape terminée : les conclusions vérifiées apparaissent dans « 调研笔记 ». Il peut aussi y avoir quelques entrées accompagnées de leur justification dans « 打回记录 ». C’est normal : cela signifie que le vérificateur fait son travail.

Étape ⑥ : valider les conclusions vérifiées dans Obsidian

Ouvrez une note de recherche au hasard. Les propriétés en haut de la note devraient ressembler à ceci :

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

Saisissez [status:已核查] dans la barre de recherche d’Obsidian pour filtrer toutes les notes vérifiées. Pour la validation, nous vous conseillons d’en choisir deux ou trois au hasard et de consulter les liens sources afin de vérifier vous-même les textes d’origine.

Une fois cette étape terminée : chaque conclusion des résultats filtrés peut être retracée jusqu’à son texte source. Les éléments douteux sont regroupés dans « 打回记录 », où vous pourrez les examiner vous-même.

Répartition des rôles et tarifs des trois modèles de la ruche de recherche

Les trois rôles utilisent le même jeton APIYI ; seul le nom du modèle change. Les tarifs ci-dessous proviennent de l’interface de tarification d’APIYI au 21 octobre 2026 (groupe default). Le groupe ClaudeCode bénéficie par défaut d’une remise de 5 %.

Quelques points méritent d’être précisés concernant les coûts. Plus il y a de sous-agents, plus leurs résultats sont longs et plus ils occupent la fenêtre de contexte de la session principale. De plus, chaque sous-agent consomme ses propres tokens pendant son exécution.

Tableau de dépannage des problèmes courants liés à un essaim de recherche

Si vous ne savez pas quels outils sont disponibles dans la session en cours, demandez directement à Claude : « De quels outils disposes-tu actuellement ? » Il vous les énumérera.

Quand éviter d’associer Obsidian à Claude Code pour créer un essaim de recherche

Cette configuration entraîne des frais fixes et ne convient pas à toutes les situations. Dans les cas suivants, une simple conversation avec Claude sera plus efficace :

• Pour vérifier une ou deux informations seulement : le coût du découpage, de la délégation et de la vérification dépasse celui de la recherche elle-même.
• Si toutes les sources se trouvent dans un seul article : demandez simplement à Claude de le lire puis d’en faire un résumé. Le travail en parallèle n’est pas nécessaire.
• Si vous avez besoin de données en temps réel : pour les cours de Bourse ou les taux de change, par exemple, mieux vaut utiliser une interface spécialisée. Les pages Web peuvent contenir des informations périmées.
• Si votre budget est très serré : plusieurs sous-agents consomment beaucoup plus de jetons. Il est plus économique de commencer par traiter le besoin dans une seule session.

Tableau récapitulatif pour lancer un essaim de recherche avec Obsidian et Claude Code

Enregistrez ce tableau et consultez-le chaque fois que vous lancez une nouvelle série de recherches.

Questions fréquentes

Points clés sur une équipe d’agents de recherche

• La méthode compte plus que le nombre : les modèles coûteux font le travail, les modèles moins chers vérifient les résultats. Le nombre d’agents n’est pas le critère essentiel.
• Une bibliothèque, ce sont simplement des dossiers : Claude Code lit et modifie directement les fichiers Markdown. Aucun plugin n’est nécessaire pour commencer.
• Le vérificateur doit être en lecture seule : ne lui donnez pas accès à Write, Edit ou Agent. Il doit uniquement indiquer si le résultat est validé ou à reprendre.
• Isolez le raisonnement : le vérificateur ne consulte que la conclusion et le texte source, afin de ne pas se laisser influencer par la personne chargée de la recherche.
• Pour les liens, utilisez WebFetch : vous éviterez les limites de WebSearch et n’aurez pas à vous demander si la passerelle le prend en charge.
• Après 3 refus, passez la main à une personne : consignez le cas dans le journal des retours et ne l’intégrez pas de force à la bibliothèque.
• Commencez par un essai pour évaluer les coûts : avec le même jeton APIYI, consultez la consommation réelle dans le tableau de bord.

En résumé

Pour monter une équipe d’agents de recherche avec Obsidian et Claude Code, trois points sont essentiels :

1. Une structure claire : 4 dossiers et un fichier CLAUDE.md, qui précisent où chacun peut écrire.
2. Des rôles distincts : Sonnet mène les recherches, Haiku vérifie les résultats et Opus coordonne le tout. Le vérificateur n’a aucun droit d’écriture.
3. Un processus d’intégration bien défini : seuls les résultats validés sont ajoutés aux notes de recherche. Les autres sont renvoyés pour être retravaillés ; après 3 refus, ils sont confiés à une personne.

Commencez par tester le processus de bout en bout avec 3 petites tâches. Vérifiez que les fichiers sont enregistrés au bon endroit, que les résultats sont correctement contrôlés et que les coûts sont conformes à vos attentes. Vous pourrez ensuite remplacer les exemples par vos propres sujets : veille concurrentielle, articles scientifiques ou actualités sectorielles. Pour connecter les modèles, vous pouvez utiliser directement un jeton du groupe ClaudeCode d’APIYI, sur apiyi.com. Les trois modèles partagent le même jeton, ce qui facilite le passage de l’un à l’autre.

📚 Références

1. Documentation des sous-agents de Claude Code : création des sous-agents, autorisations d’accès aux outils, champ du modèle et recherches en parallèle
2. Lien : code.claude.com/docs/en/sub-agents

3. Remarque : principale référence pour la configuration des sous-agents présentée dans cet article

4. Référence des outils de Claude Code : fonctionnement de WebSearch et WebFetch, et limites d’utilisation

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

6. Remarque : explique pourquoi il est recommandé d’inclure directement des liens dans la liste des tâches

7. Configuration des modèles de Claude Code : alias et noms complets des modèles

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

9. Remarque : confirme les versions correspondant à opus, sonnet et haiku

10. Documentation d’aide d’Obsidian : coffres et stockage des fichiers

11. Lien : obsidian.md/help

12. Remarque : confirme qu’un coffre est un simple dossier et que les modifications externes sont automatiquement actualisées

13. Comparatif réalisé par un tiers : outils d’IA pour Obsidian (petit coffre de 560 articles, un seul test)

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

15. Remarque : référence pour débuter sans installer de module complémentaire

16. Documentation de connexion de Claude Code à APIYI

17. Lien : docs.apiyi.com/scenarios/programming/claude-code
18. Remarque : informations sur le groupe Claude Code, l’adresse et les variables d’environnement

Auteur : équipe technique d’APIYI
Échanges techniques : si vous rencontrez des difficultés pendant la configuration, n’hésitez pas à laisser un commentaire. Pour en savoir plus sur la connexion, consultez le centre de documentation d’APIYI à l’adresse docs.apiyi.com.

Articles connexes

• Tutoriel pas à pas : une seule clé pour connecter tous les agents et unifier l’accès aux API avec la passerelle API open source magpie (exemples avec Claude Code, Codex, Pi et Hermes): Un tutoriel à suivre étape par étape : en environ 30 minutes, faites en sorte que tous les agents de programmation de votre machine (Claude Code, Codex, Pi et Hermes, par exemple) utilisent la même clé API et la même adresse de passerelle ; il comprend des captures d’écran de l’interface magpie, les étapes de configuration, une comparaison des configurations natives et un tableau de dépannage.