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 接进知识库工作流的桥。
来源: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 顶部把 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(用户级与 vault 级);输入 @ 提及 vault 文件、subagent、MCP server 或外部目录文件;Shift+Tab 切 Plan 模式(先探索设计再实现、出计划待批),# 加自定义 Instruction。
来源:README Features & Usage(Slash Commands/@mention/Plan Mode/Instruction Mode)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 UseTypeScript(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)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Claude Code CLI / Codex CLI / Openco…Claude SDK / app-server JSON-RPC / A…MCP(stdio/SSE/HTTP)Obsidian API适合:①Obsidian 重度用户,想让 Claude Code/Codex 直接在 vault 里读写笔记、整理资料、跑多步任务而不切终端;②做研究/写作/知识管理、想要 agent 就地编辑(带 diff)与 Plan 模式的人;③想在一个界面里用多家 agent(Claude/Codex/Opencode)并接 MCP 的人;④注重隐私、希望无遥测、数据留本地 vault 的人。不适合:不用 Obsidian 的人;移动端用户(仅桌面);以及不愿装 agent CLI、只想纯 GUI 零配置的人。
来源:README Features & Usage/Requirements,结合定位推断在 Obsidian 社区插件市场与 GitHub Release 发布,主分支高频更新(最近 push 2026-05-23,创建于 2025-12-05)。Roadmap 已完成 1M 上下文 Opus/Sonnet、Codex 与 Opencode 集成,处于成熟且活跃迭代的阶段。
来源:GitHub pushed_at 2026-05-23;README Installation/RoadmapClaudian 解决的是一个很自然的需求:很多人用 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 架构、依赖与平台限制的事实判断