Appearance
保姆级教程：DeepSeek V4 + Claude Code + Obsidian 搭建个人知识库。0 基础四步走，跟着做就行。
为什么选这套方案
| 优势 | 说明 |
|---|---|
| DeepSeek V4 | 文字能力对标 Claude Opus，价格不到十分之一 |
| Claude Code | AI 读写搜索笔记 |
| Obsidian | 本地 Markdown，数据安全 |
效果：让 AI 直接读文件、搜笔记、跨文件关联回答问题。
完整流程
┌─────────────────────────────────────────────────────────────┐
│ DeepSeek V4 + Claude Code + Obsidian │
├─────────────────────────────────────────────────────────────┤
│ │
│ Step 1：装 Obsidian │
│ └── 本地 Markdown 笔记软件 │
│ ↓ │
│ Step 2：装 Claudian 插件 │
│ └── 把 Claude Code 嵌进 Obsidian │
│ ↓ │
│ Step 3：装 Claude Code + 配置 DeepSeek V4 │
│ └── CC-Switch 配置 DeepSeek 后端 │
│ ↓ │
│ Step 4：开始使用 │
│ └── AI 读文件、搜笔记、跨文件关联 │
│ │
└─────────────────────────────────────────────────────────────┘Step 1：装 Obsidian
官网下载
访问 https://obsidian.md/download，Mac 和 Windows 都有安装包。
| 平台 | 安装包 |
|---|---|
| macOS | .dmg 文件 |
| Windows | .exe 安装包 |
特点
| 特点 | 说明 |
|---|---|
| 免费 | 基础功能完全免费 |
| 本地存储 | 所有文件存自己电脑 |
| Markdown | 原生支持 Markdown |
| 插件生态 | 非常强大 |
安装步骤
- 下载安装包
- 双击安装
- 打开软件
- 创建本地仓库
Step 2：装 Claudian 插件
Claudian 是什么
Claudian 把 Claude Code 嵌进 Obsidian，笔记仓库直接变成 AI 工作目录，能读能写能搜索。
前提：关闭安全模式
- 打开 Obsidian 设置（左下角齿轮图标）
- 找到「第三方插件」
- 关闭安全模式
安装 BRAT（插件加载器）
Claudian 还没上官方插件市场，需要通过 BRAT 安装。
| 步骤 | 操作 |
|---|---|
| 1 | 打开社区插件市场 |
| 2 | 搜索 "BRAT" |
| 3 | 安装并启用 |
安装 Claudian
| 步骤 | 操作 |
|---|---|
| 1 | 回到设置找到 BRAT |
| 2 | 点 "Add beta plugin" |
| 3 | 输入 Claudian 仓库地址 |
| 4 | 等待安装完成 |
启用 Claudian
回到第三方插件列表，把 Claudian 开关打开。
Step 3：装 Claude Code + 配置 DeepSeek V4
安装 Node.js
| 平台 | 命令 |
|---|---|
| macOS | brew install node |
| Windows | 去官网下载安装包 |
安装 Claude Code
bash
# 标准安装
npm install -g @anthropic-ai/claude-code
# 国内用镜像
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com配置 CC-Switch
CC-Switch 桌面工具配置 DeepSeek V4 做后端。
| 步骤 | 操作 |
|---|---|
| 1 | 安装 CC-Switch |
| 2 | 新建配置 |
| 3 | 供应商选 DeepSeek |
| 4 | 粘贴 API Key |
| 5 | 填好模型名称（deepseek-chat-v4） |
| 6 | 保存启动 |
DeepSeek API Key 获取
- 访问 https://platform.deepseek.com
- 注册并登录
- 进入 API Keys 页面
- 创建新的 API Key
- 复制并保存
Step 4：开始使用
基本操作
| 操作 | 命令/方式 |
|---|---|
| 唤起 Claude | Ctrl+P 搜索 Claudian |
| 读文件 | 直接 @ 文件名 |
| 搜笔记 | 问 AI 搜索相关笔记 |
| 跨文件关联 | 让 AI 分析多个文件 |
实际使用场景
| 场景 | 操作 |
|---|---|
| 读笔记 | "帮我读一下这篇笔记的核心观点" |
| 搜笔记 | "我之前写过关于 AI 的哪些笔记？" |
| 跨文件关联 | "这篇笔记和之前的项目笔记有什么关联？" |
| 整理知识 | "帮我把这周的笔记整理成一个知识体系" |
成本对比
| 模型 | 100 万 Token 价格 | 性价比 |
|---|---|---|
| DeepSeek V4 | ~$0.1 | ⭐⭐⭐⭐⭐ |
| Claude Opus | ~$1 | ⭐⭐⭐ |
结论：DeepSeek V4 价格不到 Claude 的十分之一。
三合一架构
┌─────────────────────────────────────────────────────────────┐
│ 三合一知识库架构 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ │
│ │ Obsidian │ ← 本地笔记（Markdown） │
│ │ 本地存储 │ │
│ └──────┬──────┘ │
│ ↓ │
│ ┌─────────────┐ │
│ │ Claudian │ ← Obsidian 插件 │
│ │ 插件桥接 │ │
│ └──────┬──────┘ │
│ ↓ │
│ ┌─────────────┐ │
│ │ Claude Code │ ← AI 能力 │
│ │ + DeepSeek│ │
│ │ V4 │ │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘常见问题
| 问题 | 解决方案 |
|---|---|
| Claudian 装不上 | 检查 BRAT 是否启用 |
| DeepSeek 连不上 | 检查 API Key 是否正确 |
| 笔记搜不到 | 确保文件在 Obsidian 仓库内 |
| AI 回复慢 | 检查网络或换节点 |
一句话总结
DeepSeek V4 + Claude Code + Obsidian = 本地笔记 + AI 搜索 + 跨文件关联，成本不到 Claude 十分之一。
核心价值：让 AI 真正读懂你的笔记，不只是问答，而是理解、关联、整合。
适合人群：写技术笔记、有知识积累需求、想用 AI 管理个人知识的开发者。
