title: " Obsidian+Claude Code | 搭建第二大脑" category: 人工智能 tags:
- 大模型API中转站
- Obsidian
- Claude Code
- 第二大脑
- 知识管理
- 4SAPI description: "基于 Obsidian 本地 Markdown Vault、Claude Code 项目记忆、Claudian 插件、Dataview、Omnisearch 和 Git 备份,搭建一个能被 AI 读取、整理、改写、归档和长期复用的个人知识工作台,并说明如何用 4sapi.com 这类大模型 API 中转站做批处理和成本治理。"
这篇讲一个很多独立创作者、开发者和知识工作者都会遇到的问题:
很多人用 Obsidian,只是在收集资料。
很多人用 Claude Code,只是在让它写代码。
但如果把两者放在一起,它们会变成一套很有意思的知识工作台:
这套系统的目标不是装很多插件,也不是追求一个很复杂的知识图谱。
真正目标只有一个:
1. 为什么是 Obsidian?因为它像一个“可编程文件夹”
Obsidian 最大的价值,不是界面好看。
而是它把笔记存在本地 Markdown 文件里。
官方文档里说得很直接:Obsidian 的笔记是 Markdown 格式的纯文本文件,Vault 本质上就是本地文件系统里的一个文件夹。
这句话对 AI 工作流特别重要。
因为本地 Markdown 有几个优势:
- 可以用任意编辑器打开
- 可以用 Git 做版本管理
- 可以被 Claude Code、Codex、Cursor 这类工具直接读取
- 可以被脚本批量处理
- 可以迁移,不容易被平台锁死
- 可以通过链接、标签、front matter 形成结构
如果 Notion 更像一个在线工作台,那 Obsidian 更像一个你自己的知识仓库。
它不是把知识关在某个平台数据库里,而是放在你电脑上的一堆 Markdown 文件里。
这就给 AI 留出了很大的空间。
Claude Code 不需要通过复杂 API 才能理解你的知识库。
只要它能进入这个 Vault,就可以:
- 搜索文件
- 阅读笔记
- 修改草稿
- 归档素材
- 生成目录
- 提炼观点
- 建议双向链接
- 运行脚本
- 根据你的规则生成新文件
这就是 Obsidian + Claude Code 的关键:
2. 先别急着装插件,先搭最小架构
很多人第一次搭 Obsidian,会先去搜“最佳插件列表”。
这很容易走偏。
第二大脑不是靠插件数量堆出来的。
建议先搭一个最小结构:
每个文件夹只承担一个职责。
_agents/
放你的 AI 档案。
这里不是普通笔记,而是给 AI 看的说明书。
比如:
- 你是谁
- 你擅长什么
- 你不碰什么
- 你的内容方向
- 你的表达风格
- 你的协作规则
_inbox/
放所有临时信息。
比如:
- 微信收藏
- 飞书文档摘录
- 浏览器剪藏
- 临时灵感
- 会议记录
- 未整理资料
所有东西先进 inbox,后面再整理。
不要一开始就想把每条信息放到完美位置。
_resources/
放附件。
比如图片、PDF、网页截图、导出文件。
建议按文章或项目分文件夹:
这样以后迁移、发布、备份都清楚。
00_daily/
放每日记录。
适合写:
- 今天看了什么
- 今天做了什么
- 今天想到什么
- 今天要跟进什么
每日笔记不是为了写日记。
而是给知识系统提供时间轴。
10_sources/
放原始资料。
比如:
- 文章摘录
- 论文笔记
- 视频笔记
- 课程笔记
- 访谈记录
- 产品文档
这里尽量保留来源,不要一上来就改写。
20_notes/
放你的二次理解。
比如:
- 一个观点
- 一个模型
- 一个判断
- 一个案例
- 一个概念解释
这层才是知识管理真正开始变值钱的地方。
30_projects/
放正在推进的项目。
比如:
- 一个课程
- 一个产品
- 一个公众号专题
- 一个客户交付
- 一个研究计划
项目笔记需要明确目标、进度、素材和下一步。
40_outputs/
放最终产出。
比如:
- 公众号文章
- 小红书文案
- 课程大纲
- 产品文档
- PRD
- 研究报告
输出区应该干净。
不要把半成品和素材都塞进去。
3. 让 AI 认识你:三份核心文件
Obsidian 真正变成第二大脑,不是因为它有知识图谱。
而是因为 AI 开始知道:
- 你是谁
- 你在做什么
- 你怎么表达
- 你的边界是什么
- 你的文件应该放在哪里
建议在 Vault 里准备三份文件。
文件一:_agents/user-manual.md
这是“人物使用说明书”。
最小版本这样写:
这份文件不需要长。
真实比完整重要。
一行真实经历,比十行空泛人设有用。
文件二:_agents/ip-position.md
如果你做内容、产品、咨询、课程或个人品牌,这份文件很重要。
这份文件解决的是一致性。
你不是每次都让 AI 从零猜你的定位,而是让它每次都先读一遍你的底层设定。
文件三:CLAUDE.md
如果你用 Claude Code,这个文件非常关键。
Claude Code 官方文档说明,CLAUDE.md 可以给 Claude 提供跨会话的持久指令。它不是系统提示词,但每次会话都会被加载,适合放项目规则、工作方式和固定约束。
建议放在 Vault 根目录:
CLAUDE.md 不要写成鸡汤。
要写成规则。
比如“写得好一点”不如“先给结论,再给步骤,每段不超过 5 行”。
4. Claude Code 接入 Obsidian 的三种方式
现在进入实际接入。
方式一:直接在 Vault 根目录运行 Claude Code
这是最稳的方式。
打开终端:
然后让 Claude Code 先读规则:
这种方式的优点是简单、稳定、可控。
缺点是你需要在终端和 Obsidian 之间切换。
方式二:用 Obsidian Terminal 插件
如果你不想频繁切窗口,可以在 Obsidian 里装 Terminal 类插件,把终端嵌进 Obsidian。
这样你可以在 Obsidian 里直接运行:
适合已经习惯命令行的人。
方式三:用 Claudian 这类社区插件
Claudian 是一个 Obsidian 社区插件,它的 GitHub 说明里写到,它可以把 Claude Code、Codex、Opencode 等 coding agents 嵌进 Vault,让 Vault 变成 agent 的工作目录。
这类插件的体验更像“在 Obsidian 侧边栏里直接和 AI 协作”。
你可以选中文字做 inline edit,也可以让 AI 搜索、编辑、生成文件。
但要注意:它是社区插件,不是 Obsidian 或 Anthropic 官方功能。
社区 issue 里能看到一些兼容性问题,比如 Claude Code CLI 版本变化、Windows 路径、插件加载失败、CLI 参数变化等。
所以建议:
- 先在测试 Vault 里试
- 确认 Claude Code CLI 单独能运行
- 确认插件能找到正确 CLI 路径
- 不要一上来给它操作真实主库
- 重要 Vault 先用 Git 备份
5. 插件怎么选?别把 Vault 装成杂货铺
Obsidian 插件很多。
但做 AI 第二大脑,不需要一口气装几十个。
建议按“输入、检索、结构、输出、备份、执行”六类来选。
输入:Readwise、剪藏、图片下载
如果你经常在 Kindle、网页、Twitter/X、Instapaper 里做高亮,Readwise Official 可以把高亮同步进 Obsidian。
如果你经常从飞书、知乎、公众号复制内容,建议配合图片下载类插件,把远程图片落到本地 _resources/。
核心原则:
检索:Omnisearch
Obsidian 内置搜索够用,但 Vault 大了以后,Omnisearch 会更顺手。
Omnisearch 的 GitHub 说明里提到,它目标是快速定位文件,支持更智能的相关性排序,也能配合 Text Extractor 支持图片、文档和 PDF 索引。
对 AI 工作流来说,检索特别重要。
因为你不应该每次把整个 Vault 都丢给模型。
更好的方式是:
结构:Dataview
Dataview 是很多 Obsidian 用户的核心插件。
官方说明里把它定义为个人知识库上的实时索引和查询引擎,可以基于 metadata、标签、任务、front matter、inline fields 做列表、过滤、排序、分组。
比如你可以在首页做一个内容工作台:
也可以做项目看板:
这类动态视图很适合给 Claude Code 使用。
因为它让 Vault 不只是“文件夹”,而是一个可查询的知识数据库。
模板:Templater
Templater 可以创建动态模板,支持变量、函数结果、JavaScript 和系统命令。
它适合做:
- 每日笔记模板
- 会议纪要模板
- 读书笔记模板
- 文章草稿模板
- 项目复盘模板
比如文章模板:
备份:Obsidian Git
Obsidian Git 可以把 Vault 接入 Git 版本管理,支持 commit、pull、push 和自动备份。
这对 AI 协作非常关键。
因为只要让 AI 具备改文件能力,就一定要有回滚机制。
建议:
- Vault 初始化 Git
- 每次批量修改前先 commit
- 每天至少自动备份一次
_resources/大文件太多时考虑 Git LFS 或单独备份.obsidian/里个人设置要不要同步,按团队情况决定
执行:Terminal / Claudian / Claude Code
Terminal 负责命令。
Claude Code 负责理解和执行工作流。
Claudian 负责把 agent 体验嵌回 Obsidian。
这三者不要混成一件事。
终端是基础设施。
Claude Code 是 agent。
Obsidian 插件是界面和入口。
6. 大模型 API 中转站放在哪里?
很多人会问:
答案是:看你的任务。
如果你只是个人在 Vault 里偶尔让 Claude Code 改笔记,未必需要中转站。
但只要出现下面这些需求,中转站就有价值:
- 批量整理几百篇笔记
- 给大量文章生成摘要
- 多模型交叉审稿
- 用便宜模型做初筛,用强模型做深度改写
- 把 Obsidian 知识库接到自己的 Web 工具
- 给团队提供统一的知识处理 API
- 统计不同工作流的 token 成本
- 统一管理 Claude、GPT、Gemini 等模型入口
这时可以把 4sapi.com 这类大模型 API 中转站放在模型调用层:
注意一个边界:
不要把“Claude Code 能读本地文件”和“所有调用都能无缝走中转站”混为一谈。
更稳的做法是:
- Claude Code 负责本地文件操作和复杂工作流
- 4SAPI 负责脚本、服务端、批量任务的模型调用
- Git 负责回滚
- CLAUDE.md 负责长期规则
7. 一个最小 API 批处理示例
假设你想批量整理 _inbox/ 里的 Markdown 文件,把每篇内容生成摘要、标签和建议归档位置。
可以先用中转站跑一个测试脚本。
环境变量:
Python 示例:
第一次运行时不要自动移动文件。
只生成 .summary.md,人工检查后再归档。
这才是安全的 AI 工作流。
8. 用 Claude Code 跑知识工作流
有了目录、规则和备份后,就可以开始让 Claude Code 做事。
工作流一:整理收件箱
确认后再说:
工作流二:把素材变成永久笔记
工作流三:写公众号文章
大纲确认后再写正文。
不要让 AI 一上来就写完整文章。
先检索、再组织、再生成。
工作流四:周复盘
9. Dataview 做一个 AI 工作台首页
你可以在 Vault 根目录建一个 首页.md。
里面放几个 Dataview 区块。
未发布文章
待整理 inbox
进行中的项目
最近更新的永久笔记
这样你打开 Obsidian,就能看到:
- 哪些素材没整理
- 哪些文章没发布
- 哪些项目在推进
- 哪些笔记最近更新
Claude Code 也可以基于这个首页理解你的工作状态。
10. 成本怎么控?不要把整个 Vault 都丢给模型
很多 AI 知识库工具最大的问题是成本失控。
Obsidian + Claude Code 的好处是你可以让模型按需读文件。
不要每次都把所有笔记塞进上下文。
建议策略:
- 先用 Omnisearch 或 grep 找相关文件。
- 再读取少量高相关笔记。
- 长文件先摘要。
- 批量任务先抽样测试。
- 简单分类用便宜模型。
- 深度写作再用强模型。
- 记录每类任务的 token 用量。
如果你通过 4SAPI 这类中转站接入多模型,可以把任务分层:
| 任务 | 推荐模型策略 |
|---|---|
| inbox 粗分类 | 低成本模型 |
| 标题生成 | 中等模型,多候选 |
| 长文初稿 | Claude / GPT 强模型 |
| 事实核查 | 另一个模型交叉检查 |
| 代码或脚本 | 编程能力强的模型 |
| 周报摘要 | 低成本模型即可 |
这比所有任务都用最贵模型更合理。
11. 权限和隐私:第二大脑最怕失控
个人知识库往往比代码仓库更敏感。
里面可能有:
- 私人经历
- 客户信息
- 财务记录
- 账号线索
- 未发布内容
- 商业计划
- 合同和沟通记录
所以一定要给 AI 设边界。
建议写进 CLAUDE.md:
另外,使用社区插件要注意:
- 看插件维护状态
- 看 GitHub issue
- 看权限说明
- 先在测试 Vault 试
- 重要数据先备份
- 不要给不熟悉插件过高权限
大模型 API 中转站也一样。
可以用于合法合规的模型接入、格式转换、成本优化、计费统计和多模型路由。
不要用于恶意绕过限制、处理违规内容、泄露隐私或绕开平台安全边界。
12. 最小可用版本:今天就能搭起来
如果你不想一次搭完整系统,可以按这个顺序来。
第一步,创建 Vault:
第二步,创建 3 个文件夹:
第三步,创建 2 个文件:
第四步,初始化 Git:
第五步,在 Vault 根目录运行 Claude Code:
第六步,输入:
第七步,开始第一个任务:
这样就够了。
先跑起来,再慢慢增加:
- Dataview
- Omnisearch
- Templater
- Obsidian Git
- Terminal
- Claudian
- API 批处理脚本
不要反过来。
13. 常见坑
第一,插件装太多。
插件越多,系统越脆。先用最小插件集。
第二,目录设计太复杂。
如果你不知道文件该放哪,说明目录太复杂。
第三,CLAUDE.md 写得太虚。
“帮我更高效”不如“改动 3 个以上文件先列清单”。
第四,让 AI 直接移动文件。
先出清单,再执行。
第五,不做版本管理。
只要 AI 能改文件,就必须有回滚。
第六,把原始资料和输出混在一起。
原始资料要保留,输出要单独存放。
第七,把整个 Vault 丢给模型。
先搜索,再读取,再生成。
第八,忽略插件兼容性。
社区插件要看版本、issue 和系统要求。
第九,过度相信 AI 归档。
AI 可以建议分类,但你的知识系统最终要符合你的思考方式。
第十,忘了第二大脑的核心是你自己。
工具只是帮你保存和连接,真正有价值的是你的经历、判断和观点。
14. 最后总结
Obsidian + Claude Code 的价值,不是把笔记软件变成聊天框。
它真正有价值的地方是:
这样搭出来的系统,才不只是“第二大脑”的口号。
它能做几件实际的事:
- 帮你整理收件箱
- 帮你把素材沉淀成笔记
- 帮你从笔记生成文章
- 帮你复盘项目
- 帮你发现旧知识之间的新连接
- 帮你把重复工作变成流程
如果你是个人用户,先从 Obsidian + Claude Code + Git 开始。
如果你是开发者或团队,再把 4sapi.com 这类大模型 API 中转站接进批量处理、内容生成、知识库问答和成本统计。
一句话总结:
资料来源与延伸阅读
- How Obsidian stores data - Obsidian Help
- Internal links - Obsidian Help
- Graph view - Obsidian Help
- How Claude remembers your project - Claude Code Docs
- Extend Claude Code - Claude Code Docs
- Explore the .claude directory - Claude Code Docs
- Dataview documentation
- Omnisearch for Obsidian
- Templater - Obsidian Community Plugin
- Obsidian Git Plugin
- Obsidian Terminal Plugin
- Claudian - Obsidian plugin for coding agents




