Claudian 实战：把 Claude Code 接进 Obsidian——从终端到侧边栏的无缝写作体验

前言

在很多人看来，使用 CLI 还是有一定难度的。特别是在编辑文案内容的时候，需要来回切换文章和 CLI 命令行，非常不方便。

这篇文章要做的事很直接：Obsidian 左边多一个机器人图标，点开之后在侧边栏发一句话，Claude 直接把内容写进笔记。不切屏，不开终端，让 AI 模型和 Obsidian 融为一体。

我自己也是 Obsidian 高强度使用者。但是在文学创作的时候，Claude Code 和 Obsidian 来回切换让我痛苦不堪。最后我找到了 Claudian，可以完美解决我的问题。

什么是 Claudian？

Claudian 是一个 Obsidian 插件，它的核心功能是把 Claude Code CLI 嵌入到 Obsidian 侧边栏，让用户可以在笔记环境中直接与 Claude 对话，而不需要切换到终端。

核心价值

• 零切换成本：写笔记和用 AI 在同一个窗口完成
• 上下文感知：可以 @提及笔记，把当前文档作为上下文喂给 Claude
• 斜杠命令：支持自定义命令快速执行常用操作
• 计划模式：可以拆解复杂任务

项目信息

• GitHub: YishenTu/claudian
• 状态: Beta（尚未进入官方插件市场）
• 支持后端: Claude Code CLI、Codex（Beta）

安装教程

第一步：安装 Claude Code CLI

Claudian 本质上是一个「壳」，真正的 AI 能力来自 Claude Code CLI。所以首先需要确保 Claude Code 已经安装。

在终端执行：

which claude

如果返回路径（比如 /usr/local/bin/claude），说明已安装。复制这个路径，后面要用。

如果返回空，需要先安装 Claude Code CLI。安装方法参考 Anthropic 官方文档或相关教程。

第二步：安装 Obsidian

1. 下载 Obsidian: 访问 obsidian.md/download 下载对应系统版本
2. 创建仓库: 首次启动时创建一个本地仓库（Vault）

第三步：开启第三方插件

进入 Obsidian 设置：

设置 → 第三方插件 → 关掉安全模式

第四步：安装 BRAT 插件

因为 Claudian 还没进官方插件市场，需要通过 BRAT 安装。BRAT 是 Obsidian 社区专门装 Beta 插件的工具。

1. 在第三方插件页面搜索 BRAT
2. 安装并启用

第五步：通过 BRAT 安装 Claudian

1. 左侧列表进入 BRAT
2. 点击 Add beta plugin
3. 粘贴 Claudian 的 GitHub 地址：

https://github.com/YishenTu/claudian

4. 等待安装完成
5. 回到设置页，左侧多出 Claudian 选项，点进去

第六步：配置 Claudian

在 Claudian 设置页面：

1. 语言：切换为中文
2. Claude CLI 路径：粘贴第一步复制的完整路径
3. Claudian 会自动探测一次，没报错就往下走

认证配置：两条路径

这一步之后，分成两条路：订阅路径和反代路径。

路径一：订阅路径（推荐）

如果你有 Claude 官方订阅（Claude Pro / Claude Team），不需要额外配置。

第一次发消息时，Claude Code 可能弹一个登录链接，跟着走授权流程即可。授权过一次后，之后就不用管了。

优点：配置最简单，稳定性最好。

路径二：反代/中转路径

如果无法开订阅，可以通过 API 中转站使用。

在 Claudian 设置里找到「自定义环境变量」，追加两条：

ANTHROPIC_API_KEY=你中转站的key
ANTHROPIC_BASE_URL=你中转站的地址

注意事项：

• ANTHROPIC_BASE_URL 是接口根路径，不是登录页地址
• 中转站控制台的「API 接入」那栏一般能找到

测试运行

配置完成后：

1. 关掉设置页
2. 看 Obsidian 左边功能区那一竖排图标——应该多出一个机器人图标
3. 点击机器人图标，右边弹出侧边栏
4. 输入框里发一句最简单的：

你是谁

几秒内应该开始流式输出回复。看到回复就算跑通了。

跑不通的三种情况

常见报错排查

报错一：Claude CLI not found

现象：侧边栏一发消息就弹红字「Claude CLI not found」

排查步骤：

1. 终端重新执行 which claude
   • 返回空 → CLI 没装上，回第一步安装
   • 返回路径 → 完整复制，注意别带多余空格或换行
2. Claudian 设置 → 高级 → Claude CLI 路径，粘贴进去覆盖
3. 关设置页，再发一次「你是谁」

报错二：npm CLI 和 Node.js 不在同一目录

现象：路径填得一字不差还是找不到 claude

原因：使用 nvm、volta、fnm 等版本管理器的人最容易踩坑——claude 和 node 可能不在同一个目录，Claudian 启动子进程时 PATH 里只有其中一个。

验证方法：

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

两条输出一样就不是这个问题。不一样就是。

解决方案 A：Claudian 设置里把 Node 目录也加进 PATH

1. 高级 → 环境变量 → 找到 PATH
2. 把 dirname $(which node) 的目录用冒号追加进去
3. 原内容不动，重启 Obsidian

解决方案 B：装 Claude Code 原生二进制，绕开版本管理器

去 Anthropic 官方下载对应系统的原生二进制，装完后 which claude 会指向系统级目录（比如 /usr/local/bin/claude），和 Node 无关。Claudian 里重填新路径即可。

Codex 支持（Beta）

Claudian 也支持 Codex 作为后端，但官方仓库标注还是 Beta 状态，跨平台还在验证阶段。

大体思路和 Claude Code 一样：

1. 装好 Codex CLI
2. Claudian 里把 provider 切成 Codex
3. CLI 路径换成 Codex 的可执行文件
4. 报错排查套路基本一致

建议等 Claudian 把 Beta 摘掉再正式用 Codex。

进阶功能

安装只是把路打通，Claudian 的真正威力在于：

• 斜杠命令：自定义命令快速执行常用操作
• @提及笔记：把当前文档或其他笔记作为上下文喂给 Claude
• 计划模式：拆解复杂任务，逐步执行

这些功能才决定它到底是个聊天框还是你的写作搭档。

总结：三条路径的选择

相关资源

• Claudian GitHub: github.com/YishenTu/claudian
• Obsidian 官网: obsidian.md
• Claude Code 官方文档: docs.anthropic.com

如果你也是 Obsidian 重度用户，Claudian 绝对值得一试。不切屏的写作体验，真的回不去。