Vincent5588 Wiki

Claude Code 操作 Obsidian Vault

閱讀時間約 8 分鐘

Claude Code 操作 Obsidian Vault

把 Claude Code 直接接到 Obsidian vault 的整合模式——cd 進 vault → claude → 用自然語言操作整個知識庫。是 AI 第二大腦 哲學的具體實作。

為什麼 Claude Code + Obsidian 天然契合

維度為什麼契合
檔案系統Claude Code 在 filesystem 工作；Obsidian vault 就是 filesystem
純 markdownClaude Code 讀寫 .md 跟呼吸一樣自然，不用轉換層
[[wiki-link]]Claude Code 解析、建立、掃描連結都直覺
YAML frontmatter批次讀取 / 篩選 / 更新 metadata = 一句話的事
CLAUDE.md 持久記憶每次啟動自動讀，記住 vault 規範

對比：Notion 的資料在雲端 DB，要透過 API 拉、轉格式、推回——多餘環節。

三種接入方式

方式 1：終端機 cd 進 vault（最簡單）

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vincent5588
claude

Claude Code 會：

  1. 自動掃描目錄結構
  2. 讀取 CLAUDE.md
  3. 進入互動模式

第一個指令可以打：

幫我列出這個 vault 裡所有的資料夾結構和筆記數量。

→ Vincent vault 用的就是這方式。

方式 2：Obsidian 內嵌外掛

如果不想離開 Obsidian 介面：

外掛特色
Agent Client支援 Claude Code / Codex / Gemini CLI；用 @notename 引用筆記
obsidian-claude-code-mcp把 Obsidian 操作註冊成 MCP 工具，Claude Code 透過 MCP 存取

→ 適合熟悉 Obsidian 介面的人。

方式 3：MCP 橋接（進階）

把 vault 操作（建檔、改 frontmatter、查 backlink）註冊成 MCP tools。Claude Desktop / 其他 Anthropic 工具都能共用同一套 vault 存取邏輯。

→ 重度使用者 / 多工具場景。

⚠️ 不要一開始就搞 MCP——先用方式 1 熟悉，再考慮方式 2 或 3。先複雜化會讓人放棄。

5 個社群驗證的實戰工作流

文章作者整理 5 個高 value 工作流：

1. /today 自動建每日筆記

設定一個 .claude/commands/today.md 指令：

檢查今天的 daily note 是否存在；
沒有就用 templates/daily.md 範本建立；
從昨天的筆記搬入未完成的待辦事項。

之後每天打 /today 自動執行，整個過程不到 10 秒。

→ 對應 Slash Commands 的自訂指令模式。

2. 研究筆記自動產出

> Research WebAssembly SIMD 的最新進展，存到 resources/ 目錄

Claude Code 會：

  1. 先搜 vault 內已有相關筆記（避免重複）
  2. 綜合外部資訊產出結構化研究筆記：概述 / 關鍵概念 / 跟 vault 其他筆記的關聯 / 資料來源
  3. 自動加 wiki-link

→ 這就是 wiki-ingest 的精神，但對外部資料源。

3. 批次加反向連結（最讓人驚艷）

> 掃描我最近一個月的 daily notes，找出所有提到的人名、專案名、書名，
  自動加上 [[wikilink]] 連結到對應的 entity note；
  沒有對應筆記的就自動建立。

一個下午的手動工作 → 幾分鐘搞定。對應 Bookkeeping by LLM 哲學。

4. 批次加標籤

> vault 裡有 200 篇筆記沒有 tags，根據內容自動分類，
  參考 CLAUDE.md 定義的標籤規範，在 YAML frontmatter 裡補上。

→ 跟 wiki-lint 的「補 frontmatter」分支類似，但用於 inbox 大量未整理筆記。

5. /weekly-review 每週回顧

.claude/commands/weekly-review.md：
- 統計本週完成 / 未完成 tasks
- 辨識重複出現的主題
- 找哪些專案停滯了
- 產出結構化回顧筆記

回顧本身也是 Obsidian 筆記，可被未來 query 引用——這就是 AI 第二大腦 的複利效應。

推薦的 vault 結構（社群驗證）

vault/
├── CLAUDE.md              ← LLM 工作手冊（< 100 行）
├── .claude/
│   └── commands/          ← 自訂 slash commands
├── daily/                 ← YYYY-MM-DD.md
├── projects/              ← 進行中
├── areas/                 ← 持續責任區
├── resources/             ← 研究筆記 / ingest 目標
├── _inbox/                ← 待處理
└── templates/             ← 筆記範本

→ Vincent vault 用更完整的 PARA + LLM Wiki 雙層結構（見 vault CLAUDE.md）。

寫 CLAUDE.md 的三個建議

文章作者的提醒：

1. 控制在 100 行以內

太長浪費 token + 重要規則被衝淡。Vincent vault 的 CLAUDE.md 約 600 行（v1.3.5），但有結構化分節 + plugin 補強，是有意識地寫長。新手先 100 行起步。

2. 寫「不做清單」（NEVER list）

“AI 工具最危險的不是它不會做什麼，而是它太積極了。”

明確寫：

  • NEVER 刪除任何檔案
  • NEVER 修改已有 frontmatter tags（只能新增）
  • NEVER 動 raw/ 內容
  • 等等

→ 對應 Vincent vault CLAUDE.md 的「規則 A：raw/ 內容唯讀」「規則 C：使用者 PARA 資料夾你別碰」。

3. 定期跑 lint

“每週讓 Claude Code 做一次 vault 健檢：找出沒任何 backlink 的孤立筆記、frontmatter 缺欄位、超過 90 天沒更新的 draft。”

→ 對應 wiki-lint。Vincent vault 已用 plugin 化的 lint。

跟 Vincent vault 的對應

vault 是這個工作流的進階版實作：

文章建議Vincent vault 實作
/today 每日筆記沒做（vault 偏知識管理而非任務管理）
研究筆記wiki-ingest 對 raw/ 文章的 ingest
批次反向連結wiki-ingest 的 Pass C（加 ?? backlinks）
批次加標籤wiki-repair 的 frontmatter 補完
/weekly-reviewwiki/log.md + daily/YYYY/MM/ 已部分對應
推薦 vault 結構PARA + raw + wiki 雙層（更完整）
CLAUDE.md 100 行600+ 行（有規模化框架）

反模式

  • ❌ 不寫 CLAUDE.md → 每次新對話重講背景，浪費時間
  • ❌ CLAUDE.md 沒 NEVER 清單 → AI 太積極時翻車
  • ❌ 沒裝 Obsidian Dataview → 沒法 live query 自己的 vault
  • ❌ Claude Code 直接動 raw 檔 → 真理錨點被污染（Vincent vault 規則 A 嚴防）
  • ❌ 一次裝太多 plugin / MCP → 失去動力放棄

相關概念

強連結（原文明確提及）

推斷連結（LLM 認為相關，待確認）

深入閱讀

← 回到 wiki

關係圖譜

反向連結