企业官网建设流程全解析

三步把 AI 协作者装进 Obsidian：Claudian 完整上手指南

【免费下载链接】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 这类 AI 编程智能体（coding agent，即能读写文件、执行命令的 AI 助手）直接嵌进你的笔记库（vault）里。装上之后，你的笔记库就是这个智能体的工作目录：你说"把这篇长文档按主题拆成小节"，它就自己读文件、改文件、搜文件，并把每一步做了什么告诉你。不需要在浏览器和 Obsidian 之间来回复制粘贴，整理笔记这件事从"手动搬段落"变成了"下指令、看结果"。

先搞懂它是什么：不是聊天机器人，是一个住进笔记库的智能体

很多人第一次听描述会以为这又是个套壳聊天框。区别在于：普通聊天机器人只能"说"，Claudian 嵌进去的是真正的编程智能体，目前支持 Claude Code、Codex、Grok、OpenCode、Pi 这几套运行框架（harness，可理解为各家智能体的本地执行器），你的 vault 就是它的工作目录，文件读写、全文搜索、跑 bash 命令、跨多步骤完成任务都是开箱即用的。

对比一下纯手动整理的体验：想把一篇几百行的散乱笔记重组成结构化文档，手动做要复制、删行、调缩进，改到一半还容易丢内容；用 Claudian，你选中文本或指出目标文件，用一句话说清要求，智能体读完原文后直接编辑，侧栏里会列出它改了哪一行、加了多少行删了多少行，以及为什么这么改。改得不满意就让它再来一版。

它适合：在 Obsidian 里积累了大量 Markdown 笔记、想让 AI 参与"动刀"整理的人；习惯 Claude Code 这类工具、想把同样的能力带到笔记场景的开发者。

它不适合：只用手机端 Obsidian 的人（插件仅支持 macOS、Linux、Windows 桌面端）；不想在电脑上装任何命令行工具的人（至少需要一个智能体 CLI，见下一节）；以及要求笔记数据完全不出本机的场景（你的输入会发送给所选的模型服务商）。

三步完成安装配置

第一步：装插件。打开 Obsidian → 设置 → 社区插件 → 浏览，搜索 "Claudian"，点击安装后启用。整个过程不到一分钟。

第二步：准备一个智能体 CLI。要求里写得很清楚，至少装以下其中之一：Claude Code CLI、Codex CLI、Grok Build、OpenCode 或 Pi。装好后 Claudian 会自动探测，通常不用你手动指路径。

第三步：接入模型服务。用你已有的订阅，或者一个 API 服务商（OpenRouter、Kimi、GLM、DeepSeek 等都可以，插件设置里能选）。

Obsidian 版本需要 1.13.0 以上。如果你想从源码编译着玩，把仓库克隆进 vault 的.obsidian/plugins目录，跑一遍依赖安装和构建再启用即可：

git clone https://gitcode.com/GitHub_Trending/cl/claudian

实战演示：让 AI 重构一篇长笔记

装好之后，用左侧边栏的丝带图标（或命令面板）打开聊天侧栏，一个完整的小案例长这样：

1. 你有一篇"黑洞图像生成提示词"的笔记，内容是一大段没分节的文字。
2. 在侧栏输入框里说：把它整理成可读的分节格式，内容一字不改，只加分节和行距。
3. 智能体先执行一次"读取文件"（侧栏显示Read: xxx.md），思考两秒后执行"编辑文件"（显示+18 -1，即新增 18 行、删除 1 行），然后在对话里解释它的分节逻辑：开头描述、关键物理、材质与遮挡、几何、中心、技术规格，哪些部分它没动、为什么。

你也可以走更轻量的路线：直接在笔记里选中一段文字，按快捷方式触发行内编辑（inline edit），AI 会在原位置改写，并给出词级别的 diff 预览，你确认后才落到文件里。适合改一句话、润色一段这种小动作，不用切到侧栏。

进阶用法：几个值得记住的输入符号

熟悉基本流程后，这几个符号能让效率再上台阶：

• 输入/或$：呼出可复用的提示词模板（Skills）。比如你每周都用同一段话术整理会议纪要，把它存成模板，之后敲一下就能调出来。
• 输入@：引用 vault 里的文件、文件夹，让智能体明确"基于哪份材料回答"。
• 输入#：在协作模式下引用工单。
• 输入/instruction：把一段自定义指令保存下来反复使用；/resume可以找回之前的对话，/fork把当前会话分叉成新的分支继续试。

会话管理也分两种形态：单面板模式下用多个标签页切换对话，双面板模式下聊天旁挂一个持久化的会话管理器，适合同时推进好几个整理任务。

另外两条进阶路径：MCP（Model Context Protocol，给 AI 挂外部工具的标准协议）可以直接用各智能体 CLI 原生的配置接入外部工具；Collab 模式（实验特性）支持局域网内多人协作共享项目，需要本机装好 Git。

常见坑：CLI 找不到是头号问题

装好插件后如果对话报spawn claude ENOENT或"CLI not found"，9 成是智能体 CLI 没被 Obsidian 找到，而不是插件本身坏了。按顺序排查：

1. 先用 nvm、fnm、volta 这类 Node 版本管理器装 CLI 的人最容易踩中这个坑——GUI 应用继承的 PATH 和终端里的不一样。先让设置里的 CLI 路径保持空值走自动探测，失败了再去终端敲which claude拿到真实路径，填到 设置 → 高级 → CLI 路径。
2. Windows 用户注意：别填.cmd或.ps1这类包装脚本，原生安装填claude.exe，npm 安装的填对应的cli-wrapper.cjs。
3. npm 全局安装的 CLI 如果和 Node.js 不在同一环境，GUI 应用可能找不到 Node。最简单的解法是改装原生二进制版，或者在 设置 → 环境 里把 Node 路径补进 PATH。

关于数据去向，README 里说得很直白：你的输入、附件和工具调用结果会发给所选服务商；插件本身不跑遥测，没有偷偷的后台网络请求。具体可以看 README.md 的 Privacy 章节。

下一步

建议先拿一篇"废了也不心疼"的笔记做一次完整演示：让它重排结构，对比 diff，确认自己看得懂它的改动逻辑，再放心让它碰正式笔记。遇到问题先翻 README 的 Troubleshooting 部分；确认是 bug 的话，按 CONTRIBUTING.md 的格式提一个 issue，把版本、系统和复现步骤写清楚，维护者处理会快很多。

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