ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

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

三步把 AI 协作者装进 Obsidian:Claudian 完整上手指南 三步把 AI 协作者装进 ObsidianClaudian 完整上手指南【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudianClaudian 是一个 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 重构一篇长笔记装好之后用左侧边栏的丝带图标或命令面板打开聊天侧栏一个完整的小案例长这样你有一篇黑洞图像生成提示词的笔记内容是一大段没分节的文字。在侧栏输入框里说把它整理成可读的分节格式内容一字不改只加分节和行距。智能体先执行一次读取文件侧栏显示Read: xxx.md思考两秒后执行编辑文件显示18 -1即新增 18 行、删除 1 行然后在对话里解释它的分节逻辑开头描述、关键物理、材质与遮挡、几何、中心、技术规格哪些部分它没动、为什么。你也可以走更轻量的路线直接在笔记里选中一段文字按快捷方式触发行内编辑inline editAI 会在原位置改写并给出词级别的 diff 预览你确认后才落到文件里。适合改一句话、润色一段这种小动作不用切到侧栏。进阶用法几个值得记住的输入符号熟悉基本流程后这几个符号能让效率再上台阶输入/或$呼出可复用的提示词模板Skills。比如你每周都用同一段话术整理会议纪要把它存成模板之后敲一下就能调出来。输入引用 vault 里的文件、文件夹让智能体明确基于哪份材料回答。输入#在协作模式下引用工单。输入/instruction把一段自定义指令保存下来反复使用/resume可以找回之前的对话/fork把当前会话分叉成新的分支继续试。会话管理也分两种形态单面板模式下用多个标签页切换对话双面板模式下聊天旁挂一个持久化的会话管理器适合同时推进好几个整理任务。另外两条进阶路径MCPModel Context Protocol给 AI 挂外部工具的标准协议可以直接用各智能体 CLI 原生的配置接入外部工具Collab 模式实验特性支持局域网内多人协作共享项目需要本机装好 Git。常见坑CLI 找不到是头号问题装好插件后如果对话报spawn claude ENOENT或CLI not found9 成是智能体 CLI 没被 Obsidian 找到而不是插件本身坏了。按顺序排查先用 nvm、fnm、volta 这类 Node 版本管理器装 CLI 的人最容易踩中这个坑——GUI 应用继承的 PATH 和终端里的不一样。先让设置里的 CLI 路径保持空值走自动探测失败了再去终端敲which claude拿到真实路径填到 设置 → 高级 → CLI 路径。Windows 用户注意别填.cmd或.ps1这类包装脚本原生安装填claude.exenpm 安装的填对应的cli-wrapper.cjs。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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表