从零搭建 AI 第二大脑——claude-obsidian 完整配置指南（含避坑清单）

📄 从零搭建 AI 第二大脑

——claude-obsidian 完整配置指南（含避坑清单）

你一定经历过的场景：

你六个月前读了一篇很好的文章，做了笔记，存进了某个文件夹。今天你正好需要里面的某个观点——但你记不住它存在哪，也不确定自己是否真的保存过，最后花了二十分钟翻找，还是没找到。

这不是你的错，也不是工具的错。这是静态存储系统的结构性缺陷：信息进去，就躺在那里；你必须记住它在哪，才能找到它。

「第二大脑」的概念——一个存储和提取信息的个人知识系统——已经存在多年。但大多数实现是静态的。你把东西写下来，它就在那里躺着，不会自动相互连接，不会帮你采取行动，也绝对不会随时间变得更聪明。这就是 Claude Code 和 Obsidian 改变局面的地方。

这篇文章，我们来把「静态第二大脑」升级成「主动知识引擎」。

首先搞清楚：你在建什么

在开始之前，必须理解一个根本性的架构差异——否则你配置出来的，只是一个更复杂的文件夹。

以 Tiago Forte 方法论推广的传统第二大脑是一个经过策划的、可搜索的知识库。Obsidian 是这方面最好的工具之一：本地优先、基于 Markdown，拥有强大的图谱视图和插件生态系统。但它仍然是被动存储。

你在建的，不是一个更好的 Obsidian 笔记系统，而是：

Claude Code，Anthropic 的 Agent 式编码和自动化工具，非常适合担任这个角色。它可以读写文件、执行代码、浏览网页，并在长时间任务中保持上下文。与 Obsidian vault 作为记忆层配合，它成为一个了解你的历史并在此基础上构建的 Agent。

用一句话说：你的 vault 是记忆，Claude Code 是会思考的大脑，两者合在一起才是 AI 第二大脑。

三层职责分离（这是整个系统的设计原则）

最重要的是职责分离：raw/ 是原始资料存放的地方，wiki/ 是模型写入页面的地方，CLAUDE.md 或 AGENTS.md 是操作规则存放的地方，index.md 告诉模型已存在哪些页面，log.md 记录最近发生了什么。没有这个结构，你只有一个浏览文件夹的聊天机器人；有了它，你才有一个可重复的维护工作流。

这三层分离，是整个系统能够自动运转的物理基础。

环境准备：三件事做好，后面一路顺畅

1. 安装 Obsidian 并创建 Vault

从一个全新的 Obsidian vault 开始。像 mybrain 这样简单直接的名称很好用，因为它在终端、编辑工具和 Web Clipper 设置中都容易引用。保持 vault 在本地——这样你的文件夹和文件就在磁盘上，这正是你希望 Agent 从 raw/ 读取并写入 wiki/ 时所需要的。

具体步骤：

1. 前往 obsidian.md 下载安装
2. 选择「Create new vault」，命名为 KnowledgeVault
3. 选择本地路径（不要选 iCloud 同步路径，Agent 操作时可能冲突）
4. 记住你的 vault 完整路径，后面需要用到

安装推荐插件（在 Obsidian 设置 → 社区插件中搜索）：

text

必装（系统运行依赖）：
□ Obsidian Web Clipper  — 一键网页存入 raw/
□ Dataview              — 动态查询笔记数据库
□ Templater             — 自定义笔记模板
强烈推荐：
□ Obsidian Git          — 版本控制（误操作救命稻草）
□ Calendar              — 日历视图，方便时间线浏览
□ Graph Analysis        — 增强图谱视图分析能力

2. 安装 Claude Code CLI

如果你已经在 B-03 中完成了这一步，直接跳过。

Bash

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude --version  # 确认安装成功

3. 建立 Vault 目录结构

这是最容易被忽视、但影响最深远的一步。错误的目录结构会让 Agent 产生混乱输出；正确的结构让每次输出都准确可预期。

在 vault 根目录下创建以下结构：

Bash

cd ~/KnowledgeVault
mkdir -p .claude
mkdir -p 00_System/templates
mkdir -p 10_Inbox/{books,articles,notes,transcripts}
mkdir -p 20_Wiki/{concepts,entities,frameworks,connections}
mkdir -p 30_Projects/{_active,_archive}
mkdir -p 40_Content/{drafts,published,assets}
mkdir -p 50_Reviews/{weekly,monthly}

执行完毕后，你的 vault 结构是：

text

KnowledgeVault/
├── .claude/              ← Claude Code 配置（隐藏文件夹）
├── 00_System/            ← 系统大脑
│   └── templates/        ← 笔记模板
├── 10_Inbox/             ← 原始输入（只读区）
├── 20_Wiki/              ← AI 编译知识图谱（主力区）
├── 30_Projects/          ← 项目执行区
├── 40_Content/           ← 内容生产区
└── 50_Reviews/           ← 复盘区

核心配置：CLAUDE.md——你的 AI 员工手册

这是整个系统中投资回报率最高的单个文件。

Claude Code 会在项目根目录中寻找 CLAUDE.md 文件。这是你的 Agent 的常驻指令——它在每次会话中都会读取这个文件。把它当作你第二大脑的宪法。 Schema 是一切。模糊的 Schema 产生模糊的输出。我对我的 Schema 迭代了好几次——收紧链接规则、精确定义页面结构、随新主题涌现添加领域标签。约束提升质量。

在 .claude/CLAUDE.md 中写入以下内容（根据你的实际情况调整）：

Markdown

# CLAUDE.md — 商业财经知识库操作手册 v1.0
## 🎯 你是谁
你是「商业财经 AI 知识引擎」，专注于提取、连接、构建
商业经典书籍的可操作框架库，服务于个人 IP 的内容创作。
## 📁 文件系统规则
### 路径约定（严格遵守）
- 原始资料：`10_Inbox/`     → 只读，永不修改原始文件
- 知识图谱：`20_Wiki/`      → 你的主要写作区域
- 内容草稿：`40_Content/drafts/` → 内容产出区
- 系统文件：`00_System/`    → 索引与缓存，定期更新
### 文件命名规则
- 概念页：`20_Wiki/concepts/[概念名称].md`
- 实体页：`20_Wiki/entities/[人名或书名].md`
- 框架页：`20_Wiki/frameworks/[框架名称].md`
- 连接页：`20_Wiki/connections/[主题]-跨书连接.md`
- 草稿：`40_Content/drafts/[YYYY-MM-DD]-[标题].md`
## 📄 页面结构规范
### 概念页（最常用，必须严格遵守）
每个概念页的 frontmatter：
---
type: concept
domain: [商业/投资/战略/心理/创业]
source: [[书名]]
related: []
strength: [核心/重要/辅助]
created: YYYY-MM-DD
---
正文结构：
1. 一句话定义（精确，不超过 30 字）
2. 核心机制（这个概念如何运作）
3. 应用场景（什么时候用，什么时候不用）
4. 连接概念（wikilink 到相关页面）
5. 内容选题提示（这个概念能产出什么内容）
## 🔗 连接质量控制（最关键规则）
建立 wikilink 之前，必须能回答：
「理解 [A] 是否真正改变了我对 [B] 的理解？」
如果答案是「有点相关」→ 使用 `> 参见：` 注释，不建 wikilink
如果答案是「是的，理解 A 让我从新角度看 B」→ 建立 wikilink
每个页面的 wikilink 上限：15 个
矛盾观点标注：用 `[!contradiction]` callout 块
## 🔧 核心操作命令
### /ingest 触发条件
用户说「摄入」「导入」「处理」「ingest」
执行：读取 10_Inbox/ 新文件 → 提取概念 → 检查已有页面
     → 更新或新建 → 建立交叉引用 → 更新 00_System/index.md
     → 追加 00_System/log.md
### /draft 触发条件
用户说「写」「草稿」「帮我写」「draft」
执行：检索相关 20_Wiki/ 概念页 → 调用对应 Book Skill
     → 在 40_Content/drafts/ 生成结构化草稿
     → 插入知识图谱引用作为论据
### /lint 触发条件
用户说「维护」「健康检查」「清理」「lint」
执行：找孤儿页面 → 找断链 → 检测矛盾
     → 生成「建议下一步研究」清单
     → 输出健康报告
## 🧠 热缓存规则
每次对话结束前，更新 00_System/hot-cache.md：
- 本次新增/修改的页面（带路径）
- 发现的重要跨书连接
- 待跟进的选题方向
- 下次建议优先处理的任务
（让下一次会话无需重新解释背景）

系统初始化：第一次运行

配置好 CLAUDE.md 后，启动系统：

Bash

# 进入 vault 根目录
cd ~/KnowledgeVault
# 启动 Claude Code
claude

从那一刻起，Claude 就在你的系统内部了。它立刻读取你的上下文，知道你的文件夹结构、项目和写作规则——它对你设置的了解，比大多数合作者在一周入职培训后还要多。

初始化第一步：让 Claude 建立系统文件

在 Claude Code 中输入：

text

读取 .claude/CLAUDE.md，然后：
1. 在 00_System/ 下创建 index.md（知识库总索引，初始为空）
2. 在 00_System/ 下创建 hot-cache.md（上下文缓存，初始为空）
3. 在 00_System/ 下创建 log.md（操作日志，初始为空）
4. 确认你已理解文件系统规则和连接质量控制要求
5. 用一句话描述你对本系统用途的理解

Claude 的正确回应应该是：理解系统定位，确认目录规则，并询问第一个要摄入的资料是什么。

如果 Claude 的回应偏离了定位，说明 CLAUDE.md 的某个部分写得不够清晰，返回修改。

初始化第二步：摄入第一本书

把准备好的书放入 inbox：

Bash

cp ~/Downloads/principles-ray-dalio.pdf \
   ~/KnowledgeVault/10_Inbox/books/

然后在 Claude Code 中：

text

/ingest 10_Inbox/books/principles-ray-dalio.pdf

你会看到 Claude 执行的完整流程：

text

正在读取：10_Inbox/books/principles-ray-dalio.pdf
检测到：Book-to-Skill已转化版本（/principles-dalio）
调用：/principles-dalio 以获取结构化框架
提取实体：
  → Ray Dalio（人物）
  → 桥水基金（机构）
提取概念（22个）：
  → 五步流程
  → 可信度加权
  → 极度透明
  → 极度真实
  → 痛苦+反思=进步
  ... [18 more]
检查已有页面：index.md 当前为空，全部新建
创建页面：
  ✓ 20_Wiki/entities/Ray-Dalio.md
  ✓ 20_Wiki/entities/桥水基金.md
  ✓ 20_Wiki/concepts/五步流程.md        [连接: 4个]
  ✓ 20_Wiki/concepts/可信度加权.md      [连接: 6个]
  ✓ 20_Wiki/concepts/极度透明.md        [连接: 5个]
  ... [19 more pages]
更新系统文件：
  ✓ 00_System/index.md（+22条目）
  ✓ 00_System/log.md（+1条记录）
完成。本次创建 24 个页面，建立 87 个连接。
选题建议已添加到每个概念页的底部。

打开 Obsidian，切换到图谱视图。你会看到 24 个节点，87 条连线——这就是《原则》的知识图谱，在你的 vault 里活了起来。

摄入第二本书：见证连接的魔法

书的价值在于第二本摄入之后。

把《纳瓦尔宝典》放入 inbox，执行 /ingest：

text

/ingest 10_Inbox/books/almanack-of-naval.epub

这一次，Claude 不只是新建页面——它会做交叉引用：

text

提取概念（18个）...
检查已有页面：
  「判断力」→ 与已有「可信度加权」有强连接
  「杠杆」  → 与已有「机器化思维」有中等连接
  「特定知识」→ 与已有「能力圈」（待建）有连接提示
  「正和博弈」→ 与已有「极度真实」有弱连接
更新页面：
  ✓ 20_Wiki/concepts/可信度加权.md     [新增连接: Naval-判断力]
  ✓ 20_Wiki/concepts/机器化思维.md     [新增连接: 四种杠杆]
创建新页面：
  ✓ 20_Wiki/concepts/判断力.md         [连接: 8个，含跨书]
  ✓ 20_Wiki/concepts/四种杠杆.md       [连接: 7个，含跨书]
  ...
[!contradiction] 发现：
  「极度透明（Dalio）」vs「信息不对称（Naval）」
  → 在「极度透明.md」中已标注 [!contradiction] callout
完成。本次创建 16 个新页面，更新 8 个已有页面，建立 134 个连接。

告诉 Claude「保持连接紧密——只在理解 A 真正改变你对 B 的看法时才建立链接」产生了比开放式「链接相关概念」戏剧性更好的交叉引用效果。每个新摄入的来源变得更有价值，因为它与 vault 中已有的一切相连。第 10 本书比第 1 本产出更多洞见，因为有更多内容可以连接。

打开 Obsidian 图谱视图——现在你能看到两个书的知识图谱已经开始交织。那些连接两本书概念的细线，就是你的知识系统开始超越单本书理解的证明。

日常三大操作

系统搭好后，你每天需要的只有三个操作。这也是 Karpathy 在 LLM Wiki 模式中提炼的核心：

Karpathy 将操作精简为三个：ingest（摄入）、query（查询）和 lint（维护）。这是第一个版本合适的复杂度层级。摄入意味着向原始集合添加新来源并让模型处理它，模型读取来源，更新已有页面，在需要时创建新页面，刷新索引，并向日志追加一条记录。

操作一：/ingest — 每日摄入

Bash

# 摄入单篇文章（Web Clipper 存入后）
/ingest 10_Inbox/articles/待摄入文章.md
# 摄入一本书
/ingest 10_Inbox/books/new-book.pdf
# 批量摄入（早晨例行操作）
/ingest
# Claude 自动处理 10_Inbox/ 中所有新文件

Web Clipper 配置（让摄入零摩擦）：

Obsidian Web Clipper 是将网页文章转换为干净 Markdown 的最快方式。如果你收集大量文章，它消除了很多摩擦。

在 Obsidian Web Clipper 设置中：

• 保存路径：10_Inbox/articles/{{date}}-{{title}}.md
• 格式：Markdown（保留原始标题和链接）
• 快捷键：Cmd+Shift+S（一键保存当前页面）

操作二：/draft — 内容生产

Bash

# 基于知识库写一篇文章
"@20_Wiki/concepts/可信度加权.md
 @20_Wiki/concepts/判断力.md
 /principles-dalio ch05
 /naval-almanack judgment
 写一篇 1500 字的公众号文章：
 《两种截然不同的决策哲学》
 输出到 40_Content/drafts/[今日日期]-decision-philosophy.md"

让 Claude Code 按需构建综合笔记：「搜索我的 /wiki 文件夹，找出过去 90 天内所有打了 #learning 标签的笔记，写一篇综合笔记，连接这些想法，并提炼出任何似乎矛盾或特别有趣的内容。」这将被动笔记记录变成主动知识构建。

操作三：/lint — 知识库维护

Bash

/lint

Claude 输出的健康报告格式：

text

知识库健康检查报告 — 2024-XX-XX
📊 基本统计
  总页面数：147
  本周新增：23
  总连接数：1,847
  平均连接密度：12.6 个/页
🔴 需要修复
  孤儿页面（零连接）：3 个
    - 20_Wiki/concepts/待连接概念A.md
    - 20_Wiki/concepts/待连接概念B.md
    - 建议：[自动修复 / 手动处理]
  断链：7 个
    - [列出具体文件和位置]
    - 建议：[自动修复]
🟡 值得关注
  矛盾标注（未处理）：2 处
    - 极度透明 vs 信息不对称
    - 长期持有 vs 快速迭代（商业模式）
🟢 建议深入的知识空白
  1. 你对「定价策略」有 3 个相关概念，但缺少框架页
  2. 「组织设计」出现在 5 个页面，但没有专门概念页
  3. 建议下一本书：《商业模式新生代》（与已有 6 个概念强相关）
更新已完成：00_System/hot-cache.md 已刷新

我尝试了很多 PKM 系统，大多数在自身重量下崩溃了。这个没有——因为第一次，不是我在维护它。Claude 和 Obsidian 承担了繁重的工作，把曾经脆弱的系统变成了真正能持续运转的东西。

避坑清单：5 个常见配置错误

错误一：vault 存在 iCloud 同步路径

症状：Agent 写入文件时偶发「文件被锁定」错误，或写入后文件内容不完整。

原因：iCloud 会在 Agent 操作时异步同步文件，产生写入冲突。

Obsidian 应安装好，vault 存储在本地（不只在 iCloud 中）。

解决：把 vault 移到本地路径，如 ~/Documents/KnowledgeVault，关闭该文件夹的 iCloud 同步。

错误二：CLAUDE.md 放在错误位置

症状：Claude Code 启动后好像没有读取任何规则，输出格式混乱。

关键洞见：你的 Obsidian vault 只是一个 Markdown 文件夹。Claude Code 可以读取该文件夹，理解其结构，并写回其中。

解决：CLAUDE.md 必须放在 vault 的根目录，不是子文件夹。Claude Code 只在项目根目录寻找这个文件。

错误三：连接规则太宽泛

症状：知识图谱看起来很密，但打开任意页面，发现连接很多但质量很差，一个概念页连接了 40+ 个页面。

约束提升质量。告诉 Claude「保持连接紧密——只在理解 A 真正改变你对 B 的看法时才建立链接」产生了比开放式「链接相关概念」戏剧性更好的交叉引用效果。

解决：在 CLAUDE.md 的连接规则中加入硬性约束：「每页 wikilink 上限 15 个，超出时优先保留强连接」。

错误四：raw/ 和 wiki/ 没有严格分离

症状：Agent 有时会直接修改原始书籍或文章文件，或者把 wiki 页面和原始资料混在一起。

解决：在 CLAUDE.md 中明确写入：「10_Inbox/ 是只读区，永远不修改其中任何文件；所有写入操作只发生在 20_Wiki/、40_Content/ 和 00_System/。」

错误五：没有 hot-cache 机制

症状：每次开启新 Claude Code 会话，都要重新解释上次做到哪里了，浪费大量 token 和时间。

将 Claude Code 从有用工具变成真正第二大脑的，是上下文系统。具体来说是两个文件：CLAUDE.md 和 memory.md（即 hot-cache）。你的上下文存在于你的文件中，而不是 AI 的记忆里。这是关键洞见。有了 Claude Code，你的上下文是可读、可编辑、完全结构化的 Markdown，由你掌控。

解决：在 CLAUDE.md 中加入 hot-cache 更新规则，每次会话结束时 Claude 自动更新 00_System/hot-cache.md，下次会话开始时自动读取。

验证系统真正跑通的标准

配置完成后，用这三个标准验证系统是否真正可用：

标准一：摄入质量

摄入《原则》后，打开 20_Wiki/concepts/可信度加权.md，检查：

• ✅ frontmatter 完整（type, domain, source, related, strength）
• ✅ 一句话定义精确（不是模糊的解释）
• ✅ 应用场景有具体条件（不是「任何情况下都可以用」）
• ✅ 连接概念中有 wikilink，且连接都是有意义的强连接

标准二：跨书连接质量

摄入第二本书后，打开 Obsidian 图谱视图，找到连接两本书概念的边，点开任意一个——检查两个被连接的概念页，确认这个连接「理解 A 真正改变了对 B 的认知」。

如果大部分连接只是「都与决策有关」这类弱关联，说明连接规则需要收紧。

标准三：/draft 生产能力

输入：

text

@20_Wiki/concepts/可信度加权.md
/principles-dalio ch05
写一篇 800 字的微信公众号文章介绍这个框架
输出到 40_Content/drafts/test-draft.md

如果 Claude 能在 2 分钟内生成一篇有清晰论据、直接引用你的 wiki 页面内容的文章——恭喜，系统跑通了。

4 周成长曲线：真实预期管理

大约需要四周持续的收集。第一周感觉像是在搭建。第二周感觉像是额外的工作。大约第三周，Agent 开始浮现你已经遗忘的连接。到第四周，它比搜索你的邮件更快。

text

Week 1：搭建期
  摄入：3-5 本书
  感受：配置麻烦，效果不明显
  关键动作：把 CLAUDE.md 迭代到满意为止
Week 2：积累期
  摄入：3-5 篇高质量文章
  感受：知识图谱开始成形，但还没有「哇」的时刻
  关键动作：坚持每日摄入，别停
Week 3：涌现期
  总节点：50-80 个
  第一个「哇」时刻：/lint 发现了你没想到的跨书连接
  关键动作：开始用 /draft 生产内容
Week 4：飞轮期
  总节点：100+ 个
  状态：/draft 生产的内容开始有真正的跨书洞见
  关键动作：开始规划系统化的选题矩阵

一句话总结

如果你一直在手动维护第二大脑，感受到它的重量——试试这个。搭建只需要一个下午，回报很快就会开始显现。

你建的不是一个笔记系统，是一个会思考的知识合伙人。

它知道你读过什么，知道这些知识之间如何连接，知道你下一步应该研究什么——而且它从不遗忘。

这才是真正意义上的第二大脑：不是被动储存你的想法，而是主动帮你延伸它们。