claudian

在 Obsidian 里"召唤"AI程序员：Claudian让笔记瞬间变成开发环境

当你正在 Obsidian 里整理一篇长文档，突然想给某段文字加个代码示例，或者想把笔记里的一堆片段重构成一个完整脚本——传统做法是什么？切换窗口、打开 IDE、写代码、再复制回来。一顿操作猛如虎，回头一看笔记还是那个笔记。

Claudian 带来了一种完全不同的体验：直接在 Obsidian 的侧边栏里召唤 AI 编程助手（Claude Code、Codex、Opencode 等），你的整个笔记库就是它的工作目录。它可以读取你的笔记、写新文件、运行搜索、执行 bash 命令——所有操作都在 Obsidian 里完成，不用跳出当前工作流。 图1：项目作者 YishenTu 的 GitHub 头像

项目起源：一位重度 Obsidian 用户的"不得已而为之"

开发者的 GitHub 主页显示，YishenTu 是一位深度使用 Obsidian 的知识工作者。在积累了大量笔记之后，他开始意识到一个问题：Obsidian 非常适合"知识的输入和整理"，但一旦涉及"知识的输出"——比如写代码、写脚本、做自动化——就必须要跳出 Obsidian，去别的工具里操作。

"能不能就在 Obsidian 里完成这些？"带着这个问题，他开发了 Claudian，将 AI 编程 agent 的能力直接嵌入 Obsidian 的侧边栏。根据项目 README 的描述，这个插件经历了从 1.x 到 2.x 的重大架构升级，当前版本 2.0.18 稳定支持 Claude Code、Codex 和 Opencode 三大主流 AI 编程工具，在 GitHub 上已获得 11,957 颗星，并在 Obsidian 社区插件市场中上架。

核心能力：不是聊天机器人，是真正能"干活"的AI搭档

Claudian 的定位不是"问答机器人"，而是能执行多步骤任务的 AI 编程搭档。以下是几个最实用的功能场景：

1. 侧边栏对话 + 文件操作

打开 Claudian 侧边栏，直接用自然语言向 AI 描述任务，比如"帮我把这个文件夹里的所有 Markdown 标题提取到一个新文件里"。AI 会读取笔记、执行搜索、写入新文件——整个过程你都能在侧边栏的对话里追踪。

2. 行内编辑（Inline Edit）

选中文本，按快捷键，AI 直接在原文位置做修改，并显示词级别的 diff 预览。适合对代码片段、格式、措辞做快速调整，不需要开一个完整的对话窗口。

3. 斜杠命令和 Skills（/ 和 $）

输入 / 调出可复用的提示模板，输入 $ 调出项目级的 Skills（可跨会话使用）。 Claudian 支持 vault 级别和用户级别的两层作用域，高级用户可以自定义大量自动化工作流。

4. @提及系统（@mention）

输入 @ 可以提及任何东西：vault 里的文件、外部目录里的文件、MCP 服务器、外部 agent。这意味着你不仅可以让 AI 操作当前笔记，还能让它处理任意外部资源——比如读取一个本地 PDF、调用一个 MCP 工具。

5. Plan Mode（Shift+Tab）

让 AI 先"思考"再执行。开启 Plan Mode 后，AI 会先探索你的笔记库，理解你的需求，设计出解决方案，再呈现给你确认后才真正执行。这对于复杂任务尤其有用，避免 AI 跑偏。

6. MCP 服务器集成

支持 Model Context Protocol（stdio、SSE、HTTP 三种传输方式），可以连接各种外部工具和服务。这让 Claudian 的能力边界大大扩展——你可以通过 MCP 接入数据库、API、搜索工具等各种外部系统。

技术架构：Provider 中立的多 agent 运行时

Claudian 的代码架构设计得非常清晰，体现了作者对"可扩展性"的深度思考：

src/
├── core/           # Provider 中立的核心运行时
│   ├── runtime/    # ChatRuntime 接口
│   ├── providers/  # Provider 注册表
│   ├── mcp/        # MCP 协议支持
│   └── tools/      # 工具定义
├── providers/
│   ├── claude/     # Claude SDK 适配器
│   ├── codex/      # Codex JSON-RPC 适配器
│   └── opencode/   # Opencode 适配器
└── features/
    ├── chat/       # 侧边栏聊天 UI
    ├── inline-edit/# 行内编辑功能
    └── settings/   # 设置界面

架构核心思想是**"Provider 中立"**：ChatRuntime 是核心接口，不同的 AI provider（Claude、Codex、Opencode）各自实现自己的适配器，但都接入同一个核心运行时。这意味着未来增加新的 AI provider 只需要新增一个适配器，不需要改动核心逻辑。

代码库采用 TypeScript 完整类型定义 + Jest 测试套件 + ESLint 规范检查，代码质量较高。国际化支持 10 种语言，文档质量优秀。

隐私设计：数据只去你配置的地方

Claudian 明确承诺：不发遥测数据、不埋追踪代码。网络活动仅限于用户配置的 AI provider（Anthropic 或 OpenAI）和 MCP 端点。所有本地数据（设置、会话记录、 transcripts）都存在本地 vault 目录和用户 home 目录，不会发送到任何第三方。

局限与风险：桌面专属、provider 需要自己搞定

需要清醒认识 Claudian 的局限：

• 桌面专属：不支持移动端（iOS/Android），这是 Obsidian 插件的固有限制
• AI Provider 需自行配置：Claude Code CLI 需要自行安装，或者配置 OpenRouter/Kimi 等第三方兼容 provider
• Windows 路径陷阱：Windows 用户需要特别注意 CLI 路径格式（避免 .cmd/.ps1，推荐用 .exe 或 cli-wrapper.cjs）
• 多 provider 功能不一致：README 明确提到 Codex 和 Opencode 的功能可能不如 Claude 完整，需要更多测试

行业意义：AI-native 笔记工具的新范式

Claudian 代表了一个重要趋势：AI 能力从"工具层"下沉到"工作层"。传统的 AI 助手要么是独立产品（ChatGPT、Claude.ai），要么是 IDE 插件（Copilot）。Claudian 走出了第三条路——让 AI 直接嵌入个人知识管理系统，使"记笔记"和"写代码/做任务"之间的边界完全消解。

随着 AI 编程能力的持续提升，这类工具的价值会越来越明显。想象一下：你在 Obsidian 里积累了几年的笔记，某个 AI 可以基于这些笔记理解你的知识体系，然后帮你完成需要这些知识的各种任务——这才是"个人知识管理 + AI"的真正愿景。

总结评分：

• ⭐⭐⭐⭐⭐ 易用性：5/5（一键安装，直接在 Obsidian 里使用）
• ⭐⭐⭐⭐⭐ 创新性：5/5（开创性地将 AI agent 嵌入 PKM）
• ⭐⭐⭐⭐ 功能完整度：4/5（核心功能扎实，多 provider 还在完善）
• ⭐⭐⭐ 部署灵活性：3/5（桌面插件形态，不适合服务器）