開發工作流程
Obsidian + Claude Code 教學：連接筆記、查找與核對答案
把 Claude Code 接上 Obsidian，不必知道檔名也能找出專案筆記，並依來源核對最新決定。附設定步驟、實測搜尋提示與答案範例；MCP 和外掛皆可選用。
01
Obsidian vault 就是一個 Markdown 資料夾。在這個資料夾執行 Claude Code，它就能讀取、搜尋與修改你的筆記。
02
不必知道檔名也能找出專案筆記，分清目前決定與舊訊息，再核對來源。
03
Wenlan 是為 AI 整理與維護知識而設計的個人 Wiki，內建知識頁、來源追蹤與修訂檢查。可以接入 Obsidian 筆記，也可以直接使用 Wenlan。
01
先給答案
Claude Code 搭配 Obsidian 不需要外掛。在 vault 資料夾開啟終端機並執行 claude，Claude Code 就能在存取權限允許的範圍內，讀取、搜尋、建立與修改這個資料夾的筆記。
不想用終端機？有 Claude Pro、Max、Team 或 Enterprise 訂閱的話，在 Claude Desktop 打開 Code 分頁，選擇 Local，再把練習 vault 選為專案資料夾。接著就能做下方相同的兩份筆記練習。
先跟著下方的安裝步驟與兩份筆記練習，查出目前的專案決定、核對引用，分清楚已確認與尚不確定的資訊。需要額外功能時，再從下表選工具：
| 做法 | 多了什麼 | 適合誰 |
|---|---|---|
| 在 vault 資料夾執行 Claude Code | 讀寫、搜尋所有 Markdown 檔案 | 幾乎所有人，從這裡開始 |
| 在 vault 放 CLAUDE.md | 固定指示：資料夾結構、筆記風格、哪些不能動 | 希望每次 session 結果一致 |
| Obsidian CLI + Obsidian skills | 反向連結、Obsidian 搜尋、任務，以及正確的 Obsidian 語法、Bases 與 Canvas | 大量使用連結與 Obsidian 功能的 vault |
| Obsidian MCP server | 提供給 MCP client 的 vault 工具 | 一般 Claude 對話或多個 client 共用工具 |
| Obsidian 內的外掛（Claudian） | 在 Obsidian 側邊欄和 Claude Code 對話 | 不想用終端機的人 |
02
開始前：先安裝並登入 Claude Code
這篇使用桌面電腦上的 Claude Code 終端機版。先依官方說明安裝，再執行 claude --version，確認終端機找得到指令。執行 claude 並完成登入後，再接上 vault。你需要支援的 Claude 訂閱、Console API 帳戶或已設定的模型服務；安裝 Obsidian 外掛不會附送模型使用額度。
第一次操作，先建立獨立的練習 vault，只放下面兩份虛構筆記。把指令中的 ~/Documents/MyVault 換成它的實際路徑；路徑有空白時，用雙引號包起來。先別用整個私人筆記庫。
下方終端機指令適用於 CLI 路線。若使用 Desktop 的 Code 分頁，在那裡選好練習 vault 後，可直接跳到兩份筆記練習。
03
步驟 1：在 Obsidian vault 裡執行 Claude Code
vault 就是你在 Obsidian 建立時選的資料夾。從那裡啟動 Claude Code。Claude Code 一存檔，Obsidian 就會顯示變更，所以兩邊可以並排開著。
如果你正在另一個專案裡工作，不必切換資料夾，把 vault 加成額外資料夾即可。
- 先備份。用 git 管理 vault，或開啟 Obsidian Sync 的版本歷史，改壞了才能復原。
- 先完成下方只讀取、不改檔的兩份筆記練習，再嘗試修改或整理筆記。
- Claude Code 會把讀到的文字送給你設定的模型服務。私密資料夾請放在練習 vault 之外；只在提示裡要求不要讀取，不等於限制存取權限。
cd ~/Documents/MyVault
claude
# 或在其他專案資料夾裡：
claude --add-dir ~/Documents/MyVault04
第一次實作：從兩份筆記找出最新決定
在練習 vault 建立下面兩份 Markdown 筆記，分別貼入對應文字。這是虛構練習：後一份筆記改了日期，但仍留下一個未知問題。不需要先安裝 MCP、Obsidian CLI 或外掛。
在這個 vault 啟動 Claude Code 後，把下方提示貼進對話。這次只讀取並回答，不整理資料夾，也不改寫筆記。
| 筆記檔名 | 貼入的內容 |
|---|---|
| 01-plan.md | 10 月 1 日會議：預計 10 月 20 日舉辦展示。負責人是小梅。場地尚待確認。 |
| 02-update.md | 10 月 3 日更新：展示改到 10 月 22 日。負責人仍是小梅。尚未確認任何場地。 |
讀取 01-plan.md 和 02-update.md。
不要建立、修改、移動或刪除任何檔案。
展示目前是哪一天？誰負責？還有什麼待確認？
每個答案請列出來源檔名，並摘錄支持答案的原句。
分清楚舊日期與新日期，不要自行補上缺少的資訊。05
核對這次答案，再換成自己的筆記
答案應該是：10 月 22 日、小梅、場地尚未確認。10 月 20 日是已被更新的舊日期。自行打開它列出的來源：新日期應出自 02-update.md；如果回答了某個具體場地，就是自行編造。
找不到檔案，先檢查工作資料夾與檔名；用了舊日期，請它比較兩份筆記的日期與原句；編造場地，就要求標示未知。兩份原始筆記都應保留不變。能核對這個小答案後，再用同一個真實專案的幾份非敏感筆記練習。
這樣才完成第一件有用的事：從分散筆記找回最新決定，並能自己核對來源。下面的 CLAUDE.md、CLI、MCP 與外掛，是日後有需要再加的選配。這個練習不代表 AI 已能安全整理整個 vault。
想讓這份答案成為專案有新進展時，還能接著使用的知識？Wenlan 已內建知識頁、來源追蹤與修訂檢查，不必自己拼裝這套維護流程。接著用下方練習，把現有 Obsidian 筆記接進來試做。
最新日期：10 月 22 日
02-update.md：「10 月 3 日更新：
展示改到 10 月 22 日。」
負責人：小梅
02-update.md：「負責人仍是小梅。」
待確認：場地
02-update.md：「尚未確認任何場地。」
已被取代的舊日期：10 月 20 日
01-plan.md：「10 月 1 日會議：
預計 10 月 20 日舉辦展示。」06
不知道檔名，也能搜尋既有 vault
在自己的 vault 裡，難處可能是先找到相關筆記。先從一個專案和幾個非敏感資料夾開始。下方提示用的是虛構的 Harbor 展示；用在自己的任務時，請換成你的問題、時間範圍、專案名稱、起始資料夾、選用的封存資料夾，以及要查的資訊。保留來源、舊決定、未知資訊與搜尋範圍的核對要求。
請 Claude 列出來源筆記與其中帶日期的敘述，不要只給看似肯定的答案。最近存檔的筆記也可能引用舊訊息。如果兩個決定互相衝突，而筆記沒有說明哪個取代哪個，答案應呈現衝突，不要替你選日期。
- 打開列出的筆記，核對支持答案的原句。引用只有在筆記確實支持該主張時才有幫助。
- 找不到來源時，提供專案名稱、別名或另一個資料夾再搜尋。搜尋失敗不代表你的 vault 裡沒有這項資訊。
- 這是只讀取的要求，不是存取限制。第一次隔離測試時，請用只含有你打算分享給模型服務之筆記的獨立資料夾。
Find the latest decision about the Harbor demo in October 2026
in this vault.
Start with Projects/Harbor/; check Archive/ only if a source
points there or the current notes are insufficient.
Do not create, edit, move, or delete files.
First find and read relevant notes; do not rely on filenames
or file modification times as evidence of a decision.
Return the current demo date, owner, duration, and what must
happen before invitations can be sent.
For each fact, give the note path, its dated statement, and
a short supporting quote. Separate superseded dates and
copied old messages from the current decision.
Mark missing information unknown.
Finish with one next action, the folders actually searched,
and any files you could not read.07
專案搜尋找到什麼，又有哪些地方尚未查過
我們用六份虛構筆記執行這個提示：四份關於 Harbor 目前的展示、一份 2025 年封存的 Harbor 展示，以及一份其他專案的筆記。我們只提供 Claude 專案與資料夾，沒有指定個別檔案。它找到並讀取了目前專案的四份筆記。以下是這次練習的精簡結果：
| 結果 | Projects/Harbor/ 下的來源 | 核對重點 |
|---|---|---|
| 展示：10 月 22 日；負責人：Mei | 2026-10-03-demo-update.md | 10 月 3 日的決定明確取代了 10 月 1 日原訂 10 月 20 日的計畫 |
| 時長：15 分鐘 | 2026-10-04-invitations.md | 檢查清單列出時長，並說明要等場地確認後才能發出邀請 |
| 場地：仍未知 | 2026-10-03-demo-update.md | 來源說尚未確認場地；不要借用其他專案的場地資訊 |
| 10 月 20 日是複製的舊訊息 | 2026-10-05-chat-excerpt.md | 10 月 5 日的檔案引用了 10 月 1 日的訊息，並明確說明那不是新決定 |
- 下一步是由 Mei 在發出邀請前確認場地。Claude 回報它沒有讀取 Archive/ 或其他專案的筆記；這並非搜尋了 vault 裡的每一份筆記。
- 接著，我們把 demo-update 筆記中的決定改為 10 月 7 日，將展示日期改到 10 月 24 日，並在全新 session 重複相同提示。它回答 10 月 24 日，也指出檔案內帶日期的敘述，雖然檔名仍是 10 月 3 日。
- 兩次 Claude 執行都沒有修改來源檔案。這次小型練習示範了該檢查什麼，不能證明它在大型個人 vault 中也準確。
- 用在自己的專案時，請依引用筆記核對目前決定與下一步。如果想保留一份能持續更新的摘要，可以試試下方的 Wenlan 練習。
08
選配：在 vault 加上 CLAUDE.md
Claude Code 每次 session 開始時，都會讀取啟動資料夾裡的 CLAUDE.md。用它說明 vault 的結構，就不必每次重講。
# 我的 vault
- 筆記用 [[wikilinks]]，不要用 Markdown 連結。
- 新筆記放在 Inbox/。不要把檔案移出 Archive/。
- 每日筆記放在 Daily/，檔名 YYYY-MM-DD.md。
- AI 寫的摘要放在 AI/，不要和我的筆記混在一起。
- 不要修改 .obsidian/ 裡的任何東西。09
選配：加上 Obsidian CLI 與 Obsidian skills
Claude Code 可以直接讀取筆記文字與檔頭屬性。Obsidian CLI 則讓它使用 Obsidian 本身的搜尋、反向連結等工具，也能讀取任務或在每日筆記後面加內容。
先更新 Obsidian 安裝程式至 1.12.7 以上，再到「設定 > 一般」開啟「Command line interface」，依提示註冊指令並重開終端機。Obsidian 必須在執行中；沒開的話，第一個指令會自動開啟它。
- Obsidian skills（kepano/obsidian-skills）教 Claude Code 使用 Obsidian CLI，並撰寫 Obsidian 風格的 Markdown、Bases 與 JSON Canvas 檔案。
- 以 Claude Code 外掛安裝：/plugin marketplace add kepano/obsidian-skills，然後 /plugin install obsidian@obsidian-skills。
- 同一套 skills 也能在 Codex 與其他支援 Agent Skills 的工具中使用。
obsidian search query="meeting notes"
obsidian backlinks file=Recipe
obsidian tasks todo
obsidian daily:append content="- [ ] Follow up"10
Obsidian MCP server：什麼時候需要
Claude Code 本來就讀得到你的檔案，所以通常不需要 MCP server。一般 Claude Desktop 對話需要 MCP 才能使用 vault 工具；Claude Desktop 的 Code 分頁也提供 Local 資料夾存取，若不想用終端機，可在那裡選擇練習 vault。MCP 也適合讓多個 client 共用同一組 vault 工具。
Local REST API 社群外掛現在內建 MCP server。在 Obsidian 安裝並啟用它，從「設定 > Local REST API」複製 API key，再加入 Claude Code。Obsidian 必須在執行中，server 才會回應。
下方指令只設定 Claude Code。若使用 Claude Desktop 另一個 Chat 分頁，請依 Local REST API 文件中的 Claude Desktop 步驟設定；這條 CLI 指令不會替一般對話完成設定。
- 這個外掛使用自己產生的憑證。連不上時，信任它的憑證，或在外掛設定中開啟 27123 埠的 HTTP server。
- mcp-obsidian 是較早的 Python server，透過 uvx 連接同一個外掛。
- 不要把 API key 放進會分享的檔案，例如提交到 git 的 .mcp.json。
claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \
--header "Authorization: Bearer <your-api-key>"11
Claude Code 的 Obsidian 外掛
不想用終端機的話，外掛可以讓 Claude Code 在 Obsidian 裡執行。你仍需要安裝並登入 Claude Code。
| 外掛 | 功能 | 安裝方式 |
|---|---|---|
| Claudian | 在 Obsidian 側邊欄執行 Claude Code 或 Codex，以 vault 作為工作資料夾 | 社群外掛：搜尋「Claudian」 |
| Claude Code IDE bridge（obsidian-claude-ide） | 把目前檔案與選取內容分享給終端機裡的 Claude Code | 設定 → 社群外掛 → 瀏覽，搜尋「Claude Code IDE」並安裝、啟用；在 Claude Code 終端機執行 `/ide` 選擇 Obsidian |
| obsidian-claude-code（Roasbeef） | 內嵌在 vault 裡的 Claude 助手 | 從 GitHub 安裝 |
| obsidian-claude-code-mcp（iansinnott） | Claude Code 的 MCP 與 IDE bridge；最後更新於 2025 年 | 從 GitHub 安裝 |
12
用 Claude Code 與 Obsidian 打造第二大腦
這類筆記流程通常從收件匣開始，裡面放文章、會議記錄或逐字稿。Claude Code 讀取後寫成摘要、連結到既有筆記，再歸檔。claude-obsidian 等套件把這些步驟做成 Claude Code skills。
AI 筆記累積後，可能更難分辨哪些是你寫的、哪些是 AI 推論的，以及哪些摘要已經和來源對不上。
- AI 寫的筆記放在獨立資料夾。
- 要求 Claude Code 在每篇摘要中連回它根據的筆記或檔案。
- 提交前先用 git diff 檢查變更。
- 原始筆記改了，就重新檢查相關摘要。
13
已經用 Obsidian 加 AI，什麼時候還需要 Wenlan？
Wenlan 是為 AI 整理與維護知識而設計的個人 Wiki。建立知識頁、保留來源、追蹤變更與檢查修訂都已內建；你不用為了這些工作，另外拼裝並維護一套外掛、腳本與規則。
可以直接從文件、筆記與 AI 工作成果開始，Obsidian 並非必要。日常透過已連接的 AI 保存與取用知識，需要閱讀頁面、查來源或檢查修改時，再打開 Wenlan。如果仍需要 Obsidian 的編輯器與外掛，也可以繼續使用，並把筆記庫接進來。
Obsidian 的 Markdown 筆記，本來就能讓有存取權限的不同 AI 工具讀寫；claude-obsidian 等專案也提供引用與維護流程。選擇 Wenlan，是選擇它內建的整套流程，光是跨 AI 存取並不足以構成理由。若現有工具已經順手，也未必需要另裝。
以這篇練習為例，值得留下的是一份能接著維護的專案摘要：展示日期從 10 月 22 日改成 24 日後，依新來源更新同一頁，核對修改依據；之後處理這個專案時，就能使用這一頁，不必沿用對話裡的舊答案。
Obsidian 筆記庫以來源連接，原始筆記仍留在 Obsidian；沒有你同意，Wenlan 不會改動它們，只在你接受時才寫入變更。Wenlan 會在背景跟進筆記庫，約每 30 秒檢查一次，所以修改筆記後不必手動重新同步，直接請已連接的 AI 更新頁面即可；背景更新頁面另需設定模型。如果 AI 更新的是你編輯過的頁面，會先提出修訂讓你檢查。AI 承擔整理工作，內容仍由你判斷。
| 需求 | 可用做法 |
|---|---|
| 偶爾查找幾份筆記 | 直接請 Claude 讀取檔案 |
| 自動整理 vault | 使用 skills 或 claude-obsidian 等外掛 |
| 使用內建流程建立並持續維護知識頁 | 直接使用 Wenlan，或接入既有 Obsidian 筆記 |
14
把練習筆記整理成 Wenlan 專案摘要
如果想在對話結束後繼續維護專案摘要，可以試這個選做練習。開始前，先用下方指令把 Wenlan 連到 Claude Code。
保留前面的兩份筆記，再新增下表的 03-checklist.md。Wenlan 0.18.16 的預設設定需要至少三筆獨立來源才能建立這類摘要頁；這三份短筆記各提供一筆。
| 新增筆記 | 貼入內容 |
|---|---|
| 03-checklist.md | 10 月 4 日檢查清單：展示預留 15 分鐘。確認場地後才能寄出邀請。 |
- 在 Wenlan 桌面 App 開啟「設定 → 來源」，把練習 vault 加為 Obsidian 來源，等三份筆記同步完成。
- 請 Claude：「用 Wenlan 找出練習 vault 裡的 01-plan.md、02-update.md 和 03-checklist.md，依這三份來源建立專案摘要頁。正文列出目前展示日期、負責人、時長與待確認事項；頁面的短摘要只描述用途，不重複日期。完成後給我 Page ID，方便下次更新同一頁。」
- 打開頁面及其來源，核對 10 月 22 日、小梅、15 分鐘、場地未確認。不能把舊的 10 月 20 日當成目前安排。先不要手動修改摘要頁，接著測試來源更新。
- 把 02-update.md 裡的 10 月 22 日改成 10 月 24 日。Wenlan 會在背景跟進這個 vault，約每 30 秒檢查一次，稍等片刻讓變更被讀入，再請 Claude 重新讀取這個 Page 的來源，更新同一個 Page ID。核對正文已改為 10 月 24 日，且仍連到三份筆記。只讓來源跟上變更，不會直接改寫頁面。
npx -y wenlan setup
# 接著在 Claude Code 裡：
/plugin marketplace add wenlan-app/wenlan
/plugin install wenlan@7xuanlu-wenlan用現有筆記，建立第一份可持續更新的專案摘要
從你已有的筆記開始，在 Wenlan 建立第一份有引用的專案摘要。跟著上方練習，在來源改變後更新同一頁。
在實際畫面中，核對引用與修訂
以下來自 Wenlan App 的 Tally 發票專案示範錄影。放大實際畫面，查看一條引用如何回到來源，以及頁面修訂提出了哪些改變。
1. 從 SQLite 結論回到原始依據
Wiki 說明 Tally 為單人應用選擇 SQLite。打開的引用顯示「SQLite for Single-User App」來源、摘要與「Open memory」入口。再次使用這個決策前，先比較句子和來源是否一致。
2. 先看增刪內容，再決定是否接受
Project notes 修訂刪除「資料庫尚未決定」的舊文字，提出使用 SQLite 的新敘述。畫面保留增刪差異、先前版本，以及 Skip／Approve 操作。先檢查新文字和引用，再決定保留哪些內容。
常見問題