很多开发者手里已经订了 Claude Code、Cursor 或 Codex 用来写代码,但想搭一套本地 AI 个人知识库时,要么得在网页端聊天框和本地 Markdown 文件之间来回复制粘贴,要么得给笔记软件再单独配一套 API Key、多掏一份钱。
如果你平时用 Obsidian(一款免费、文件全存在本地的 Markdown 双链知识库软件)记项目资料或读书笔记,或者正打算搭一个本地个人知识库,可以试试开源插件 Oh My Claudian。它不用你重新绑卡或额外购买笔记 AI 会员,直接复用本机已经配好的 Claude Code、Codex、Cursor Agent 等 8 种 Coding Agent(沿用各工具原有的订阅或账号额度):可以在侧边栏用 @ 引用多篇笔记对话、展开卡片查看文件修改 Diff、对选中段落做内联编辑,还能调用 Obsidian 原生接口维护双链和 Frontmatter 属性。
图:Oh My Claudian 实际运行界面,左侧是笔记正文,右侧可以直接 @ 引用笔记并查看文件修改的 Diff 卡片。
它最顺手的 4 个地方
1. 直接复用本机已有的 8 种 Agent CLI
很多 AI 插件需要你单独填一套 API Key、配 Base URL,而 Oh My Claudian 直接复用你电脑里已经在用的 Agent CLI。目前内置支持 8 个提供商:
- Claude Code / Codex / Cursor Agent
- DeepSeek Harness / OpenCode / Grok Build
- Oh My Pi (OMP) / Pi
只要这些工具在你的终端里能正常登录使用,插件就能直接沿用它们原有的认证方式、模型目录、权限策略、/commands(斜杠命令)、Skills 以及 MCP 服务。插件设置里还带了 Readiness(就绪状态检查),会自动帮你核对 CLI 是否可用、模型目录是否加载成功,受支持的 CLI 还能直接在界面里触发安装或更新。
2. 改文件可看 Diff,聊天结论一键存回笔记
把 Agent 放进笔记软件,最怕它一声不吭把原有的排版或内容改乱。Oh My Claudian 提供了三种可控的交互方式:
- 多笔记对比与工具折叠:在输入框打
@选择笔记,或者直接把文件、文件夹拖进输入框。长任务里冗长的工具调用过程会自动折叠成可展开的摘要,当提供商返回受支持的编辑数据时,点开文件编辑卡片就能看到具体的修改 Diff。 - 选中文本内联编辑(Inline Edit):只想润色或改写笔记里的某一段话时,直接选中文字,从命令面板调起内联编辑,输入修改要求后会先展示逐词级别的差异对比(word-level diff),确认没问题再应用。
- 回复内容一键存为笔记(Save to note):在聊天回答里选中一段有用的内容,点击浮层里的「保存到笔记」,插件会自动把渲染后的标题、列表、表格、代码块还原成标准 Markdown,支持新建笔记或追加到现有笔记,保存后还能在弹窗里一键撤销。
3. 原生理解 Obsidian 的双链与属性
如果让普通命令行工具直接在文件夹里重命名或移动 Markdown 文件,Obsidian 里的 [[双链]] 很容易断掉。
在 Claude Code、Codex、DeepSeek Harness、OpenCode 和 Pi 中,Oh My Claudian 接入了 Obsidian 原生的仓库操作能力:Agent 可以直接检查笔记的反向链接(backlinks)、新增或修改笔记头部的 Frontmatter 属性(set-property)、通过 Obsidian 接口移动或重命名文件并自动更新全库链接(move),以及将文件移入 Obsidian 回收站(trash)。
4. 收起侧栏自动变悬浮窗的「禅模式」
嫌侧边栏占地方时,直接把 Oh My Claudian 所在的侧边栏收起,当前对话会自动变成笔记上方的一个轻量悬浮面板(Zen Mode)。你可以边看长文边提问,正在流式输出的回答、输入框里的草稿和待确认的权限审批都会保持在同一个会话里,双击底部手柄或按 Home 键就能归位到底部中央。
3 步快速上手
使用前请确认你的 Obsidian 桌面版版本 ≥ 1.7.2,并且终端里已经装好并登录了至少一个受支持的 CLI(比如运行 claude 或 codex 能正常对话)。
- 安装插件:打开 Obsidian 设置 → 第三方插件 → 浏览,搜索 Oh My Claudian,点击安装并启用(也可直接访问 Obsidian 插件商店页面)。
- 启用提供商:打开 设置 → Oh My Claudian → 提供商(Providers),开启你正在用的工具(如 Claude Code 或 Codex),点击 就绪状态(Readiness) 检查环境,并在模型列表里勾选要在聊天框显示的模型。
- 发第一条消息:从左侧功能区或命令面板执行
Oh My Claudian: Open chat view,输入@附上一篇笔记,先发一条只读指令试试效果:
请用三个要点概括这篇笔记,附上来源笔记链接,并建议一个下一步。先不要修改任何文件。
等确认能正常拿到带 [[笔记链接]] 的回答后,再让它帮你把行动项写进目标笔记即可。
两个常见配置小坑
1. 终端里能跑 claude / codex,但插件提示找不到 CLI?
从桌面图标启动的 Obsidian,拿到的系统 PATH 往往比终端里少。先在终端跑一下 which claude(Windows 用 where.exe claude)拿到绝对路径,再填进插件对应提供商设置的 CLI 可执行文件绝对路径 里就能解决。
2. Claude Code 在终端用订阅登录正常,但在插件里报 authentication_failed?
这通常是因为系统环境变量里存在残留的 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN,覆盖了 CLI 自己的订阅登录。打开 Settings → Oh My Claudian → Providers → Claude Code → Environment → Custom variables,给冲突的变量赋一个空值即可(只影响插件内的 Claude Code,不影响系统其他工具):
ANTHROPIC_API_KEY=
项目地址
Oh My Claudian 基于 Yishen Tu 的 Claudian 分叉并独立维护,采用 MIT 协议开源,本地优先且不发送任何插件遥测数据,界面内置简体中文等 10 种语言。
- GitHub 仓库:github.com/lee259/oh-m…
- Obsidian 插件市场:community.obsidian.md/plugins/oh-…
如果你平时既重度使用 Obsidian,手里又订了 Claude Code、Codex 或 Cursor,不妨装上试试;觉得顺手的话,也欢迎去 GitHub 给项目点个 Star。