Claudian Obsidian 插件教程：三步把 Claude Code 装进你的笔记库
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
Claudian 是一个 Obsidian 插件，把 Claude Code、Codex、Grok、OpenCode、Pi 等 AI 编程智能体直接嵌入你的笔记库。装好之后，你的库就是智能体的工作目录：读写文件、全文搜索、执行 bash、跑多步任务全部开箱即用，你在侧边栏说一句自然语言，它就动手干活。
笔记存得越来越多，却产不出一篇成品
你可能也遇到过这种情况：素材收藏了一堆，真要写初稿时翻遍整个库也拼不成文。改用终端里的 AI，又得先把笔记手动复制粘贴进对话，产出的文本还是终端里的纯文本，再手工贴回 Obsidian。
每一道复制粘贴都在损耗上下文。Claudian 把这个中间环节砍掉了：AI 直接读你的笔记，产出也直接写回你的笔记。
Claudian 是什么：你的库变成 AI 的工作目录
一句话说清：Claudian 是个"搬运壳"，把终端编程智能体（Claude Code、Codex、Grok、OpenCode、Pi）的完整能力整体搬进 Obsidian 侧边栏。它不是又一个聊天框，而是把工作目录指向你的库。
和直接开终端用 CLI 的差异，一张表就能看明白：
| 对比维度 | 终端里裸跑 CLI | Obsidian 里用 Claudian |
|---|---|---|
| 上下文来源 | 手动粘贴、手动指定路径 | 库内文件天然就是它的背景 |
| 产出形态 | 终端纯文本，手工贴回 | 直接写入笔记，带词级 diff 预览 |
| 操作入口 | 反复切窗口、复制路径 | 侧边栏对话 + 行内编辑 |
| 知识资产 | 与笔记库无关 | 每篇笔记都是可被调用的资料 |
实现上也相当克制：跨智能体的统一运行时与权限体系在 src/core/，每个智能体的适配层各自放在 src/providers/ 的子目录里，侧边栏聊天与行内编辑等界面则归属 src/features/。新增智能体或替换后端，都不必动核心。
图里左侧是你正在编辑的笔记，右侧是 Claudian 侧边栏：AI 读文件、给出思考过程，并把改动以 +18/-1 的 diff 形式写回笔记。
装完就能上手的几个能力
行内编辑：选中即改，原地看 diff
选中一段文字，或把光标停在某处，按行内编辑热键，AI 就在笔记里直接动笔。改动以词级 diff 呈现，删了什么、加了什么一目了然，不满意可以回退。润色、扩写、压缩、翻译都在原地完成。
斜杠命令与 Skills
输入框敲/弹出可复用的提示词模板；敲$则调用 Skills 技能，分"用户级"和"库级"两种作用域。把审稿标准、翻译口吻这类常用要求固化成命令，下次一行触发。
@ 提及：把任何东西喂给 AI
敲@可引用库内文件与文件夹；使用 Collab 模式时，#还能引用工单。写文章时直接@参考文献笔记，让它按引用格式重组，省掉复制粘贴。
指令模式
通过/instruction进入指令模式，把细化的自定义要求追加到本次对话。比如"所有回答用口语化中文""不要动代码块内部内容"，AI 会照此办事。
MCP 服务器与多标签会话
MCP 配置沿用每个智能体原生命令行管理的那一套，你在终端里用过就原样生效。会话方面，单栏模式可开多个标签页，双栏模式则让常驻会话管理器躺在对话旁，随时回来接续上下文。
Collab 模式（实验性）
和其他 Claudian 用户协作共享项目，项目 Git 数据在受邀成员的局域网设备之间直连传输，不经第三方。需要本机装好 Git。
Claudian 安装步骤：三步到第一次对话
第一步：装插件。推荐走社区插件市场：Obsidian → 设置 → 社区插件 → 浏览，搜索 "Claudian"，安装并启用。想尝鲜最新版可以从源码构建：
cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian && npm install && npm run build然后在 设置 → 社区插件 中启用 "Claudian"。开发阶段用npm run dev可开监听模式。
第二步：准备一个智能体。Claudian 只是壳，至少装一个 CLI：Claude Code、Codex、Grok Build、OpenCode 或 Pi，外加对应的订阅或 API 服务。OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式都可以。硬性要求：桌面端（macOS / Linux / Windows），Obsidian v1.13.0 及以上。
第三步：发第一句对话。从左侧 ribbon 图标或命令面板打开聊天侧边栏，试试：
"打开当前这篇笔记，用三句话总结我的观点，并列出 5 个可以补充的论据。"
Claudian 常见问题速查
Q：提示找不到 CLI（spawn claude ENOENT）怎么办？A：用 nvm、fnm、volta 这类 Node 版本管理器时很常见。先把 CLI 路径设置留空让它自动检测；失败就用which claude（macOS/Linux）或where.exe claude（Windows）找到可执行文件路径，填到 设置 → 高级。也可以在 设置 → 环境 的自定义变量里把 Node.js 的 bin 目录加进 PATH。
Q：Obsidian Sync 不同步插件文件？A：主插件文件已超过 5MB，超出官方 Sync 的上限。多设备用 Sync 的话，需要在每台设备分别安装和更新 Claudian。
Q：要联网、要花钱吗？数据发给谁？A：需要。你的输入、附加文件和工具调用结果会发往所选提供方（Anthropic、OpenAI、xAI 等）。插件本身没有遥测，也没有任何非你触发的后台网络活动。
Q：手机能用吗？A：不能。它要承载完整的多步 CLI 工作流，目前仅限桌面端。
Q：装了多个智能体怎么切换？A：每个智能体在设置里独立配置，对话中随时切换，历史记录互不干扰。界面内置简繁中文在内的 10 种语言。
下一步
打开你的 Obsidian，装好 Claudian，把第一句话对准库里最乱的那篇笔记，让它先梳理一遍。熟悉之后，把你最常用的话术沉淀成命令——你的库就开始从"仓库"变成"产线"了。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
