claudian 是什么?

Claudian 是一个 Obsidian 插件,把 AI 编码 agent(Claude Code、Codex、Opencode 等)嵌进你的 vault:你的笔记库就是 agent 的工作目录,文件读写、搜索、bash、多步工作流开箱即用。它把你熟悉的 Claude Code/Codex 体验搬进 Obsidian 侧边栏聊天,支持选中文本就地编辑(带词级 diff)、斜杠命令/Skills、@提及(vault 文件/subagent/MCP/外部目录)、Plan 模式、Instruction 模式、MCP server、多标签会话(fork/resume/compact)。TypeScript,MIT,桌面端(macOS/Linux/Windows,Obsidian 1.7.2+)。它不是新 agent,而是把现有编码 agent 接进知识库工作流的桥。

⭐ 10,631 Stars 🍴 637 Forks TypeScript MIT 作者: YishenTu
来源:README 顶部/Features & Usage/Requirements;GitHub desc,license MIT 查看 GitHub 仓库 →

为什么值得关注

约 1.16 万星,热度来自把『AI 编码 agent』和『Obsidian 知识库』两个高频工具打通:很多人用 Obsidian 管笔记/研究/写作,又想让 Claude Code/Codex 直接在 vault 里读写文件、改笔记、跑多步任务,而不必切到终端。Claudian 把这套体验原生嵌进 Obsidian,还做了就地编辑、@提及、Plan 模式等,对 Obsidian 重度用户和想用 agent 做知识工作的人很对路。

来源:GitHub 11,649 stars / 701 forks,created 2025-12-05;README 顶部

核心功能

vault 即 agent 工作目录

把 Obsidian vault 作为 Claude Code/Codex/Opencode 的工作目录,agent 可在其中读、写、编辑、搜索文件并跑 bash 与多步工作流,等于把终端编码 agent 的全部能力带进笔记库。

来源:README 顶部/Features & Usage
就地编辑 + 侧边栏聊天

从 ribbon 或命令面板开聊天侧栏;选中文本或在光标处用快捷键就地编辑笔记,带词级 diff 预览;多标签、会话历史、fork、resume、compact。

来源:README Features & Usage(Inline Edit/Multi-Tab)
斜杠命令/Skills + @提及 + 模式

输入 / 或 $ 用可复用提示词模板或 Skills(用户级与 vault 级);输入 @ 提及 vault 文件、subagent、MCP server 或外部目录文件;Shift+Tab 切 Plan 模式(先探索设计再实现、出计划待批),# 加自定义 Instruction。

来源:README Features & Usage(Slash Commands/@mention/Plan Mode/Instruction Mode)
多 provider + MCP

provider 中立:支持 Claude(Claude Code CLI,可接 Claude 订阅/API 或 OpenRouter/Kimi 等兼容 provider)、Codex CLI、Opencode;连外部工具走 MCP(stdio/SSE/HTTP),Claude 的 vault MCP 在应用内管、Codex 用其 CLI 管。

来源:README Features & Usage(MCP)/Requirements/Architecture
隐私意识 + 本地存储

无遥测信标,UI 轮询只读本地 Obsidian/编辑器选区状态;网络活动仅限显式 provider 运行、配置的 MCP 端点与 SDK/CLI 调用;设置/会话存 vault/.claudian/,Claude 文件在 vault/.claude/,转写在 ~/.claude/projects/ 与 ~/.codex/sessions/。

来源:README Privacy & Data Use

技术架构

TypeScript(Bun/esbuild)写的 Obsidian 插件,provider 中立分层清晰:core/ 是 provider 无关运行时(ChatRuntime 接口与审批类型、provider 注册与 workspace 服务、bootstrap 装配、security 审批、commands/mcp/prompt/storage/tools/types);providers/ 下每家一个适配器——claude(Claude SDK 适配、提示词编码、存储、MCP、插件)、codex(app-server 适配、JSON-RPC 传输、JSONL 历史)、opencode、acp(Agent Client Protocol 共享传输);features/ 是 chat(侧栏聊天的标签/控制器/渲染器)、inline-edit(就地编辑模态与编辑服务)、settings(带 provider tab 的设置);shared/ 复用 UI、i18n(10 语言)、utils、style。main.ts 是插件入口。它本身不实现 agent,而是把各家 CLI/SDK 适配成统一运行时、再用 Obsidian UI 把聊天与就地编辑包出来,vault 作工作目录。整体是『provider 中立运行时 + 各 agent 适配器 + Obsidian 聊天/编辑 UI + MCP/Skills/会话管理』的笔记库 agent 集成插件。

来源:README Architecture;tree(src/core、src/providers、src/features)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code CLI / Codex CLI / Opencode(外部 agent)Claude Code CL… Claude SDK / app-server JSON-RPC / ACP(适配)Claude SDK / a… MCP(stdio/SSE/HTTP)MCP(stdio/SSE… Obsidian API vault 即 agent 工作目录vault 即 agent 工作… 就地编辑 + 侧边栏聊天 斜杠命令/Skills + @提及 + 模式斜杠命令/Skills + @… 多 provider + MCP 隐私意识 + 本地存储 claudian 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架Obsidian 插件(Bun + esbuild)
Claude Code CLI / Codex CLI / Openco…Claude SDK / app-server JSON-RPC / A…MCP(stdio/SSE/HTTP)Obsidian API
桌面 Obsidian(macOS/Linux/Windows,1.7.2+);需本机装对应 agent CLI;可接 Claude 订阅/API 或 OpenRouter/Kimi 等兼容 provider
来源:README Requirements/Architecture;package.json

快速上手

前置:桌面 Obsidian 1.7.2+,并装好至少一个 agent CLI——Claude 用 Claude Code CLI(接 Claude 订阅/API 或 OpenRouter/Kimi 等),可选 Codex CLI、Opencode。安装:从 Obsidian 社区插件市场装(推荐),或下 GitHub Release,或从源码(bun + esbuild watch/build)。装好后从 ribbon/命令面板开聊天侧栏,选中文本 + 快捷键就地编辑,用 / $ 调命令/Skills、@ 提及文件/MCP、Shift+Tab 进 Plan 模式。设置里配 provider、环境变量与 MCP。CLI 找不到等问题见 Troubleshooting。
来源:README Installation/Requirements/Features & Usage

使用场景

适合:①Obsidian 重度用户,想让 Claude Code/Codex 直接在 vault 里读写笔记、整理资料、跑多步任务而不切终端;②做研究/写作/知识管理、想要 agent 就地编辑(带 diff)与 Plan 模式的人;③想在一个界面里用多家 agent(Claude/Codex/Opencode)并接 MCP 的人;④注重隐私、希望无遥测、数据留本地 vault 的人。不适合:不用 Obsidian 的人;移动端用户(仅桌面);以及不愿装 agent CLI、只想纯 GUI 零配置的人。

来源:README Features & Usage/Requirements,结合定位推断

优势与局限

优势

  • 打通两个高频工具:把 Claude Code/Codex 的编码 agent 能力原生带进 Obsidian 知识库,vault 即工作目录
  • 体验完整:就地编辑带词级 diff、斜杠命令/Skills、@提及、Plan/Instruction 模式、多标签会话 fork/resume/compact
  • provider 中立、可扩展:claude/codex/opencode/acp 适配器分层清晰,可接多家或兼容 provider + MCP
  • 隐私友好:无遥测、数据留本地 vault、网络仅限显式 provider/MCP 调用
  • 工程规范(10 语言 i18n、测试、模块化),社区大、迭代极快、MIT

局限

  • 强依赖外部 agent CLI(Claude Code/Codex/Opencode)与对应订阅/API,需自行安装与认证,门槛不低
  • 仅桌面 Obsidian,移动端不可用
  • agent 在 vault 里跑 bash/改文件有误操作风险,需用 Plan 模式与审批把关
  • 本质是集成层,能力与质量取决于底层 agent 与模型,自身不解决 agent 质量问题
  • 面向已用 Obsidian 的人,非 Obsidian 用户无从受益
来源:README Requirements/Privacy/Architecture;依赖外部 agent 的性质

最新版本

在 Obsidian 社区插件市场与 GitHub Release 发布,主分支高频更新(最近 push 2026-05-23,创建于 2025-12-05)。Roadmap 已完成 1M 上下文 Opus/Sonnet、Codex 与 Opencode 集成,处于成熟且活跃迭代的阶段。

来源:GitHub pushed_at 2026-05-23;README Installation/Roadmap

总结评价

Claudian 解决的是一个很自然的需求:很多人用 Obsidian 管笔记和研究,又想让 Claude Code/Codex 直接在 vault 里读写文件、改笔记、跑多步任务,而不必切到终端。它把这套体验原生嵌进 Obsidian——就地编辑带 diff、斜杠命令/Skills、@提及、Plan 模式、多 provider + MCP,还做得隐私友好、provider 中立、工程规范,1.16 万星说明这个交叉点很有人要。要清楚它是『集成层』:依赖外部 agent CLI 与订阅、仅桌面、能力受底层 agent 决定、agent 在 vault 跑 bash 也需审批把关。对 Obsidian 重度用户、想用 agent 做知识工作的人,这是目前把编码 agent 接进笔记库最完整的方案;不用 Obsidian 的人则不需要。

来源:综合 README 定位/功能/隐私、tree 架构、依赖与平台限制的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 16:49. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件