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/claudianClaudian 插件把 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 CLICodex CLIGrok BuildOpenCodePi两个硬性限制要留意Claudian 仅支持桌面端macOS、Linux、Windows且要求 Obsidian v1.13.0 及以上版本。如果版本不满足社区市场里可能直接搜不到或装不上。发起第一次对话提示找不到 CLI怎么排查从左侧边栏的 ribbon 图标或命令面板打开对话侧边栏就可以开始说话。第一次可以给它一个贴近日常的任务打开当前这篇笔记用三句话总结我的观点并列出 5 个可以补充的论据。如果回话提示找不到 CLI常见报错是spawn claude ENOENT或Claude CLI not found通常是图形界面应用读不到终端里的 PATH 所致nvm、fnm、volta 这类 Node 版本管理器尤其容易踩坑。排查分两步先在系统终端确认 CLI 真实路径macOS/Linux 用which claudeWindows 用where.exe claude。回到 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 敢动手、又守规矩先出计划批准后再执行按ShiftTab可以切到计划模式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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claudian 插件三步上手指南：把 Claude Code 装进 Obsidian，让 AI 直接参与笔记协作
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/claudianClaudian 插件把 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 CLICodex CLIGrok BuildOpenCodePi两个硬性限制要留意Claudian 仅支持桌面端macOS、Linux、Windows且要求 Obsidian v1.13.0 及以上版本。如果版本不满足社区市场里可能直接搜不到或装不上。发起第一次对话提示找不到 CLI怎么排查从左侧边栏的 ribbon 图标或命令面板打开对话侧边栏就可以开始说话。第一次可以给它一个贴近日常的任务打开当前这篇笔记用三句话总结我的观点并列出 5 个可以补充的论据。如果回话提示找不到 CLI常见报错是spawn claude ENOENT或Claude CLI not found通常是图形界面应用读不到终端里的 PATH 所致nvm、fnm、volta 这类 Node 版本管理器尤其容易踩坑。排查分两步先在系统终端确认 CLI 真实路径macOS/Linux 用which claudeWindows 用where.exe claude。回到 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 敢动手、又守规矩先出计划批准后再执行按ShiftTab可以切到计划模式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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考