Membangun kawanan riset dengan Obsidian dan Claude Code: 6 langkah agar kesimpulan riset otomatis tersimpan di basis pengetahuan

Beberapa hari terakhir, sebuah unggahan di X ramai dilihat. Isinya tentang seorang “developer Tiongkok berusia 23 tahun” yang menjalankan 300 Claude Code secara paralel. Setiap keluaran dicocokkan dengan file sumber dalam waktu sekitar 100 milidetik, lalu lebih dari 100 profil perusahaan ditulis ke Obsidian dengan “nol kesalahan”.

Gagasan yang benar-benar layak dipelajari dari unggahan itu: biarkan model mahal mengerjakan tugas, lalu minta model murah memeriksa kebenarannya. Jika tidak lolos, minta dikerjakan ulang; hanya hasil yang lolos pemeriksaan yang dimasukkan ke basis data.

Panduan yang bisa langsung diikuti sampai berhasil dijalankan. Seluruh prosesnya lebih banyak menggunakan antarmuka grafis dan instruksi dengan bahasa sehari-hari kepada Claude Code—Anda tidak perlu bisa menulis kode.

Manfaat utama: Setelah membaca artikel ini, Anda bisa menyiapkan tim riset kecil di komputer sendiri. Sesi utama bertugas memecah pertanyaan, beberapa subagen riset mencari informasi secara paralel, dan satu subagen pemeriksa yang lebih murah mengkritisi setiap temuan. Kesimpulan yang lolos pemeriksaan akan otomatis ditulis ke vault Obsidian, lengkap dengan sumber dan penanda verifikasi.

Riset Swarm dengan Obsidian dan Claude Code: Sebelum Mulai

Sebelum mulai, pastikan beberapa hal berikut sudah siap.

• Tujuan: Sesi utama (Opus) memecah topik dan merangkum hasil. Dua hingga tiga subagen riset (Sonnet) mencari informasi secara paralel, lalu satu subagen pemeriksa (Haiku) memeriksa kebenaran setiap poin. Kesimpulan yang lolos pemeriksaan disimpan di folder «Catatan Riset» Obsidian.
• Waktu yang dibutuhkan: Sisihkan satu sore untuk penyiapan pertama. Untuk riset berikutnya, cukup tulis daftar tugas lalu berikan satu instruksi untuk menjalankannya.
• Prasyarat: Obsidian versi desktop dan Claude Code sudah terpasang, akun APIYI sudah siap, dan komputer dapat mengakses tautan sumber yang dituju.
• Tingkat kesulitan: Pemula. Anda tidak perlu menulis kode. File konfigurasi hanya muncul di bagian opsional yang bisa dilipat.

Berikut alur lengkapnya. Setiap langkah dilengkapi kriteria penerimaan. Selesaikan satu langkah, lalu pastikan hasilnya sesuai kriteria sebelum melanjutkan ke langkah berikutnya.

Poin Utama Riset tentang Kawanan Agen

Mengapa kawanan agen riset perlu membagi peran menjadi “mengerjakan riset” dan “memverifikasi kebenaran”

Jika jumlah agen ditambah tanpa menambahkan proses verifikasi, makin banyak pekerjaan yang dijalankan secara paralel, makin banyak pula halusinasi yang bisa ikut masuk. Dengan membagi riset dan verifikasi ke dua model, pemeriksa hanya perlu menjawab satu pertanyaan: apakah kesimpulan ini punya dasar dalam kutipan sumber? Tugas ini jauh lebih sederhana daripada melakukan riset itu sendiri, jadi cukup dikerjakan oleh Haiku yang lebih murah.

Ada juga saran praktis di kolom komentar: pemeriksa jangan melihat proses penalaran peneliti. Cukup lihat kesimpulan dan sumber aslinya, agar tidak terpengaruh oleh cara peneliti menyampaikannya. Selain itu, pemeriksa hanya boleh memberikan hasil “lulus / dikembalikan + alasan” dan tidak boleh mengubah apa pun sendiri. Begitu pemeriksa ikut mengubah isi, perannya akan bercampur dengan peran peneliti. Konfigurasi dalam artikel ini sepenuhnya mengikuti kedua prinsip tersebut.

Mengapa untuk mulai menggunakan Obsidian, Anda tidak perlu memasang plugin atau MCP

Pada dasarnya, vault Obsidian hanyalah sebuah folder. Alat baca-tulis bawaan Claude Code bisa langsung digunakan untuk mengelola file .md di dalamnya, dan Obsidian akan memperbarui tampilannya secara otomatis. Dalam pengujian pihak ketiga yang disebutkan sebelumnya—vault kecil berisi 560 catatan, dengan setiap alat hanya dijalankan satu kali—kelompok pembanding yang tidak memasang apa pun justru menggunakan token paling sedikit. Jadi, Anda tidak perlu repot memasang plugin saat baru mulai. Belum ada data tentang kinerjanya saat ukuran vault bertambah.

Panduan Cepat Memulai Kawanan Agen Riset dengan Obsidian dan Claude Code

Langkah ①: Buat vault di Obsidian dan siapkan CLAUDE.md

Buka Obsidian, lalu pilih “Vault baru” (buat vault kosong). Beri nama 调研库, lalu pilih lokasi yang mudah ditemukan, misalnya folder “Dokumen”. Jangan letakkan vault ini di dalam folder vault lain karena vault di dalam vault bisa membuat tautan internal tidak berfungsi.

Klik kanan “Buat folder baru” di panel file sebelah kiri, lalu buat empat folder berikut: 任务清单, 原始资料, 调研笔记, dan 打回记录.

Setelah itu, buat catatan baru di direktori utama vault dan beri nama CLAUDE.md, lalu tuliskan aturan untuk memasukkan materi ke vault. Claude Code akan membaca file ini setiap kali dijalankan dari direktori tersebut:

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

Setelah selesai, Anda akan melihat empat folder dan satu file CLAUDE.md di panel sebelah kiri Obsidian. Di direktori utama juga ada folder konfigurasi .obsidian, yang secara default disembunyikan oleh Obsidian. Folder ini menyimpan pengaturan Obsidian, dan agen mana pun tidak boleh mengubahnya.

Langkah ②: Hubungkan token APIYI ke Claude Code

Artikel ini tidak akan mengulang detail konfigurasinya. Ikuti tutorial Menghubungkan Claude Code, Codex, Pi, Hermes, dan alat lainnya melalui satu jendela dengan magpie untuk menghubungkan token APIYI melalui antarmuka grafis, lalu kembali ke sini.

Perhatikan dua hal berikut:

• Saat membuat token di konsol APIYI, pilih grup ClaudeCode.
• Isi alamat API dengan https://api.apiyi.com, tanpa menambahkan /v1 di bagian akhir.

Setelah terhubung, buka terminal dari folder 调研库, ketik claude untuk memulai, lalu ajukan pertanyaan apa saja. Jika jawabannya muncul dengan normal, berarti koneksi berhasil.

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

Setelah selesai, Claude Code akan menjawab pertanyaan dengan normal. Selain itu, konsol APIYI akan menampilkan catatan penggunaan token tersebut. Ini menandakan bahwa permintaan memang dikirim menggunakan token itu.

Langkah ③: Minta Claude Code membuat subagen peneliti dan pemeriksa dengan satu instruksi

Subagen adalah file Markdown dengan header YAML. Anda tidak perlu menulisnya sendiri; minta Claude yang membuatnya. Kirim teks berikut di 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。它只接收“结论 + 原文摘录 + 来源文件路径”，
   不看调研员的推理过程，只输出「通过」或「打回 + 理由」，不得自己修改任何内容。

Sesi utama menggunakan claude-opus-5-5 untuk membagi tugas, menugaskan pekerjaan, dan merangkum hasil. Anda bisa beralih model dengan /model setelah memulai, atau mengaturnya langsung melalui alat pada langkah ②.

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

Perhatikan: setelah pertama kali membuat folder .claude/agents/, Anda perlu menutup lalu membuka kembali sesi Claude Code. Setelah itu, perubahan pada file subagen akan diterapkan otomatis dalam beberapa detik. Subagen yang tidak diberi alat Agent tidak bisa meneruskan tugas ke subagen lain. Dengan begitu, proses tidak akan berkembang menjadi rangkaian agen bertingkat yang sulit dikendalikan.

Setelah selesai, ketik /agents. Daftar akan menampilkan researcher dan fact-checker, masing-masing dengan model yang sesuai.

Langkah ④: Tulis daftar tugas, lalu tugaskan riset paralel dengan satu instruksi

Buat file 第一批.md di folder “Daftar Tugas” Obsidian. Contoh berikut menggunakan lima produk. Setiap tugas langsung mencantumkan tautan yang perlu dibaca. Alasannya, dokumentasi resmi tidak menjelaskan apakah WebSearch tersedia saat dipanggil melalui gateway pihak ketiga. Jadi, cara yang paling aman adalah memberikan tautan secara langsung agar subagen membacanya dengan 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
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

Kembali ke Claude Code, lalu kirim instruksi berikut:

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

Lima produk ini hanya contoh. Cara yang sama bisa digunakan untuk memantau kompetitor, merangkum makalah, atau mengikuti berita industri: cantumkan tautan untuk setiap tugas, lalu jelaskan pertanyaan apa saja yang harus dijawab.

Setelah selesai, lima file akan muncul satu per satu di folder “Materi Sumber”. Setiap file berisi butir dengan format “kesimpulan / tautan sumber / kutipan sumber”.

Langkah ⑤: Atur siklus verifikasi dengan maksimal tiga kali pengembalian

Lanjutkan dengan memberi instruksi berikut kepada sesi utama:

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

Inilah yang secara resmi disebut “subagen berantai”: minta subagen A menyelesaikan tugas terlebih dahulu, lalu teruskan hasilnya ke subagen B. Di sini, sesi utama bertindak sebagai pengatur tugas dan mengontrol dengan ketat informasi yang boleh dilihat pemeriksa: hanya kesimpulan dan sumber asli, bukan proses penalarannya.

Setelah selesai, kesimpulan yang sudah diverifikasi akan muncul di “Catatan Riset”. Sementara itu, “Catatan yang Dikembalikan” mungkin berisi beberapa butir beserta alasannya. Catatan yang dikembalikan adalah hal yang wajar—itu tandanya pemeriksa bekerja.

Langkah ⑥: Periksa kesimpulan yang sudah diverifikasi di Obsidian

Buka catatan riset mana saja. Properti di bagian atas seharusnya terlihat seperti ini:

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

Ketik [status:已核查] di kotak pencarian Obsidian untuk menyaring semua catatan yang sudah lolos verifikasi. Saat memeriksa hasilnya, sebaiknya pilih dua atau tiga butir secara acak, buka tautan sumbernya, lalu cocokkan sendiri dengan teks aslinya.

Setelah selesai, setiap kesimpulan dalam hasil pencarian bisa ditelusuri kembali ke sumber aslinya. Konten yang meragukan akan terkumpul di “Catatan yang Dikembalikan” untuk Anda periksa sendiri.

Riset pembagian tugas dan harga tiga model dalam swarm

Ketiga peran menggunakan kunci APIYI yang sama; yang berbeda hanya nama modelnya. Harga pada tabel berikut berasal dari API harga APIYI pada 2026-10-21 (grup default). Grup ClaudeCode juga mendapat diskon 5% secara default.

Soal biaya, ada beberapa hal yang perlu diperhatikan. Semakin banyak subagen, semakin panjang hasil yang dikembalikan masing-masing subagen, sehingga semakin banyak pula konteks yang digunakan dalam sesi utama. Setiap subagen juga mengonsumsi token secara terpisah saat berjalan.

Tabel Pemecahan Masalah Umum pada Swarm Riset

Kalau tidak yakin tool apa saja yang tersedia di sesi saat ini, tanyakan langsung kepada Claude, “Tool apa saja yang tersedia sekarang?” Claude akan menampilkannya.

Kapan Sebaiknya Tidak Menggunakan Obsidian dan Claude Code untuk Membuat Swarm Riset

Pendekatan ini memiliki biaya tetap, jadi tidak cocok untuk semua situasi. Untuk kondisi berikut, mengobrol langsung dengan Claude biasanya lebih praktis:

• Hanya mencari satu atau dua informasi: proses memecah pertanyaan, mendelegasikan, dan memeriksa hasil justru lebih merepotkan daripada risetnya sendiri.
• Semua materi ada dalam satu artikel: cukup minta Claude membaca seluruh artikel lalu membuat rangkuman. Tidak perlu memprosesnya secara paralel.
• Membutuhkan data real-time: misalnya harga saham atau kurs terkini. Data seperti ini lebih cocok diambil melalui API data khusus karena informasi di halaman web bisa sudah kedaluwarsa.
• Anggaran sangat terbatas: penggunaan beberapa subagen dapat meningkatkan konsumsi token berkali-kali lipat. Lebih hemat jika kebutuhan diuji terlebih dahulu dalam satu sesi.

Lembar contekan cepat untuk riset berkelompok dengan Obsidian dan Claude Code

Simpan tabel ini dan gunakan sebagai panduan setiap kali memulai batch riset baru.

Pertanyaan umum

Poin Utama tentang Swarm Riset

• Strategi lebih penting daripada jumlah: gunakan model mahal untuk mengerjakan tugas, lalu model murah untuk memeriksa kebenarannya. Jumlah agen bukan hal yang utama.
• Basis pengetahuan cukup berupa folder: Claude Code bisa langsung membaca dan menulis file Markdown. Tidak perlu plugin untuk memulai.
• Pemeriksa harus hanya memiliki akses baca: jangan beri akses Write, Edit, atau Agent. Pemeriksa hanya boleh menyatakan lolos atau mengembalikan hasil.
• Pisahkan proses penalaran: pemeriksa hanya melihat kesimpulan dan sumber asli agar tidak terpengaruh oleh peneliti.
• Gunakan WebFetch untuk tautan: cara ini menghindari batas WebSearch dan tidak perlu khawatir gateway mendukungnya atau tidak.
• Jika tidak lolos setelah 3 putaran, serahkan kepada manusia: catat dalam rekaman pengembalian, jangan memaksakan hasilnya masuk ke basis pengetahuan.
• Uji coba dulu sebelum menghitung biaya: gunakan kunci API APIYI yang sama, lalu periksa pemakaian sebenarnya di konsol.

Ringkasan

Untuk membangun swarm riset menggunakan Obsidian dan Claude Code, ada tiga hal utama:

1. Struktur yang jelas: gunakan 4 folder dan satu file CLAUDE.md untuk mengatur siapa yang boleh menulis di lokasi mana.
2. Pembagian tanggung jawab: Sonnet melakukan riset, Haiku memeriksa, dan Opus mengoordinasikan. Pemeriksa tidak memiliki izin menulis.
3. Alur penyimpanan yang tuntas: hasil yang lolos masuk ke catatan riset. Hasil yang tidak lolos dikembalikan untuk dikerjakan ulang. Jika tidak lolos setelah 3 putaran, serahkan kepada manusia.

Sebaiknya mulai dengan 3 tugas kecil untuk menguji seluruh alur. Pastikan lokasi file, hasil pemeriksaan, dan biaya sudah sesuai harapan sebelum mengganti contoh dengan pemantauan pesaing, makalah, atau berita industri milik Anda sendiri. Untuk menghubungkan model, Anda bisa langsung menggunakan token grup Claude Code dari APIYI apiyi.com. Ketiga model dapat menggunakan satu token yang sama, sehingga lebih praktis saat beralih model.

📚 Referensi

1. Dokumentasi Subagen Claude Code: pembuatan subagen, izin alat, kolom model, dan riset paralel
2. Tautan: code.claude.com/docs/en/sub-agents

3. Keterangan: Acuan utama untuk konfigurasi subagen dalam artikel ini

4. Referensi Alat Claude Code: cara kerja WebSearch dan WebFetch serta batas jumlah penggunaannya

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

6. Keterangan: Menjelaskan alasan kami menyarankan agar tautan dicantumkan langsung dalam daftar tugas

7. Konfigurasi Model Claude Code: alias model dan nama model lengkap

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

9. Keterangan: Memastikan versi yang sesuai untuk opus, sonnet, dan haiku

10. Dokumentasi Bantuan Obsidian: vault dan cara penyimpanan file

11. Tautan: obsidian.md/help

12. Keterangan: Memastikan bahwa vault hanyalah folder biasa dan perubahan dari luar akan diperbarui secara otomatis

13. Uji coba pihak ketiga: Perbandingan alat AI untuk Obsidian (vault kecil berisi 560 artikel, satu kali pengujian)

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

15. Keterangan: Acuan untuk memulai tanpa memasang plugin

16. Dokumentasi integrasi Claude Code APIYI

17. Tautan: docs.apiyi.com/scenarios/programming/claude-code
18. Keterangan: Penjelasan tentang grup Claude Code, alamat, dan variabel lingkungan

Penulis: Tim Teknis APIYI
Diskusi teknis: Jika mengalami kendala saat menyiapkan konfigurasi, silakan tinggalkan komentar. Panduan integrasi lainnya dapat dilihat di pusat dokumentasi APIYI, docs.apiyi.com.

Artikel terkait

• Tutorial langkah demi langkah: Hubungkan semua agen dengan satu kunci menggunakan API gateway terpadu magpie open-source (contoh: Claude Code, Codex, Pi, Hermes): Tutorial lengkap yang bisa langsung diikuti: dalam sekitar 30 menit, semua Agen pemrograman di mesinmu—seperti Claude Code, Codex, Pi, dan Hermes—dapat menggunakan satu kunci API dan satu alamat gateway, lengkap dengan tangkapan layar antarmuka magpie, panduan integrasi langkah demi langkah, perbandingan konfigurasi bawaan, dan tabel pemecahan masalah.