claudian

在 Obsidian 笔记库里直接召唤 AI 代理干活

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 1081 🐛 待处理 66 👀 关注 39
GitHub ↗
GitHub 星标 ★ 15869
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源插件免费使用,需自备Claude/Codex等API

项目预览

claudian 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队YishenTu
定价模式🏷️完全免费
价格说明开源插件免费使用,需自备Claude/Codex等API
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型claude-code,codex,deepseek-harness,grok,ide,obsidian,obsidian-plugin,opencode,pi,productivity
GitHub 星标★ 15869
上线时间2025-12-05 00:00:00
代码更新2026-10-31
仓库体积36.1 MB
本站数据更新2026-11-01
维护状态活跃
收录时间2026-11-01
浏览次数0

项目介绍

claudian 是一款 Obsidian 插件,把 Claude Code、Codex 等多种 AI 编程代理直接嵌入笔记库,让 AI 成为与笔记内容同处一处的协作伙伴。它解决的核心问题是:使用 Obsidian 写作或整理知识时,若要借助 AI 代理处理代码、批量改写或生成内容,通常需要在编辑器与终端之间反复切换,上下文容易丢失。该插件在库内提供对话界面,代理可读取当前笔记与库结构,围绕真实文件执行任务,并把结果写回笔记。它支持多个代理后端,用户可按任务选择不同模型或工具链;基于 TypeScript 开发,遵循 Obsidian 插件规范,安装后即可在库内调用。适合需要把知识管理、写作与 AI 辅助编程结合起来的用户,例如在笔记中维护代码片段、让代理整理文档或基于库内容生成草稿。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 15869

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 10 分钟 部署方式:本地安装 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Obsidian 桌面版(插件需在桌面端运行,移动端通常不可用)
  • 支持 Claude Code、Codex、Grok Build、OpenCode、Pi、DeepSeek Harness 等代理后端之一
  • 一个本地笔记库(vault),插件会把库根目录作为代理工作目录
  • README 未提供安装章节内容,具体步骤以插件市场页面为准

安装与启动步骤

  1. 1安装并打开 Obsidian

    先安装 Obsidian 桌面客户端,创建一个笔记库或打开已有库,后续插件都在该库内生效。

  2. 2进入第三方插件设置

    打开设置 → 第三方插件,关闭安全模式( Restricted Mode ),才能浏览和安装社区插件。

  3. 3搜索并安装插件

    在社区插件市场搜索 realclaudian,确认作者与页面信息后点击安装,再点击启用。

  4. 4打开 Claudian 界面

    点击左侧功能区(ribbon)的 Claudian 图标,或在命令面板中搜索 Claudian 命令打开对话界面。

  5. 5确认工作目录

    库根目录即代理的工作目录,代理可读写、搜索文件并执行 bash,首次使用前建议先备份笔记库。

  6. 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

★ 816 2026-09-13
ai-code-context-helper 开源

一键打包代码上下文,让 AI 建议更懂你的项目

Desktop tool for extracting code context to enhance AI-assisted development. Visuali···

★ 243 2026-08-09
opencode-manager 开源

手机上管 OpenCode 会话、Git 和终端,一个网页全搞定

A self-hosted command center for OpenCode. Sessions, git, terminal, and schedules in···

★ 912 2026-10-19
spec-first 开源

先定规范再写码,让接口永不跑偏

仓库原生 AI Coding Harness —— 把一次性 AI 对话变成可治理、可验证、可沉淀的工程闭环···

★ 109 2026-08-09
deepagents-open-lovable 开源

用大白话聊需求,自动生成React应用

An open-source AI-powered frontend development platform built on DeepAgents and Lang···

★ 113 2026-08-09
kubb 开源

一份 OpenAPI,自动生成类型安全的 TS 请求代码

Turn your API spec into type-safe code. Generate TypeScript types, API clients, hook···

★ 1833 2026-09-14
LSP-copilot 开源

让 Sublime Text 也能用上 Copilot 行内补全

GitHub Copilot support for Sublime Text LSP plugin provided through Copilot.vim.

★ 792 2026-09-15
cc-switch-cli 开源

一条命令切换 Claude Code、Codex、Gemini 的配置与供应商

⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini ···

★ 5420 2026-10-16
CrossCoder 开源

跨仓库图检索,让代码生成不再只盯着当前项目

[EMNLP 2026] Beyond Repository Boundaries: Cross-Repository Graph Retrieval for Code···

★ 134 2026-09-24