Skip to content

Obsidian + Claude Code 知识库搭建与插件生态

基于小陈同学c_z 的两期视频整理,涉及 Obsidian 接入 Claude Code 的完整方案。


一、环境配置

安装 Claude Code

  1. 到 Claude Code 官网复制对应系统的一键安装命令(支持 macOS、Linux、Windows)
  2. Windows 用户先安装 Git
  3. 终端执行安装命令

接入第三方 API

如果需要使用第三方模型(如 DeepSeek V4)而非官方 Claude:

  1. 安装 ccswitch 开源工具
  2. 到 DeepSeek API 官网购买 API Key
  3. 在 ccswitch 中添加 DeepSeek 供应商,粘贴 API Key
  4. 测试模型运行正常后启用
  5. 终端输入 claude 命令启动

二、Obsidian 插件生态

核心插件

插件用途推荐度
Terminal在 Obsidian 内部打开终端窗口,直接调用 Claude Code⭐⭐⭐
Claudian为 Obsidian 提供 Claude Code 对话界面,更美观易用⭐⭐⭐⭐⭐
Excalidraw手绘风格白板/绘图工具,可让 AI 生成可视化图表⭐⭐⭐⭐
Local REST API给 Obsidian 开本地接口,让浏览器插件直接写入文件⭐⭐⭐⭐

Terminal 插件

  • 在第三方插件市场搜索安装
  • 推荐使用 "整合式" 模式(在 Obsidian 内部启动终端)
  • 终端所在目录即为当前知识库路径
  • 输入 claude 即可调用 Claude Code

Claudian 插件

安装方式(两种):

  • 方法一:直接在第三方插件市场搜索安装(已上架)
  • 方法二:到 GitHub Release 下载 main.jsmanifest.jsonstyles.css 三个文件,手动放到 .obsidian/plugins/claudian/ 目录

特点:

  • 界面美观,无需额外配置
  • 对话时默认选中当前 Markdown 文件
  • 支持多 Tab、历史对话查看

Excalidraw 白板

  • 安装 Excalidraw 插件后可直接在 Obsidian 中创建白板
  • 配合 excalidraw-diagram skill,让 Claude Code 根据内容自动生成白板图表
  • 安装 skill 方式:将 skill 仓库地址发给 Claude Code,说"请帮我安装这个 skill"
  • 通过 / 命令显式调用 skill

三、内容采集工具

Bilibili Obsidian Clipper

由小陈同学c_z 开发的浏览器插件,使用 Claude Code(Codex)vibe coding 制作。

功能:

  • 在 B 站视频页面一键抓取字幕(支持作者字幕和 AI 字幕)
  • 支持多语言选择
  • 支持复制 Markdown、下载 txt/srt 格式
  • 一键写入 Obsidian 指定目录(需配合 Local REST API 插件)

安装:

  • Chrome 扩展商店:安装链接
  • GitHub 开源:项目地址
  • 离线安装:下载 Release 压缩包 → 浏览器扩展页开启开发者模式 → 加载解压后的目录

配置:

  1. Obsidian 安装 Local REST API 插件,开启 HTTP 服务(端口 27123)
  2. 复制 API Key 填入插件设置
  3. 指定保存目录(如 Clippings/Bilibili/

Obsidian Web Clipper

官方浏览器扩展,适合抓取网页文章、博客等内容。

  • 保存为 Markdown 格式,保留章节信息、配图
  • 配合 CLAUDE.md 中的规范,让 AI 自动翻译/整理

四、CLAUDE.md 配置

CLAUDE.md 是驱动 AI 工作的核心配置文件:

  • 定义仓库定位和目录结构
  • 设定输出规范和格式要求
  • 包含翻译规范(针对外文内容)
  • 可根据个人需求迭代修改

五、完整工作流

浏览 B站/网页 → Bilibili Clipper / Web Clipper → Clippings/

Claude Code 读取 → 按 CLAUDE.md 规范整理

结构化笔记存入 cc内容/ → 原文件归档到 Clippings/已归档/

(可选)Excalidraw 生成可视化白板 → 附件/excalidraw/

参考来源

  • Clippings/已归档/2026-05-30-Obsidian+AI 知识库搭建,把 claude code 和 DeepSeek 装进来.md
  • Clippings/已归档/2026-05-30-视频内容一键保存到 Obsidian:打通本地知识库.md

基于 Obsidian + VitePress 构建