☰
Claudian 安装指南:把 Claude Code 嵌进 Obsidian 侧边栏的 3 条路径
2026/9/25 20:55:30 网站建设 项目流程

Claudian 安装指南:把 Claude Code 嵌进 Obsidian 侧边栏的 3 条路径

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian

你在 Obsidian 里写完一段内容,想让 Claude Code 顺手改个东西,可终端在另一个窗口,来回复制粘贴很麻烦。Claudian就是为省掉这种窗口切换而做的:它把 Claude Code、Codex 这类 AI 编码助手直接嵌进 Obsidian 侧边栏,知识库变成 AI 的工作区——文件读写、检索、执行命令、跑多步任务都能就地完成。

🧰 装上 Claudian 之后你能拿到什么

功能不逐条罗列了,最值得先上手的是这三件事:

  • 在编辑器里直接改笔记:Inline Edit对选中的文字或光标位置用热键触发,AI 就地修改内容,落笔前你能先看到单词级别的差异预览。
  • 对话本身可管理:侧边栏支持多个聊天选项卡、完整的历史记录,还能对对话做分叉和恢复,另有一个紧凑视图来收拢长线程。
  • 上下文工具箱开箱即用:输入@可以提及你希望 AI 处理的任何内容——知识库文件、子代理、MCP 服务器,甚至外部目录里的文件;输入/或$调用可复用的提示模板(Slash Commands & Skills),个人和知识库级别都支持;输入#添加一条精炼的自定义指令(Instruction Mode);按Shift+Tab进入Plan Mode,AI 会先探索项目、给出计划,经你批准后才动手执行。再配合 MCP 服务器,还能通过 stdio、SSE、HTTP 三种方式把外部工具接进工作流。

📋 安装前确认一下环境

  • Obsidian 版本 v1.7.2 及以上,且为桌面端(macOS、Linux、Windows)
  • 已安装Claude Code CLI(推荐原生安装),并有可用的 Claude 订阅/API 或兼容提供商
  • 可选提供商:Codex CLI、Opencode

如何安装 Claudian

推荐:从 Obsidian 社区插件商店安装

  1. 打开 Obsidian,进入 设置 → 社区插件
  2. 点击 浏览,搜索 “Claudian”
  3. 点击 安装
  4. 返回插件列表,启用 “Claudian”

备选:下载 Release 文件或源码构建

方式 A,手动获取 Release 三件套:

  1. 从项目最新 Release 下载main.js、manifest.json、styles.css三个文件
  2. 在知识库的.obsidian/plugins/目录下新建claudian文件夹
  3. 把三个文件复制进该文件夹
  4. 在 设置 → 社区插件 中启用 “Claudian”

方式 B,从源码构建(想先体验开发版时选它):

cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build

首次启动:如何打开侧边栏

打开方式有两种:点击左侧功能区里的 Claudian 图标,或从命令面板调用对应命令。打开后右侧出现对话区,可以直接开始第一轮对话:

⚠️ 报 spawn claude ENOENT / Claude CLI not found 怎么办

症状:提示spawn claude ENOENT或Claude CLI not found。

原因:Claudian 没能自动检测到 Claude Code CLI。如果你在用 nvm、fnm、volta 这类版本管理器切换 Node 环境,最容易碰到这个问题。

处理:

  1. 先保持设置里对应项为空,让插件自动检测
  2. 仍失败时,找到 CLI 的实际路径,手动填入 设置 → 高级 → Claude CLI 路径

路径怎么找,分平台如下:

平台命令结果示例
macOS / Linuxwhich claude/Users/you/.volta/bin/claude
Windows(原生安装)where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exe
Windows(npm 安装)npm root -g{root}\@anthropic-ai\claude-code\cli-wrapper.cjs

注意 Windows 上别指向.cmd或.ps1包装文件:原生安装选claude.exe,包管理器安装选cli-wrapper.cjs,cli.js只是旧版 Claude Code npm 包的遗留回退。

替代思路:在 设置 → 环境 → 自定义变量 里,把 Node.js 的 bin 目录加入 PATH。

CLI 和 Node.js 不在同一目录

症状:用 npm 装过 CLI,却仍提示找不到。

排查:分别运行下面两条命令,对比结果

dirname $(which claude) dirname $(which node)

原因:两者路径对不上时,Obsidian 这类 GUI 应用会因环境不同而定位不到 Node.js。

处理:

  1. 改用原生二进制安装(推荐)
  2. 或在 设置 → 环境 中补上 Node.js 路径,例如PATH=/path/to/node/bin

上手建议

Claudian 可以简单理解为“给 Claude Code 在知识库里安了个常驻工位”。第一次跑,建议先装社区版、把一轮对话聊通,再决定要不要玩源码构建;遇到 CLI 检测问题时,先用which claude(Windows 用where.exe claude)确认真实路径再填设置。

想深入看实现的话,相关源码在这里:聊天功能源码、内联编辑源码、设置页源码。

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询