Obsidian + Claude Code 的 AI 筆記：何時需要 Agent Memory？

如果你的主要工作是整理文章、研究與個人知識，先用 Obsidian。Markdown vault 對人可讀、可編輯，也容易用 git 或一般備份工具保存。

如果問題是 AI agent 每次開新 session 都忘記決策、踩過的坑與 handoff，光讓 Claude Code 讀寫 vault 還不夠。你還需要決定什麼值得 capture、何時 recall、誰能修正、來源在哪，以及舊結論何時應被 supersede。

Obsidian core 提供本地 Markdown vault、連結與人類知識工作介面。Claudian 把 Claude Code 工作流帶進 Obsidian；其他 MCP bridge 則把 vault 檔案與操作暴露給支援 MCP 的 client。

這些工具很適合 vault 搜尋、建立筆記、改寫內容或在 Obsidian 內協作。它們的共同中心仍是 vault；memory 是否要 review、如何跨 client 共用、如何保留 handoff 與來源，要看各專案另外提供什麼。

當同一份工作會在 Claude Code、Codex、Cursor、Gemini CLI 或其他 MCP client 之間移動，memory runtime 的責任開始和筆記 app 不同。它必須讓不同 client 用同一套 capture、recall、review、distill 與 handoff 語意工作。

Wenlan 把 atomic memories、sessions、handoffs 與 source-backed pages 保存在本地 runtime，再把可讀 artifacts 投影成 Markdown。這讓 Obsidian 可以當檢視與寫作介面，但不必承擔 retrieval index、review state 或跨 client protocol。

把設計稿、研究筆記與長篇原文留在 Obsidian。當其中一個結論會影響未來 AI 工作，再 capture 那個可重用的後果，例如已接受的 tradeoff、部署限制、使用者偏好或已驗證的 gotcha。

工作結束時寫 handoff；同一主題反覆出現後，再把相關 memories distill 成 source-backed page。不要把整個 vault 複製進 memory，也不要讓 agent 自動改寫所有人類筆記。

先問 source of truth 在哪裡。如果人類維護的 vault 是中心，而且 agent 只要協助搜尋與寫作，Obsidian-centered workflow 已經足夠。

如果中心是跨工具延續的 AI work context，就把 vault 當可讀知識面，把 agent memory 當 runtime。兩者可以共存；重點是不要讓同一份資料在兩套系統裡互相覆寫。