Claudian Obsidian 插件完整使用指南把 Claude Code 等 AI 智能体接入笔记库的 5 个步骤【免费下载链接】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、Grok、OpenCode、Pi 这类编程智能体直接嵌进你的笔记库。装好之后库目录就是智能体的工作目录读笔记、改文件、全文搜索、跑命令、执行多步任务开箱就能用。这篇文章按读者要完成的任务来组织先讲清安装和环境准备再逐一拆解聊天、行内编辑、命令体系和权限管理怎么用最后汇总常见报错的排查路径。读完并照做你能在自己的库里跑通第一次对话并让 AI 直接改动一篇笔记。它适合两类人已经在用 Claude Code 或 Codex CLI、想把整理素材、改写长文这类工作从终端挪到编辑器里的用户以及想在团队里沉淀固定写作规则审稿标准、术语表、排版规范的人。全程不需要读源码只需提前备好桌面版 Obsidian 和至少一个智能体 CLI。安装 Claudian 插件前的环境与安装配置步骤 最省事的安装路径是社区插件市场打开 Obsidian → 设置 → 社区插件 → 浏览搜索 Claudian点击安装后启用即可。有一个已知限制需要注意由于插件主文件超过 5 MB社区页面可能弹出大插件警告且官方 Obsidian Sync 无法同步这个文件。如果你用 Sync 管理多台电脑请在每台设备上分别安装和更新不要指望 Sync 帮你拷贝插件文件。想尝鲜最新版可以从源码构建。把仓库克隆到库的插件目录然后装依赖、构建最后在设置里启用插件克隆仓库并构建cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build在 Obsidian 的 设置 → 社区插件 中启用 Claudian开发调试时可改用npm run dev进入监听模式除了 Obsidian 本身插件还有四个前置条件缺一样都会装不上或跑不起来。其一至少装好一个底层 CLI 智能体Claude Code CLI、Codex CLI、Grok Build、OpenCode 或 Pi任选其一其二该智能体对应的订阅或 API 额度OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式均可其三Obsidian v1.13.0 及以上版本其四仅限桌面端macOS、Linux、Windows。如果你还想用实验性的 Collab 协作模式需要额外安装 Git。Claudian 核心功能速览侧边栏聊天、行内编辑与权限管理 入口是从左侧 ribbon 图标或命令面板打开聊天侧边栏。打开后当前正在读的笔记和整个库都是智能体的上下文它读你的素材、按你的指令搜索和改写产出直接落回笔记。单面板模式下可以同时开多个标签页并行处理不同任务双栏模式则让一个常驻的会话管理器始终贴在对话旁随时回到旧会话续写。行内编辑选中文字后让 AI 原地改写选中的一段文字或仅把光标停在某处触发 Inline edit 命令AI 就在笔记里直接改写结果以词级 diff 呈现——删掉什么、新增什么一目了然不满意直接拒绝回退。对润色、扩写、压缩、翻译长文特别顺手省掉了在聊天框和正文之间来回复制的步骤。它的界面实现在src/features/inline-edit/下触发时请确保当前处于 Markdown 视图否则会提示无法访问活动视图。斜杠命令、技能与 提及在输入框里敲/会弹出可复用的提示词模板敲$调用 Skills 技能二者都分用户级和库级两个作用域——把团队的审稿标准写成库级技能后任何成员一条$就能调用。敲可以引用库内文件、文件夹以及协作成员对项目的改动敲#则引用协作项目的工单。写文献综述时直接几篇参考笔记让它按引用格式重组内容比粘贴原文干净得多。指令模式与权限管理/instruction指令模式可以从聊天输入框追加细化的自定义要求比如所有回答用口语化中文不要改动代码块内部内容约束只作用于本次对话。权限体系是另一件放心事智能体每次读文件、写文件、跑命令都会列出具体动作供你审批你可以把高频安全操作设为免审批——bash 命令支持精确匹配和git *、npm:*这类显式通配符文件读写工具按路径前缀匹配规则逻辑在src/core/security/approvalRules.ts。MCP 服务器沿用各智能体原生命令行的那套配置插件内不重复造一套零学习成本。Claudian 常见报错排查CLI 找不到与路径配置 装完插件最常见的报错是spawn claude ENOENT或Claude CLI not found意思是 Obsidian 这个图形界面程序在 PATH 里找不到 CLI 可执行文件。使用 nvm、fnm、volta 这类 Node 版本管理器的用户尤其容易踩中因为终端里的 PATH 往往没被图形程序继承。排查顺序建议这样走先把设置里的 CLI 路径留空让插件自动探测探测失败再手动查路径填进去入口在 设置 → 高级 → Claude CLI path。查路径的命令和典型结果如下平台查询命令示例路径macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows 原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindows npm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjsWindows 用户注意两点不要用.cmd或.ps1包装文件原生安装填claude.exe包管理器安装填cli-wrapper.cjscli.js只是旧版 npm 包的遗留回退。另一个变体问题是 npm 安装的 CLI 与 Node.js 不在同一环境里用dirname $(which claude)和dirname $(which node)对比一下若目录不同要么改用原生二进制要么在 设置 → 环境 里加PATH/path/to/node/bin。Claudian 的联网与数据隐私说明需要说清数据去向你的输入、附加的文件和图片、工具调用的输出会发送到所选提供方——AnthropicClaude、OpenAICodex、xAIGrok或 OpenCode / Pi 中配置的第三方目的地可通过提供方设置和环境变量调整。除此之外Claudian 不跑任何遥测信标也没有非用户触发的后台网络活动只在响应你的请求、调用你已配置的 MCP 端点、以及你显式开启的 Collab 局域网协作这三类场景下联网。协作模式下项目 Git 数据与协调元数据只在受邀成员的本地网络设备之间直接传输不经过任何云端服务。使用 Claudian 前常见问题速查手机上能用吗不能。插件仅支持桌面端macOS、Linux、Windows因为它要承载完整的多步 CLI 工作流移动端跑不起来。支持国产模型吗支持。通过 OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式即可接入界面内置简繁中文等 10 种语言包位于src/i18n/。装了多个智能体怎么切换每个智能体在设置里独立配置聊天界面随时切换各自的会话历史互不干扰。Obsidian Sync 会同步插件吗主插件文件超过官方 Sync 的单文件上限不会同步。多台电脑需在每台设备上分别安装和更新。装好插件、确认which claude能查到 CLI 路径之后就可以做最小的一次验证从命令面板打开聊天侧边栏发一句总结当前这篇笔记的核心观点并列出五个可补充的论据。再选中一段文字触发 Inline edit接受一次词级 diff。这两步走完Claudian 的读写链路就全部通了剩下的技能沉淀和权限白名单配置可以等日常用起来之后逐步加。【免费下载链接】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 Obsidian 插件完整使用指南：把 Claude Code 等 AI 智能体接入笔记库的 5 个步骤
Claudian Obsidian 插件完整使用指南把 Claude Code 等 AI 智能体接入笔记库的 5 个步骤【免费下载链接】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、Grok、OpenCode、Pi 这类编程智能体直接嵌进你的笔记库。装好之后库目录就是智能体的工作目录读笔记、改文件、全文搜索、跑命令、执行多步任务开箱就能用。这篇文章按读者要完成的任务来组织先讲清安装和环境准备再逐一拆解聊天、行内编辑、命令体系和权限管理怎么用最后汇总常见报错的排查路径。读完并照做你能在自己的库里跑通第一次对话并让 AI 直接改动一篇笔记。它适合两类人已经在用 Claude Code 或 Codex CLI、想把整理素材、改写长文这类工作从终端挪到编辑器里的用户以及想在团队里沉淀固定写作规则审稿标准、术语表、排版规范的人。全程不需要读源码只需提前备好桌面版 Obsidian 和至少一个智能体 CLI。安装 Claudian 插件前的环境与安装配置步骤 最省事的安装路径是社区插件市场打开 Obsidian → 设置 → 社区插件 → 浏览搜索 Claudian点击安装后启用即可。有一个已知限制需要注意由于插件主文件超过 5 MB社区页面可能弹出大插件警告且官方 Obsidian Sync 无法同步这个文件。如果你用 Sync 管理多台电脑请在每台设备上分别安装和更新不要指望 Sync 帮你拷贝插件文件。想尝鲜最新版可以从源码构建。把仓库克隆到库的插件目录然后装依赖、构建最后在设置里启用插件克隆仓库并构建cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build在 Obsidian 的 设置 → 社区插件 中启用 Claudian开发调试时可改用npm run dev进入监听模式除了 Obsidian 本身插件还有四个前置条件缺一样都会装不上或跑不起来。其一至少装好一个底层 CLI 智能体Claude Code CLI、Codex CLI、Grok Build、OpenCode 或 Pi任选其一其二该智能体对应的订阅或 API 额度OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式均可其三Obsidian v1.13.0 及以上版本其四仅限桌面端macOS、Linux、Windows。如果你还想用实验性的 Collab 协作模式需要额外安装 Git。Claudian 核心功能速览侧边栏聊天、行内编辑与权限管理 入口是从左侧 ribbon 图标或命令面板打开聊天侧边栏。打开后当前正在读的笔记和整个库都是智能体的上下文它读你的素材、按你的指令搜索和改写产出直接落回笔记。单面板模式下可以同时开多个标签页并行处理不同任务双栏模式则让一个常驻的会话管理器始终贴在对话旁随时回到旧会话续写。行内编辑选中文字后让 AI 原地改写选中的一段文字或仅把光标停在某处触发 Inline edit 命令AI 就在笔记里直接改写结果以词级 diff 呈现——删掉什么、新增什么一目了然不满意直接拒绝回退。对润色、扩写、压缩、翻译长文特别顺手省掉了在聊天框和正文之间来回复制的步骤。它的界面实现在src/features/inline-edit/下触发时请确保当前处于 Markdown 视图否则会提示无法访问活动视图。斜杠命令、技能与 提及在输入框里敲/会弹出可复用的提示词模板敲$调用 Skills 技能二者都分用户级和库级两个作用域——把团队的审稿标准写成库级技能后任何成员一条$就能调用。敲可以引用库内文件、文件夹以及协作成员对项目的改动敲#则引用协作项目的工单。写文献综述时直接几篇参考笔记让它按引用格式重组内容比粘贴原文干净得多。指令模式与权限管理/instruction指令模式可以从聊天输入框追加细化的自定义要求比如所有回答用口语化中文不要改动代码块内部内容约束只作用于本次对话。权限体系是另一件放心事智能体每次读文件、写文件、跑命令都会列出具体动作供你审批你可以把高频安全操作设为免审批——bash 命令支持精确匹配和git *、npm:*这类显式通配符文件读写工具按路径前缀匹配规则逻辑在src/core/security/approvalRules.ts。MCP 服务器沿用各智能体原生命令行的那套配置插件内不重复造一套零学习成本。Claudian 常见报错排查CLI 找不到与路径配置 装完插件最常见的报错是spawn claude ENOENT或Claude CLI not found意思是 Obsidian 这个图形界面程序在 PATH 里找不到 CLI 可执行文件。使用 nvm、fnm、volta 这类 Node 版本管理器的用户尤其容易踩中因为终端里的 PATH 往往没被图形程序继承。排查顺序建议这样走先把设置里的 CLI 路径留空让插件自动探测探测失败再手动查路径填进去入口在 设置 → 高级 → Claude CLI path。查路径的命令和典型结果如下平台查询命令示例路径macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows 原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindows npm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjsWindows 用户注意两点不要用.cmd或.ps1包装文件原生安装填claude.exe包管理器安装填cli-wrapper.cjscli.js只是旧版 npm 包的遗留回退。另一个变体问题是 npm 安装的 CLI 与 Node.js 不在同一环境里用dirname $(which claude)和dirname $(which node)对比一下若目录不同要么改用原生二进制要么在 设置 → 环境 里加PATH/path/to/node/bin。Claudian 的联网与数据隐私说明需要说清数据去向你的输入、附加的文件和图片、工具调用的输出会发送到所选提供方——AnthropicClaude、OpenAICodex、xAIGrok或 OpenCode / Pi 中配置的第三方目的地可通过提供方设置和环境变量调整。除此之外Claudian 不跑任何遥测信标也没有非用户触发的后台网络活动只在响应你的请求、调用你已配置的 MCP 端点、以及你显式开启的 Collab 局域网协作这三类场景下联网。协作模式下项目 Git 数据与协调元数据只在受邀成员的本地网络设备之间直接传输不经过任何云端服务。使用 Claudian 前常见问题速查手机上能用吗不能。插件仅支持桌面端macOS、Linux、Windows因为它要承载完整的多步 CLI 工作流移动端跑不起来。支持国产模型吗支持。通过 OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的接入方式即可接入界面内置简繁中文等 10 种语言包位于src/i18n/。装了多个智能体怎么切换每个智能体在设置里独立配置聊天界面随时切换各自的会话历史互不干扰。Obsidian Sync 会同步插件吗主插件文件超过官方 Sync 的单文件上限不会同步。多台电脑需在每台设备上分别安装和更新。装好插件、确认which claude能查到 CLI 路径之后就可以做最小的一次验证从命令面板打开聊天侧边栏发一句总结当前这篇笔记的核心观点并列出五个可补充的论据。再选中一段文字触发 Inline edit接受一次词级 diff。这两步走完Claudian 的读写链路就全部通了剩下的技能沉淀和权限白名单配置可以等日常用起来之后逐步加。【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考