
claudian
在 Obsidian 笔记库里直接召唤 AI 代理干活
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 15869
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Obsidian 桌面版(插件需在桌面端运行,移动端通常不可用)
- 支持 Claude Code、Codex、Grok Build、OpenCode、Pi、DeepSeek Harness 等代理后端之一
- 一个本地笔记库(vault),插件会把库根目录作为代理工作目录
- README 未提供安装章节内容,具体步骤以插件市场页面为准
安装与启动步骤
-
1安装并打开 Obsidian
先安装 Obsidian 桌面客户端,创建一个笔记库或打开已有库,后续插件都在该库内生效。
-
2进入第三方插件设置
打开设置 → 第三方插件,关闭安全模式( Restricted Mode ),才能浏览和安装社区插件。
-
3搜索并安装插件
在社区插件市场搜索 realclaudian,确认作者与页面信息后点击安装,再点击启用。
-
4打开 Claudian 界面
点击左侧功能区(ribbon)的 Claudian 图标,或在命令面板中搜索 Claudian 命令打开对话界面。
-
5确认工作目录
库根目录即代理的工作目录,代理可读写、搜索文件并执行 bash,首次使用前建议先备份笔记库。
-
6按需使用功能
选中文本后用快捷键做 Inline Edit;输入 / 或 $ 调用斜杠命令与 Skills,输入 @ 引用库内文件或会话。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
代理后端 | 是 | 选择本次会话使用的代理,如 Claude Code、Codex、Grok Build 等 | Claude Code |
Inline Edit 快捷键 | 否 | 在设置中为行内编辑绑定快捷键,选中文本或定位光标后触发 | Ctrl+Shift+E |
MCP 配置 | 否 | 通过各代理原生 CLI 的 MCP 配置接入外部工具,插件本身不单独托管 | 由代理 CLI 配置文件管理 |
如何确认成功
左侧功能区出现 Claudian 图标,命令面板能打开对话界面并成功发起一次会话,即表示安装启用成功。
常见问题
Q:插件市场搜不到怎么办?
A:确认使用的是桌面版 Obsidian、已在设置中关闭安全模式,并按 README 给出的社区插件页地址核对插件名 realclaudian。
Q:需要先装代理命令行工具吗?
A:需要。插件调用的是各代理自身的 CLI 能力,README 提到 MCP 等配置由代理原生 CLI 管理,因此对应工具需提前就绪。
Q:插件会改动我的笔记吗?
A:会。库是代理的工作目录,代理可读写、搜索文件并执行 bash,建议先备份库或在不重要的测试库中试用。
Q:支持手机上用吗?
A:README 未说明移动端支持情况,涉及本地命令行代理,通常以桌面端使用为主,请以插件页说明为准。
注意事项
- README 的 Installation 章节未给出具体命令,本教程仅基于插件市场信息与功能描述整理,请以官方插件页为准。
- 代理拥有库内文件读写与命令执行权限,首次使用前务必备份笔记库。
- CoIlab 已拆分为独立插件 Claudian Collab,需要协作功能请另行安装。
- 插件 API 标注为实验性,其他插件调用前请先在小库中验证。
核心亮点
- 把 Claude Code、Codex 等多个代理后端统一接入 Obsidian,可在同一界面按任务切换
- 代理能感知当前笔记库的文件结构与内容,围绕真实文件读写,减少复制粘贴和上下文丢失
- 基于 TypeScript 并按 Obsidian 插件规范开发,安装配置流程与常规插件一致
不足之处
- 依赖外部 AI 代理服务与相应凭据,实际可用性受所接后端能力与配额影响
- 在库内运行代理涉及文件读写权限,权限边界与误操作防护需要使用者自行留意
- 多后端适配带来配置项较多,新手需要一定时间理解各代理的差异
适用场景
- 在 Obsidian 中维护代码笔记时,让代理直接读取并修改库内代码片段
- 写作过程中调用代理基于已有笔记内容生成草稿或整理提纲
- 把零散的技术文档交给代理批量归纳、改写并写回指定笔记
替代项目
obsidian-copilot、continue、aider
同类项目推荐
open-spdd
开源
把 AI 编码提示词模板集中管理,一键复用不重复写
A SPDD AI Coding Assistant Command Template Manager
ai-code-context-helper
开源
一键打包代码上下文,让 AI 建议更懂你的项目
Desktop tool for extracting code context to enhance AI-assisted development. Visuali···
opencode-manager
开源
手机上管 OpenCode 会话、Git 和终端,一个网页全搞定
A self-hosted command center for OpenCode. Sessions, git, terminal, and schedules in···
spec-first
开源
先定规范再写码,让接口永不跑偏
仓库原生 AI Coding Harness —— 把一次性 AI 对话变成可治理、可验证、可沉淀的工程闭环···
deepagents-open-lovable
开源
用大白话聊需求,自动生成React应用
An open-source AI-powered frontend development platform built on DeepAgents and Lang···
kubb
开源
一份 OpenAPI,自动生成类型安全的 TS 请求代码
Turn your API spec into type-safe code. Generate TypeScript types, API clients, hook···
LSP-copilot
开源
让 Sublime Text 也能用上 Copilot 行内补全
GitHub Copilot support for Sublime Text LSP plugin provided through Copilot.vim.
cc-switch-cli
开源
一条命令切换 Claude Code、Codex、Gemini 的配置与供应商
⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini ···
CrossCoder
开源
跨仓库图检索,让代码生成不再只盯着当前项目
[EMNLP 2026] Beyond Repository Boundaries: Cross-Repository Graph Retrieval for Code···