大多数同时用Obsidian和Claude Code的开发者，把它们当作完全独立的工具。

少数人发现了把它们连成一个统一stack的方法。这两个群体之间的生产力差距，不是很小，是巨大的。

为什么这个组合不一样

Obsidian解决知识管理问题：如何捕获、组织、连接你知道的一切，让它在需要时可用。

Claude Code解决执行问题：如何把想法变成可运行的代码、完整系统或成品。

大多数开发者把这两个工具用在工作流的不同阶段：在Obsidian里研究，在Claude Code里构建。它们从不相遇。

把两者连接起来的人发现了意想不到的东西：当Claude Code可以访问你的Obsidian保险库时，你的知识变成了可执行的。

几个月前捕获的想法变成了今天构建系统的上下文。你在某个主题上做的研究，变成了Claude Code解决相关问题时的推理基础。你积累的思考变成了开发工作流中的积极参与者，而不是躺在很少打开的文件夹里被动等待。

这就是这个stack的核心洞察。

第一步：把保险库结构化

Claude Code把你的保险库当作文件系统读取。它可以读markdown文件、跟踪笔记之间的内部链接、理解你建立的文件夹结构。

最佳文件夹结构：

在保险库根目录创建一个Context文件夹。这是专门放想让Claude Code在项目工作时参考的笔记的地方。在Context里创建与工作领域匹配的子文件夹。

创建一个Projects文件夹，每个活动项目有自己的笔记。项目笔记包含目标、约束、已做的决定、开放问题。这成为Claude Code开始项目工作前读取的简报文件。

创建一个Decisions文件夹，在其中记录架构和技术决策。为什么选择这个方案而非另一个，考虑过什么、拒绝了什么。这是当你在构建与过去决策相关的系统时，Claude Code的宝贵上下文。

关键文件：CLAUDE.md

在Obsidian保险库根目录创建一个CLAUDE.md文件。这是告诉Claude Code保险库如何组织、使用什么约定、以及你希望它如何处理在其中找到的知识的主上下文文件。

模板：

# Obsidian Vault - Claude Code Context

## Vault Structure
- /Context - 活动开发的参考笔记
- /Context/Architecture - 我使用的系统设计模式
- /Context/Decisions - 技术决策及其理由
- /Projects - 活动项目简报
- /Notes - 通用知识库

## My Development Conventions
- 在可能的情况下优先使用函数式模式而非类模式
- 在/Context/Decisions中记录每个架构决策
- /Projects中的项目笔记包含当前状态和开放问题
- 我使用[[双括号]]进行相关概念之间的内部链接

## How to Use This Vault
当我开始项目session时，问我先读哪个项目笔记。
在建议方案之前，总是检查/Context/Decisions中相关的过去决策。
如果你发现我的笔记和你的建议有矛盾，解释为什么。

## Current Active Projects
[列出3-5个最活跃的项目，每个一行描述]

## My Technical Preferences
[列出语言偏好、框架选择、测试方法]

这个文件做了一件重要的事：把Claude Code从通用编码助手，变成了理解你特定上下文、你的约定、以及你积累的知识的东西。

第二步：核心工作流

项目启动工作流

当你开始一个新功能或项目时，打开Claude Code，指向你的Obsidian保险库。说："读我[项目名称]的项目笔记和/Context/Architecture中的相关笔记。然后告诉我你对我要构建的东西的理解，并在写任何代码之前问我三个最重要的问题。"

这做了大多数开发者从不做的事：强迫在写任何代码之前进行真正的简报。Claude Code读取你积累的上下文，综合它理解的内容，并识别信息中的空白。

决策捕获工作流

每次你和Claude Code在session中做出重大技术决策时，立即捕获它。说："我们刚决定[描述决策]。为我的/Context/Decisions文件夹写一个决策笔记，记录我们决定了什么、为什么选择这个方案、考虑过哪些替代方案、以及何时应该重新审视这个决策。"

随着时间推移，你的Decisions文件夹变成了非凡的资源。你曾经做过的每个架构选择都有文档记录其理由。当未来面对类似决策时，Claude Code可以读取这段历史，并做出与过去思考一致的推荐。

知识提取工作流

在每个重要Claude Code session结束时，运行这个提示："总结我们今天构建了什么、做了什么决策、以及关于我的代码库你学到了什么，这些对未来的session是有用的上下文。格式化成我可以添加到Obsidian保险库的笔记。"

这是使这个stack随时间复利的飞轮。每个session产生知识，知识被捕获到Obsidian，未来的session被那些捕获的知识告知。系统随着你运行的每个session变得更聪明。

调试智能工作流

当你遇到困难bug时，打开Claude Code运行这个提示："我在调试[描述bug]。在我们看代码之前，检查我的/Context/Decisions文件夹中与[相关系统]相关的任何决策，以及我的/Notes文件夹中与[相关主题]相关的任何内容。然后基于代码和我的过去决策帮助我理解可能是什么原因。"

这就是这个stack展示真正力量的地方。大多数调试session从零开始。Claude Code读取你的代码并尝试在没有决策背景的情况下理解它。

有了这个工作流，Claude Code不仅理解代码做什么，还理解为什么它被构建成那样。这个上下文戏剧性地改变了调试辅助的质量。

第三步：完成stack的插件

三个Obsidian插件把这个设置从好变成卓越。

Templater

为你接入Claude Code工作流的每种笔记类型创建模板。项目模板、决策模板、调试session模板。当Templater创建新项目笔记时，自动添加Claude Code期望的部分。保险库结构的一致性意味着Claude Code可以在每个session中可靠地导航和使用它。

Dataview

这个插件让你像查询数据库一样查询保险库。创建一个仪表盘笔记，用Dataview查询显示：所有项目中的开放问题、过去30天做出的所有决策、标记为与当前关注领域相关的所有笔记。

当你开始Claude Code session时，先打开这个仪表盘。它给你一个即时画面，了解在开始之前与Claude Code分享的最相关上下文。

Canvas

在构建之前，用Obsidian Canvas直观地绘制复杂系统的地图。然后当打开Claude Code时说："我在Canvas笔记[名称]中映射了系统架构。这是该地图的文本描述[粘贴或描述]。以匹配此架构的方式构建它。"

Canvas成为你的系统设计工具。Claude Code成为实现引擎。这个组合比你发现的任何其他设计到代码的工作流都快。

复利效应

关于这个stack，没人告诉你的事：

第一周，收益很小。你进入每个session的上下文比平时多一点。

第一个月，收益显著。你的决策有文档记录。你的模式有记录。Claude Code开始理解你如何构建。

第一年，收益非凡。

你运行的每个session都添加到了保险库。每个决策都有文档记录。每个调试洞察都被捕获。你开发的每个架构模式都可用。

你建立了一个反映你特定思维和构建方式的知识库。

Claude Code可以完全访问所有这些。

大多数开发者用AI构建，每次session从零开始。

Obsidian加Claude Code的stack意味着你永远不必从零开始。

每个session都建立在之前所有session的基础上。

那个复利效应是这个stack改变一切的真正原因。