Claudian：我在 Obsidian 里装了一个不用切屏的 AI 写作搭档

——深度使用指南：从安装到日常工作流全拆解

先描述一个你一定熟悉的场景：

你在 Obsidian 里写一篇分析文章，需要参考《原则》里的某个框架。于是你切到浏览器，打开 Claude 网页版，把框架粘贴进去，得到分析，再把结果复制回 Obsidian，继续写。写到一半，你想引用你三周前存的一篇文章里的某个数据，又要去搜索，找到了再切回来。

整个写作过程，你在 Obsidian、浏览器、Claude 网页版之间来回切换了十几次。

每一次切换，都是一次上下文中断。每一次复制粘贴，都是一次信息损耗。

Claudian 解决的就是这件事。

不是「让 AI 更聪明」，而是让你不再切屏。

先弄清楚：Claudian 和 Claude 网页版的本质区别

很多人第一次听到 Claudian，以为它是「Obsidian 里的 Claude 对话框」——你可以直接在笔记软件里聊天了，不用切浏览器。

这个理解对了三分之一，错了三分之二。

Claudian 是一个 Obsidian 插件，它将 AI 编码 Agent（Claude Code、Codex、Opencode 等）嵌入你的 vault。你的 vault 成为 Agent 的工作目录——文件读写、搜索、bash 命令和多步骤工作流开箱即用。

关键词：Agent 的工作目录。

这是和网页版 Claude 的根本区别：

text

Claude 网页版：
你 ←→ AI（临时对话，无记忆，无文件访问）
每次对话从零开始，你必须自己复制粘贴上下文
Claudian：
你 ←→ AI（嵌入 vault，可读写所有文件，跨会话记忆）
AI 知道你的所有笔记，可以直接操作文件，上下文永久存在

Claudian Agent 可以直接读取你实际的 vault 文件——它具备关于你有哪些笔记、内容是什么、笔记如何相互链接的完整上下文。浏览器聊天机器人需要你手动复制粘贴内容，对你更广泛的知识库毫无感知。Claudian 还能执行操作：创建笔记、添加 wikilinks、更新 frontmatter——聊天机器人只能产生文本，你还得自己去应用。

一句话说清楚：Claude 网页版是你的对话工具，Claudian 是你的 AI 写作搭档。

安装：10 分钟完成

前置条件

text

✅ Obsidian 已安装（版本 1.0+）
✅ Claude Code CLI 已安装（参见 B-03）
✅ ANTHROPIC_API_KEY 已配置
✅ vault 已建立基础目录结构（参见 B-04）

安装步骤

方法一：Obsidian 社区插件商店（推荐）

text

Obsidian → 设置 → 社区插件 → 浏览
搜索：「Claudian」
点击安装 → 启用

方法二：手动安装（获取最新版本）

Bash

# 进入 Obsidian 插件目录
cd ~/KnowledgeVault/.obsidian/plugins/
# 克隆 Claudian
git clone https://github.com/yishentu/claudian.git
# 重启 Obsidian，在社区插件中启用 Claudian

关键配置

安装启用后，进入 Claudian 设置页：

text

Obsidian → 设置 → Claudian
必须配置：
├── AI Provider: Claude Code（推荐）
├── Claude CLI Path: /usr/local/bin/claude
│   （nvm 用户注意：填写 which claude 的输出路径）
├── Model: claude-sonnet-4-5（性价比最优）
└── Vault Skills Path: .claude/skills/（vault 级 Skills 目录）
快捷键配置（在 Obsidian 快捷键设置中）：
├── 打开 Claudian 侧边栏：Cmd+Shift+A
├── 内联编辑（选中文本触发）：Cmd+Shift+E
└── 快速命令（光标位置触发）：Cmd+Shift+C

⚠️ nvm 用户必看

这是 Claudian 最常见的安装问题。Obsidian 作为 GUI 应用启动时，不会加载你的 shell 配置文件（.zshrc 或 .bashrc），所以它找不到通过 nvm 安装的 claude 命令。

解决方案：在 Claudian 设置的「Claude CLI Path」中填写 claude 的完整绝对路径。

Bash

# 在终端中找到正确路径
which claude
# 输出示例：/Users/yourname/.nvm/versions/node/v20.15.0/bin/claude
# 把这个完整路径填入 Claudian 设置

验证安装成功

打开 Claudian 侧边栏（Cmd+Shift+A），输入：

text

你好，确认你正在运行。读取 00_System/index.md 并告诉我其中有多少条目。

如果 Claude 能正确读取并返回 index.md 的内容——安装成功，系统可用。

五大核心功能深度拆解

功能一：侧边栏对话——上下文永久在线

这是 Claudian 的基础功能，但它和网页版的本质区别在于：你的整个 vault 是它的上下文。

你不需要把任何内容复制粘贴进去——因为它已经在那里了。

text

侧边栏示范对话：
你：我今天要写一篇关于「定价决策」的文章，
    先帮我看看知识库里有哪些相关概念
Claude：[自动搜索 20_Wiki/concepts/]
       找到相关概念页（7个）：
       • 价值主张.md（来源：《商业模式新生代》）
       • 安全边际.md（来源：《聪明的投资者》）
       • 特定知识.md（来源：《纳瓦尔宝典》）
       • 损失厌恶.md（来源：《金钱心理学》）
       • 垄断定价.md（来源：《从0到1》）
       • 价格锚点.md（来源：《影响力》）
       • MVP定价.md（来源：《精益创业》）
       建议文章角度：
       1. 从「垄断定价 vs 竞争定价」切入（Thiel 框架）
       2. 从「损失厌恶的定价应用」切入（心理学角度）
       3. 综合7个视角建立定价决策框架（跨书连接）
你：选第3个，帮我设计文章结构
Claude：[读取7个概念页，设计骨架，输出文章大纲]

没有上下文切换：你的整个 AI 工作流——研究、起草、编辑、组织笔记——都在 vault 内运行。不再在终端或单独的浏览器标签页之间切换。

功能二：内联编辑——词级差异预览，精确控制每处修改

这是 Claudian 最让人上瘾的功能。

传统流程：写完一段 → 复制到 Claude → 收到修改建议 → 手动对比 → 手动修改原文。

Claudian 内联编辑流程：选中文本 → 按快捷键 → 输入修改指令 → 看到词级差异预览 → 一键接受或拒绝。

内联编辑——选中文本或在光标位置使用快捷键，直接在笔记中编辑，支持词级差异预览。逐词差异预览让你对每个更改都有精确控制。

完整操作演示：

text

步骤一：在 Obsidian 中选中你想修改的段落
        ↓
步骤二：按 Cmd+Shift+E（内联编辑快捷键）
        ↓
步骤三：在弹出的输入框中输入修改指令：
        「这段逻辑跳跃太快，用《原则》五步流程框架
         重写这个论点，保持口语化风格，不超过150字」
        ↓
步骤四：Claude 在你的笔记中直接显示差异预览：
        红色删除线 = 要删除的内容
        绿色文字   = 新增内容
        ↓
步骤五：逐词审查，按 Tab 键逐条接受/拒绝每处修改
        或按 Cmd+Enter 全部接受

内联编辑的核心价值：你始终是最终决策者。

AI 提出修改，你控制每一个字的去留。这不是「让 AI 替你写」，而是「让 AI 当你的文字编辑」——它提建议，你做决定。

实用的内联编辑指令模板：

text

逻辑类：
「这段论点缺少过渡，补充连接上下文的句子」
「用 [框架名] 重写这段，保留原意」
「这个论点有什么漏洞？加入反驳和回应」
风格类：
「改成更口语化的表达，像朋友对话」
「这段太学术，改成让普通读者也能看懂」
「压缩到原来的一半字数，保留核心论点」
结构类：
「这段应该是开头还是中间？建议如何移动」
「加入一个具体案例支撑这个论点」
「用一个问句开头，提升代入感」

功能三：斜杠命令与 Skills——召唤你的专属知识工具

这是 Claudian 与 Book-to-Skill 系统打通的关键接口。

输入 / 或 $ 来调用可重用的提示模板和来自 vault 级或用户级范围的 Skills，用自定义命令扩展你的工作流。

两类斜杠命令的区别：

text

/命令（Prompt 模板）：
→ 触发预设的提示词模板
→ 存储在 vault 的 .claude/prompts/ 目录
→ 例：/summarize（自动总结当前笔记）
        /topic-extract（提取选题建议）
$命令（Skills 调用）：
→ 调用 Book-to-Skill 生成的书籍 Skill
→ 存储在 ~/.claude/skills/ 或 vault 的 .claude/skills/
→ 例：/principles-dalio（加载《原则》框架）
        /naval-almanack（加载《纳瓦尔宝典》框架）

设置你的专属 Prompt 模板：

在 vault 的 .claude/prompts/ 目录下创建 Markdown 文件，即可通过斜杠命令调用：

Markdown

# .claude/prompts/draft-article.md
---
name: draft-article
description: 基于知识库概念页生成文章草稿
---
根据以下要求生成公众号文章：
- 字数：1500-2000字
- 结构：痛点场景开篇 → 框架拆解 → 实战应用 → 行动召唤
- 风格：口语化，有具体案例，避免过度学术
- 论据：直接引用相关 wiki 概念页的内容作为支撑
- 输出位置：40_Content/drafts/[今日日期]-[标题].md
选题：{{topic}}
核心引用概念：{{concepts}}

设置完成后，在 Claudian 侧边栏输入 /draft-article，Claudian 会自动补全参数提示。

Book Skill 的完整调用链：

text

在 Claudian 侧边栏输入：
/principles-dalio decision
@20_Wiki/concepts/可信度加权.md
@20_Wiki/concepts/判断力.md
「对比 Dalio 和 Naval 的决策框架，
 找出三个关键差异，
 输出一个可以直接用于文章的比较表格」
→ Claude 同时拥有：
  书籍原文框架（Skill）+ 知识图谱上下文（wiki 页面）
→ 输出的比较表格有原文依据，不是 AI 的泛泛发挥

功能四：@提及——精准引入上下文

输入 @ 来引用 vault 文件、子 Agent、MCP 服务器或外部目录中的文件，AI 立刻获得完整上下文。

这个功能解决了一个关键问题：如何告诉 AI 你想让它参考哪些具体内容。

四种 @提及类型：

text

@文件引用（最常用）：
@20_Wiki/concepts/五步流程.md
→ Claude 读取该文件全文作为上下文
@文件夹引用：
@20_Wiki/concepts/
→ Claude 读取该文件夹下所有文件
@子Agent引用（进阶）：
@research-agent
→ 触发专门的研究子 Agent
@MCP服务器（外部工具）：
@notion-mcp
→ 连接 Notion 数据库
@browser-mcp
→ 触发网页搜索

实际使用场景：

text

场景一：跨书连接写作
@20_Wiki/concepts/可信度加权.md
@20_Wiki/concepts/判断力.md
@20_Wiki/connections/Dalio-vs-Naval-决策-跨书连接.md
/principles-dalio ch05
「基于以上材料，写一篇分析两种决策哲学本质差异的文章」
场景二：项目上下文写作
@30_Projects/2024-商业财经IP/project.md
@30_Projects/2024-商业财经IP/content-calendar.md
「根据项目规划，推荐本周最适合发布的3个选题，
 并说明理由」
场景三：精修参考写作
@40_Content/published/已发布-高赞文章.md
「参考这篇已发布文章的风格和结构，
 帮我重写当前草稿的开头」

功能五：Plan Mode——大操作前的预览审查

当你需要让 Claudian 执行多步骤、影响多个文件的操作时，Plan Mode 是你的安全网。

Claudian 的 Plan Mode 在执行前会进入探索阶段：Agent 读取相关文件、分析依赖关系，制定详细计划供你审查，展示将要做出哪些更改以及原因——你可以批准、修改或拒绝计划后再执行。

什么时候用 Plan Mode：

text

适合用 Plan Mode 的操作：
✅ 「重组整个 20_Wiki/ 的目录结构」
✅ 「批量更新所有概念页的 frontmatter 格式」
✅ 「整合三篇草稿合并成一篇完整文章」
✅ 「将《原则》的所有概念页与《反脆弱》交叉引用」
不需要 Plan Mode 的操作：
❌ 写单篇文章草稿（普通对话即可）
❌ 查询知识库信息（普通对话即可）
❌ 内联编辑单段文字（内联编辑功能即可）

Plan Mode 操作流程：

text

步骤一：在指令前加上 「Plan Mode：」前缀
        Plan Mode：将所有概念页按 domain 字段
        重新整理到对应子文件夹
步骤二：Claude 输出执行计划（不执行）：
        「我将执行以下操作：
         1. 扫描 20_Wiki/concepts/ 下所有页面
         2. 读取每个页面的 domain frontmatter 字段
         3. 创建子文件夹：商业/ 投资/ 战略/ 心理/ 创业/
         4. 将 47 个概念页移动到对应子文件夹
         5. 更新 00_System/index.md 中的路径引用
         受影响文件：47 个概念页 + 1 个 index.md
         预计耗时：约 3 分钟
         是否批准执行？（输入「执行」开始，「取消」放弃）」
步骤三：你审查计划，输入「执行」或根据需要修改计划

日常工作流：Claudian 如何融入每一天

理解了五大功能，现在把它们组合成真实的工作节奏：

早晨：信息摄入流（20 分钟）

text

7:30 — 打开 Obsidian，Claudian 自动读取 hot-cache
       （知道昨天做到哪里，无需重新解释）
7:35 — RSS/Twitter 发现好文章
       → Web Clipper 一键存入 10_Inbox/articles/
       （快捷键 Cmd+Shift+S，不离开浏览器）
7:45 — 在 Claudian 侧边栏输入：
       /ingest
       → Claude 处理所有新文件，更新知识图谱
       → 自动生成今日选题建议
8:00 — 查看选题建议，选定今天要写的主题

上午：深度创作流（90 分钟）

text

9:00 — 阅读当月书籍 2-3 章（30 分钟）
       标记关键框架（3-5 个）
9:30 — 在 Claudian 中扩展知识图谱：
       /principles-dalio ch[X]
       「将本章核心框架整合进知识图谱，
        重点关注与已有概念的连接」
10:00 — 开始内容生产：
        在 Claudian 侧边栏：
        @20_Wiki/concepts/[相关概念A].md
        @20_Wiki/concepts/[相关概念B].md
        /[相关-book-skill] [主题]
        /draft-article topic=[今日选题] concepts=[A,B]
10:15 — 草稿生成完成（约 1500 字）
        开始内联精修：
        选中开头段落 → Cmd+Shift+E
        「开头太平淡，改成以一个让读者代入的决策困境开场」
10:45 — 精修完成，检查论据来源是否有 wiki 页面支撑
11:00 — 输出至 40_Content/drafts/，可以发布

下午：跨书连接挖掘（30 分钟，每周 2 次）

text

15:00 — 在 Claudian 侧边栏：
        「扫描 20_Wiki/concepts/ 下本周新增的所有页面，
         找出 3 个非显而易见的跨书连接，
         每个连接说明为什么这两个概念相互改变了理解，
         并给出一个可以立刻写的选题标题」
→ Claude 的输出示例：
  连接一：「极度透明（Dalio）」× 「认知失调（心理学）」
  洞见：透明度要求与人类天然的自我保护机制存在张力，
        这解释了为什么大多数公司的「透明文化」流于形式。
  选题：「为什么达利欧的极度透明，在99%的公司行不通」
  连接二：「安全边际（Graham）」× 「反脆弱（Taleb）」
  洞见：两者都在谈「下行保护」，但机制截然不同。
        安全边际是防御性的（减少损失），
        反脆弱是进攻性的（从压力中获益）。
  选题：「防守 vs 进攻：两种截然不同的风险管理哲学」

晚间：维护流（15 分钟）

text

21:00 — /lint
        → 知识库健康检查报告
        → 处理孤儿页面和断链
21:10 — 查看当日数据（平台数据或写作量）
        → 在 Claudian 中更新内容日历
21:15 — 会话结束，Claude 自动更新 hot-cache
        （明天打开直接继续，零重启成本）

进阶：MCP 服务器扩展工作流

Claudian 支持通过 MCP（Model Context Protocol）连接外部工具，将工作流从 vault 内部延伸到外部系统。

输入 @ 来引用 MCP 服务器——在支持 MCP 的地方，Claudian 可以连接任何兼容的 MCP 服务器：Notion、Slack、GitHub，甚至自定义的内部工具。

几个高价值的 MCP 连接：

text

@browser-mcp（网页搜索）：
「搜索关于「可信度加权决策」的最新学术研究，
 将相关结果摘要存入 10_Inbox/articles/」
@notion-mcp（直接推送发布）：
「将这篇草稿推送到我的 Notion 内容库，
 添加标签：商业/框架拆解/原则，状态：待审核」
@github-mcp（版本管理）：
「将今日更新的所有 wiki 页面提交到 GitHub，
 commit message：[日期] 摄入《X》+ 更新Y个概念页」

MCP 的价值在于：你的工作流不再是孤岛。Obsidian vault 变成了一个指挥中心，所有工具围绕它运转，而不是相互孤立。

避坑清单：5 个 Claudian 的常见卡点

卡点一：侧边栏启动但 Claude 无响应

症状：侧边栏打开，输入命令，一直在加载，没有任何回应。

原因 90%：Claude CLI 路径不对，Claudian 找不到 claude 命令。

解决：

Bash

# 终端中找到正确路径
which claude
# 将输出的完整路径填入 Claudian 设置 → Claude CLI Path

卡点二：@提及文件后 Claude 说「文件不存在」

症状：输入 @20_Wiki/concepts/五步流程.md，Claude 回应「找不到该文件」。

原因：@提及的路径必须相对于 vault 根目录，不是系统绝对路径。

解决：确认文件路径正确，使用相对路径。可以在文件资源管理器中右键 → 复制相对路径，再粘贴到 @提及中。

卡点三：内联编辑触发后，差异预览不显示

症状：选中文本，按快捷键，弹出输入框，输入指令后 Claude 回复了文字，但没有差异预览格式。

原因：Claude 的输出格式不符合 Claudian 的差异渲染要求。

解决：在内联编辑指令中明确说明：「请以 diff 格式输出，用 --- 标记删除内容，用 +++ 标记新增内容」。或者在 Claudian 设置中调整「内联编辑输出格式」为「Diff Mode」。

卡点四：Book Skill 在 Claudian 中无法调用

症状：在 Claude Code 终端里可以用 /principles-dalio，但在 Claudian 侧边栏里输入同样命令没有反应。

原因：Skills 需要在 Claudian 的 Skill 搜索路径中被找到。

解决：

text

Claudian 设置 → Skills Paths → 添加：
~/.claude/skills/        （全局 Skill 路径）
.claude/skills/          （vault 级 Skill 路径）

卡点五：Plan Mode 执行到一半停止

症状：批准了执行计划，Claude 开始操作，但处理到第15个文件时停止，后面的文件没有处理。

原因：长时间操作超出了 Claude Code 的上下文窗口，或遇到了文件权限问题。

解决：拆分操作。不要一次性「整理所有100个文件」，改为「整理商业类别的20个文件」，分批执行。每批执行完后 /lint 检查一次。

一句话总结

Claudian 不是「AI 聊天在 Obsidian 里」，而是「AI Agent 住进了你的知识库」。

它拥有你所有的阅读积累，能读写你的任何文件，记得你上次停在哪里，知道你的写作风格，了解你的内容方向——而你，不需要再切一次屏。

你的写作搭档一直都在，就在侧边栏，随时待命。