|Claudian Obsidian 插件
访问官网

Claudian Obsidian 插件

插件

在Obsidian中直接使用Claude AI助手，结合笔记与AI提升效率

BLUF 摘要（点开查看）

这篇教程说明如何配置 Claudian Obsidian 插件，重点是先准备 API Key、Base URL 和模型名称，再按章节完成安装、配置、验证与排错。

配置前检查

  • 确认工具读取的是哪个配置文件，避免改错项目目录或用户目录
  • 准备 API Key、Base URL、模型名称和计费平台登录方式
  • 先用测试模型跑通一次简单对话，再切换到更贵或更强的模型
  • 把 API Key 放在环境变量或工具密钥管理里，不要写进公开仓库

常见排错

  • 401/403：优先检查 API Key 是否复制完整、是否过期、是否有调用权限
  • 404/模型不存在：检查模型名、Base URL、供应商兼容接口路径是否匹配
  • 429：降低并发，开启重试退避，或升级额度与限速套餐
  • 超时：先切换更快模型或国内直连 API，再缩短输入上下文测试
目录（7 章）
1. 前提条件2. 下载 Claudian 插件文件3. 放置插件文件4. 配置 Claudian 连接 Claude Code5. 配置 DeepSeek API 环境变量6. 测试 Claudian 插件7. 常见问题排查
1

前提条件

在开始安装 Claudian 插件之前，请确保已完成以下准备工作。

确认已完成前置准备

以下三项必须提前完成

  • 已安装 Claude Code 命令行工具
  • 已配置 DeepSeek API
  • Obsidian 已安装并运行正常
⚠ 如果未完成 Claude Code 安装，请先参考 Claude Code 安装教程
2

下载 Claudian 插件文件

从 GitHub 发布页面下载插件的三个必需文件。

下载插件文件

访问 Claudian 插件 GitHub 发布页面下载所需文件

bash
# 需要下载的三个文件
main.js          # 插件主程序
manifest.json    # 插件配置文件
styles.css       # 插件样式文件
3

放置插件文件

将下载的插件文件放到 Obsidian 的插件目录中。

找到插件目录

通过 Obsidian 设置打开插件文件夹

  • 打开 Obsidian，进入任意笔记仓库
  • 点击左下角的设置图标（齿轮形状）
  • 在左侧菜单中，选择「第三方插件」
  • 点击「打开插件文件夹」图标

放置插件文件

在 plugins 文件夹内创建 claudian 目录并放入文件

  • 在打开的 plugins 文件夹内，新建文件夹命名为 claudian
  • 将下载的 main.js、manifest.json、styles.css 复制到 claudian 文件夹内
  • 回到 Obsidian，在设置 → 第三方插件页面中点击「重新加载插件」
  • 在插件列表中找到 Claudian，启用插件（切换开关）

核心要点

文件结构参考：.obsidian/plugins/claudian/ 下应有 main.js、manifest.json、styles.css 三个文件

4

配置 Claudian 连接 Claude Code

设置 Claudian 插件连接到本地安装的 Claude Code。

设置 Client Path

将 Claude Code 的安装路径填入 Claudian 设置

bash
# 获取 Claude Code 安装路径
which claude
# 返回示例：/c/Users/你的用户名/AppData/Roaming/npm/claude
  • 在 Obsidian 中，进入 Claudian 插件的设置页面（设置 → Claudian）
  • 找到「Client Path」或「Claude CLI Path」输入框
  • 打开 Git Bash，输入命令获取 Claude Code 路径

完成路径配置

将路径粘贴到 Claudian 设置中

  • 复制 which claude 返回的路径
  • 粘贴到 Obsidian 的 Client Path 输入框中
  • 点击「保存」按钮
5

配置 DeepSeek API 环境变量

为了让 Obsidian 能读取 API 配置，需要在 Windows 系统中设置环境变量。

设置系统环境变量

在 Windows 系统环境变量中添加 DeepSeek API 配置

bash
# 依次创建以下三个环境变量
# 变量名                    变量值
ANTHROPIC_BASE_URL     https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN   你的DeepSeek API Key
ANTHROPIC_MODEL        deepseek-v4-flash
  • 按 Win + S 搜索「编辑系统环境变量」并打开
  • 点击「环境变量」按钮
  • 在「用户变量」区域点击「新建」

保存并重启

保存环境变量后重启 Obsidian

  • 点击「确定」保存所有更改
  • 完全关闭 Obsidian（不只是最小化）
  • 重新打开 Obsidian
  • 更彻底的方法：重启电脑

注意事项

环境变量设置后必须重启 Obsidian 才能生效

API Key 务必保密，不要泄露

6

测试 Claudian 插件

验证插件是否安装配置成功。

测试对话

在 Obsidian 中与 Claudian 对话测试

  • 在 Obsidian 界面中找到 Claudian 插件图标（机器人头像）
  • 通常在右侧边栏或左侧边栏
  • 点击机器人图标，打开 Claudian 对话窗口
  • 输入测试问题，例如：你好，请用中文介绍一下自己
  • 如果收到回复，说明安装成功！

核心要点

如果图标不显示，检查插件是否已启用（设置 → 第三方插件）

尝试重启 Obsidian

7

常见问题排查

安装过程中可能遇到的问题及解决方案。

Claude CLI not found

Obsidian 中 Claudian 报错找不到 Claude CLI

  • 检查 Client Path 是否正确
  • 重新执行 which claude 命令确认路径
  • 确保路径中不包含多余的空格或特殊字符

环境变量设置了但 Obsidian 读不到

系统环境变量未生效

  • 完全关闭 Obsidian 再重新打开
  • 如果仍无效，重启电脑
  • 在 Git Bash 中测试：echo $ANTHROPIC_AUTH_TOKEN

API 返回错误

调用 API 时出错

  • 确认 API Key 是否正确
  • 检查网络连接
  • 确认 DeepSeek API 服务是否正常

其他应用教程

CC Switch

推荐

跨平台 AI 终端配置管理工具，统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 的 API 供应商、模型、MCP 和 Skills。

OpenAI Codex

官方

OpenAI 官方 AI 编程助手安装与使用教程，覆盖 CLI、IDE 扩展、云端任务、AGENTS.md、权限审批、安全规范和真实项目工作流。

Claude Code

热门

Claude Code 安装、区域限制处理、CC Switch 配置与 DeepSeek 模型接入完整教程

OpenClaw

开源

开源AI助手平台，支持飞书集成，一键部署私人AI助理

OpenClaw 接入飞书

飞书

基于飞书开放平台创建机器人，并通过 OpenClaw Feishu 插件把本地 AI 助手接入飞书对话

Hermes Agent

Agent

Nous Research 开源 AI Agent 安装与初始化教程，覆盖一键安装、模型配置、健康检查和常见问题排查

LLM Wiki 知识编译器

知识管理

将零散信息编译成结构化知识网络的AI驱动知识管理系统，基于Obsidian和Claude构建