title: Obsidian + Claude Code:让 AI 深度融入你的知识库
source: https://zhuanlan.zhihu.com/p/2019848059090129859
author:
- evan
created: 2026-04-16
Claudian 是一个 Obsidian 桌面端插件,用于连接 Claude Code CLI,支持 Claude Code 的 Skills 体系,可在 Obsidian 内直接与 Claude 交互、编辑文本。
为什么使用 Claudian?
- 在 Obsidian 中直接与 Claude 对话
- 支持读写笔记、搜索 vault、执行复杂任务
- 兼容多种 Anthropic API(官方 Claude、DeepSeek、智谱 GLM 等)
- 深度集成 Obsidian 的 Wikilink、标签、Dataview 等特性
快速开始
安装流程:Node.js → Claude Code CLI → Claudian 插件 → 配置 API
第一步:安装 Claude Code CLI
前置要求:Node.js v18+
验证安装:
node --version
npm --version
安装 CLI(以管理员身份运行):
npm install -g @anthropic-ai/claude-code
claude --version
初始化 MCP 服务端:
claude code --mcp-init
第二步:安装 Claudian 插件
目前 Claudian 尚未上架 Obsidian 社区市场,需手动安装。
- 从 GitHub Releases 下载
main.js、manifest.json、styles.css - 创建目录:
.obsidian/plugins/claudian/ - 将三个文件复制到该目录
- Obsidian 设置 → 社区插件 → 启用 Claudian
第三步:配置 API 环境
设置路径:设置 → Claudian → Environment
根据你的 API 提供商选择对应配置:
官方 Claude
ANTHROPIC_API_KEY=your_api_key
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
DeepSeek
ANTHROPIC_API_KEY=sk-your-key
ANTHROPIC_BASE_URL=https://api.deepseek.com
ANTHROPIC_MODEL=deepseek-chat
智谱 GLM
ANTHROPIC_API_KEY=your-key
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_MODEL=glm-4.7
CC Switch:如已配置 CC Switch,Claudian 会自动读取,无需重复设置。
配置提示:选择 Claude 类型后点 + 号,只需填写 API Key;智谱用户需根据购买模型修改对应的模型名称。
Skills 体系(可选)
Claudian 支持 Claude Code 的 Skills 体系扩展功能:
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
此命令需在 Claude Code CLI 中执行。
使用技巧
基本用法:打开笔记 → 调用 Claudian → Claude 可读取/编辑笔记、搜索 vault、理解 Wikilink 和标签。
推荐工作流:
- 打开项目笔记,选中需处理的内容
- 调用 Claudian 分析/总结/改写
- Claude 直接编辑,你审查确认
常见问题
| 问题 | 解决方案 |
|---|---|
| 插件不显示 | 刷新社区插件列表 / 重启 Obsidian / 检查目录下是否含三个文件 |
| API 调用失败 | 检查 API Key、BASE_URL、网络连接、模型名称是否匹配 |
| 支持哪些模型 | 任何兼容 Anthropic API 格式的模型 |