我昨天在Obsidian里改一篇笔记,想让Claude Code帮我重构一下里面的代码片段。
切到终端,cd到vault目录,等Claude Code加载完,告诉它改哪个文件。改完再切回Obsidian看效果,发现不对,又切回去。来来回回五六次,改了半小时,其中一半时间花在切窗口上。
后来在GitHub上闲逛,看到一个叫Claudian的Obsidian插件。装上试了一下,直接在侧边栏跟Claude Code对话,选中文字按快捷键就能改,不用再切窗口了。
项目简介
Claudian是一个Obsidian社区插件,已经上架官方插件商店。
说白了就一件事:把Claude Code、Codex、Opencode、Pi这些AI编程Agent的完整运行时塞进了Obsidian。不是调API返回文本的"聊天壳子",是真正跑CLI的完整Agent,文件读写、Shell命令、多步推理、MCP工具调用,一个不少。

核心功能
• 多Agent切换:Claude Code、Codex、Opencode、Pi,想用哪个用哪个,不同标签页可以同时跑不同Agent
• 内联编辑:选中笔记里的文字,按快捷键,AI原位修改,带逐词diff预览。这个功能让我直接省掉了"复制到终端→改完→粘贴回来"的循环
• Plan模式:Shift+Tab切换,AI先出方案你再确认。不会上来就乱动你的笔记
• @提及:对话框里打@,直接引用笔记库文件、子Agent、MCP服务器、外部目录
• Slash命令和Skills:输入/或$调出可复用的prompt模板,相当于给Agent预装工作流
• MCP服务器:通过Model Context Protocol接外部工具,stdio、SSE、HTTP都支持。等于给Agent装了扩展插槽
• 多标签对话:多个聊天标签页独立运行,支持对话历史、分叉、续聊、压缩
• 10种语言:国际化支持中文
快速上手
方式一:社区插件安装(推荐)
最简单的方式,三步搞定:
打开Obsidian → 设置 → 社区插件 → 浏览 搜索"Claudian",点安装 启用插件
方式二:从GitHub Release手动安装
去GitHub Release页面下载三个文件:
main.jsmanifest.jsonstyles.css在你的vault目录下创建插件文件夹:
你的vault/.obsidian/plugins/claudian/
把下载的三个文件放进去
Obsidian设置 → 社区插件 → 启用"Claudian"
前置条件
Claudian本身只是个"壳",真正干活的是Agent CLI。至少装一个:
npm install -g @anthropic-ai/claude-code | ||
npm install -g @openai/codex | ||
装好后,点Obsidian侧边栏的Claudian图标就能用了。
Windows用户注意
如果遇到spawn claude ENOENT报错,说明插件找不到Claude CLI路径。解决方法:
# 找到你的claude路径
where.exe claude
# 通常是 C:\Users\你的用户名\AppData\Local\Claude\claude.exe
然后去Claudian设置 → Advanced → Claude CLI path,填进去就行。
注意避开.cmd和.ps1包装脚本,用claude.exe本体。
macOS/Linux用户
如果用了nvm、fnm、volta等Node版本管理器,Obsidian可能找不到CLI。执行which claude拿到路径,填到设置里。
或者在Claudian设置 → Environment → Custom variables里加上Node.js的bin目录:
PATH=/你的node/bin目录
写在最后
说真的,装上Claudian之后我就没再单独开终端跑Claude Code了。笔记库本身就是Agent的工作目录,读文件、改文件、搜索、执行命令全在一个界面里完成。
对于把Obsidian当"第二大脑"用的人来说,这相当于直接给大脑接上了AI Agent的算力。不用再在两个世界之间来回跳了。
项目地址:https://github.com/YishenTu/claudian
夜雨聆风