企业官网建设流程全解析

Claudian 完整指南：3 步把 Claude Code 搬进 Obsidian，让 AI 在笔记里直接动笔

【免费下载链接】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 编程智能体直接嵌进你的笔记库——整个库就是 AI 的工作目录，读写文件、全文搜索、多步任务开箱即用。这篇教程带你三步装好跑通对话，再看懂最值钱的几个功能，最后避开新手最容易踩的坑。

一句话看懂：Claudian 靠什么工作？

它就像在你家墙上开了一扇通向后厨的门。厨师（AI 智能体）就住在你家：橱柜里的食材（你的笔记）他全都看得见，随手取出来加工、调味、摆盘，再把成品放回原处——你不必再把稿子抱去外面印刷厂（终端）反复来回。你的库越厚，他懂的就越多。

想深入看实现的读者可以定位两处源码：src/core/ 是跨智能体的统一运行时与权限层，src/providers/ 下每个目录对应一个智能体的适配层，新引擎接进来时改动都很收敛。

快速上手：3 步装好 Claudian 跑通第一次对话

第一步：从社区插件市场安装

打开 Obsidian → 设置 → 社区插件 → 浏览，搜索 “Claudian”，点击安装并启用。插件要求桌面端（macOS、Linux、Windows）且 Obsidian v1.13.0 及以上。

第二步：准备一个 AI 智能体

Claudian 是“壳”，底层需要一台“发动机”：Claude Code、Codex CLI、Grok Build、OpenCode、Pi 任选其一安装好，并准备好对应的订阅或 API 密钥。之后可以在设置里自由切换，各家的对话历史互不干扰。

第三步：打开侧边栏，说出第一句话

点击左侧边栏的 ribbon 图标（或从命令面板搜索）打开对话窗口，然后直接像这样开口：

“打开当前这篇笔记，用三句话总结我的观点，再列出 5 个可以补充的论据。”

几秒钟后你会看到 AI 先读了笔记，再逐条作答——恭喜，已经跑通了。

小提示：若提示“找不到 CLI”，多半是图形界面读不到命令行 PATH（用 nvm 这类版本管理器的人最常见）。在终端执行which claude（Windows 用where.exe claude）找到路径，填进设置 → 高级 即可。

功能体验：4 个最改变写作习惯的用法

✍️ 选中句子就能改，改前改后一眼看清

选中一段文字（或光标停在某处）按下热键，AI 就在笔记原地动笔。改动以词级 diff 呈现——删掉的词划掉、新增的词高亮，满意直接落盘，不满意一键回退。润色、扩写、压缩、翻译都不需要离开当前笔记，对中文长文特别顺手。

📎 用 @ 把要处理的“素材”直接端给 AI

输入框里敲@，可以引用库内任意文件或文件夹；敲#还能引用协作任务。比如写论文时@参考文献A @参考文献B，再补一句“按引用格式重新组织这两篇要点”，AI 会先读完引用内容再动手，省掉所有复制粘贴。

🧰 把常用话术变成一行命令

输入框敲/会弹出可复用的提示词模板列表，敲$则调用 Skills 技能（分“用户级”和“库级”两种作用域）。审稿标准、周报格式、翻译口吻，写一次、存一次，之后每次一行触发，风格永远一致。

🗺️ 计划模式：先让它想清楚，再许它动文件

按Shift+Tab切到计划模式后，AI 不急着改东西，而是先勘察库、研究方案、输出完整计划，等你点头才执行。配合权限规则（读哪些文件、跑哪些命令、哪些路径前缀需要审批都可控），在重要库上操作心里有底。

它适合谁？一张清单快速对号

适合你，如果：

• 库里“只进不出”，存了海量素材却拼不出一篇初稿
• 想润色、排版、改写，但希望成果直接落在笔记里、随时可回退
• 团队想把写作规范沉淀下来，让每个人一键复用
• 已经在用 Claude Code / Codex，只是嫌终端离笔记太远

不太适合，如果：

• 你只需要“帮我总结这段文字”级别的功能，网页聊天工具就够了
• 主要在手机、平板上使用 Obsidian——Claudian 目前仅限桌面端
• 不想为任何 AI 订阅或 API 付费

常见问题，一次说清

插件本身要钱吗？开源免费。但底层智能体（Claude、Codex、Grok 等）按各自订阅或 API 额度计费，这部分费用产生在你所选的服务商侧。

我的笔记会不会被“偷跑”？不会。只有你发起请求时，涉及的内容（输入、附加文件、工具结果）才会发往你选定的提供方；插件没有任何遥测信标，也没有未经你触发的后台网络活动。不发消息，它就不联网。

能接国产模型吗？可以。OpenRouter、Kimi、GLM、DeepSeek 等支持 Claude Code 协议的接入方式都支持。界面本身内置简繁中文在内的 10 种语言包，见 src/i18n/。

Obsidian 官方 Sync 能同步插件吗？插件主文件超过 5MB，官方 Sync 不支持同步它，建议每台电脑分别安装和更新插件，笔记本身照常同步不受影响。

装了多个智能体，历史会混在一起吗？不会。每个智能体在设置里独立配置，对话与历史各存各的，随时切换互不干扰。

进阶玩法：3 个可以直接照做的技巧

• 给 AI 接上“外接工具”：通过 MCP（Model Context Protocol，一套让 AI 调用外部工具的标准协议）把智能体接到外部工具上。配置沿用各智能体原生命令行那套，零学习成本。
• 把“家规”写成 Skill：你的开头习惯、禁用词、引用格式，整理成一条库级 Skill。新草稿先@原文再$技能，成稿风格就稳定得像一个人写的。
• 双栏模式养一个“常驻会话”：双栏布局下会话管理器常驻在对话旁，长任务挂在一个标签页慢慢跑，短问题在另一个标签页随手问，互不阻塞，随时回来接续上下文。

现在就动手

开头说你的库“只进不出”，Claudian 就是那扇通向后厨的门：素材在屋里，厨师也在屋里，灵感随时能落地成文。现在去仓库安装插件、配好一个智能体、发出你的第一句指令；中途卡住或有更好想法，欢迎到仓库讨论区留个言，开源项目每多一条真实反馈，就离好用更近一步。

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian