Obsidian 社区插件

在你的知识库中
驾驭 AI 编程助手

将 Claude Code、Codex 和 Opencode 无缝嵌入 Obsidian vault。你的 vault 成为 AI 的工作目录——文件读写、终端命令、多步骤工作流，开箱即用。

免费安装 查看源码
v2.0.10 最新版本

专为知识工作者设计的 AI 编程体验

不只是聊天界面——Claudian 让 AI 真正理解并深度操作你的 Obsidian vault

  • 内联编辑

    选中文本或定位光标后按快捷键，直接在笔记中调用 AI 编辑。字级差异预览，精确控制每一处变更。

  • 斜杠命令与技能

    输入 / 或 $ 调用可复用的提示模板和技能库，支持 vault 级和用户级双重作用域，随时扩展你的工作流。

  • @提及引用

    在对话中输入 @ 快速引用 vault 文件、子代理、MCP 服务器或外部目录文件，AI 即刻获得完整上下文。

  • 计划模式

    Shift+Tab 切换计划模式。AI 先充分探索和设计方案，呈现完整计划供你审批，再执行实现——避免盲目操作。

  • 指令模式

    使用 # 从聊天输入框添加精细化自定义指令，实时调整 AI 的行为风格，无需离开当前对话。

  • MCP 服务器

    通过模型上下文协议连接外部工具，支持 stdio、SSE、HTTP 三种传输方式。Claude 支持应用内 MCP 管理。

  • 多标签对话管理

    同时维护多个独立聊天标签页，完整保留对话历史，支持分叉、恢复和上下文压缩。

  • 多提供商支持

    统一界面下无缝切换 Claude Code、Codex 和 Opencode，共享同一套对话模型和工作流体验。

支持的 AI 提供商

选择你熟悉的 AI 编程工具，在 Obsidian 中无缝使用

  • Claude Code

    完整支持

    Anthropic 旗舰 AI 编程助手。支持全部功能：内联编辑、MCP 管理、技能、子代理、插件集成及第三方兼容提供商（Openrouter、Kimi 等）。

  • Codex

    支持

    OpenAI Codex CLI 集成。支持发送、流式传输、取消、历史记录、分叉、计划模式、图片附件、内联编辑和 $ 技能。

  • Opencode

    支持

    新兴开源 AI 编程工具。Claudian 率先提供 Obsidian 原生集成，功能持续完善中。

了解更多

三分钟上手

选择最适合你的安装方式，快速将 AI 引入你的 vault

系统要求

  • Obsidian v1.4.5 或更高版本
  • macOS、Linux 或 Windows（仅桌面端）
  • Claude Code CLI（使用 Claude 提供商时必需）
  • Codex CLI 或 Opencode（可选）

前往 GitHub Release 页面，下载 main.js、manifest.json 和 styles.css

在 vault 的插件目录创建文件夹：<你的vault>/.obsidian/plugins/claudian/

将下载的三个文件复制到该文件夹

打开 Obsidian → 设置 → 社区插件 → 启用 Claudian

了解更多

常见问题

提示 "spawn claude ENOENT" 或 "Claude CLI not found" 怎么办？
插件无法自动找到 Claude CLI，通常发生在使用 nvm、fnm、volta 等版本管理器时。解决：先将设置中的 CLI 路径留空让 Claudian 自动检测；若仍失败，运行 which claude（macOS/Linux）或 where.exe claude（Windows）找到路径，在 设置 → 高级 → Claude CLI 路径 中手动填写。
npm 安装的 CLI 和 Node.js 不在同一目录怎么办？
运行 dirname $(which claude) 和 dirname $(which node) 检查是否在同一目录。若不同，推荐安装原生二进制版本，或在 设置 → 环境变量 中添加 PATH=/path/to/node/bin。
Codex 和 Opencode 支持哪些功能？
Codex 支持：发送、流式传输、取消、历史重载、分叉、计划模式、图片附件、内联编辑、$ 技能。暂不支持：回滚、运行时发现的提供商命令、应用内 MCP 管理和 Claude 插件集成。Opencode 功能仍在持续完善中。
Windows 上应使用哪个 CLI 路径？
原生安装使用 claude.exe；npm 安装通过 npm root -g 找到全局根目录，使用 cli-wrapper.cjs。避免使用 .cmd、.ps1 包装脚本和旧版 cli.js。
插件会收集我的数据吗？
Claudian 不收集任何遥测数据。发送到 API 的内容：你的输入、附件文件、图片和工具调用输出，发给你配置的 API 提供商（默认 Anthropic 或 OpenAI）。本地存储：vault/.claudian/（设置）和 vault/.claude/（Claude 提供商文件）。
支持哪些平台？
Claudian 仅支持桌面端（macOS、Linux、Windows），最低要求 Obsidian v1.4.5。不支持移动端（iOS/Android）。
文档 →
↑