📌

Claudian 是 Obsidian 的社区插件，把 Claude Code AI 直接嵌入到你的笔记库里。本教程教你从零开始安装配置 Claudian，并接入星狐云中转 API，让 AI 帮你读笔记、改笔记、查资料、整理知识库。

🌟 为什么要在 Obsidian 里用 Claudian

如果你是 Obsidian 重度用户，相信你一定遇到过这些场景：

想用 AI 改一段笔记，但要复制到 ChatGPT 来回切换窗口，结果就是改完忘记粘回来

笔记越攒越多，想问 AI "我去年关于 XX 的笔记写了什么"，但 AI 看不到你的 vault

想让 AI 整理一整个文件夹的内容，但只能一篇篇喂给它

Claudian 把这些痛点全部解决了，它直接把 Claude Code 装进 Obsidian：

功能	说明
🗂️ vault 是 AI 的工作目录	AI 可以直接读、写、搜索、改你的笔记，不用复制粘贴
✏️ Inline Edit 选中即改写	选中段落 + 快捷键，AI 当场重写，还有 word-level 差异对比
🧠 Plan Mode 先规划后动手	Shift+Tab 切换，AI 先列计划再执行，避免乱改
⚡ Slash Commands / Skills	输入 `/` 触发模板，输入 `$` 调用技能脚本，常用操作一键完成
📎 @mention 引用任何文件	输入 `@` 直接引用 vault 内笔记、子代理、MCP 服务器
🔌 MCP 服务器集成	接入外部工具（GitHub、数据库、网页搜索等）
🗨️ 多 Tab + 对话历史	同时开多个对话，可以分支、恢复、压缩历史

简单来说：Claudian = Obsidian + Claude Code，让你的笔记库变成一个能思考的 AI 工作台。

📋 系统要求

项目	要求
Obsidian 版本	v1.7.2 及以上
操作系统	macOS / Linux / Windows（仅桌面端，不支持手机端）
Node.js 版本	≥ 18.0（用来跑 Claude Code CLI）
星狐云账号	已注册并创建 API 令牌

Claudian 本身不直接调用 API，它会调用系统里安装好的 Claude Code CLI，所以我们要先把 Claude Code 装好并配置好星狐云。

🚀 第一步：安装 Node.js

📌

如果你已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。
在终端输入 node --version 查看，能输出 v18.x.x 或更高即可。

Windows 用户

打开 Node.js 官方网站下载 LTS 版本并安装，安装时一路下一步即可，会自动配置好环境变量。

macOS 用户

Ubuntu / Debian 用户

🚀 第二步：安装 Claude Code CLI

Windows 用户

使用快捷键 Win + R，输入 cmd 打开电脑终端，运行：

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

macOS / Linux 用户

打开终端运行：

能输出版本号即代表安装成功。

🚀 第三步：获取星狐云 API 令牌

前往 https://xinghuapi.com/ 注册并登录，进入 控制台 → API 令牌 页面，点击 添加令牌。

📝 创建令牌时的建议设置：

配置项	建议值
名称	随意命名，如 `obsidian-claudian`
分组	选 Claude Code 专属分组或 Claude Code 专属 2 分组（最稳定）
额度	选无限额度
其他选项	保持默认

保存后复制以 sk- 开头的令牌，下一步会用到。

🚀 第四步：配置环境变量（关键步骤）

我们需要配置两个环境变量，Claudian 启动时会自动读取：

配置项	值
ANTHROPIC_AUTH_TOKEN	`sk-你的星狐云令牌密钥`
ANTHROPIC_BASE_URL	`https://xinghuapi.com`

📌

重要：必须设置为「系统环境变量」（永久生效），不能用临时的 set / export，否则 Obsidian 启动时读不到。

Windows：设置系统环境变量（永久生效）

右键 此电脑 → 属性 → 高级系统设置 → 环境变量

在 用户变量 里点击新建，分别添加两条：

变量名：ANTHROPIC_AUTH_TOKEN
变量值：sk-你的星狐云令牌密钥

变量名：ANTHROPIC_BASE_URL
变量值：https://xinghuapi.com

点击确定保存，完全退出 Obsidian 后重新打开（必须重启才能加载新的环境变量）

macOS 用户：永久写入 shell 配置文件

打开终端运行：

macOS 还需要执行下面这步，让 Obsidian 桌面应用也能读到环境变量（必须）：

然后完全退出 Obsidian（Cmd+Q）再打开。

Linux 用户

然后从终端启动 Obsidian（不要从图形菜单启动，否则读不到变量）。

验证环境变量是否生效

新开一个终端运行：

能正常输出说明配置成功。也可以直接运行 claude 测试 Claude Code 能否连上星狐云，能正常对话即代表配置完全 OK。

🧩 第五步：在 Obsidian 中安装 Claudian 插件

方法一：从社区插件市场安装（推荐）

打开 Obsidian → 设置（Settings） → 第三方插件（Community plugins）

关闭 安全模式（Safe mode）（如果是首次启用）

点击 浏览（Browse）

在搜索框输入 Claudian，找到作者 YishenTu 的版本

点击 安装（Install）

安装完成后点击 启用（Enable）

方法二：从 GitHub Release 手动安装

如果你的网络无法访问 Obsidian 插件市场，可以手动安装：

前往 Claudian 的 GitHub Releases 页面下载最新版本的三个文件：

main.js

manifest.json

styles.css

在你的 vault 文件夹下找到 .obsidian/plugins/ 目录（如果没有 plugins 文件夹就自己新建）

新建一个名为 claudian 的子文件夹，把刚才下载的 3 个文件放进去，最终路径应该是：

你的vault/.obsidian/plugins/claudian/main.js
你的vault/.obsidian/plugins/claudian/manifest.json
你的vault/.obsidian/plugins/claudian/styles.css

重启 Obsidian → 设置 → 第三方插件 → 启用 Claudian

⚙️ 第六步：配置 Claudian 插件

6.1 自动检测 Claude CLI

打开 设置 → Claudian → Claude CLI Path，一般情况下留空即可，插件会自动找到系统里的 claude 命令。

启用插件后，点击 Obsidian 左侧边栏的 Claudian 图标，能正常打开聊天面板说明检测成功。

6.2 如果提示 "Claude CLI not found" 或 "spawn claude ENOENT"

这表示插件没找到 Claude Code CLI（常见于用 nvm、fnm、volta 等版本管理器的用户），需要手动指定路径。

第一步：在终端查询 CLI 完整路径

第二步：把路径填进 Claudian

打开 设置 → Claudian → Advanced → Claude CLI path，把上一步输出的完整路径粘贴进去。

⚠️ Windows 用户特别注意：

优先填 claude.exe 的完整路径（如 C:\Users\你的用户名\AppData\Local\Claude\claude.exe）

如果是用 npm 全局安装的，填 cli-wrapper.cjs 的路径（运行 npm root -g 找到 npm 根目录，再拼上 @anthropic-ai\claude-code\cli-wrapper.cjs）

不要填 .cmd 或 .ps1 后缀，会启动失败

6.3 在 Claudian 内单独配置星狐云（可选）

如果你不想配置全局环境变量，或者想让 Obsidian 用独立的令牌，可以在插件内单独设置：

打开 设置 → Claudian → Environment → Custom variables，添加：

ANTHROPIC_AUTH_TOKEN = sk-你的星狐云令牌密钥
ANTHROPIC_BASE_URL = https://xinghuapi.com

插件内设置的值会覆盖系统环境变量，方便在 Obsidian 里独立切换。

✨ 第七步：开始使用

配置完成后，回到 Obsidian 主界面：

操作	触发方式
打开聊天面板	点击左侧 ribbon 栏的 Claudian 图标，或命令面板搜索 `Claudian: Open Chat`
Inline Edit 改写选中文本	选中文本 → 默认快捷键（可在 Hotkeys 自定义）
斜杠命令 / 模板	在聊天框输入 `/` 查看可用命令
调用 Skills 技能	输入 `$` 选择技能脚本
引用 vault 文件	输入 `@` 选择笔记、子代理、MCP 服务器
切换 Plan Mode	按 `Shift + Tab`，AI 会先规划再执行
加自定义指令	输入 `#` 在当前对话追加临时指令

第一次对话试试：

帮我看下当前打开的这篇笔记，总结一下主要观点

或者选中一段文字，用快捷键触发 Inline Edit：

把这段改成更口语化的表达

✨ 恭喜！现在你的 Obsidian 已经是一个 AI 加持的智能知识库了！

📊 推荐的星狐云模型

在 Claudian 对话中可以通过 /model 命令切换模型：

模型	Model ID	特点
Claude Sonnet 4.6	`claude-sonnet-4-6`	日常使用首选，性价比高
Claude Opus 4.6	`claude-opus-4-6`	最强性能，复杂笔记整理、深度分析
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	速度最快，简单改写、摘要

完整模型列表和价格见星狐云文档：xinghuapi.apifox.cn

❓ 常见问题解答

Q: 提示 spawn claude ENOENT 或 Claude CLI not found？

A: 插件没找到 Claude Code CLI，按第 6.2 节手动指定 CLI 路径。

Q: Windows 启动报错，提示 .cmd 文件不能执行？

A: 不要用 .cmd 或 .ps1 文件，改用 claude.exe 的完整路径，或者 npm 安装目录下的 cli-wrapper.cjs。

Q: 设置好了但 AI 不响应，提示 401 错误？

A: 大概率是令牌分组的问题，按以下步骤排查：

先在星狐云控制台把令牌的分组改成 Claude Code 专属分组 或 Claude Code 专属 2 分组

如果之前没设置过分组，先设置一下再试

还不行的话，截图发给客服看具体报错

Q: 出现 400 报错 / 请求格式错误？

A: Claude Code 常见报错，换一个令牌分组试试，或者在对话中输入 /clear 新建对话即可。

Q: 提示「模型在该分组下无法使用」？

A: 你选的模型和当前令牌分组不匹配。换到模型对应的分组：日常用模型推荐 Claude Code 专属分组 或 专属 2 分组。

Q: macOS 上从 Launchpad 启动 Obsidian 后插件读不到环境变量？

A: macOS 桌面应用不继承终端的环境变量，必须用 launchctl setenv 命令注入（见第四步 macOS 配置最后一段），或者在 Claudian 设置里用 6.3 节的方法单独配置。

Q: 配置了但 Obsidian 还是用不了？

A: 三个常见原因依次排查：

没重启 Obsidian → 完全退出（Windows 任务栏右键退出 / macOS Cmd+Q）后重新打开

环境变量是临时的 → 确认用的是「系统环境变量」，不是 set / export 临时命令

Claude Code CLI 本身没装好 → 在终端运行 claude --version 看是否正常输出

Q: 想换一个令牌或切换分组怎么办？

A: 修改系统环境变量的 ANTHROPIC_AUTH_TOKEN，重启 Obsidian 即可；或者在 Claudian 插件设置里的 Environment 板块改，无需重启系统。

📌 注意事项

妥善保管你的 sk- 开头的 API 令牌，避免泄露

推荐使用 Claude Code 专属分组 或 Claude Code 专属 2 分组，最稳定最兼容

额度建议设为无限（实际消耗受账户余额限制）

让 AI 改写笔记前建议先 commit 一次或备份，方便对比/回滚

Plan Mode（Shift+Tab）适合复杂任务，让 AI 先列计划再动手，避免误改

🔗 相关链接

Obsidian 使用 Claudian教程

🌟 为什么要在 Obsidian 里用 Claudian#

📋 系统要求#

🚀 第一步：安装 Node.js#

🚀 第二步：安装 Claude Code CLI#

🚀 第三步：获取星狐云 API 令牌#

🚀 第四步：配置环境变量（关键步骤）#

Windows：设置系统环境变量（永久生效）#

macOS 用户：永久写入 shell 配置文件#

Linux 用户#

验证环境变量是否生效#

🧩 第五步：在 Obsidian 中安装 Claudian 插件#

方法一：从社区插件市场安装（推荐）#

方法二：从 GitHub Release 手动安装#

⚙️ 第六步：配置 Claudian 插件#

6.1 自动检测 Claude CLI#

6.2 如果提示 "Claude CLI not found" 或 "spawn claude ENOENT"#

6.3 在 Claudian 内单独配置星狐云（可选）#

✨ 第七步：开始使用#

📊 推荐的星狐云模型#

❓ 常见问题解答#

📌 注意事项#

🔗 相关链接#