Claudian Obsidian 插件安装指南3 步把 Claude Code 搬进你的笔记库【免费下载链接】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 编码助手嵌进你的 Obsidian 侧边栏。装上之后你的笔记库直接变成 AI 的工作目录读文件、写文件、搜索、执行命令、跑多步任务全在笔记旁边完成不用在笔记软件和代码工具之间来回切换。值不值得上手它解决什么问题平时想把 AI 编码助手用在笔记上常见卡点有两个助手默认待在终端或代码编辑器里而你的内容在 Obsidian 库中每次都要手动复制粘贴复制过去之后AI 又看不到库里的其他文件没法跨笔记做搜索和批量修改。Claudian 把这两件事合二为一AI 的当前目录就是库本身它读写的是你库里的真实文件。它适合已经订阅 Claude Code、Codex 等编码助手想把它们用在知识库上的人希望笔记文件参与 AI 协作、但不想切换到代码编辑器的人想尝试多助手Claude / Codex / Grok / OpenCode / Pi统一在一个聊天面板里的人。它不适合需要移动端使用的人——插件目前仅支持 macOS、Linux、Windows 桌面版还没装任何 CLI 工具的人——至少要先装一个且要有对应的订阅或 API Key。准备清单安装前核对这 5 项项目要求是否必须Obsidian桌面版 v1.13.0 及以上是操作系统macOS / Linux / Windows仅桌面是CLI 工具Claude Code、Codex、Grok Build、OpenCode、Pi 五选一至少装一个是订阅 / API Key对应提供商的账号凭证或 OpenRouter、Kimi、GLM、DeepSeek 等兼容 API是Git仅使用协作模式Collab Mode实验功能时需要可选Node.js版本 24见.node-version仅源码构建时需要可选如果 CLI 是通过 nvm、fnm 这类 Node 版本管理器装的先留意这一点——后面排错会用到。安装全流程两条路径任选其一路径 A社区插件市场推荐3 步打开 Obsidian进入 设置 → 社区插件 → 浏览Browse。完成标志能看到插件搜索框和插件列表。在搜索框输入Claudian点击 安装Install。完成标志按钮变为已安装。回到插件列表开启 Claudian 的 启用 开关建议顺手重启一次 Obsidian。完成标志Obsidian 左侧边栏出现 Claudian 图标点一下会打开对话面板。路径 B从源码安装库的插件目录适合想跟进最新版或参与开发的人。把仓库克隆进库的插件目录cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian然后安装依赖并构建npm install npm run build构建产物会生成main.js和styles.css。回到 Obsidian设置 → 社区插件 → 启用 Claudian重启生效。完成标志插件在已安装列表中显示为 v2.2.6且重启后侧边栏出现图标。日常开发可用npm run dev进入监听模式改代码自动重新打包完整构建脚本见 package.json。跑通验收怎么确认装成功了装上就是这个样子左边是你的笔记右边是 AI 对话面板。验收时依次确认检查项预期结果侧边栏图标出现 Claudian 图标点击打开对话面板发一条消息比如总结这个库里的 README能正常回复工具调用展示面板顶部列出它读过的文件、编辑的文件并标注增删行数如 18 -1输入区底部有模型选择、思考档位Thinking: Low等控件可切换权限开关面板右下角的 Yolo 等权限档位可切换以上都正常说明安装成功可以进入日常使用。高频用法4 个最常用的操作场景输入操作产出就地改写一段文字在笔记里选中一段话触发内联编辑热键AI 在原文位置改写改动以词级差异标出一键接受或拒绝调用自定义命令输入/或$从下拉里选你保存的提示模板或 Skill用户级 / 库级作用域一条命令发出重复性工作流引用库内文件输入或#点名库里的文件 / 文件夹#引用协作票据被引用的内容直接喂进对话上下文多会话并行开多个 Tab单面板模式多标签或双面板模式在聊天旁挂一个持久会话管理器多个任务互不干扰内置命令速查命令作用/clear别名/new开始一段新对话/resume恢复之前的会话支持原生历史的提供商/fork把整个对话分叉到新会话/instruction从聊天输入保存一条可复用的自定义指令/fast切换快速模式仅 Codex此外还支持MCP 服务器通过各助手原生的 CLI 配置接入外部工具无需在 Claudian 里单独对接。卡点与处理3 类高频报错怎么解以下以 Claude Code 为例其他提供商思路相同。1. 提示 CLI 找不到spawn claude ENOENT/Claude CLI not found现象发第一条消息就报错说找不到 claude 命令。可能原因GUI 程序Obsidian拿不到终端里的 PATHnvm、fnm、volta 等版本管理器装的工具尤其常见。处理办法先把 设置 → 高级 → Claude CLI 路径 留空让 Claudian 自动检测大多数情况能解决。仍不行就查出实际路径再手动填平台命令示例路径macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindowsnpm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjsWindows 注意避免.cmd和.ps1包装器原生装用claude.exe包管理器装用cli-wrapper.cjs。 备选方案把 Node.js 的 bin 目录加进 设置 → 环境 → 自定义变量。2. npm 装的 CLI 与 Node.js 不在同一目录现象CLI 明明装了插件还是连不上、或启动即失败。可能原因npm 全局安装的 CLI 依赖 Node而 Obsidian 这类 GUI 程序找不到那个 Node。处理办法两条命令对比一下目录dirname $(which claude) dirname $(which node)两个目录不一致时二选一装原生二进制版本推荐或在 设置 → 环境 里追加PATH/path/to/node/bin。3. 其他提供商Codex / OpenCode / Pi行为异常现象面板里没有对应模型或会话行为不对。可能原因该提供商的 CLI 未安装、未登录或路径同样没被 GUI 检测到。处理办法先在终端里确认该 CLI 能直接跑通再按第 1 类思路核对路径仍不行就看设置页里该提供商的配置与报错提示。各家 CLI 的安装文档在 README 的 Requirements 一节 都有链接。深入入口源码目录地图想继续往下走先看这几个目录完整结构见 README 的 Architecture 一节目录职责src/main.ts插件入口与整体装配src/app/应用服务、设置、存储以及协作Collab的基础设施src/core/不依赖具体提供商的运行时、注册表与类型契约src/providers/claude/Claude SDK 适配器、提示词编码、存储、MCP、插件src/providers/codex/Codex app-server 适配器、JSON-RPC 传输、JSONL 历史src/providers/grok/Grok Build ACP 适配器、原生历史、模型与工具src/providers/opencode/ 与 src/providers/pi/对应提供商的适配器实现src/features/chat/侧边栏聊天标签页、控制器、渲染器src/features/inline-edit/内联编辑弹窗与提供商支撑的编辑服务src/features/settings/设置界面外壳与提供商标签页src/i18n/10 种语言国际化下一步行动挑一个真实任务比如整理这个库里某篇长笔记的结构发出去看它读文件、出方案、改文件的完整流程跑通之后用/instruction把你高频使用的一条指令存成可复用模板。再往后可以去 官方文档 了解实验性的协作模式和别的 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 插件安装指南：3 步把 Claude Code 搬进你的笔记库
Claudian Obsidian 插件安装指南3 步把 Claude Code 搬进你的笔记库【免费下载链接】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 编码助手嵌进你的 Obsidian 侧边栏。装上之后你的笔记库直接变成 AI 的工作目录读文件、写文件、搜索、执行命令、跑多步任务全在笔记旁边完成不用在笔记软件和代码工具之间来回切换。值不值得上手它解决什么问题平时想把 AI 编码助手用在笔记上常见卡点有两个助手默认待在终端或代码编辑器里而你的内容在 Obsidian 库中每次都要手动复制粘贴复制过去之后AI 又看不到库里的其他文件没法跨笔记做搜索和批量修改。Claudian 把这两件事合二为一AI 的当前目录就是库本身它读写的是你库里的真实文件。它适合已经订阅 Claude Code、Codex 等编码助手想把它们用在知识库上的人希望笔记文件参与 AI 协作、但不想切换到代码编辑器的人想尝试多助手Claude / Codex / Grok / OpenCode / Pi统一在一个聊天面板里的人。它不适合需要移动端使用的人——插件目前仅支持 macOS、Linux、Windows 桌面版还没装任何 CLI 工具的人——至少要先装一个且要有对应的订阅或 API Key。准备清单安装前核对这 5 项项目要求是否必须Obsidian桌面版 v1.13.0 及以上是操作系统macOS / Linux / Windows仅桌面是CLI 工具Claude Code、Codex、Grok Build、OpenCode、Pi 五选一至少装一个是订阅 / API Key对应提供商的账号凭证或 OpenRouter、Kimi、GLM、DeepSeek 等兼容 API是Git仅使用协作模式Collab Mode实验功能时需要可选Node.js版本 24见.node-version仅源码构建时需要可选如果 CLI 是通过 nvm、fnm 这类 Node 版本管理器装的先留意这一点——后面排错会用到。安装全流程两条路径任选其一路径 A社区插件市场推荐3 步打开 Obsidian进入 设置 → 社区插件 → 浏览Browse。完成标志能看到插件搜索框和插件列表。在搜索框输入Claudian点击 安装Install。完成标志按钮变为已安装。回到插件列表开启 Claudian 的 启用 开关建议顺手重启一次 Obsidian。完成标志Obsidian 左侧边栏出现 Claudian 图标点一下会打开对话面板。路径 B从源码安装库的插件目录适合想跟进最新版或参与开发的人。把仓库克隆进库的插件目录cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian然后安装依赖并构建npm install npm run build构建产物会生成main.js和styles.css。回到 Obsidian设置 → 社区插件 → 启用 Claudian重启生效。完成标志插件在已安装列表中显示为 v2.2.6且重启后侧边栏出现图标。日常开发可用npm run dev进入监听模式改代码自动重新打包完整构建脚本见 package.json。跑通验收怎么确认装成功了装上就是这个样子左边是你的笔记右边是 AI 对话面板。验收时依次确认检查项预期结果侧边栏图标出现 Claudian 图标点击打开对话面板发一条消息比如总结这个库里的 README能正常回复工具调用展示面板顶部列出它读过的文件、编辑的文件并标注增删行数如 18 -1输入区底部有模型选择、思考档位Thinking: Low等控件可切换权限开关面板右下角的 Yolo 等权限档位可切换以上都正常说明安装成功可以进入日常使用。高频用法4 个最常用的操作场景输入操作产出就地改写一段文字在笔记里选中一段话触发内联编辑热键AI 在原文位置改写改动以词级差异标出一键接受或拒绝调用自定义命令输入/或$从下拉里选你保存的提示模板或 Skill用户级 / 库级作用域一条命令发出重复性工作流引用库内文件输入或#点名库里的文件 / 文件夹#引用协作票据被引用的内容直接喂进对话上下文多会话并行开多个 Tab单面板模式多标签或双面板模式在聊天旁挂一个持久会话管理器多个任务互不干扰内置命令速查命令作用/clear别名/new开始一段新对话/resume恢复之前的会话支持原生历史的提供商/fork把整个对话分叉到新会话/instruction从聊天输入保存一条可复用的自定义指令/fast切换快速模式仅 Codex此外还支持MCP 服务器通过各助手原生的 CLI 配置接入外部工具无需在 Claudian 里单独对接。卡点与处理3 类高频报错怎么解以下以 Claude Code 为例其他提供商思路相同。1. 提示 CLI 找不到spawn claude ENOENT/Claude CLI not found现象发第一条消息就报错说找不到 claude 命令。可能原因GUI 程序Obsidian拿不到终端里的 PATHnvm、fnm、volta 等版本管理器装的工具尤其常见。处理办法先把 设置 → 高级 → Claude CLI 路径 留空让 Claudian 自动检测大多数情况能解决。仍不行就查出实际路径再手动填平台命令示例路径macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindowsnpm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjsWindows 注意避免.cmd和.ps1包装器原生装用claude.exe包管理器装用cli-wrapper.cjs。 备选方案把 Node.js 的 bin 目录加进 设置 → 环境 → 自定义变量。2. npm 装的 CLI 与 Node.js 不在同一目录现象CLI 明明装了插件还是连不上、或启动即失败。可能原因npm 全局安装的 CLI 依赖 Node而 Obsidian 这类 GUI 程序找不到那个 Node。处理办法两条命令对比一下目录dirname $(which claude) dirname $(which node)两个目录不一致时二选一装原生二进制版本推荐或在 设置 → 环境 里追加PATH/path/to/node/bin。3. 其他提供商Codex / OpenCode / Pi行为异常现象面板里没有对应模型或会话行为不对。可能原因该提供商的 CLI 未安装、未登录或路径同样没被 GUI 检测到。处理办法先在终端里确认该 CLI 能直接跑通再按第 1 类思路核对路径仍不行就看设置页里该提供商的配置与报错提示。各家 CLI 的安装文档在 README 的 Requirements 一节 都有链接。深入入口源码目录地图想继续往下走先看这几个目录完整结构见 README 的 Architecture 一节目录职责src/main.ts插件入口与整体装配src/app/应用服务、设置、存储以及协作Collab的基础设施src/core/不依赖具体提供商的运行时、注册表与类型契约src/providers/claude/Claude SDK 适配器、提示词编码、存储、MCP、插件src/providers/codex/Codex app-server 适配器、JSON-RPC 传输、JSONL 历史src/providers/grok/Grok Build ACP 适配器、原生历史、模型与工具src/providers/opencode/ 与 src/providers/pi/对应提供商的适配器实现src/features/chat/侧边栏聊天标签页、控制器、渲染器src/features/inline-edit/内联编辑弹窗与提供商支撑的编辑服务src/features/settings/设置界面外壳与提供商标签页src/i18n/10 种语言国际化下一步行动挑一个真实任务比如整理这个库里某篇长笔记的结构发出去看它读文件、出方案、改文件的完整流程跑通之后用/instruction把你高频使用的一条指令存成可复用模板。再往后可以去 官方文档 了解实验性的协作模式和别的 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），仅供参考