如果说过去几年“个人知识管理”还是一个略带极客色彩的圈子话题那么到了 2025 年底它已然成为每个知识工作者绕不开的必修课。今天想和大家聊聊一个技术含量足够硬核、但对普通用户也足够友好的组合Obsidian Claude Code。它们究竟能碰撞出什么火花凭什么说 Obsidian 绝不仅仅只是一个“本地笔记库”如何让 AI“记住”你真正成为你的“第二大脑”下面一一道来。一、为什么需要 Obsidian——本地优先的数字花园在开始谈技术之前得先回答一个更基本的问题在当今 Notion、飞书、印象笔记等云端笔记产品大行其道的时代为什么还要选择一个“土里土气”的本地 Markdown 笔记软件答案藏在 Obsidian 最核心的理念里Your data is yours你的数据属于你。你的每一次思考、每一篇日记、每一个工作计划都以纯文本 Markdown 文件的形式存放在你的硬盘里。就算 Obsidian 这家公司明天倒闭了你的所有笔记依然可以用任何文本编辑器打开你的“第二大脑”永远不会被任何厂商绑架。更重要的是Obsidian 通过双向链接和知识图谱两大核心功能彻底颠覆了传统笔记软件的文件夹-文件式组织方式。当你创建[[JavaScript异步编程]]这样的 wiki 链接时Obsidian 会自动在目标文件底部生成反向链接列表形成立体的知识网络。而打开“图谱视图”你所有的笔记关系将呈现为一个不断生长的“数字花园”每个想法都是一颗种子被悉心照料、嫁接、生长。“9 年换了 5 款笔记软件最终 Obsidian 让我停下了”——这不是个例。很多深度用户用 Obsidian 搭建了完整的人生管理系统核心吸引力就在于它的轻量、高效和 700 社区插件构成的强大生态。但 Obsidian 也并非没有门槛。很多新手被劝退正是因为不知道如何搭建一个适合自己的工作流。而 Claude Code 的加入刚好解决了这个问题。二、Obsidian 安装与基础配置——三分钟建好你的数字花园进入实战环节。Obsidian 的安装非常轻量基于 Electron 框架构建的安装包仅 100MB 左右支持 Windows、macOS、Linux 全平台部署。安装步骤下载访问 Obsidian 官网obsidian.md根据操作系统下载对应版本。Windows 用户下载 .msi 安装包macOS 用户下载 .dmg 文件。安装双击安装文件默认安装在 %APPDATA%\obsidianWindows或 /ApplicationsmacOS。创建知识库首次启动时系统会提示创建一个新的 Vault。Vault 本质上就是一个存放 Markdown 文件的普通文件夹。建议选择一个容易备份的位置比如云盘同步目录或本地 SSD。启用核心插件进入“设置→核心插件”至少开启文件探索器浏览笔记和反向链接构建知识网络两个基础插件。完成这一步你就拥有了一个最小可用的 Obsidian 笔记库。你可以用[[双括号]]创建笔记之间的链接用#标签进行分类一切都基于纯 Markdown 语法干净、可控、无厂商锁定。三、Claude Code 安装——AI 编程助手的正确打开方式Claude Code 是 Anthropic 推出的 AI 编程助手但它的能力远不止“编程”——它是一个可以执行复杂工作流的 AI Agent。安装方式非常简单前置要求Node.js 16.0 或更高版本npm 包管理器随 Node.js 一起安装一键安装# 全局安装 Claude Code npm install -g anthropic-ai/claude-code # 启动 claude安装完成后在项目根目录下输入claude即可启动。默认使用 Claude 3.5 Sonnet 模型如果需要更强的能力可以通过/model命令切换到 Opus。启动后会看到两种验证方式账号验证需 Claude Pro/Max 订阅以及全局代理或 API 验证推荐性能最佳。完成验证后就可以开始与 Claude Code 对话了。四、Obsidian Claude CodeMCP 集成方案详解这才是本文最硬核的部分。要让 Claude Code 访问你的 Obsidian 笔记库有两种主流方案直接文件访问和MCPModel Context Protocol服务器集成。方案一直接文件访问简单但不完美Claude Code 可以直接读写本地文件。在 Obsidian Vault 所在的目录启动 Claude Code它就能浏览、修改你的 Markdown 笔记。这种方式的优点是零配置缺点是 Claude Code 无法理解 Obsidian 特有的双向链接语法和插件生态系统而且存在一些文件读写稳定性问题比如 BrokenPipeError。方案二MCP 服务器集成推荐MCPModel Context Protocol是 Anthropic 推出的模型上下文协议标准让 AI 助手能够通过标准化接口访问外部数据源。目前已有多个 MCP 服务器支持 Obsidian 集成。推荐使用obsidian-http-mcp——第一个 HTTP 原生 MCP 服务器彻底解决了 stdio 传输的稳定性问题响应速度低于 200 毫秒API 调用次数减少 70%针对 MCP 优化了 Token 使用效率。详细配置步骤第一步安装 Obsidian Local REST API 插件打开 Obsidian → 设置 → 社区插件 → 搜索 “Local REST API” → 安装并启用开启Non encrypted (HTTP) API选项复制生成的 API Key保存好下一步需要第二步安装 obsidian-http-mcp# 安装 npm install -g obsidian-http-mcp # 配置会提示输入 Obsidian API Key obsidian-http-mcp --setup配置信息会自动保存到~/.obsidian-mcp/config.json下次无需重复输入。第三步启动 MCP 服务器bashobsidian-http-mcp服务器默认在http://localhost:3000/mcp端口运行。第四步连接 Claude Code在 Claude Code 所在终端执行claude mcp add如果你的 Claude Code 运行在 WSL 或远程服务器上需要将localhost替换为服务器的实际 IP 地址。第五步验证启动 Claude Code 并输入/ide选择 “Obsidian” 即可看到你的 Vault 内容。完成这五步Claude Code 就能无缝访问你的整个 Obsidian 笔记库了。五、Obsidian 真的只是一个本地笔记库吗很多人对 Obsidian 的误解就卡在这里。它的底层确实是一堆 Markdown 文件但它的能力边界远不止“本地笔记库”。如果把 Obsidian 的能力分层来看第一层本地存储层。所有笔记以纯文本 Markdown 格式存储你可以用任何编辑器打开。这是 Obsidian 最基础的“数据库”属性。第二层知识网络层。通过双向链接、反向链接、图谱视图Obsidian 将孤立的笔记文件编织成一个立体的知识网络。这种网络结构远比文件夹组织更能反映大脑的联想式思考方式。第三层插件生态层。Obsidian 有超过 700 个社区插件。Dataview 让你用 SQL 查询笔记元数据Templater 让你创建动态笔记模板Kanban 让你建立项目看板。这意味着 Obsidian 不仅是笔记库还是一个可编程的知识管理平台。第四层Agent 接入层。这才是 Claude Code Obsidian 组合真正展现威力的地方。通过 MCP 集成Claude Code 作为 AI Agent 可以直接“进入”你的笔记库内部执行复杂操作。以前 Obsidian 劝退新用户的核心原因之一是“太难上手”但今天完全可以通过一个指令让 Claude Code 帮你搭建一个最小可用的知识管理文件夹系统。六、如何让 AI 拥有记忆——让大模型从“失忆症”到“过目不忘”大模型有一个致命的短板它不记得你。每次对话都是一张白纸它对你的了解仅限于当前会话中你告诉它的那些信息。那么如何让 AI 真正“记住”你核心答案就是RAG检索增强生成。RAG 最通俗的理解是给大模型配一个实时查阅的“外挂数据库”或“离线手册”。大模型虽然强大但有两个致命伤——一是幻觉没见过的东西会一本正经地胡说八道二是知识滞后知识停留在训练结束的那一天。RAG 的核心思路是在回答问题之前先去你的 Obsidian 知识库里把相关的资料查出来贴给大模型让它“开卷考试”。具体的 RAG 实现流程是读取 Obsidian 库中的所有 .md 文件 → 把长文章切成小文本块 → 用嵌入模型如 BGE-M3将这些文本块转换成高维向量 → 存入本地向量数据库 → 用户提问时先在向量库中检索相关文档 → 将检索结果作为上下文发给大模型 → 大模型生成答案。有了 RAG你可以问 AI“我爸妈的身份证号是多少”“去年年夜饭吃的什么”“六一儿童节晚上我和孩子们聊了什么”——所有这些私人信息都可以安全地存储在本地 Obsidian 中AI 基于这些信息回答数据从不离开你的硬盘。目前在 Obsidian 中实现 AI 记忆主要有三条路径MCP 云端模型通过 obsidian-http-mcp 让 Claude Code 访问笔记库问题由云端模型回答。优点是模型能力强缺点是需要联网且有隐私顾虑。本地 Ollama 本地模型完全离线部署数据不出门。用 Ollama 运行 Qwen 3 等本地模型配合 BGE-M3 嵌入模型实现真正的“完全离线、绝对隐私”的 RAG 知识库。Obsidian Copilot 插件在 Obsidian 内部集成 AI 功能支持多种大模型 API需要自己的 API Key无需编程即可创建领域专用的智能助手。七、场景案例让 Claude Code 真正帮你干活下面来看几个实际的场景这才是 Obsidian Claude Code 组合的真正价值所在。场景一自动写每日报告处理完一天的工作笔记后把下面这个指令发给 Claude Code# 任务 在Diary文件夹中创建今天的日报 # 步骤 1. 找到今天创建或编辑的所有文档 2. 阅读所有的内容 3. 按照Diary模板中的维度分析今天我做了什么学到了什么知识 4. 基于我的活动记录给我提供一些思考Claude Code 会自动扫描今天的笔记、提取关键信息、生成符合模板的报告。场景二语音记录 自动整理结合 Mac 的语音输入功能可以建立一个“语音 → 文字 → 结构化笔记”的自动化流程。Claude Code 的自定义斜杠命令允许复杂处理流程用简短命令执行本地环境兼容性让直接读写本地文件变得异常顺畅。场景三会议纪要自动生成将会议录音放在指定文件夹Claude Code 可以调用转录服务如 Vertex AI将音频转为文字然后按照预设模板整理出结构化的会议纪要包括参会人、核心议题、待办事项等。场景四历史笔记的批量编辑当你需要给过去两年的所有项目笔记统一添加某个标签时手动操作几乎不可能。但 Claude Code 可以用一条指令完成帮我找到所有标签为#project的笔记在文件顶部添加tags: [legacy]这一行Claude Code 会扫描整个 Vault精确定位并批量处理从分钟级的人工操作变成秒级的自动执行。八、结语Obsidian 的核心是“数据归属”Claude Code 的核心是“AI 赋能”。两者结合诞生了一个前所未有的工具形态一个完全本地化、完全私密、却拥有顶级 AI 能力的知识管理系统。以前提高效率本质上是提高自己的时间利用效率——同样的时间做更多的事。但 Claude Code 带来的是一种维度的跃迁你可以让 20 个 Agent 同时帮你工作。你不再只是更好地利用自己的时间而是开始利用 AI Agent 的时间。动脑更多动手更少。这正是 Obsidian Claude Code 组合最迷人的地方。它不只是一个笔记工具和一个编程助手它是一套全新的人机协作范式。你的数据属于你你的时间更属于你。现在它们可以一起为你工作了。
Obsidian + Claude Code：把你的本地知识库变成懂你的私人 AI 助理
发布时间：2026/5/29 22:50:46
如果说过去几年“个人知识管理”还是一个略带极客色彩的圈子话题那么到了 2025 年底它已然成为每个知识工作者绕不开的必修课。今天想和大家聊聊一个技术含量足够硬核、但对普通用户也足够友好的组合Obsidian Claude Code。它们究竟能碰撞出什么火花凭什么说 Obsidian 绝不仅仅只是一个“本地笔记库”如何让 AI“记住”你真正成为你的“第二大脑”下面一一道来。一、为什么需要 Obsidian——本地优先的数字花园在开始谈技术之前得先回答一个更基本的问题在当今 Notion、飞书、印象笔记等云端笔记产品大行其道的时代为什么还要选择一个“土里土气”的本地 Markdown 笔记软件答案藏在 Obsidian 最核心的理念里Your data is yours你的数据属于你。你的每一次思考、每一篇日记、每一个工作计划都以纯文本 Markdown 文件的形式存放在你的硬盘里。就算 Obsidian 这家公司明天倒闭了你的所有笔记依然可以用任何文本编辑器打开你的“第二大脑”永远不会被任何厂商绑架。更重要的是Obsidian 通过双向链接和知识图谱两大核心功能彻底颠覆了传统笔记软件的文件夹-文件式组织方式。当你创建[[JavaScript异步编程]]这样的 wiki 链接时Obsidian 会自动在目标文件底部生成反向链接列表形成立体的知识网络。而打开“图谱视图”你所有的笔记关系将呈现为一个不断生长的“数字花园”每个想法都是一颗种子被悉心照料、嫁接、生长。“9 年换了 5 款笔记软件最终 Obsidian 让我停下了”——这不是个例。很多深度用户用 Obsidian 搭建了完整的人生管理系统核心吸引力就在于它的轻量、高效和 700 社区插件构成的强大生态。但 Obsidian 也并非没有门槛。很多新手被劝退正是因为不知道如何搭建一个适合自己的工作流。而 Claude Code 的加入刚好解决了这个问题。二、Obsidian 安装与基础配置——三分钟建好你的数字花园进入实战环节。Obsidian 的安装非常轻量基于 Electron 框架构建的安装包仅 100MB 左右支持 Windows、macOS、Linux 全平台部署。安装步骤下载访问 Obsidian 官网obsidian.md根据操作系统下载对应版本。Windows 用户下载 .msi 安装包macOS 用户下载 .dmg 文件。安装双击安装文件默认安装在 %APPDATA%\obsidianWindows或 /ApplicationsmacOS。创建知识库首次启动时系统会提示创建一个新的 Vault。Vault 本质上就是一个存放 Markdown 文件的普通文件夹。建议选择一个容易备份的位置比如云盘同步目录或本地 SSD。启用核心插件进入“设置→核心插件”至少开启文件探索器浏览笔记和反向链接构建知识网络两个基础插件。完成这一步你就拥有了一个最小可用的 Obsidian 笔记库。你可以用[[双括号]]创建笔记之间的链接用#标签进行分类一切都基于纯 Markdown 语法干净、可控、无厂商锁定。三、Claude Code 安装——AI 编程助手的正确打开方式Claude Code 是 Anthropic 推出的 AI 编程助手但它的能力远不止“编程”——它是一个可以执行复杂工作流的 AI Agent。安装方式非常简单前置要求Node.js 16.0 或更高版本npm 包管理器随 Node.js 一起安装一键安装# 全局安装 Claude Code npm install -g anthropic-ai/claude-code # 启动 claude安装完成后在项目根目录下输入claude即可启动。默认使用 Claude 3.5 Sonnet 模型如果需要更强的能力可以通过/model命令切换到 Opus。启动后会看到两种验证方式账号验证需 Claude Pro/Max 订阅以及全局代理或 API 验证推荐性能最佳。完成验证后就可以开始与 Claude Code 对话了。四、Obsidian Claude CodeMCP 集成方案详解这才是本文最硬核的部分。要让 Claude Code 访问你的 Obsidian 笔记库有两种主流方案直接文件访问和MCPModel Context Protocol服务器集成。方案一直接文件访问简单但不完美Claude Code 可以直接读写本地文件。在 Obsidian Vault 所在的目录启动 Claude Code它就能浏览、修改你的 Markdown 笔记。这种方式的优点是零配置缺点是 Claude Code 无法理解 Obsidian 特有的双向链接语法和插件生态系统而且存在一些文件读写稳定性问题比如 BrokenPipeError。方案二MCP 服务器集成推荐MCPModel Context Protocol是 Anthropic 推出的模型上下文协议标准让 AI 助手能够通过标准化接口访问外部数据源。目前已有多个 MCP 服务器支持 Obsidian 集成。推荐使用obsidian-http-mcp——第一个 HTTP 原生 MCP 服务器彻底解决了 stdio 传输的稳定性问题响应速度低于 200 毫秒API 调用次数减少 70%针对 MCP 优化了 Token 使用效率。详细配置步骤第一步安装 Obsidian Local REST API 插件打开 Obsidian → 设置 → 社区插件 → 搜索 “Local REST API” → 安装并启用开启Non encrypted (HTTP) API选项复制生成的 API Key保存好下一步需要第二步安装 obsidian-http-mcp# 安装 npm install -g obsidian-http-mcp # 配置会提示输入 Obsidian API Key obsidian-http-mcp --setup配置信息会自动保存到~/.obsidian-mcp/config.json下次无需重复输入。第三步启动 MCP 服务器bashobsidian-http-mcp服务器默认在http://localhost:3000/mcp端口运行。第四步连接 Claude Code在 Claude Code 所在终端执行claude mcp add如果你的 Claude Code 运行在 WSL 或远程服务器上需要将localhost替换为服务器的实际 IP 地址。第五步验证启动 Claude Code 并输入/ide选择 “Obsidian” 即可看到你的 Vault 内容。完成这五步Claude Code 就能无缝访问你的整个 Obsidian 笔记库了。五、Obsidian 真的只是一个本地笔记库吗很多人对 Obsidian 的误解就卡在这里。它的底层确实是一堆 Markdown 文件但它的能力边界远不止“本地笔记库”。如果把 Obsidian 的能力分层来看第一层本地存储层。所有笔记以纯文本 Markdown 格式存储你可以用任何编辑器打开。这是 Obsidian 最基础的“数据库”属性。第二层知识网络层。通过双向链接、反向链接、图谱视图Obsidian 将孤立的笔记文件编织成一个立体的知识网络。这种网络结构远比文件夹组织更能反映大脑的联想式思考方式。第三层插件生态层。Obsidian 有超过 700 个社区插件。Dataview 让你用 SQL 查询笔记元数据Templater 让你创建动态笔记模板Kanban 让你建立项目看板。这意味着 Obsidian 不仅是笔记库还是一个可编程的知识管理平台。第四层Agent 接入层。这才是 Claude Code Obsidian 组合真正展现威力的地方。通过 MCP 集成Claude Code 作为 AI Agent 可以直接“进入”你的笔记库内部执行复杂操作。以前 Obsidian 劝退新用户的核心原因之一是“太难上手”但今天完全可以通过一个指令让 Claude Code 帮你搭建一个最小可用的知识管理文件夹系统。六、如何让 AI 拥有记忆——让大模型从“失忆症”到“过目不忘”大模型有一个致命的短板它不记得你。每次对话都是一张白纸它对你的了解仅限于当前会话中你告诉它的那些信息。那么如何让 AI 真正“记住”你核心答案就是RAG检索增强生成。RAG 最通俗的理解是给大模型配一个实时查阅的“外挂数据库”或“离线手册”。大模型虽然强大但有两个致命伤——一是幻觉没见过的东西会一本正经地胡说八道二是知识滞后知识停留在训练结束的那一天。RAG 的核心思路是在回答问题之前先去你的 Obsidian 知识库里把相关的资料查出来贴给大模型让它“开卷考试”。具体的 RAG 实现流程是读取 Obsidian 库中的所有 .md 文件 → 把长文章切成小文本块 → 用嵌入模型如 BGE-M3将这些文本块转换成高维向量 → 存入本地向量数据库 → 用户提问时先在向量库中检索相关文档 → 将检索结果作为上下文发给大模型 → 大模型生成答案。有了 RAG你可以问 AI“我爸妈的身份证号是多少”“去年年夜饭吃的什么”“六一儿童节晚上我和孩子们聊了什么”——所有这些私人信息都可以安全地存储在本地 Obsidian 中AI 基于这些信息回答数据从不离开你的硬盘。目前在 Obsidian 中实现 AI 记忆主要有三条路径MCP 云端模型通过 obsidian-http-mcp 让 Claude Code 访问笔记库问题由云端模型回答。优点是模型能力强缺点是需要联网且有隐私顾虑。本地 Ollama 本地模型完全离线部署数据不出门。用 Ollama 运行 Qwen 3 等本地模型配合 BGE-M3 嵌入模型实现真正的“完全离线、绝对隐私”的 RAG 知识库。Obsidian Copilot 插件在 Obsidian 内部集成 AI 功能支持多种大模型 API需要自己的 API Key无需编程即可创建领域专用的智能助手。七、场景案例让 Claude Code 真正帮你干活下面来看几个实际的场景这才是 Obsidian Claude Code 组合的真正价值所在。场景一自动写每日报告处理完一天的工作笔记后把下面这个指令发给 Claude Code# 任务 在Diary文件夹中创建今天的日报 # 步骤 1. 找到今天创建或编辑的所有文档 2. 阅读所有的内容 3. 按照Diary模板中的维度分析今天我做了什么学到了什么知识 4. 基于我的活动记录给我提供一些思考Claude Code 会自动扫描今天的笔记、提取关键信息、生成符合模板的报告。场景二语音记录 自动整理结合 Mac 的语音输入功能可以建立一个“语音 → 文字 → 结构化笔记”的自动化流程。Claude Code 的自定义斜杠命令允许复杂处理流程用简短命令执行本地环境兼容性让直接读写本地文件变得异常顺畅。场景三会议纪要自动生成将会议录音放在指定文件夹Claude Code 可以调用转录服务如 Vertex AI将音频转为文字然后按照预设模板整理出结构化的会议纪要包括参会人、核心议题、待办事项等。场景四历史笔记的批量编辑当你需要给过去两年的所有项目笔记统一添加某个标签时手动操作几乎不可能。但 Claude Code 可以用一条指令完成帮我找到所有标签为#project的笔记在文件顶部添加tags: [legacy]这一行Claude Code 会扫描整个 Vault精确定位并批量处理从分钟级的人工操作变成秒级的自动执行。八、结语Obsidian 的核心是“数据归属”Claude Code 的核心是“AI 赋能”。两者结合诞生了一个前所未有的工具形态一个完全本地化、完全私密、却拥有顶级 AI 能力的知识管理系统。以前提高效率本质上是提高自己的时间利用效率——同样的时间做更多的事。但 Claude Code 带来的是一种维度的跃迁你可以让 20 个 Agent 同时帮你工作。你不再只是更好地利用自己的时间而是开始利用 AI Agent 的时间。动脑更多动手更少。这正是 Obsidian Claude Code 组合最迷人的地方。它不只是一个笔记工具和一个编程助手它是一套全新的人机协作范式。你的数据属于你你的时间更属于你。现在它们可以一起为你工作了。
