ObsidianとClaude Codeでリサーチスウォームを構築：調査結果をナレッジベースに自動で書き込む6つのステップ

ここ数日、Xで大きな注目を集めている投稿があります。「23歳の中国人開発者」がClaude Codeを300個並列で動かし、それぞれの出力を約100ミリ秒以内にソースファイルと照合。100件以上の企業プロフィールを「エラーゼロ」でObsidianに書き込んだというものです。

投稿から学べる本質的な考え方は、高性能モデルに作業を任せ、安価なモデルに真偽を判定させる。不合格ならやり直し、合格したものだけをデータベースに登録するということです。

これを再現できる、1本のチュートリアルです。作業のほとんどはグラフィカルインターフェースで行い、Claude Codeには普段の言葉で指示します。プログラミングの知識は必要ありません。

この記事でできること：読み終えるころには、自分のパソコンに小規模な調査エージェント群を構築できます。メインのセッションが課題を分解し、複数の調査サブエージェントが並行して情報を集めます。さらに、低コストの検証サブエージェントが一つひとつ内容をチェック。検証に通った結論は、出典と検証済みの印を付けて、自動的にObsidianのライブラリに保存されます。

ObsidianとClaude Codeで調査スウォームを構築する：始める前に

作業を始める前に、次の条件を確認してください。

• 目標：メインセッション（Opus）がテーマを分解して結果をまとめ、2～3個の調査サブエージェント（Sonnet）が並行して情報を調べます。さらに、1個の検証サブエージェント（Haiku）が各項目の真偽を確認し、確認済みの結論をObsidianの「調査ノート」フォルダーに保存します。
• 所要時間：初回のセットアップには、半日ほど見込んでください。次回以降は、タスクリストを作成して一言指示するだけで調査を依頼できます。
• 事前準備：Obsidianのデスクトップ版とClaude Codeをインストールし、APIYIのアカウントを用意してください。また、調査対象のリンクに問題なくアクセスできるインターネット環境が必要です。
• 難易度：入門レベルです。コードを書く必要はありません。設定ファイルが登場するのは、任意で開く折りたたみ部分だけです。

全体の流れを以下に示します。各ステップには完了条件も記載しています。ステップを終えたら、完了条件を満たしていることを確認してから次に進んでください。

調査スウォームの要点

調査スウォームを「調査」と「真偽判定」の2つの役割に分ける理由

エージェントの数だけを増やして検証を加えなければ、並列処理が増えるほど、紛れ込む幻覚も増えていきます。調査と検証を2つのモデルに分担させると、検証担当は「この結論は原文の引用箇所で裏付けられているか」だけを判断すればよくなります。調査そのものよりずっと簡単なタスクなので、安価な Haiku で十分です。

コメント欄では、実用的なアドバイスも紹介されていました。検証担当には、調査担当の推論過程を見せず、結論と原文だけを渡しましょう。そうしないと、調査担当の説明に引きずられる可能性があります。また、検証担当の出力は「承認／差し戻し＋理由」だけにし、自分で内容を修正させてはいけません。検証担当も修正を始めると、調査担当との役割分担が曖昧になります。この記事では、この2つの方針に沿って設定します。

Obsidian の入門でプラグインや MCP が不要な理由

Obsidian の保管庫は、実質的には単なるフォルダーです。Claude Code に標準搭載されている読み書きツールで、中の .md ファイルを直接操作できます。変更内容は Obsidian に自動で反映されます。先ほど紹介した第三者による実測（小規模な保管庫にノート560件、各ツールの実行は1回のみ）では、何も追加していない対照グループが最もトークンを節約できました。そのため、入門時にプラグインを導入する必要はありません。保管庫の規模が大きくなった場合の性能については、現時点でデータがありません。

Obsidian と Claude Code で調査スウォームを始める

ステップ①：Obsidian で保管庫を作成し、CLAUDE.md を用意する

Obsidian を開き、「新しい保管庫」を選択して、空の保管庫を作成します。名前は 調研库、保存場所は「ドキュメント」など、見つけやすいフォルダーを選びましょう。この保管庫を別の保管庫の中に作るのは避けてください。保管庫の中に別の保管庫を作ると、内部リンクが機能しなくなることがあります。

左側のファイル一覧を右クリックして「新しいフォルダー」を選び、次の4つのフォルダーを作成します：任务清单、原始资料、调研笔记、打回记录。

次に、保管庫のルートに CLAUDE.md というノートを作り、ファイルの取り込みルールを記入します。Claude Code は、このディレクトリで起動するたびにこのファイルを読み込みます。

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

完了すると：Obsidian の左側に4つのフォルダーと CLAUDE.md が表示されます。ルートには .obsidian という設定フォルダーもあります。Obsidian では通常、これは非表示になっています。Obsidian 自体の設定が保存されているため、どのエージェントも変更しないようにしてください。

ステップ②：Claude Code に APIYI のトークンを設定する

設定の詳細は、この記事では繰り返しません。magpie を使って Claude Code などのツールをウィンドウ上でまとめて接続する方法を参考に、グラフィカルな画面で APIYI のトークンを設定してから、こちらに戻ってきてください。

注意点は次の2つだけです。

• APIYI のコンソールでトークンを作成するときは、グループに ClaudeCode を選びます。
• エンドポイントには https://api.apiyi.com を指定します。末尾に /v1 は付けないでください。

設定が終わったら、调研库 フォルダーでターミナルを開き、claude と入力して起動します。適当な質問をして、正常に回答が返ってくれば接続完了です。

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

完了すると：Claude Code が質問に正常に回答します。また、APIYI のコンソールにこのトークンの使用量が記録されていれば、リクエストが実際にこのトークン経由で送信されたことを確認できます。

ステップ③：ひと言で Claude Code に調査担当と検証担当のサブエージェントを作らせる

サブエージェントは YAML ヘッダー付きの Markdown ファイルです。自分で書く必要はなく、Claude に作成を任せられます。Claude Code に次の内容を送ってください。

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

メインのセッションには claude-opus-5-5 を使い、課題の分割、タスクの割り当て、結果の取りまとめを担当させます。起動後に /model で切り替える方法と、ステップ②で使ったツールから直接設定する方法があります。

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

注意：.claude/agents/ ディレクトリを初めて作成したあとは、Claude Code のセッションをいったん終了し、もう一度起動してください。その後、サブエージェントのファイルを変更すると、数秒以内に反映されます。Agent ツールを割り当てていないサブエージェントは、さらに別のサブエージェントを呼び出せません。こうすることで、エージェントが何層にも増えて制御不能になるのを防げます。

完了すると：/agents を入力すると、一覧に researcher と fact-checker が表示され、それぞれに対応するモデルが示されます。

ステップ④：タスクリストを作成し、ひと言で並列調査を依頼する

Obsidian の「任务清单」フォルダーに 第一批.md を作成します。ここでは5つの製品を調査する例を使い、それぞれに参照するリンクを直接記載します。第三者のゲートウェイ経由で呼び出す場合、WebSearch が利用できるかどうかは公式ドキュメントに明記されていないため、リンクを直接渡してサブエージェントに 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
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

Claude Code に戻り、次のように送信します。

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

ここに挙げた5つの製品はあくまで例です。競合製品のモニタリング、論文の要点整理、業界ニュースの調査でも、同じ方法で進められます。各タスクにリンクを指定し、回答してほしい質問を明記してください。

完了すると：Obsidian の「原始资料」フォルダーにファイルが5つ順次作成され、それぞれに「結論／出典リンク／原文の引用」という項目が記載されます。

ステップ⑤：検証のループを設定し、差し戻しは最大3回までにする

続けて、メインセッションに次のように伝えます。

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

これが、公式ドキュメントでいう「チェーン型サブエージェント」です。まずサブエージェントAに作業させ、その結果をサブエージェントBに渡します。ここではメインセッションが調整役となり、検証担当に見せる内容を厳密に制限します。渡すのは結論と原文だけで、推論過程は見せません。

完了すると：「调研笔记」に検証済みの結論が記録され、「打回记录」には理由付きの項目がいくつか残ることがあります。差し戻しが記録されるのは正常です。検証担当が機能している証拠です。

ステップ⑥：Obsidian で検証済みの結論を確認する

任意の調査ノートを開き、冒頭のプロパティが次のようになっていることを確認します。

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

Obsidian の検索ボックスに [status:已核查] と入力すると、検証に通ったノートを絞り込めます。確認時には、2〜3件をランダムに選び、出典リンクを開いて原文を直接照合するのがおすすめです。

完了すると：検索結果に表示される結論はすべて原文までたどれるようになります。疑わしい内容は「打回记录」にまとまっているので、必要に応じて人が判断できます。

調査チームにおける3種類のモデルの役割分担と料金

3つの役割で使うのは同じAPIYIトークンで、異なるのはモデル名だけです。以下の料金は、APIYIの2026年10月21日時点の料金API（defaultグループ）に基づいています。ClaudeCodeグループでは、デフォルトでさらに5%割引が適用されます。

コストについては、押さえておきたい点がいくつかあります。サブエージェントを増やすほど、各エージェントから返される結果も長くなり、メインセッションのコンテキストを多く消費します。また、サブエージェントの実行にも、それぞれ個別にトークンがかかります。

調査スウォームでよくある問題と対処法

現在のセッションで使えるツールがわからない場合は、Claude に「今使えるツールは何ですか？」と尋ねてください。利用可能なツールの一覧が表示されます。

Obsidian と Claude Code を使った調査スウォームが向かないケース

この構成には一定の手間がかかるため、どんな場面にも適しているわけではありません。次のような場合は、Claude と直接やり取りするほうが手軽です。

• 調べる情報が1、2件だけの場合：テーマの分解、タスクの割り振り、内容の確認にかかる手間が、調査そのものを上回ります。
• 資料が1本の記事にまとまっている場合：Claude に記事をすべて読ませて要約してもらえば十分です。並列処理は必要ありません。
• リアルタイムのデータが必要な場合：株価やリアルタイムの為替レートなどは、Webページを読むと古い情報を取得する可能性があります。専用のデータ API を呼び出すほうが適しています。
• 予算が限られている場合：複数の子エージェントを使うとトークン消費が大幅に増えます。まずは単一のセッションで要件を試すほうが効率的です。

Obsidian＋Claude Code 調査スウォーム早見表

この表を保存しておき、新しい調査を始めるたびに確認しましょう。

よくある質問

調査スウォームの要点

• 数よりも考え方が重要：高性能モデルに作業を任せ、低コストのモデルに真偽を検証させます。エージェントの数は重要ではありません。
• ナレッジベースはフォルダーで十分：Claude Code は Markdown を直接読み書きできるため、導入時にプラグインは必要ありません。
• 検証担当は読み取り専用にする：Write、Edit、Agent の権限は付与せず、「承認」か「差し戻し」だけを出力させます。
• 推論プロセスは分離する：検証担当には結論と原文だけを見せ、調査担当の意見に引きずられないようにします。
• リンクの取得には WebFetch を使う：WebSearch の上限を避けられ、ゲートウェイが対応しているかどうかを心配する必要もありません。
• 3回の検証で通らなければ人に引き継ぐ：差し戻しの記録に残し、無理にナレッジベースへ登録しないようにします。
• コストはまず試運転して確認する：同じ APIYI のトークンを使い、コンソールで実際の利用量を確認します。

まとめ

Obsidian と Claude Code で調査スウォームを構築する際のポイントは、次の3つです。

1. 構成を明確にする：4つのフォルダーと1つの CLAUDE.md を用意し、誰がどこに書き込めるかを定めます。
2. 役割を分ける：Sonnet が調査、Haiku が検証、Opus が統括を担当します。検証担当には書き込み権限を与えません。
3. 登録までの流れを整える：承認された内容だけを調査ノートに登録し、承認されなければ修正のために差し戻します。3回検証しても通らない場合は、人が対応します。

まずは小さなタスクを3件試し、ファイルの保存先、検証の精度、費用が想定どおりかを確認してから、サンプルを自分の競合モニタリング、論文、業界ニュースなどに置き換えるのがおすすめです。モデルの接続には、APIYI（apiyi.com）の Claude Code 用グループトークンを利用できます。3種類のモデルで1つのトークンを共用できるため、切り替えも簡単です。

📚 参考資料

1. Claude Code サブエージェントのドキュメント：サブエージェントの作成、ツールの権限、モデルフィールド、並行調査について
2. リンク：code.claude.com/docs/en/sub-agents

3. 説明：この記事のサブエージェント設定の主な参考資料です

4. Claude Code ツールリファレンス：WebSearch、WebFetch の動作と利用回数の上限について

5. リンク：code.claude.com/docs/en/tools-reference

6. 説明：タスクリストにリンクを直接記載することを推奨する理由を解説しています

7. Claude Code モデル設定：モデルのエイリアスと正式なモデル名について

8. リンク：code.claude.com/docs/en/model-config

9. 説明：opus、sonnet、haiku がそれぞれどのバージョンに対応するかを確認できます

10. Obsidian ヘルプドキュメント：保管庫とファイルの保存方法について

11. リンク：obsidian.md/help

12. 説明：保管庫が通常のフォルダーであり、外部からの変更が自動的に反映されることを確認できます

13. 第三者による実測：Obsidian AI ツールの比較（560件のノートを含む小規模保管庫での単回テスト）

14. リンク：agentskillshub.top/best/obsidian-second-brain/

15. 説明：プラグインをインストールせずに始める場合の参考資料です

16. APIYI Claude Code 接続ガイド

17. リンク：docs.apiyi.com/scenarios/programming/claude-code
18. 説明：Claude Code のグループ、エンドポイント、環境変数について説明しています

著者：APIYI 技術チーム
技術に関するお問い合わせ：構築中に問題が発生した場合は、コメント欄からお気軽にお問い合わせください。接続方法の詳細は、APIYI のドキュメントセンター docs.apiyi.com でもご確認いただけます。

関連記事

• 徹底解説：1つのキーですべてのエージェントを接続、オープンソースのmagpieでAPIゲートウェイを一元化（Claude Code、Codex、Pi、Hermesを例に）:そのまま実践できるチュートリアル：所要時間は約30分で、Claude Code、Codex、Pi、Hermesなど、あなたのマシン上のすべてのコーディングエージェントで1つのAPIキーとゲートウェイアドレスを共有できます。magpieの画面キャプチャ、手順に沿った接続方法、ネイティブ設定の比較、エラーのトラブルシューティング表も含まれています。