用 Obsidian 加 Claude Code 搭调研蜂群：6 步让调研结论自动写进知识库

这几天 X 上有一条帖子浏览量很高：一位“23 岁的中国开发者”并行跑了 300 个 Claude Code，每条输出在约 100 毫秒内对照源文件核对，100 多份公司档案“零错误”地写进了 Obsidian。

帖子里真正值得学的思路：贵模型干活，便宜模型判真假，不合格就打回重做，通过了才入库。

一份照着做就能跑通的教程。整个过程以图形界面操作和“对 Claude Code 说人话”为主，不需要会写代码。

核心价值：读完本文，你会在自己电脑上搭好一个小号调研蜂群。主会话负责拆题，几个调研子代理并行查资料，一个便宜的核查子代理逐条挑刺，通过核查的结论会自动写进 Obsidian 库，并带上来源和核查标记。

Obsidian 加 Claude Code 调研蜂群：开始之前

动手之前，先确认下面几项条件。

• 目标：主会话（Opus）拆题和汇总，2～3 个调研子代理（Sonnet）并行查资料，1 个核查子代理（Haiku）逐条判真假，通过的结论写进 Obsidian 的「调研笔记」文件夹。
• 耗时：第一次搭建预留一个下午。之后每次调研只需要写一份任务清单，再说一句话派发。
• 前置条件：已安装 Obsidian 桌面端和 Claude Code，准备好一个 API易 账号，电脑可以正常上网访问目标资料链接。
• 难度：入门级。全程不需要写代码，配置文件只出现在可选的折叠块里。

下面是整体路线图，每一步都附了验收标准。做完一步、对照验收标准确认无误后，再进入下一步。

调研蜂群核心要点

调研蜂群为什么要拆成“干活”和“判真假”两种角色

只增加代理数量、不加校验，并发越多，混进来的幻觉也越多。把调研和核查拆给两个模型之后，核查员只需要回答一个问题：这句结论能不能在原文摘录里找到依据。这个任务比写调研本身简单得多，所以交给便宜的 Haiku 就够用。

评论区还有一条很实用的建议：核查员不要看调研员的推理过程，只看结论和原文，否则容易被调研员的说法带偏。另外，核查员只输出“通过 / 打回 + 理由”，不能自己动手改。一旦核查员也去改内容，它和调研员的职责就混在一起了。本文的配置完全按这两条来做。

Obsidian 入门为什么不用装插件或 MCP

Obsidian 的库本质上就是一个文件夹，Claude Code 自带的读写工具可以直接操作里面的 .md 文件，Obsidian 会自动刷新显示。前面提到的第三方实测（560 篇小库、每个工具只跑一次）中，什么都不装的对照组反而最省 token。所以入门阶段不需要折腾插件，库规模变大之后表现如何，目前还没有数据。

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 自己的设置，任何 Agent 都不应该改动它。

第 ② 步：给 Claude Code 接好 API易 令牌

这一步本文不重复讲配置细节。请按 用 magpie 在窗口里统一接入 Claude Code 等工具 这篇教程，在图形窗口里接好 API易 令牌，然后再回到这里。

需要留意的只有两点：

• 在 API易 控制台创建令牌时，分组选 ClaudeCode。
• 接口地址填 https://api.apiyi.com，末尾不要加 /v1。

接好之后，在 调研库 文件夹里打开终端，输入 claude 启动，随便问一句，能正常回复就说明接通了。

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

做完你会看到：Claude Code 正常回答问题。同时，API易 控制台里这把令牌出现了用量记录，这说明请求确实是通过这把令牌发出去的。

第 ③ 步：一句话让 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:已核查]，就能筛选出所有通过核查的笔记。验收时建议随机抽两三条，点开来源链接，亲自核对一下原文。

做完你会看到：筛选结果中的每条结论都能追溯到原文，可疑内容都集中在「打回记录」里，等你人工判断。

调研蜂群三种模型分工与价格

三个角色使用同一把 API易 令牌，区别只在模型名。下表价格来自 API易 2026-10-21 的价格接口（default 分组），ClaudeCode 分组默认还有 95 折。

关于成本，需要说清楚几件事。子代理越多，每个子代理返回的结果越长，主会话的上下文就占用得越多，每个子代理运行时也会单独消耗 token。

调研蜂群常见问题排错表

如果不确定当前会话里有哪些工具可用，直接问 Claude“你现在有哪些工具”，它会列出来。

什么时候不该用 Obsidian 加 Claude Code 搭调研蜂群

这套搭法有固定开销，不是所有场景都适合。遇到下面几种情况，直接和 Claude 单聊会更省事：

• 只查一两条信息：拆题、派发、核查的流程开销比调研本身还大。
• 资料都在一篇文章里：让 Claude 直接读完再总结即可，不需要并行。
• 需要实时数据：比如股价、实时汇率，这类数据更适合调用专门的数据接口，读网页容易拿到过期内容。
• 预算很紧：多个子代理会成倍消耗 token，先用单会话把需求跑通更划算。

Obsidian 加 Claude Code 调研蜂群速查表

把这张表保存下来，以后每次开新一批调研时对照着用。

常见问题

调研蜂群核心要点

• 思路比数量重要：贵模型干活、便宜模型判真假，代理多少不是关键。
• 库就是文件夹：Claude Code 直接读写 Markdown，入门不需要插件。
• 核查员必须只读：不给 Write、Edit、Agent，只输出通过或打回。
• 隔离推理过程：核查员只看结论和原文，避免被调研员带偏。
• 给链接用 WebFetch：避开 WebSearch 上限，也不用担心网关是否支持。
• 3 轮不过就交给人：写进打回记录，不要硬塞进库里。
• 成本先试跑再看：同一把 API易 令牌，到控制台查看实际用量。

总结

用 Obsidian 加 Claude Code 搭调研蜂群，核心有三点：

1. 结构清晰：4 个文件夹加一份 CLAUDE.md，规定好谁能写哪里。
2. 职责分离：Sonnet 调研、Haiku 核查、Opus 统筹，核查员没有写权限。
3. 闭环入库：通过才进调研笔记，不通过就打回重做，3 轮不过交给人工。

建议先拿 3 条小任务把整个流程跑通，确认文件落点、核查效果和费用都符合预期，再把示例替换成你自己的竞品监控、论文或行业新闻。模型接入可以直接使用 API易 apiyi.com 的 ClaudeCode 分组令牌，三种模型共用一把，切换起来比较方便。

📚 参考资料

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. API易 Claude Code 接入文档

17. 链接：docs.apiyi.com/scenarios/programming/claude-code
18. 说明：ClaudeCode 分组、地址与环境变量说明

作者：APIYI 技术团队
技术交流：搭建过程中遇到问题，欢迎在评论区留言，更多接入说明可查阅 API易 docs.apiyi.com 文档中心

延伸阅读

• 手把手教程：一个 Key 接上所有 Agent，用开源 magpie 统一接入 API 网关（以 Claude Code、Codex、Pi、Hermes 为例）:一份能照着做完的教程：约 30 分钟让你机器上所有编程 Agent（以 Claude Code、Codex、Pi、Hermes 为例）共用一个 API Key 和一个网关地址。含 magpie 界面截图、逐步接入流程、原生配置对照和报错排查表。