乐于分享
好东西不私藏

装上这个Obsidian插件后,我再没开过终端跑Claude Code

装上这个Obsidian插件后,我再没开过终端跑Claude Code

我昨天在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种语言:国际化支持中文

快速上手

方式一:社区插件安装(推荐)

最简单的方式,三步搞定:

  1. 打开Obsidian → 设置 → 社区插件 → 浏览
  2. 搜索"Claudian",点安装
  3. 启用插件

方式二:从GitHub Release手动安装

  1. 去GitHub Release页面下载三个文件:

    • main.js
    • manifest.json
    • styles.css
  2. 在你的vault目录下创建插件文件夹:

你的vault/.obsidian/plugins/claudian/
  1. 把下载的三个文件放进去

  2. Obsidian设置 → 社区插件 → 启用"Claudian"

前置条件

Claudian本身只是个"壳",真正干活的是Agent CLI。至少装一个:

Agent
安装方式
说明
Claude Code
npm install -g @anthropic-ai/claude-code
 或官方安装包
主力,功能最完整
Codex
npm install -g @openai/codex
OpenAI的Agent
Opencode
见 opencode.ai
备选
Pi
见 github.com/earendil-works/pi
备选

装好后,点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