Obsidian 结合 Claude Code

两种结合方式

方式一：Claudian 插件（推荐）

Claudian 是将 Claude Code 直接嵌入 Obsidian 的插件，在侧边栏提供完整的 AI 协作界面。

方式二：终端结合

在 Obsidian Vault 目录启动 Claude Code，通过文件交互协作。

Claudian 插件

简介

Github - YishenTu/claudian

⭐ 8555+ Stars | 500+ Forks | MIT License

将 Claude Code/Codex 直接嵌入 Obsidian，Vault 成为 AI Agent 的工作目录，支持文件读写、搜索、终端命令和多步骤工作流。

核心特性

支持的 AI 提供商

• Claude Code：Claude 订阅/API（推荐）
• Codex CLI：OpenAI Codex
• 兼容服务：Openrouter、Kimi 等

系统要求

• Claude Code CLI 已安装（推荐原生安装）
• Obsidian v1.4.5+
• 仅支持桌面端（macOS/Linux/Windows）

安装方式

方式一：从 GitHub Release（推荐）

1. 下载 最新版本 的 main.js、manifest.json、styles.css
2. 在 Vault 创建插件文件夹：

   /path/to/vault/.obsidian/plugins/claudian/
   

3. 复制文件到该文件夹
4. Obsidian 设置 → 社区插件 → 启用 “Claudian”

方式二：BRAT 自动更新

1. 安装 BRAT 插件（社区插件搜索）
2. BRAT 设置 → 添加 Beta 插件
3. 输入：https://github.com/YishenTu/claudian
4. 自动安装并启用

方式三：从源码

cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudian
npm install
npm run build

配置 Claude CLI 路径

如果遇到 spawn claude ENOENT 错误：

在 Claudian 设置 → Advanced → Claude CLI path 中填入路径。

Vault 目录结构

vault/
├── .obsidian/
│   └── plugins/
│       └── claudian/      # 插件文件
├── .claude/
│   ├── commands/          # 自定义命令
│   ├── agents/            # 自定义 Agent
│   ├── skills/            # Skills
│   └── hooks/             # 钩子配置
└── .claudian/             # Claudian 设置

使用技巧

1. Inline Edit 模式

1. 选中要修改的文字
2. 按快捷键（默认 Ctrl+Shift+E）
3. 输入修改指令
4. 预览 diff，确认后应用

2. Plan Mode 工作流

1. Shift+Tab 切换到 Plan Mode
2. Claude 探索代码库，设计方案
3. 展示计划供你确认
4. 批准后执行

3. @mention 高效引用

@ 笔记名          # 引用笔记
@ #标签              # 引用标签相关
@ scripts/清理.py    # 引用脚本

终端结合方式

直接在 Vault 启动 Claude

# 进入笔记目录
cd ~/Obsidian/Vault
claude

# 让 Claude 学习笔记
"阅读 项目笔记.md 了解项目背景"

# 执行任务
"根据笔记中的需求，实现用户注册功能"

快捷命令

创建别名简化操作：

# ~/.zshrc 或 ~/.bashrc
alias claude-vault="cd ~/Obsidian/Vault && claude"

.claudeignore 配置

# .claudeignore
# Obsidian 排除项
**/.obsidian/
**/.trash/
**/Daily/*.md
**/Templates/

# 其他排除
.git/
node_modules/

实战应用案例

案例一：知识库整理

场景：整理散乱的笔记，建立知识体系

Claudian 工作流：

1. 打开 Claudian，对话：
   "分析 01-学习/ 目录下的所有笔记，提取核心概念和主题"

2. Claude 分析后：
   "基于分析结果，生成知识索引笔记，包含主题分类和 双向链接"

3. 自动生成：
   - 知识索引.md（主题地图）
   - 每个主题的汇总笔记
   - 相关笔记的链接关系

案例二：代码文档化

场景：为 Obsidian Vault 中的脚本生成文档

Claudian 工作流：

1. 选中脚本文件
2. Inline Edit：
   "为这个脚本生成完整的 Markdown 文档，包含：
   - 功能说明
   - 参数解释
   - 使用示例
   - 注意事项"

3. 自动生成带格式的文档

案例三：写作助手

场景：撰写技术博客或文档

Claudian 工作流：

1. 打开 Claudian，引用草稿：
   @ 草稿.md

2. 对话：
   "优化这段文字的表达，使其更清晰专业"

3. 续写：
   "根据以上内容，续写下一节"

4. 检查：
   "检查文章的逻辑连贯性和技术准确性"

案例四：项目管理

场景：用 Obsidian 管理项目，用 Claude 执行任务

Claudian 工作流：

1. 项目笔记结构：
   项目A/计划.md     - 包含任务清单
   项目A/需求.md     - 需求文档
   项目A/进度.md     - 进度跟踪

2. 执行任务：
   @ 项目A/计划.md
   "读取任务清单，完成第一个待办事项"

3. 更新进度：
   "更新 项目A/进度.md，记录完成的任务"

案例五：自动化脚本生成

场景：快速生成 Obsidian 自动化脚本

Claudian 工作流：

1. 对话：
   "写一个 Obsidian 插件脚本，功能：
   - 批量给笔记添加标签
   - 根据文件名自动设置 alias
   - 生成笔记索引"

2. Claude 生成完整脚本
3. 保存到 .obsidian/plugins/my-plugin/
4. Claudian 继续调试和优化

案例六：数据处理

场景：处理笔记中的数据

Claudian 工作流：

1. 对话：
   "分析 Daily/ 目录下所有日记，统计：
   - 每周写的笔记数量
   - 最常提到的关键词
   - 情绪趋势分析"

2. Claude 读取所有文件
3. 生成分析报告
4. 保存到 日记分析报告.md

工作流程模板

模板一：笔记整理工作流

## 笔记整理流程

1. **收集** → Claudian 快速记录想法
2. **分析** → Claude 提取关键信息
3. **链接** → 自动建立双向链接
4. **索引** → 生成主题 MOC
5. **回顾** → 定期用 Claude 总结

 Claudian Commands：
 /analyze    - 分析笔记结构
 /summarize  - 生成摘要
 /link       - 建立链接
 /toc        - 生成目录

模板二：写作工作流

## 写作辅助流程

1. **列提纲** → Claude 帮助规划结构
2. **写草稿** → Obsidian 编写
3. **优化** → Claudian Inline Edit 润色
4. **检查** → Claude 检查逻辑和语法
5. **发布** → 导出为 PDF/Markdown

 Claudian Commands：
 /outline    - 生成文章大纲
 /polish     - 优化表达
 /check      - 检查逻辑
 /translate  - 翻译

模板三：学习工作流

## 学习笔记流程

1. **速记** → Daily Notes 快速记录
2. **整理** → Claudian 提取要点
3. **关联** → Claude 建立知识链接
4. **测试** → Claude 生成问答测试
5. **复习** → 基于笔记的间隔重复

 Claudian Commands：
 /extract    - 提取知识点
 /quiz       - 生成测验
 /mindmap    - 生成思维导图
 /flashcard  - 生成闪卡

Claudian Commands 示例

在 .claude/commands/ 目录下创建：

analyze.md - 笔记分析

---
description: 分析笔记结构和内容
argument-hint: [note-path]
---

分析 @$1，输出：

1. **结构**：标题层级、段落划分
2. **关键信息**：核心概念、术语、引用
3. **行动项**：TODO、待办、计划
4. **关联**：建议链接的其他笔记
5. **建议**：优化方向

summarize.md - 摘要生成

---
description: 生成笔记摘要
argument-hint: [note-path]
---

为 @$1 生成简洁摘要：

- 核心主题（一句话）
- 关键要点（3-5 条）
- 适用场景
- 相关主题

link.md - 链接建议

---
description: 建议笔记链接
argument-hint: [note-path]
---

扫描 Vault 中所有笔记，为 @$1 推荐链接：

1. 同一主题的笔记
2. 引用或被引用的笔记
3. 相关概念的笔记
4. 案例或应用的笔记

输出格式：
- 笔记名 - 关联原因

最佳实践

1. 保持职责分离

Obsidian（知识库）←→ Claudian（理解+建议）←→ 用户（决策）

• Obsidian：结构化存储笔记
• Claudian：分析、理解、生成建议
• 用户：审核、执行、决策

2. 利用 Plan Mode

复杂任务先切 Plan Mode：

/plan "整理项目笔记，建立完整知识体系"

Claude 先设计方案，你批准后再执行。

3. 善用 @mention

高效引用 → 精准上下文 → 更好的回答

4. 定期清理上下文

• 大任务分多次对话
• 定期开启新会话
• 重要结论写回笔记

5. 版本控制

# 将 Vault 纳入 Git
cd ~/Obsidian/Vault
git init
git add .
git commit -m "Initial commit"

常见问题

Q: Claudian 和终端 Claude Code 哪个好？

Q: 如何避免修改错误？

1. 使用 Plan Mode：先看计划再执行
2. Inline Edit 预览：diff 确认后再应用
3. 备份重要笔记：纳入 Git 版本控制
4. 设置 Safe 模式：敏感操作二次确认

Q: 隐私安全？

• 数据存储在本地 Vault
• 仅发送笔记内容到 API
• 无遥测追踪
• 支持自托管 API（如 Openrouter）

参考资源

官方资源

• Claudian GitHub
• Claude Code 官方文档
• Obsidian 插件 API

社区

• Obsidian 论坛
• Claudian Discussions

相关插件

相关

• Claude Code使用指南 —— Claude Code 基础
• CLAUDE.md写法 —— 在 Obsidian 项目里写 CLAUDE.md 的写法
• Claude-Code-Skills与Agents完全指南 —— Skills / Agents 体系
• Obsidian使用指南 —— Obsidian 基础