用 Claude Code 写代码确实方便,但写文档的时候就不那么顺了——每次想让 AI 帮忙改段落,都得切到终端,复制粘贴,再切回来。几趟下来思路早就散了。
后来我找到了一个叫 Claudian 的 Obsidian 插件,能直接在笔记界面里跟 Claude 对话。装完试了一下,我只能说,早该这么干了。
今天把安装过程写下来,跟着操作,十分钟左右能搞定。
这篇文章能帮你搞定什么
Obsidian 安装和知识库创建(已经有 Vault 的跳过这步) Claudian 插件安装(官方市场搜不到,得用 BRAT 中转) Claude Code 和 Codex 的双模型配置 验证连接是否成功
Obsidian 和 Claude Code 能配合干什么
Obsidian 是本地 Markdown 笔记工具,数据全在本地,支持各种插件扩展。Claude Code 就不用多介绍了,你正在用的就是。
两个打通之后,在 Obsidian 里直接跟 Claude 对话,让它帮你改笔记、整理文档、生成内容,甚至接 Codex。一个窗口搞定,不用反复切终端。

第一步:安装 Obsidian,创建知识库
官网下载:https://obsidian.md/download
macOS 用户点 Download for macOS,下完拖进应用程序文件夹就行。

首次打开会有欢迎界面,点「创建新库」,选个存放位置。

已经有 Vault 的直接跳过。
第二步:安装 Claudian 插件
插件地址:https://github.com/YishenTu/claudian

这个插件还没上架 Obsidian 官方插件市场,在市场里搜不到。需要用一个叫 BRAT 的插件来中转安装。

流程不复杂,往下看。
2.1 关掉安全模式
Obsidian 设置 → 左侧菜单往下滑 → 「第三方插件」→ 点进去。

下面有个「关闭安全模式」,默认开着。开着的时候不允许装任何第三方插件,关掉它。

关掉之后,下面的「社区插件市场」就可用了,点「浏览」进去。
2.2 安装 BRAT
插件市场搜 brat,第一个就是。

点进去 → 安装。
如果显示"无法安装",多试几次就行,通常是网络问题。

装完点「启用」,然后重启 Obsidian。

2.3 用 BRAT 安装 Claudian
重启后回到设置页面,左侧菜单滑到最底下,找到 BRAT 点进去。

在 Repository 框里输入 Claudian 的地址:
https://github.com/YishenTu/claudian
点确认,等它装好。
2.4 确认插件状态
装完后,Obsidian 左边的侧边栏应该会多出一个机器人图标,那就是 Claudian 的入口。

没看到的话,去设置里确认一下 Claudian 有没有启用。
第三步:配置 Claude CLI 路径
插件装好了,还得告诉它 Claude Code 装在哪。
设置 → 第三方插件 → 找到 Claudian → 切到「Claude」标签页。
先查一下路径:
where claude# 我用 homebrew 装的,路径是 /opt/homebrew/bin/claude把结果填进去:

页面默认英文,可以改语言:

第四步:把 Codex 也配上
既然都在配了,不如把 Codex 也一起搞定。
套路一样,先查路径:
where codex# /opt/homebrew/bin/codex填到 Claudian 的 Codex 配置里:

重启 Obsidian,Claude 和 Codex 的模型就都出来了:

模型没出来的话,检查两个地方:1.「Enable Codex provider」开关有没有打开2. 在 Claudian 里重新开一个对话框测试(旧对话框不会刷新,我踩过这个坑)
测试一下
打开 Claudian 对话面板,随便问一句:
你能连接上 Claude Code 嘛?

能正常回复就说明成功了。它会自动检测本地的 Claude 安装路径,不需要额外配置。
打通之后能干什么
写技术文档的时候,让 Claude 帮你补代码示例 整理会议纪要,让 Claude 提炼要点 写博客草稿,让 Claude 润色措辞(不要太过,以自己口述为主) 笔记太乱,让 Claude 自动分类打标签
Obsidian 本身是 Markdown,Claude 输出的内容格式直接兼容,不用二次排版。
最大的好处是写文档的时候思路不会断。以前写到一半想让 AI 帮忙整理结构,得切到终端折腾半天。现在在 Obsidian 里问一句就行,改完继续写。
下期预告
装好了只是开始。下期讲怎么用 Claudian 在 Obsidian 里重构技术笔记、自动打标签、写博客草稿。
我是赛博李同学大厂写代码的,觉得有用的话,点个赞 + 转发给需要的TA,感谢支持!,我们下期再见!
夜雨聆风