# Claudian - Obsidian AI 协作插件

> 在 Obsidian 中嵌入 Claude Code，让 Vault 变成 AI 的工作目录
>
> 归档：2026-04-22

---

## 项目信息

| 项目 | 数据 |
|------|------|
| **仓库** | https://github.com/YishenTu/claudian |
| **Stars** | ⭐ 8,887 |
| **类型** | Obsidian 插件 |
| **许可证** | MIT |

---

## 核心功能

| 功能 | 说明 |
|------|------|
| 🖥️ **嵌入式 AI** | Claude Code 集成到 Obsidian 侧边栏 |
| 📁 **文件操作** | 读写、搜索、执行 bash 命令 |
| ✏️ **内联编辑** | 选择文本 + 热键，直接编辑并预览 diff |
| ⚡ **斜杠命令** | `/` 或 `$` 触发可复用 prompt 模板 |
| 🏷️ **@提及** | 引用 vault 文件、MCP 服务器、外部文件 |
| 📋 **计划模式** | Shift+Tab 让 AI 先探索设计再执行 |
| 🔧 **MCP 支持** | 连接外部工具（stdio、SSE、HTTP） |
| 💬 **多标签对话** | 多会话、fork、恢复、压缩 |

---

## 核心概念

### AI 作为工作目录

> **你的 Vault 变成 AI 的工作目录**

- AI 可以读写笔记文件
- 可以执行搜索和 bash 命令
- 支持 Claude Code 和 Codex CLI 两种 provider
- 与现有的 Obsidian 工作流无缝集成

### Inline Edit

选择文本或光标位置 + 热键，直接在笔记中编辑，带 word-level diff 预览。

### Slash Commands & Skills

输入 `/` 或 `$` 触发可复用的 prompt 模板，作用域支持用户级和 vault 级。

### @mention

输入 `@` 引用：
- Vault 文件
- 子 agent
- MCP 服务器
- 外部目录文件

### Plan Mode

Shift+Tab 切换：
1. AI 先探索并设计方案
2. 呈现计划给用户审批
3. 用户批准后才执行

### MCP Servers

连接外部工具：
- stdio
- SSE
- HTTP

---

## 安装方式

### 方式一：BRAT（推荐）

1. 安装 BRAT 插件
2. BRAT 设置 → 添加 Beta plugin
3. 输入：`https://github.com/YishenTu/claudian`
4. 启用插件

### 方式二：手动安装

1. 下载 [最新 release](https://github.com/YishenTu/claudian/releases/latest)
2. 复制文件到 `.obsidian/plugins/claudian/`
3. 启用插件

### 方式三：源码编译

```bash
git clone https://github.com/YishenTu/claudian.git
cd claudian
npm install
npm run build
```

---

## 系统要求

| 项目 | 要求 |
|------|------|
| Obsidian | v1.4.5+ |
| 平台 | 仅桌面端（macOS/Linux/Windows） |
| Claude | Claude Code CLI + API 订阅 |

---

## 隐私说明

| 类型 | 说明 |
|------|------|
| 发送至 API | 输入、附加文件、图片、工具输出 |
| 本地存储 | 设置、会话元数据、转录本 |
| 遥测 | **无额外追踪** |

---

## 与 OpenClaw 的对比

| 功能 | Claudian | OpenClaw |
|------|----------|----------|
| 集成方式 | Obsidian 插件 | 独立助手 |
| 文件操作 | ✅ 直接读写 vault | ✅ 可访问 Obsidian |
| MCP 支持 | ✅ | ✅ |
| 内联编辑 | ✅ | ❌ |
| 多会话 | ✅ | ✅ |

---

## 相关资源

| 资源 | 链接 |
|------|------|
| GitHub | https://github.com/YishenTu/claudian |
| Claude Code | https://code.claude.com |
| BRAT 插件 | https://github.com/TfTHacker/obsidian42-brat |

---

## AI工程索引

其他笔记：
- [[INDEX_AI工程]] - AI工程知识索引

---

*整理：知识库管理员 | 归档：2026-04-22*