Obsidian 插件配置指南

Claudian 完全指南

从 BRAT 安装到国产大模型配置，让你的 Obsidian Vault 成为 AI 的工作目录

Obsidian Claudian BRAT GLM DeepSeek
向下滚动

Claudian 是一款将 Claude Code 嵌入 Obsidian 的插件，让你的 Vault 成为 AI 的工作目录，具备完整的 Agentic 能力：文件读写、搜索、Bash 命令和多步骤工作流。

插件仓库：github.com/YishenTu/claudian

01

前置要求

要求 说明
Obsidian v1.8.9 或更高版本，仅支持桌面端（macOS / Windows / Linux）
Node.js v18 或更高版本（用于安装 Claude Code CLI）
Claude Code CLI Claudian 的核心依赖，必须先安装

安装 Claude Code CLI

# 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version
💡 提示

Claudian 支持 Anthropic API 格式的任何模型提供商（OpenRouter、Kimi、GLM、DeepSeek 等），不一定需要 Claude 订阅。

02

安装 BRAT 插件

BRAT（Beta Reviewers Auto-update Tool）是 Obsidian 的社区插件，专门用于安装和管理未上架官方市场的第三方插件。

🔧

添加 Beta 插件

通过 GitHub 仓库地址安装插件，无需等待官方审核

🔄

自动更新

定期检查更新，支持一键更新到最新版本

📦

插件管理

查看、更新、删除已添加的 Beta 插件

安装步骤

  1. 打开 Obsidian 设置
    Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）
    依次点击：设置 → 第三方插件
  2. 关闭安全模式
    如果首次使用第三方插件，需要先点击「关闭安全模式」
  3. 浏览社区插件
    点击「浏览」按钮，搜索 BRAT
    找到 "BRAT"（作者：TfTHacker），点击 Install
  4. 启用 BRAT
    回到第三方插件列表，启用 BRAT
03

通过 BRAT 安装 Claudian

  1. 添加 Claudian
    设置 → BRAT → Add Beta plugin
    输入仓库地址：https://github.com/YishenTu/claudian
  2. 启用插件
    设置 → 第三方插件 → 启用 "Claudian"
  3. 确认安装成功
    左侧 Ribbon 栏出现机器人图标
    Ctrl/Cmd + P → 搜索 claudian
💡 推荐使用 BRAT

BRAT 会自动检查更新并通知你，省去手动更新的麻烦。

04

配置国产大模型（以智谱 GLM 为例）

Claudian 不限定官方 Claude API，只要兼容 Anthropic API 格式即可。智谱 GLM 提供了 Anthropic 兼容的 API 端点。

获取智谱 API Key

  1. 访问 智谱开放平台
  2. 注册 / 登录账号
  3. 右上角头像 → API Keys → 创建新的 API Key
  4. 复制并保存 API Key（仅显示一次）

配置环境变量

设置 → Claudian → Environment → Custom variables：

ANTHROPIC_API_KEY=你的智谱API_Key
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_DEFAULT_OPUS_MODEL=glm-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL=glm-4.7
ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-4.7
变量名 说明 推荐值
ANTHROPIC_API_KEY API 密钥 你的智谱 API Key
ANTHROPIC_BASE_URL API 基础地址 open.bigmodel.cn/api/anthropic
ANTHROPIC_DEFAULT_MODEL 主模型 glm-4.7

其他国产大模型配置

🔵

DeepSeek

api.deepseek.com/anthropic
🌙

Kimi

api.moonshot.cn/anthropic
💎

SiliconFlow

api.siliconflow.cn/anthropic
05

安装与配置 Skills

Skills 是 Claudian 的可扩展能力模块，当识别到匹配的场景时，会自动加载对应的 Skill 并执行。

官方 Obsidian Skills

Skill 名称 功能
obsidian-markdown 处理 Obsidian 专有 Markdown 语法
json-canvas 生成和编辑 Canvas 无限画布
obsidian-bases 创建和编辑数据库视图
obsidian-cli 通过命令行与 Vault 交互

安装步骤

  1. 下载 Skills
    访问 github.com/kepano/obsidian-skills
  2. 放置到 Vault
    将 skills/ 文件夹复制到 .claude/skills/
  3. 验证安装
    输入 /skills 查看已安装的 Skills
💡 Skill 存放路径

~/.claude/skills/（全局）| {Vault}/.claude/skills/（当前 Vault）

✓

验证连接

  1. 打开聊天界面：点击 Claudian 机器人图标，或 Ctrl/Cmd + P → claudian
  2. 发送测试消息：你好，请告诉我你是什么模型？
  3. 如果回复中包含 "GLM"、"智谱" 等关键词，说明配置成功！
⚠️ 常见问题
  • 确认 ANTHROPIC_BASE_URL 地址正确（末尾不要加 /v1）
  • 确认 ANTHROPIC_API_KEY 正确且未过期
  • 确认网络可以访问智谱 API
Deerflow