企业官网建设流程全解析

Claudian 插件三步上手指南：把 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 插件把 Claude Code、Codex、Grok、OpenCode、Pi 这些 AI 编程智能体嵌入 Obsidian 知识库，让你的整个笔记库成为它们的工作目录。读完本文，你能完成 Claudian 插件的安装配置、跑通第一次对话，并掌握行内编辑、技能沉淀和权限管控这几项核心用法。

先看 Claudian 给知识库带来了什么

大多数人和 AI 写作的关系是"隔空投喂"：把内容复制进网页对话框，再把结果复制回笔记，来回倒手。Claudian 换了个思路——它不做聊天窗口，而是让智能体直接"住进"你的库：读文件、改文件、全文搜索、跑命令、执行多步流程，全部在 Obsidian 里就地完成。库里的每一篇笔记，天然就是它调用的背景资料。

这里有个前提概念值得先说清：Claudian 本身不内置模型，它调用的是你本机已安装的命令行智能体（也就是 Claude Code、Codex 这类在终端里干活的工具）。你只需要有对应服务的订阅或 API 额度，OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式也能用。

从源码分层也能看出它的设计意图：src/core/是跨智能体的公共运行时，src/providers/下每个目录对应一个智能体的适配层，src/features/chat/和src/features/inline-edit/分别承载侧边栏对话与行内编辑两个入口。这种结构意味着换后端、加智能体都很轻，你作为用户只需要知道"换一个 CLI 就行"。

安装 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

装完插件只是装好了"壳"，真正干活的是底层 CLI。下面任选其一即可：

• Claude Code CLI
• Codex CLI
• Grok Build
• OpenCode
• Pi

两个硬性限制要留意：Claudian 仅支持桌面端（macOS、Linux、Windows），且要求 Obsidian v1.13.0 及以上版本。如果版本不满足，社区市场里可能直接搜不到或装不上。

发起第一次对话，提示"找不到 CLI"怎么排查

从左侧边栏的 ribbon 图标或命令面板打开对话侧边栏，就可以开始说话。第一次可以给它一个贴近日常的任务：

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

如果回话提示找不到 CLI（常见报错是spawn claude ENOENT或Claude CLI not found），通常是图形界面应用读不到终端里的 PATH 所致，nvm、fnm、volta 这类 Node 版本管理器尤其容易踩坑。排查分两步：

1. 先在系统终端确认 CLI 真实路径：macOS/Linux 用which claude，Windows 用where.exe claude。
2. 回到 Obsidian 设置里手动填入这个路径。注意 Windows 上优先用原生安装的claude.exe或包管理器安装的cli-wrapper.cjs，避开.cmd、.ps1包装脚本。

更多细节可以翻仓库 README 的 Troubleshooting 章节，它按"CLI 找不到"、"Node 路径不一致"等情形逐一给了处置方案。

日常使用的两个入口：侧边栏对话与行内编辑

行内编辑：选中文字，原地改写

这是新手最容易上头的功能。选中一段文字（或让光标停在某处），按下热键，AI 就直接在笔记里动笔；改动以词级 diff 的形式预览——删了什么、加了什么，逐词可见，不满意立刻回退。润色、扩写、压缩、翻译都可以原地完成，对中文写作特别顺手。这个弹出窗口的实现集中在src/features/inline-edit/ui/InlineEditModal.ts。

@ 提及：把上下文"喂"给它

在输入框敲@，就能引用想让 AI 处理的对象：库内文件、子代理（subagents，可以理解为可复用的小任务执行器），甚至外部目录里的文件。比如写论文时直接@那篇参考文献笔记，让它按引用格式重组内容，不用手动复制粘贴。

# 指令模式：给本次对话加私规

在输入框敲#进入指令模式，把自定义要求追加到当前对话中，比如"回答用口语化中文""不要改动代码块内部内容"。它的作用范围是本次对话，不影响其他标签页里的会话。

把常用话术沉淀成斜杠命令与 Skills

输入框里敲/会弹出斜杠命令面板，里面是可复用的提示词模板；敲$则调用 Skills 技能。技能分"用户级"和"库级"两种作用域：用户级只属于你这个人，库级跟着笔记库走。

这个设计对协作场景价值很大：把团队的审稿标准、术语表、排版规范写成一个 Skill 放进库里，任何成员敲一个$就能以统一口径执行，方法论从此落在库中而不是某个人脑子里。命令与技能的发现、存储、运行时加载，都由src/core/providers/commands/统一管理。

计划模式与权限管控：让 AI 敢动手、又守规矩

先出计划，批准后再执行

按Shift+Tab可以切到计划模式（plan mode）。在这个模式下，AI 不会急着改文件，而是先搜库、勘察、给出完整方案，等你点头才动手。对"让 AI 全文巡视一遍再决定改哪"这类任务，比直接放行安全得多。

给命令和路径配白名单

Claudian 的权限规则支持精细到具体操作：bash 命令支持显式通配符（例如git *、npm:*这类写法），文件类工具支持路径前缀匹配。把高频且安全的命令设为免审批，把写库操作设为每次确认，审批负担和风险都能压下来。规则的具体匹配逻辑在 src/core/security/approvalRules.ts，感兴趣可以一读。

外接工具与并行会话

智能体还能通过 MCP 服务器（一种让 AI 调用外部工具的开放协议）接入外部工具，配置沿用各智能体原生命令行的管理方式，没有额外学习成本。会话方面，可以开多个标签页并行处理不同任务——一个起草周报，一个整理文献，互不阻塞；双栏模式下还有常驻的会话管理器躺在对话旁，随时回来接续上下文。

常见问题与进阶使用

Q：要联网和花钱吗？A：需要。你的输入、附加文件与工具调用结果会发到所选提供方（Anthropic、OpenAI、xAI 等），需要有对应订阅或 API 额度。

Q：笔记会被后台偷偷上传吗？A：不会。插件没有遥测信标，也不存在非用户触发的后台网络活动；只有你主动发请求，或调用已配置的 MCP 端点时才会联网。

Q：装了好几个智能体怎么切换？A：每个智能体在设置里独立配置，对话时随时切换，历史记录互不干扰。

Q：界面支持中文吗？A：内置简繁中文等 10 种语言包，代码在 src/i18n/，语言文件按语种分目录存放。

Q：手机端能跑吗？A：目前仅限桌面端，因为它要承载完整的多步 CLI 工作流。

几个进阶用法供参考：把权限白名单当"安全基线"来维护，每周过一遍免审批清单；用库级 Skill 固化团队方法论，新人入库即有章可循；大改动前强制走计划模式，让 AI 先交方案再执行。

想再深入一层，可以从 src/features/inline-edit/ 的行内编辑实现和 src/core/security/approvalRules.ts 的权限匹配规则入手——这两处代码不厚，却能帮你把"AI 到底能碰什么"这件事彻底想明白。装好插件、备好一个 CLI、发出第一句话，你的知识库就从"存东西的地方"变成了"能干活的地方"。

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