Panduan Integrasi Lengkap Claude Code x Obsidian | Catatan AI untuk Menumbuhkan Vault Anda

Setiap pengguna Obsidian pasti pernah berpikir: “Andai Vault ini bisa merapikan dirinya sendiri.” Claude Code adalah partner terbaik untuk Obsidian. Karena Vault Obsidian pada akhirnya hanyalah folder berisi file Markdown, dan membaca serta menulis file tree adalah keahlian terkuat Claude Code.

Dalam artikel ini kita akan membahas cara menggabungkan Claude Code dan Obsidian untuk menumbuhkan Vault secara otomatis, lengkap dengan kode yang berjalan dan contoh nyata. Dari generasi catatan harian, web clipping, hingga melengkapi backlink dan pengembangan plugin.

Mengapa Obsidian x Claude Code?

Kekuatan Obsidian bermuara pada tiga hal:

• Local-first: Semua adalah file Markdown di mesin Anda sendiri
• Teks polos: Tanpa vendor lock-in, bisa dibaca di masa depan
• Berbasis tautan: Merajut pikiran dengan [[Nama catatan]] ke segala arah

Ini cocok sekali dengan kekuatan Claude Code:

• Bisa beroperasi langsung di file tree (Read / Edit / Write / Glob)
• Memperlakukan Markdown sebagai warga kelas satu (bisa parse Wikilink sekalipun)
• CLAUDE.md memungkinkan mengajari “aturan Vault ini”

Singkatnya, dari perspektif Claude Code, Vault Obsidian adalah “proyek kecil yang sangat rapi”. Pengorganisasian catatan bisa diotomatisasi dengan rasa yang sama seperti menulis kode.

Setup dasar: taruh CLAUDE.md di Vault

Pertama, taruh CLAUDE.md di root Vault. Maka saat Claude Code diluncurkan di dalam Vault, file tersebut akan dimuat otomatis.

# Aturan Obsidian Vault saya

## Struktur direktori
- `daily/YYYY-MM-DD.md` — Catatan harian
- `zettel/` — Catatan permanen (1 catatan = 1 ide, judul = nama konsep)
- `literature/` — Catatan bacaan, clipping artikel web
- `project/` — Proyek berjalan
- `meta/` — Definisi tag, template

## Aturan notasi
- Tautan antar catatan pakai `[[Nama catatan]]`
- Tag ditaruh di frontmatter paling atas
- Catatan harian: struktur 3 level tetap `## Today / ## Learned / ## Questions`
- URL sumber di frontmatter sebagai `source:`

## Larangan
- Rename catatan lama wajib konfirmasi (backlink bisa putus)
- Jangan ubah catatan di bawah `_archive/`

Dengan menjelaskan aturan Vault secara eksplisit, Claude Code akan membuat dan mengedit catatan sesuai konvensi Anda. Ini mencegah kontaminasi format yang tidak konsisten.

Contoh 1: Generasi catatan harian otomatis

Script yang setiap pagi merangkum catatan kemarin dan membuat template hari ini.

#!/bin/bash
# ~/vault/scripts/daily-note.sh

TODAY=$(date +%Y-%m-%d)
YESTERDAY=$(date -d "yesterday" +%Y-%m-%d)
VAULT=~/vault

claude -p "
Mohon lakukan hal berikut:

1. Baca $VAULT/daily/$YESTERDAY.md (lewati jika tidak ada)
2. Ekstrak 'tugas yang belum selesai' dari bagian 'Today' kemarin
3. Ekstrak 3 'poin refleksi' dari bagian 'Learned' kemarin
4. Buat $VAULT/daily/$TODAY.md dengan template berikut:

---
date: $TODAY
tags: [daily]
---

## Today (rencana hari ini)
- (tugas kemarin yang belum selesai di sini)

## Learned (temuan)
_kosong_

## Questions (yang ingin dieksplorasi)
_kosong_

## Review (refleksi kemarin)
- (3 poin hasil ekstraksi di sini)

## Links
[[$YESTERDAY]] <-> [[$(date -d tomorrow +%Y-%m-%d)]]
---

5. Setelah dibuat, laporkan cukup 'Catatan harian selesai'
"

Daftarkan di cron, launchd macOS, atau Task Scheduler Windows, maka catatan hari ini sudah siap saat Anda bangun. Tinggal buka Obsidian dan mulai bekerja.

Contoh 2: Clip artikel web ke Vault

Gaya Read-Later. Lewati URL, catatan terformat tersimpan di literature/.

// scripts/clip-url.mjs
import Anthropic from "@anthropic-ai/sdk";
import { writeFileSync } from "fs";

const url = process.argv[2];
const client = new Anthropic();

const res = await client.messages.create({
  model: "claude-opus-4-6",
  max_tokens: 4096,
  tools: [{ type: "web_search_20250101", name: "web_search" }],
  messages: [{
    role: "user",
    content: `Ambil artikel di URL ini dan buat catatan Obsidian:
URL: ${url}

Format output:
---
title: (judul artikel)
source: ${url}
tags: [literature, (2-3 tag topik)]
clipped: ${new Date().toISOString().slice(0, 10)}
---

# (judul artikel)

## TL;DR
(ringkasan dalam maksimal 3 baris)

## Key Points
- (5 poin penting)

## My Take
_ditambahkan kemudian_

## Related
[[catatan terkait di Vault yang ada (tebakan boleh)]]
`,
  }],
});

const body = res.content[0].text;
const slug = body.match(/title: "(.+?)"/)?.[1]?.replace(/[\/:]/g, "-") ?? "untitled";
writeFileSync(`${process.env.VAULT}/literature/${slug}.md`, body);
console.log(`Clipped to literature/${slug}.md`);

Pemakaian: node clip-url.mjs https://example.com/article

Sambungkan ke menu klik kanan browser, maka satu klik kanan menyimpan artikel apa pun ke Vault - bisa dicari nanti.

Contoh 3: Pelengkap backlink otomatis

Obsidian membuat backlink saat Anda menulis [[Nama]], tapi “catatan ini jelas terkait konsep itu tapi lupa saya kaitkan” sering terjadi. Claude Code bisa memperbaiki semuanya sekaligus.

claude -p "
Baca semua Markdown di $VAULT/zettel/ dan lakukan:

1. Ekstrak 'konsep, tokoh, nama teori penting' dari body tiap catatan
2. Cek apakah konsep tersebut ada sebagai judul di catatan lain
3. Bungkus kemunculan yang belum ditautkan dengan [[...]]
4. Jika tidak ada heading '## Related', tambahkan, dan daftar
   2-3 catatan terkait yang tidak muncul alami di body

Tampilkan diff sebelum apply dan minta persetujuan.
"

Kuncinya: jangan lewatkan alur persetujuan. Memasukkan backlink otomatis itu nyaman, tapi tautan salah merusak kepercayaan pada Vault. “Tampilkan diff sebelum apply” adalah aturan emas.

Contoh 4: Notulen rapat ke catatan + tagging

Konversi transkrip suara atau teks rapat mentah menjadi catatan terstruktur.

claude -p "
Baca $VAULT/inbox/raw-meeting-2026-04-16.txt dan simpan ke
$VAULT/literature/meeting-2026-04-16.md dengan struktur berikut:

---
title: '(judul rapat dugaan)'
date: 2026-04-16
type: meeting
tags: [meeting, (tag hasil inferensi topik)]
attendees: [(nama peserta yang diekstrak)]
---

## Keputusan
## Action Items (dengan penanggung jawab dan tenggat)
## Pembahasan (diorganisir per topik)
## PR untuk pertemuan berikutnya

Di akhir, tautkan penyebutan orang ke [[Nama]].
Setelah selesai, pindahkan inbox/raw-meeting-2026-04-16.txt ke _archive/.
"

Lempar teks mentah ke inbox, konversi batch belakangan.

Contoh 5: Pengembangan plugin Obsidian dengan Claude Code

Plugin Obsidian ditulis dalam TypeScript. Claude Code jago TS, kecocokannya luar biasa.

cd ~/my-obsidian-plugin
claude

# Di dalam Claude Code:
> Baca main.ts dan jelaskan dalam 3 baris apa yang dilakukan plugin ini
> Tambahkan fitur baru: "rangkum teks terpilih dengan Claude API dan tempel di posisi kursor"
> Update manifest.json ke versi yang sesuai
> Pastikan npm run build lolos

Plugin jadi dalam hitungan menit. git clone repo sample plugin Obsidian resmi, dan Claude Code akan membangun dari sana.

Berurusan dengan notasi khusus Obsidian

Notasi khas Obsidian yang perlu diketahui Claude Code:

Notasi	Arti	Contoh
[[Nama]]	Wikilink (tautan internal)	[[Claude Code]]
[[Nama#heading]]	Tautan ke heading tertentu	[[FAQ#Harga]]
[[Nama|alias]]	Tautan beralias	[[Claude Code|CC]]
![[Nama]]	Embed seluruh catatan	![[Kutipan]]
%%komentar%%	Disembunyikan di view publish	%%TODO: revisi%%

Dokumentasikan di CLAUDE.md, Claude Code akan memakainya dengan tepat.

5 jebakan yang harus dihindari

1. Konflik sinkronisasi (Obsidian Sync / iCloud / Dropbox) Jika mobile sync berjalan saat Claude Code menulis file, konflik terjadi. Jeda sync saat Claude Code berjalan lebih aman. Bisa juga sisipkan perintah “pause Obsidian Sync” di awal script.

2. Karakter terlarang di nama file Judul yang mengandung titik dua : atau garis miring / gagal dibuat di level OS. Saat minta Claude Code generate, spesifikasikan “nama file hanya huruf, angka, tanda hubung, dan karakter bahasa”.

3. Penulisan ulang backlink massal Mengotomatiskan rename mengakibatkan backlink tidak terupdate dan tautan putus. Rename lewat UI Obsidian, serahkan hanya pemindahan file mentah ke Claude Code.

4. Penulisan yang bergantung plugin Jika Claude Code menghasilkan sintaks Dataview atau Templater, akan rusak di lingkungan tanpa plugin tersebut. Batasi ke Markdown standar + Wikilink lewat CLAUDE.md.

5. Eksekusi massal di Vault terlalu besar Glob **/*.md plus baca penuh di Vault 5000 catatan akan meledakkan konteks. Delegasikan ke sub-agent dengan scope terbatas seperti “hanya zettel/”.

Contoh alur kerja: satu hari

Rutinitas saya sendiri:

07:00  daily-note.sh jalan otomatis, catatan hari ini tergenerate
09:00  Buka Obsidian, isi bagian Today
12:00  Simpan artikel menarik dengan clip-url.mjs
15:00  Rapat, lempar transkrip ke inbox/
17:00  Jalankan claude untuk format ke literature/
22:00  Jadikan pembelajaran hari itu catatan permanen di zettel/
Larut  Mingguan: backlink-suggest.sh untuk menambal backlink

“Menulis” urusan saya, “merapikan” urusan Claude Code - pembagian ini pas. Anda fokus pada pemikiran dan ideasi, beban organisasi dan koneksi diberikan ke AI. Inilah nilai sejati Obsidian x Claude Code.

Kesimpulan

Vault Obsidian sering diibaratkan “kebun yang dirawat”. Sewa Claude Code sebagai robot tukang kebun, dan Anda bisa mengotomatiskan menyiram (catatan harian) / mencabut gulma (backlink) / panen (ringkasan) semuanya.

Langkah pertama yang bisa dicoba hari ini:

1. Taruh CLAUDE.md di root Vault dan tulis aturan
2. Daftarkan daily-note.sh untuk mengotomatiskan catatan pagi
3. Pasang clip-url.mjs untuk clip artikel web sekali klik

Hanya dengan tiga langkah ini, hubungan Anda dengan Vault akan berubah dari akarnya.

Artikel terkait

• Panduan lengkap Harness Engineering
• 10 pola sub-agent untuk Claude Code
• CLAUDE.md Best Practices

Referensi

• Dokumentasi resmi Obsidian
• Panduan pengembangan plugin Obsidian
• Panduan resmi Claude Code