用 Claude Code 打造 Obsidian 第二大腦：Zettelkasten、MCP 與自動化筆記工作流

你的 Obsidian vault 裡有多少筆記？100 則？500 則？

更重要的問題是：你上次真的回去翻舊筆記，是什麼時候？

多數人的第二大腦長這樣：inbox 塞滿未整理的想法，Daily Note 越積越多，連結稀疏到 Graph View 像一盤散沙。Zettelkasten 方法論都懂，但手動拆解、手動加連結、手動歸類——光想就累。

Claude Code 解決的就是這個斷層。它直接進你的 vault 資料夾，讀 Markdown、寫 Markdown、建連結、搬檔案。你負責思考，它負責整理。

這篇教你從零開始，把 Claude Code 接進 Obsidian，打造一個會自己整理的第二大腦。

---

Obsidian 為什麼適合當第二大腦

在講 Claude Code 怎麼接之前，先釐清一件事：為什麼是 Obsidian，不是 Notion？

特性	Obsidian	Notion
檔案格式	本地 .md 純文字	雲端資料庫，專屬格式
資料所有權	100% 在你手上	在 Notion 伺服器
雙向連結	原生 wikilink	需手動建 relation
AI 存取難度	極低（就是讀檔案）	需要 API + 權限設定
離線使用	完整離線	需要網路
外掛生態	2000+ 社群外掛	官方 API + 第三方串接

核心差異：Obsidian 的檔案就是普通的 Markdown。

這代表任何能讀寫文字檔的工具都能操作你的 vault——包括 Claude Code。不需要 API token、不需要 OAuth、不需要特殊權限。cd ~/my-vault && claude 就完事了。

Notion 適合管流程（任務追蹤、社群排程、CRM），Obsidian 適合管思想（閱讀筆記、想法連結、知識建構）。兩者分工，不衝突。

---

Zettelkasten 方法：三層筆記結構

Zettelkasten（卡片盒筆記法）的核心邏輯很簡單：

層級	名稱	做什麼	存在哪
①	Fleeting Note（閃念筆記）	隨手記下的想法、截圖、語音轉文字	0_inbox/
②	Literature Note（文獻筆記）	讀完一篇文章或書，用自己的話重寫重點	1_literature/
③	Permanent Note（永久筆記）	一則筆記只講一個想法，用 連結 串起來	2_knowledge/

流程：閃念丟進 inbox → 整理成文獻筆記 → 拆解成永久筆記 → 連結到既有知識網。

卡住的地方永遠在第二步到第三步。

你讀了一篇長文，記了一堆重點，然後呢？手動拆成原子想法、手動找相關筆記、手動加 wikilink——這段苦工就是多數人放棄 Zettelkasten 的原因。

Claude Code 可以接手這整段。

---

Claude Code 能幫 Obsidian 做什麼

Claude Code 跟一般 AI 聊天視窗完全不同。它是一個跑在終端機裡的 coding agent，能直接讀寫你電腦上的檔案。

把它指向你的 Obsidian vault，它可以做這些事：

讀取與搜尋

• 用 Grep 搜尋整個 vault 的關鍵字
• 用 Glob 找特定模式的檔案（例如所有 0_inbox/*.md）
• 讀取任何筆記的完整內容

建立與編輯

• 建立新的 Markdown 筆記，帶 YAML frontmatter
• 在既有筆記裡插入 wikilink 雙向連結
• 重新命名、搬移檔案到正確資料夾

自動化整理

• 掃描 inbox，把未整理的閃念筆記拆解成原子想法
• 自動比對既有筆記，建議相關連結
• 依照命名規則產生標準化的筆記標題

排程巡邏

• 用 Scheduled Tasks 每天早上自動掃描 vault
• 找出孤立筆記（沒有任何連結的筆記）
• 生成每日整理報告

---

三種連接方式：怎麼讓 Claude Code 讀你的 Vault

方案	做法	需要安裝	適合誰
A. 直接本地（推薦）	cd ~/vault && claude	不需要	所有人
B. MCP 外掛	裝 obsidian-claude-code-mcp	Obsidian 外掛	想在 Obsidian 內操作
C. REST API	裝 Local REST API + mcp-obsidian	兩個外掛	需要遠端存取

方案 A：直接本地（最簡單）

Obsidian vault 就是一個資料夾，裡面全是 .md 檔。Claude Code 天生就能操作。

cd ~/Documents/ObsidianVault
claude

進去之後直接說：「幫我看一下 0_inbox 裡有哪些未整理的筆記」，它就開始工作了。

這是最推薦的方式。不用裝外掛、不用設定 port、不用擔心版本相容性。

方案 B：MCP 外掛

如果你想在 Obsidian 介面裡直接跟 Claude Code 對話，可以裝 obsidian-claude-code-mcp 外掛。

它在 Obsidian 裡啟動一個 MCP Server（預設 port 22360），Claude Code 透過 WebSocket 連上來。

連接步驟：

① 在 Obsidian 社群外掛搜尋 claude-code-mcp，安裝並啟用
② 在終端機跑 claude
③ 輸入 /ide 指令，選擇 Obsidian
④ 連線成功，Claude Code 可以透過 MCP 工具操作 vault

這個方案的好處是 Claude Code 能拿到 Obsidian 的上下文（例如當前開啟的檔案），缺點是多一層依賴。

方案 C：REST API

用 mcp-obsidian 搭配 Obsidian Local REST API 外掛。適合需要從遠端或其他工具存取 vault 的情境。

一般使用場景用方案 A 就夠了。

---

CLAUDE.md：教 Claude Code 認識你的 Vault

不管用哪種連接方式，CLAUDE.md 是最關鍵的設定。

在 vault 根目錄建立 CLAUDE.md，Claude Code 每次啟動都會自動讀取。把你的 vault 結構、命名規則、行為指引寫在裡面。

# Obsidian Vault 規則

## 資料夾結構

| 資料夾 | 用途 |
|--------|------|
| `0_inbox/` | 未整理的閃念筆記 |
| `1_literature/` | 文獻筆記（讀書 / 讀文章） |
| `2_knowledge/` | 永久筆記（一則一想法） |
| `3_projects/` | 進行中的專案筆記 |
| `daily/` | 每日日記 |
| `templates/` | 筆記模板 |

## 命名規則

- 永久筆記：`YYYY-MM-DD 主題筆記.md`
- 文獻筆記：`YYYY-MM-DD 《書名》筆記.md`
- 日記：`daily/YYYY-MM-DD.md`

## 筆記格式

每則永久筆記必須包含：
- YAML frontmatter：tags, created, source
- 正文：用自己的話寫，不超過 300 字
- 連結區：至少一條 `相關筆記`

## 行為規則

- 整理 inbox 時，先讀完內容，再決定拆成幾則永久筆記
- 每則永久筆記只講一個核心想法
- 建連結前，先用 Grep 搜尋 vault 有沒有相關主題的既有筆記
- 不要刪除任何筆記，只做搬移和重組
- 語言：台灣繁體中文

Claude Code 讀完這份文件，就知道你的 vault 怎麼運作。之後你說「整理一下 inbox」，它會照著這些規則執行。

---

實戰工作流一：Inbox 自動整理

這是最常用的工作流。你白天隨手丟想法進 0_inbox/，晚上讓 Claude Code 幫你整理。

步驟

① 打開終端機，進入 vault

cd ~/Documents/ObsidianVault && claude

② 給指令

幫我整理 0_inbox/ 裡所有未整理的筆記。
每則閃念筆記拆解成一到三則永久筆記，放到 2_knowledge/。
每則永久筆記要有 frontmatter、正文、至少一條 wikilink。
整理完的閃念筆記搬到 0_inbox/_done/。

③ Claude Code 會依序：

• 用 Glob 掃描 0_inbox/*.md
• 逐一讀取內容
• 用 Grep 搜尋 vault 裡的相關筆記
• 建立新的永久筆記，加上 連結
• 把處理完的檔案搬到 _done/

範例

假設 inbox 裡有一則筆記：

# 隨手記

看到一篇文章說 Zettelkasten 最重要的是連結，分類反而次要。
分類是靜態的，連結是動態的。
想到之前讀的《How to Take Smart Notes》也講過類似概念。
另外，數位花園（Digital Garden）的概念也很像，
都是強調知識要公開、要連結、要持續生長。

Claude Code 會拆成兩則永久筆記：

2_knowledge/2026-04-01 Zettelkasten 的核心是連結而非分類筆記.md

---
tags: [zettelkasten, pkm, 筆記方法]
created: 2026-04-01
source: inbox 整理
---

Zettelkasten 的核心價值在連結，不在分類。

分類是靜態架構——一旦定了就很難改。連結是動態網絡——每加一則筆記，整個知識庫的結構都在演化。

這跟 2026-04-01 數位花園的核心概念筆記 的邏輯一致：知識要持續生長，不是一次整理完就封存。

相關：2026-03-15 《How to Take Smart Notes》讀書筆記

2_knowledge/2026-04-01 數位花園的核心概念筆記.md

---
tags: [digital-garden, pkm, 知識管理]
created: 2026-04-01
source: inbox 整理
---

數位花園（Digital Garden）強調三件事：公開、連結、持續生長。

跟傳統部落格的差異：部落格是完成品，花園是進行式。筆記不需要完美才能發佈，它會隨時間被修改和擴充。

這個概念跟 2026-04-01 Zettelkasten 的核心是連結而非分類筆記 互相呼應。

相關：2026-03-08 Obsidian 是什麼筆記

一則閃念筆記變成兩則有連結的永久筆記，整個過程不到 30 秒。

---

實戰工作流二：文章拆解成筆記

讀完一篇長文或一本書，想把重點變成 Zettelkasten 筆記？

我剛讀完這篇文章，幫我整理成 literature note，
然後從中拆出可以獨立存在的永久筆記。
文章內容如下：

[貼上文章內容或給檔案路徑]

Claude Code 會：

① 先建一則文獻筆記（整篇文章的摘要 + 你可能感興趣的重點）
② 從文獻筆記拆出 2-5 則永久筆記（每則只講一個概念）
③ 每則永久筆記都會 Grep 搜尋 vault，找到相關筆記並加上 連結

---

實戰工作流三：孤立筆記巡邏

vault 裡最浪費的就是「孤立筆記」——沒有任何 連結 指向它、它也沒連到任何其他筆記。

幫我找出 2_knowledge/ 裡所有孤立筆記
（沒有被其他筆記連結，自己也沒有連出去的）。
列出清單，然後逐一建議可以連到哪些筆記。

Claude Code 會用 Grep 掃描所有 wikilink，交叉比對，找出孤兒。這個動作手動做要花半小時以上，它幾秒鐘就完成。

---

進階：用 Scheduled Tasks 排程巡邏

Claude Code 支援排程任務。你可以設定每天早上自動巡邏 vault。

在 Claude Code 裡設定：

幫我建立一個每天早上 7 點的排程任務：

1. 掃描 0_inbox/ 有幾則未整理的筆記，列出標題
2. 掃描 2_knowledge/ 找出孤立筆記
3. 統計 vault 總筆記數、本週新增數
4. 把結果寫進 daily/YYYY-MM-DD.md 的「Vault 巡邏報告」區塊

每天打開 Obsidian，Daily Note 裡就有一份自動生成的巡邏報告。你知道 inbox 積了多少、哪些筆記需要連結、vault 的健康狀態如何。

搭配 Claude Code 排程任務教學，你可以設計更複雜的自動化流程。

---

我的實際用法

我自己的品牌 repo 就是一個 Obsidian vault。根目錄有 .obsidian/ 設定，所有內容都是 Markdown 檔案。

sousan-vault/
├── .obsidian/          ← Obsidian 設定
├── CLAUDE.md           ← Claude Code 行為指引
├── articles/           ← SEO 長文
├── newsletter/         ← 電子報
├── notes/              ← Zettelkasten 筆記
├── journal/            ← 每日日記
├── drafts/             ← 社群草稿
├── docs/               ← 選題池、pipeline 文件
└── scripts/            ← 自動化腳本

Claude Code 同時扮演三個角色：

角色	做什麼
筆記整理員	每天整理 inbox → notes，建立 wikilink
內容工廠	從 notes 提煉成文章、電子報、Threads 串文
系統管理員	跑排程、推數據到 journal、維護選題池

從想法到發佈，整個流程都在同一個 vault 裡完成。Obsidian 負責知識的結構，Claude Code 負責知識的流動。

---

常見問題

Claude Code 會不會改壞我的筆記？

可以在 CLAUDE.md 裡加規則：「不要刪除任何筆記，只做搬移和新增」。Claude Code 也支援 permission mode，可以設成每次修改都要你確認。

vault 很大（幾千則筆記），Claude Code 跑得動嗎？

跑得動。Claude Code 用的是增量搜尋（Grep、Glob），不會一次把整個 vault 載進記憶體。即使是上萬則筆記的 vault，搜尋和操作都在秒級。

需要付費嗎？

Claude Code 需要 Anthropic API 帳號或 Claude Pro/Max 訂閱。Obsidian 個人使用免費。兩者加起來的成本大約等於一杯超商拿鐵。

可以搭配 Obsidian Sync 嗎？

可以。Claude Code 操作的是本地檔案，Obsidian Sync 會自動同步到其他裝置。改完就同步，手機上馬上看得到。

跟 Notion 衝突嗎？

不衝突。我自己的分工：Notion 管任務排程和社群發佈，Obsidian 管知識和思考。Claude Code 兩邊都能操作。

---

結語

Obsidian + Claude Code 的組合，讓 Zettelkasten 從「知道但做不到」變成「自動幫你做」。

你只需要做一件事：把想法丟進 inbox。剩下的拆解、連結、歸類、巡邏，交給 Claude Code。

第二大腦的重點從來都在「持續餵養」，工具只是手段。Claude Code 把餵養的門檻壓到最低——你負責想，它負責整理。

想了解更多 Claude Code 的基礎操作，可以看 Claude Code 完整教學。想深入 MCP 和排程任務，看 AI Agent 完整教學。