不花一分额外 API 钱，用现成的 Claude Code / Codex / Cursor 搭建 AI 个人知识库

很多开发者手里已经订了 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，输入 @ 附上一篇笔记，先发一条只读指令试试效果：

text 复制代码

请用三个要点概括这篇笔记，附上来源笔记链接，并建议一个下一步。先不要修改任何文件。

等确认能正常拿到带 [[笔记链接]] 的回答后，再让它帮你把行动项写进目标笔记即可。

两个常见配置小坑

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，不影响系统其他工具）：

env 复制代码

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。