Obsidian 与 Claude 协作完全指南，从零开始打造基于 AI 的智能笔记工作流

概述

本教程将引导你完成从安装 Obsidian 到使用 Claude Code 进行智能写作的完整流程。通过本教程，你将学会如何将强大的 AI 助手集成到你的笔记系统中，实现高效的内容创作。

技术栈：
- Obsidian：本地优先的知识管理工具
- Claude Code：Anthropic 官方 CLI 工具
- Obsidian Skills：Claude Code 的 Obsidian 扩展能力

第一步：安装 Obsidian

1.1 下载 Obsidian

访问 Obsidian 官网 下载适合你操作系统的版本：

• macOS: 下载 .dmg 文件
• Windows: 下载 .exe 安装程序
• Linux: 下载 .AppImage 或使用包管理器

1.2 创建你的第一个 Vault

1. 启动 Obsidian
2. 选择「创建新仓库」或「打开现有文件夹」
3. 选择一个本地文件夹作为你的知识库位置
4. 为你的 Vault 命名（例如：我的知识库）

# 推荐的 Vault 目录结构
~/Documents/Obsidian/
└── 我的知识库/
    ├── 日记/
    ├── 项目/
    └── 资源/

1.3 基础配置

进入 设置 → 编辑器，建议启用：
- ✅ 自动配对括号
- ✅ 显示行号
- ✅ Vim 键位绑定（可选，适合高级用户）

第二步：安装 Claude Code

2.1 前置要求

确保你的系统已安装：
- Node.js 18+ 或 Bun 1.0+
- Git（用于版本控制）

验证安装：

node --version  # 应显示 v18.0.0 或更高
git --version   # 应显示 git 版本信息

2.2 安装 Claude Code CLI

使用 npm 全局安装：

npm install -g @anthropic-ai/claude-code

或使用 Bun（更快）：

bun install -g @anthropic-ai/claude-code

2.3 验证安装

claude --version

如果显示版本号，说明安装成功。

2.4 配置 API Key

1. 访问 Anthropic Console
2. 创建 API Key
3. 配置环境变量：

# macOS/Linux
export ANTHROPIC_API_KEY='your-api-key-here'

# 或添加到 ~/.zshrc 或 ~/.bashrc 使其永久生效
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell):

$env:ANTHROPIC_API_KEY = "your-api-key-here"

第三步：启用 Obsidian Skills

3.1 什么是 Obsidian Skills？

Obsidian Skills 是 Claude Code 的扩展能力集，让 Claude 能够：
- 理解 Obsidian 特有的 Markdown 语法（Wikilinks、Callouts 等）
- 创建和编辑 Obsidian Bases（数据库视图）
- 使用 Obsidian CLI 进行 Vault 操作
- 处理 JSON Canvas 文件

3.2 进入你的 Obsidian Vault

cd ~/Documents/Obsidian/我的知识库

3.3 启动 Claude Code

claude

首次启动时，Claude 会自动检测到你在 Obsidian Vault 中，并加载相关 Skills。

3.4 验证 Skills 可用性

在 Claude Code 交互界面中输入：

/help

你应该能看到以下 Obsidian 相关的 Skills：
- obsidian-markdown - 处理 Obsidian 风格的 Markdown
- obsidian-bases - 创建和编辑 .base 文件
- obsidian-cli - 使用 Obsidian CLI 操作
- json-canvas - 处理 Canvas 文件

第四步：使用 Claude 创作你的第一篇文章

4.1 明确写作目标

在 Claude Code 中，清晰地描述你的需求：

请帮我写一篇关于「时间管理方法论」的文章，包含：
1. 番茄工作法的原理
2. GTD（Getting Things Done）方法
3. 时间块管理技巧
4. 使用 Obsidian 实践这些方法的具体案例

文章风格：专业但易懂，适合知识工作者阅读

4.2 Claude 的工作流程

Claude 会：
1. 理解需求 - 分析你的写作目标
2. 规划结构 - 设计文章大纲
3. 创建文件 - 使用 Obsidian Markdown 语法
4. 填充内容 - 生成高质量的文章内容
5. 添加元数据 - 使用 Frontmatter 添加标签、日期等

4.3 实时协作与修改

你可以随时要求 Claude 调整：

请在「番茄工作法」部分添加一个实践案例

把第二段改得更简洁一些

添加一个 Callout 框，强调 GTD 的核心理念

4.4 使用 Obsidian 特性

Claude 会自动使用 Obsidian 的高级特性：

Wikilinks（内部链接）：

参考 [[时间管理]] 和 [[效率工具]] 获取更多信息

Callouts（提示框）：

> [!tip] 专业提示
> 番茄工作法最适合需要深度专注的任务

Frontmatter（元数据）：

---
title: 时间管理方法论
tags: [效率, 时间管理, GTD]
created: 2026-03-18
---

任务列表：

- [ ] 尝试番茄工作法
- [ ] 设置 GTD 收集箱
- [ ] 创建时间块日历

4.5 完整示例对话

你: 帮我写一篇关于「如何使用 Obsidian 进行项目管理」的文章

Claude: 我来帮你创建这篇文章。

[Claude 创建文件并生成内容]

你: 很好，但我希望添加一个关于 Dataview 插件的部分

Claude: 我会在文章中添加 Dataview 部分。

[Claude 编辑文件，添加新章节]

你: 完美！请再添加一些实际的 Dataview 查询示例

Claude: 我会添加实用的查询示例。

[Claude 继续完善内容]

第五步：高级技巧

5.1 使用 Obsidian CLI

Claude 可以直接操作你的 Vault：

请搜索所有包含「时间管理」标签的笔记

帮我创建一个新的日记模板

5.2 创建 Obsidian Base

创建一个 Base 来追踪我的阅读清单，包含：书名、作者、状态、评分

Claude 会创建一个 .base 文件，提供类似数据库的视图。

5.3 使用 Canvas 进行可视化

创建一个 Canvas，展示我的知识管理系统架构

Claude 会生成 .canvas 文件，包含节点和连接关系。

5.4 批量处理笔记

请检查 Projects 文件夹下的所有笔记，为缺少标签的笔记添加合适的标签

最佳实践

✅ 推荐做法

1. 明确指令 - 清晰描述你的需求和期望的输出格式
2. 迭代优化 - 先让 Claude 生成初稿，再逐步完善
3. 利用 Obsidian 特性 - 充分使用 Wikilinks、Tags、Callouts
4. 保持 Vault 整洁 - 使用文件夹和标签系统组织内容
5. 版本控制 - 使用 Git 追踪重要笔记的变更

❌ 避免的陷阱

1. 过于模糊的指令 - "写点东西" 不如 "写一篇 800 字的技术教程"
2. 忽略文件结构 - 让 Claude 了解你的 Vault 组织方式
3. 不检查输出 - AI 生成的内容需要人工审核
4. 过度依赖 - Claude 是助手，不是替代品

故障排除

问题：Claude 无法识别 Obsidian Skills

解决方案：

# 确保在 Vault 目录中启动
cd /path/to/your/vault
claude

问题：生成的 Markdown 格式不正确

解决方案：

请使用 Obsidian 风格的 Markdown，包括 Wikilinks 和 Callouts

问题：API Key 未生效

解决方案：

# 检查环境变量
echo $ANTHROPIC_API_KEY

# 重新加载配置
source ~/.zshrc

总结

通过本教程，你已经掌握了：

1. ✅ 安装和配置 Obsidian
2. ✅ 安装和设置 Claude Code
3. ✅ 启用 Obsidian Skills
4. ✅ 使用 Claude 进行智能写作

现在，你拥有了一个强大的 AI 增强笔记系统。开始探索更多可能性吧！

相关链接

• Obsidian 官方文档
• Claude Code GitHub
• Anthropic API 文档
• Obsidian 社区插件