AI × Obsidian 高效知识工作流
结合 Claude Code、Obsidian CLI 与 AI 打造个人知识操作系统
核心工具链: Obsidian Vault ⟷ Obsidian CLI ⟷ Claude Code ⟷ Claude AI
01 · 核心工具链
Obsidian
本地 Markdown 知识库,双向链接、Graph View、插件生态。数据完全本地,支持 Git 同步。
Obsidian CLI
命令行工具,无需打开 GUI 即可读写笔记,支持脚本批处理,是 AI 自动化的桥梁。
Claude Code
终端 AI 编程助手,可直接读写文件系统,执行脚本,自动化处理 Vault 内容。
Claude AI
通过 API 或 Claude.ai 进行内容生成、总结提炼、知识结构化、批量处理笔记。
02 · 快速安装配置
安装工具链:
npm install -g obsidian-clinpm install -g @anthropic-ai/claude-codeobsidian --versionclaude --version进入 Vault 目录并启动 Claude Code:
cd ~/Documents/MyVaultclaude在 Vault 根目录创建 CLAUDE.md,告诉 Claude Code 你的知识库结构:
# My Obsidian Vault
## 目录结构
- 00-Inbox/ # 新笔记收集箱
- 10-Projects/ # 当前项目
- 20-Areas/ # 长期关注领域
- 30-Resources/ # 参考资料
- 90-Archive/ # 归档
- Templates/ # 笔记模板
## 笔记规范
- 使用 YAML frontmatter(tags, created, status)
- 双向链接用 [[Note Name]] 格式
- 每天 Daily Note 在 Daily/ 目录关键技巧: 在 Vault 根目录创建
CLAUDE.md,Claude Code 会自动读取它作为系统上下文,完全理解你的知识库结构,无需每次重复说明。
03 · 五大核心工作流
Workflow A · AI 辅助笔记整理
- 收集到 Inbox — 随手把想法、文章、截图丢进
00-Inbox/目录,不加整理 - Claude Code 批量处理 — 告诉 Claude:“分析 Inbox 里的所有笔记,按主题分类,建议移动到对应目录”
- AI 添加 Frontmatter — 自动为每篇笔记生成 tags、summary、related links
- 建立双向链接 — Claude 扫描 Vault,发现相关笔记后自动添加
[[]]链接
Claude Code 实际指令示例:
分析 00-Inbox/ 里的所有 .md 文件,帮我:
1. 提取每个文件的核心主题(1行)
2. 建议最合适的目标目录
3. 为每个文件添加 YAML frontmatter(tags, summary)
4. 找出可以相互链接的笔记对
先列出分析结果让我确认,再执行移动
Workflow B · AI Daily Note 增强
- 自动生成 Daily Note 模板 — Claude Code 每天早上运行脚本,从日历/任务读取今日计划填入模板
- 晚间 AI 总结 — 把今天的笔记发给 Claude,生成 Key Learnings 和 Tomorrow Focus
- 周回顾自动化 — Claude 读取本周所有 Daily Note,生成周报、提取 Highlights
Workflow C · 知识库 AI 问答
- 让 Claude Code 搜索 Vault — “在我的笔记里找所有关于 React 性能优化的内容,汇总成一份摘要”
- 跨笔记综合分析 — “我在 Projects/ 和 Resources/ 里都有关于 AI 的笔记,帮我找出矛盾和知识空白”
- 生成知识地图 — Claude 分析笔记关系,输出 Mermaid 图谱插入 Obsidian Canvas
04 · Obsidian CLI 实用命令
| 命令 | 用途 | AI 结合场景 |
|---|---|---|
obsidian open [file] | 在 GUI 中打开指定笔记 | AI 处理后自动打开结果 |
obsidian new [title] | 快速创建新笔记 | Claude 生成内容后创建 |
obsidian search [query] | 全文搜索 Vault | 给 Claude 上下文 |
obsidian daily | 打开今日 Daily Note | 配合 cron 定时脚本 |
obsidian template [name] | 用模板创建笔记 | AI 选择最合适模板 |
Claude Code 自动化脚本示例:
#!/bin/bash
# ai-inbox-process.sh — 每晚自动整理 Inbox
VAULT="~/Documents/MyVault"
INBOX="$VAULT/00-Inbox"
COUNT=$(ls "$INBOX" | wc -l)
if [ $COUNT -gt 0 ]; then
echo "Found $COUNT notes in Inbox, processing..."
claude -p "分析 $INBOX 里的所有笔记,
按照 CLAUDE.md 的目录规范进行分类整理,
添加 frontmatter,建立内部链接。
执行前先输出计划。" --allowedTools Edit,Write,Read
fi05 · 进阶技巧
Prompt 模板库
在 Vault 里建 Templates/AI-Prompts/ 目录,存储常用 Claude 提示词,Claude Code 可直接读取执行。
MCP + Obsidian
配置 Obsidian MCP Server,让 Claude Code 通过标准协议直接操作 Vault,比文件 API 更稳定。
知识图谱导出
让 Claude 分析 Vault 链接关系,生成 JSON 数据,用 D3.js 渲染自定义图谱,比内置 Graph View 更强大。
Git + AI 变更日志
每次 commit 前,Claude 自动读取 diff,生成有意义的 commit message 和 CHANGELOG 条目。
写作助手流水线
原子笔记 → Claude 聚合相关笔记 → 生成文章草稿 → 写回 Vault,实现 Zettelkasten 到长文的自动化。
cron 定时任务
用 launchd(macOS)定时执行:早晨生成 Daily Note、晚上整理 Inbox、周末生成周报。
最佳实践: 给 Claude Code 的指令要明确”先分析后执行”——让 AI 先列出操作计划,你确认后再批量修改文件。这样既保证安全,也能学习 AI 的思考逻辑,逐渐建立信任后可以开启自动模式。