Claudian 安装教程:把 Claude Code 装进 Obsidian,从安装到第一句对话的完整指南
2026/9/20 16:25:50 网站建设 项目流程

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 这类 AI 编程智能体直接在你的笔记库里干活:你的库就是它的工作目录,读、写、搜索、跑命令开箱即用。

它比终端 CLI 多了什么

如果你已经在终端里用过 Claude Code,可以把终端里的用法当成基准,Claudian 在这之上多了 4 件事:

  • 上下文自动关联:对话时当前打开的笔记和库内文件直接作为背景资料,不用手动粘贴路径。
  • 改动直接落在笔记里:每次修改以词级 diff 形式预览,哪些词被删、哪些被加,接受前看得一清二楚。
  • 整个库都是它的背景:全文搜索、跨文件引用,素材在库里,智能体也在库里。
  • 两个入口都有热键:侧边栏对话和行内编辑,不离开编辑器就能发起和结束任务。

Claudian Obsidian 插件安装教程:两种方式与环境检查

方式一:社区插件市场(推荐)。打开 Obsidian,进 设置 → 社区插件 → 浏览,搜索 "Claudian",安装并启用。整个过程 3 步。

方式二:源码构建。适合想跟进最新提交的用户:

cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian

接着依次运行npm installnpm run build,回 Obsidian 启用即可。日常开发用npm run dev开监听模式。

装之前先核对 3 条环境要求:

  • Obsidianv1.13.0 及以上
  • 仅桌面端(macOS、Linux、Windows),移动端没有界面
  • 至少装好 1 个智能体 CLI:Claude Code、Codex、Grok Build、OpenCode、Pi 任选其一,且准备对应的订阅或 API 额度

CLI 检测一条短命令就够了:macOS / Linux 用which claude,Windows 用where.exe claude,把查到的可执行文件路径填入 设置 → 高级 里的 CLI 路径项。

打开侧边栏,发第一条 Claude Code Obsidian 对话指令

从 Obsidian 左侧的 ribbon 图标,或命令面板里搜 "Claudian",打开对话侧边栏。第一次建议从当前笔记入手——上下文已经自动关联好了。下面 3 条指令都可以直接复制:

  • "总结当前笔记里我的核心观点,用 3 句话。"
  • "列出 5 个可以补充的论据,按可信度排序。"
  • "改写刚才选中的段落:更短、更口语化。"

四个高频玩法:行内编辑、命令、@ 提及与计划模式

行内编辑:改某一段、润色某句话时用。选中文字或把光标停在某处,按行内编辑热键,改动直接落在原文里,看词级 diff 再决定接受还是回退。

/$:重复的话术需要模板时用。敲/触发提示词模板,敲$调用 Skill,两者都分用户级和库级作用域,沉淀下来的审稿、翻译风格可以反复用。

@引用:让 AI 参考库内别的内容时用。敲@引用文件、文件夹或协作成员的改动,等于把背景资料附进对话,整理跨多篇素材时特别顺手。

计划模式:批量改写、结构调整这种大范围动作用。按 Shift+Tab 进入后,智能体先勘察库、给出完整方案,你批准后才开始改文件。

改库之前,你能管住什么

权限规则支持 2 种匹配:bash 命令按精确匹配或显式通配符,比如放行git *后所有 git 命令免审批;文件类工具按路径前缀匹配,写哪些目录你说了算,规则逻辑见 审批规则实现。隐私上,插件没有遥测,也没有后台网络活动——只有你发请求,或调用已配置的 MCP 端点时才联网。MCP 服务器可以挂外部工具,配置沿用各智能体原生的 CLI 管理方式,不额外学一套。会话方面,多标签页并行不同任务互不阻塞,双栏模式还有一个常驻会话管理器。界面语言内置 10 种,含简繁中文,目录在 多语言包。

新手最常踩的 4 个坑

CLI 路径找不到原因:GUI 应用的 PATH 里通常不含 nvm、fnm 这类版本管理器写入的目录。 解法:先把 CLI 路径设置留空让 Claudian 自动检测,失败再用which claude查出路径手动填入。

提示需要订阅或 API原因:插件本身免费,但每次对话消耗的是你所选提供方的额度。 解法:准备一个对应订阅或 API Key,OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入都可以用。

手机上打不开原因:Claudian 仅支持桌面端,它需要承载完整的多步 CLI 工作流。 解法:换到 macOS、Linux 或 Windows 桌面端使用。

装了多个智能体,不知怎么切换原因:每个智能体在设置里是独立的一套配置,没有装好就看不到。 解法:把要用的智能体在设置里逐个配好,对话时随时切换,各自历史互不干扰。

收尾:3 步行动清单

  1. 装好插件:社区市场搜索 "Claudian",安装并启用。
  2. 配好 CLI:装好 1 个智能体 CLI,用一条命令确认路径可达,必要时手动填入。
  3. 发第一句指令:打开侧边栏,说一句"总结当前笔记",剩下的上下文它自己会找。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询