企业官网建设流程全解析

让 AI 直接住进你的知识库：Claudian 把 Claude Code 和 Codex 嵌入 Obsidian 的完整上手指南

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

你有没有过这样的时刻：在 Obsidian 里写笔记写到一半，想请 AI 帮忙润色、查资料、甚至整理整个文件夹，于是打开浏览器、登录网页版、复制粘贴一大段内容、等回复、再复制回来……来回切换窗口的烦躁，足够浇灭一半创作热情。

更麻烦的是，网页版 AI 根本看不到你的知识库全貌。它不知道你写过什么、不知道"上个星期整理的那篇笔记"在哪里，只能靠你手动喂上下文。

Claudian就是来终结这个场景的。它是一款专为 Obsidian 设计的开源插件，把 Claude Code、Codex、Grok、OpenCode、Pi 等主流 AI 编码代理直接嵌入你的笔记软件，让 AI 变成知识库里的"同事"——你的 vault 就是它的工作目录，读文件、写笔记、搜内容、执行命令、多步骤任务，全都开箱即用。

先看它长什么样

下面是 Claudian 在 Obsidian 里的真实运行界面：左侧是你的笔记内容，右侧是 AI 对话面板，你在笔记里选中文字、在面板里下达指令，AI 直接在库内帮你改写、整理、生成内容。

它不是聊天机器人，是你的"驻库员工"

理解 Claudian，关键在一句话：让代码级 AI 代理以你的笔记库为工作区运行。

过去 Obsidian 里的 AI 插件大多是"问答式"的——把选中的文本发给接口，返回一段文字。而 Claudian 用的是真正意义上的 Agent 架构：AI 可以在你的 vault 里自由读写文件、运行命令、跨笔记搜索、规划并执行多步骤任务。你在聊天里说一句"把本周所有会议记录整理成行动项清单"，它会自己去翻文件、归纳、生成新笔记。

这就是核心关键词：AI 协作伙伴（AI collaborator）。配套的长尾词是"Obsidian AI 插件"和"Claude Code 嵌入笔记软件"。

三分钟完成环境配置

Claudian 的上手路径很短，按下面三步走就行。

第一步：安装插件

最省事的方式是直接从 Obsidian 社区插件市场安装：

1. 打开 Obsidian → 设置 → 第三方插件（Community plugins）→ 浏览
2. 搜索Claudian
3. 点击安装并启用

想自己动手编译也没问题。把仓库 clone 到 vault 的插件目录，然后安装依赖并构建：

git clone https://gitcode.com/GitHub_Trending/cl/claudian npm install npm run build

然后在 Obsidian 的第三方插件设置里启用即可。注意：Claudian 仅支持桌面端（macOS、Linux、Windows），需要 Obsidian v1.7.2 以上版本。

第二步：准备一个 AI 运行时

Claudian 本身不提供模型，它是"胶水层"——需要你本机装有至少一个编码代理 CLI，比如 Claude Code、Codex、Grok Build、OpenCode 或 Pi。搭配对应的订阅或 API 服务商（OpenRouter、Kimi、GLM、DeepSeek 等）即可运行。

装好 CLI 后，Claudian 会自动探测路径。如果探测失败，在设置 → Advanced 里手动指定即可。

第三步：打开侧边栏，开始对话

从功能区的 ribbon 图标或命令面板打开聊天面板。现在你可以像使用 Claude Code 一样和 AI 对话——它读你库里的文件、改笔记、建目录，一切都发生在 Obsidian 内部。

六个会改变你工作方式的实用功能

1. 行内编辑：选中即改，带逐字 diff 预览

在笔记里选中一段文字，按快捷键触发行内编辑，AI 会在原位置直接改写，并用词级 diff 高亮显示改动前和改动后的差异，确认后一键应用。写论文、改文案、修代码片段时，这个体验比"复制出去再粘贴回来"顺滑太多。核心实现见 src/features/inline-edit/ui/InlineEditModal.ts。

2. 计划模式：先想清楚，再动手

按Shift+Tab切换计划模式。AI 先探索你的笔记库、理解需求、给出实施计划，经你批准后才真正执行修改。对重要文档、团队共用的知识库来说，这层"审批闸门"能避免 AI 乱改内容。

3. 斜杠命令与技能：把常用指令沉淀下来

输入/触发内置命令，比如clear开启新会话、resume恢复历史对话、fork把整段对话分叉到新会话。输入$可以调用技能（Skills）——相当于可复用的提示词模板，分为用户级和知识库级两个范围，团队可以共享一套标准工作流。内置命令的定义见 src/core/commands/builtInCommands.ts。

4. @提及：把任意上下文拖进对话

输入@可以直接提及知识库里的文件、子代理，甚至是 vault 外部的目录文件。想让 AI 基于某篇笔记、某个外部文件夹里的资料来做任务，不用手动复制粘贴，一个 @ 就搞定。

5. 指令模式：给 AI 定制"工作守则"

输入#打开指令模式，从聊天输入框补充精细化的自定义指令，让 AI 在本次会话中遵守你写的规则——比如"回复用中文，语气像产品文档"。

6. 多标签与会话管理：像浏览器一样管理 AI 会话

Claudian 支持多个标签页并行运行不同的 AI 会话：单面板模式下用标签切换，双面板模式下可以把持久化的会话管理器放在聊天区旁边。配合resume命令，随时回到之前的对话继续工作，历史会话由各代理原生的存储机制管理。

连接外部工具：MCP 服务器

Claudian 支持通过每个编码代理自带的 CLI 管理 MCP 配置，从而把外部工具接入工作流。也就是说，AI 不仅能读写笔记，还能调用你配置好的外部服务，把 Obsidian 变成 AI 的中枢操作台。

一个插件，五家 AI 任你切换

Claudian 最大的差异化在于Provider 无关：Claude Code、Codex、Grok、OpenCode、Pi 都在支持之列，你可以在不同标签页里跑不同的 AI，按任务选"人"。

这种多代理架构在代码里体现得很清晰：src/providers/目录下每个子目录对应一家代理的适配器，比如 claude、codex、grok、opencode、pi，以及统一的 acp 传输层。上层则是一套 Provider 无关的核心运行时，定义在 src/core/，新代理接入不影响整体架构。

另外，插件的界面文案支持 10 种语言（i18n 目录下可见 en、zh-CN、ja、ko 等语言包），对中文用户非常友好。

隐私设计：没有遥测，不搞小动作

对笔记类工具，隐私是硬要求。Claudian 在这方面的原则很清晰：

• 不运行遥测信标，没有后台偷偷上报数据的行为
• 界面轮询定时器只读取本地 Obsidian 编辑器的选中状态
• 网络活动仅限于你明确触发的 AI 运行时调用、已配置的 MCP 端点，以及回答请求所需的 SDK/CLI 调用

也就是说，你的数据去向取决于你选了哪家 provider，插件本身不做多余的小动作。

常见问题排查

如果 Claude CLI 找不到，典型的报错是spawn claude ENOENT或Claude CLI not found。常见原因是 Node 版本管理器（nvm、fnm、volta）导致 PATH 不完整。解决方法是：

• 先用which claude找到可执行文件路径
• 在设置 → Advanced → Claude CLI path 中手动指定
• 或者把 Node 的 bin 目录加到 PATH 里

如果用的是 npm 安装的 CLI，还要确保它的可执行文件路径和 Node.js 在同一个环境变量环境下，否则 Obsidian 这样的 GUI 应用可能找不到 Node。建议优先安装原生二进制版本。

下一步：从一篇笔记开始

Claudian 的价值不在于"多了个聊天框"，而在于它打破了"知识库"和"AI"之间的墙。你不用再搬运内容，AI 直接住在你的笔记里工作。

如果它是你需要的工具，行动路径很简单：安装插件 → 装好任一编码代理 CLI → 打开侧边栏，让它帮你整理今天写的那篇笔记。五分钟就能感受到差别。

想深入了解插件的能力边界和内部实现，可以查看项目里的 README.md 和 src/features/chat/ 源码。遇到问题，项目的 CONTRIBUTING.md 也说明了如何参与贡献与反馈。

把 AI 请进知识库，就从 Claudian 开始。

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