Claudian 插件安装配置教程：把 Claude Code 装进 Obsidian 知识库
【免费下载链接】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 Build、OpenCode、Pi 这些 AI 编程智能体直接嵌进你的笔记库，让"整理素材"和"生成成稿"在同一扇窗口里完成。它替你把"给 AI 喂上下文"这件琐事省掉了：你只管说人话，文件读、写、搜索它自己干。它不替你判断哪篇笔记值得保留，也不替你付费——智能体背后的订阅或 API 额度照样要钱。
核心机制：你的笔记库就是智能体的工作目录
一句话讲透：你的笔记库 = 智能体的工作目录。
终端里的 AI 是"临时工"：上下文靠你手动粘贴，产出靠你手动贴回文档。Claudian 里的 AI 站在整个库之上，库里的每一篇笔记自动成为它的背景资料，读文件、写文件、全文搜索、跑 bash 命令、多步骤长流程全部开箱即用。侧边栏对话的界面长这样：
这套分层在代码里也很克制：src/core/是跨智能体的统一运行时与权限体系，src/providers/下每个目录对应一个智能体的适配层，src/features/chat/与src/features/inline-edit/承载两大交互入口。新增或替换智能体，改的是适配层，不动核心。
功能拆解：从一句对话到整库协作
侧边栏对话：先让 AI 读库、再让它动笔
从左侧 ribbon 图标或命令面板打开对话侧边栏，像说话一样下指令："搜索所有笔记里提到'知识管理'的内容，整理成一篇大纲。"智能体会自己去读文件、搜索、改文件，行为和你在终端里熟悉的 Claude Code 一致。跨智能体的执行、历史、存储逻辑都收敛在src/core/的统一运行时里，所以你换智能体时，工作流习惯不用重学。
选中文字直接改写，词级 diff 当场可回退 ✍️
最顺手的入口是行内编辑：选中一段文字（或把光标停在某处），按下热键，AI 直接在笔记里动笔。改动以词级 diff 预览呈现——删了什么、加了什么，一眼看清，不满意立刻回退。它的实现集中在src/features/inline-edit/ui/InlineEditModal.ts。对中文写作特别友好：润色、扩写、压缩、翻译全在原地完成，不用切窗口复制粘贴。
用/、$、#给 AI 追加规矩和素材 📌
输入框里还有三个符号值得记住。敲/或$调用可复用的提示词模板与 Skill，Skill 区分用户级和库级两种作用域——团队可以把审稿标准、术语表、排版规范写成 Skill，任何成员一条$触发。敲#进入指令模式，把本次对话的临时要求（"回答都用口语化中文""别动代码块"）附加进去。这些命令的发现与存储由src/core/providers/commands/统一管理。
MCP 外接工具，多标签并行处理任务 🔌
需要外部能力时，MCP 服务器可以直接接入，配置沿用各智能体原生命令行那一套，零学习成本。多任务并行靠标签页：一个标签起草周报，另一个标签整理文献，互不阻塞；双栏模式下还能让"常驻会话管理器"贴在对话旁，随时回来接续上下文。实验性的 Collab 模式则更进一步——多个 Claudian 用户围绕同一个共享项目协作，项目数据走局域网直连，不经任何第三方中转。
从零跑通：三步装好并发起第一次对话
第一步：安装插件。打开 Obsidian → 设置 → 社区插件 → 浏览，搜索 "Claudian"，点击安装并启用。想尝鲜最新版也可以源码构建：
git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build把构建产物放进库的.obsidian/plugins/目录，重启 Obsidian 并启用即可；开发时npm run dev可开监听模式。
第二步：准备一个智能体 CLI。Claudian 只是"壳"，底层至少装一个：Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi，并配好对应订阅或 API（OpenRouter、Kimi、GLM、DeepSeek 等兼容接入均可）。
第三步：发起第一次对话。打开侧边栏，输入："打开当前这篇笔记，用三句话总结我的观点，再列 5 个可以补充的论据。"若提示找不到 CLI，多半是 GUI 应用的 PATH 没带上：先在终端用which claude（Windows 用where.exe claude）确认真实路径，再填进 设置 → 高级 里的 CLI 路径栏，细节可翻 README 的 Troubleshooting 一节。
适用边界：适合谁，常见误解
Claudian 只支持桌面端（macOS、Linux、Windows），要求 Obsidian v1.13.0 及以上。重度使用 Obsidian、已持有 Claude Code 或 Codex 订阅、希望 AI 直接读写笔记的人，是它最典型的用户；只用手机端、或想零成本白嫖模型的人则不必安装——插件本身免费，但每次对话的内容都会发给 Anthropic、OpenAI、xAI 等提供方，费用照算。
还有一个常见误解：担心笔记被"偷跑"。README 明确写着：没有遥测信标，也没有任何非用户触发的后台网络活动；只有你主动发请求、或调用已配置的 MCP 端点时才会联网。另外插件包体超过 5 MB，Obsidian 官方 Sync 不同步主文件，多设备用户需在每台设备上分别安装。
进阶玩法：把潜力榨出来
- 给危险操作设白名单：权限规则（
src/core/security/approvalRules.ts）支持对 bash 命令用git *这类通配符、对文件操作用路径前缀匹配。把高频安全命令设为免审批，把写库操作设为每次确认，审批弹窗从此只出现在该出现的地方。 - 用计划模式先想后做：切到计划模式后，AI 会先全文搜索、研究方案、给出完整计划，等你批准才动文件。让它先"巡视"一遍库再改，比直接改文件靠谱得多。
- 把团队方法论沉淀成库级 Skill：审稿标准、术语表、排版规范写成 Skill 提交进库，新人一条
$就能按团队风格产出，知识不再存于某个人脑中。
打开 Obsidian，点开侧边栏，让智能体把你收藏夹里那堆素材，变成一篇初稿吧。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
