Claudian
把 Claude Code、Codex 等编码代理直接搬进 Obsidian 仓库，让笔记库成为代理的工作目录。
- Star 数
- ★ 16k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 在 Obsidian 里写长文档的研究者，需要代理直接检索、引用并改写 vault 内的多篇笔记。
- 不适合
- 需要在移动端或 Obsidian 移动版使用的人
- 只想轻量记笔记、不愿安装并维护外部 CLI 的用户
- 不能接受笔记内容被发送到 Anthropic、OpenAI、xAI 等云端的团队
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Claudian 是一个 Obsidian 插件，把 Claude Code、Codex、Grok Build、OpenCode、Pi、DeepSeek Harness 等编码代理嵌入到你的 vault 中，vault 本身充当代理的工作目录，文件读写、搜索、bash 与多步工作流开箱可用。它通过侧边栏聊天界面工作，支持标签页与单栏/双栏会话管理、Zen 模式紧凑输入条、内联编辑（词级 diff 预览）、斜杠命令与 Skills、@mention 引用文件与其它会话，以及跨会话消息。模型不写死在插件里，而是从你配置的提供商运行时中发现并启用。插件提供 Claude、Codex、DeepSeek、Grok、OpenCode、Pi 各自的适配层，并共享 ACP 协议机制与 MCP 配置。它以 MIT 许可发布、在 Obsidian 社区插件市场可安装，仅支持桌面端 v1.13.0+，且需要你自备至少一个 harness CLI 与相应订阅或 API。
Claudian 以侧边栏聊天作为主界面：你输入指令后，代理在该 vault 目录内读取、写入、编辑、搜索文件并执行命令。内联编辑功能让你选中文本或把光标停在目标位置，用快捷键触发 provider 支持的原地改写，结果以词级 diff 预览确认。输入 / 或 $ 可调用用户级与 vault 级的斜杠命令模板和 Skills；输入 @ 可引用 vault 中的文件、文件夹或其它 Claudian 会话。跨会话消息允许一个代理读取、发消息、引导或打断另一个 Claudian 会话，也能在任何提供商上发起新会话；/side 或 /btw 打开独立的临时旁支对话而不改动主对话。插件通过各代理原生 CLI 管理的 MCP 配置接入外部工具，并内置一个仅监听 127.0.0.1 的监听器，供 OpenCode、DeepSeek 与 Grok 会话使用其会话工具。
- 在 Obsidian 里写长文档的研究者，需要代理直接检索、引用并改写 vault 内的多篇笔记。
- 希望用自然语言批量整理、重命名、补全 Markdown 笔记与附件目录的个人知识库管理者。
- 已经订阅 Claude Code 或 Codex、想把同一套编码代理工作流用于写作与资料整理的开发者。
- 需要在同一界面里切换多个提供商（Claude、Codex、Grok、OpenCode 等）比较输出效果的用户。
- 想在笔记中做小范围措辞润色、借助内联编辑与词级 diff 精确确认改动的编辑者。
- 希望代理在后台会话中并行处理任务、并通过跨会话消息协调进度的高级用户。
如何安装或部署这个 Agent？
推荐从 Obsidian 社区插件安装：打开 Obsidian → 设置 → 第三方插件 → 浏览，搜索 “Claudian” 并安装、启用。也可从社区插件页直接安装。
从源码安装（开发用）：把仓库克隆到 vault 的插件目录，安装依赖并构建。
cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudiannpm install
npm run build随后在 Obsidian 的 设置 → 第三方插件 中启用 “Claudian”。前提是已安装 Obsidian v1.13.0+（仅桌面端）、至少一个 harness CLI（Claude Code、Codex、DeepSeek Harness、Grok Build、OpenCode 或 Pi），以及可用的订阅或 API。
如何使用这个 Agent？
从侧边栏图标或命令面板打开 Claudian 界面，直接与代理对话，它会在 vault 内读、写、改、搜并执行命令。
常用入口：
/ 调用斜杠命令模板
$ 调用 Skills
@ 引用 vault 文件、文件夹或其它 Claudian 会话
/side /btw 打开临时旁支对话若代理 CLI 未被自动发现，可在 设置 → Claudian → Providers → Claude Code 展开安装卡片并填写 CLI 路径；例如在 macOS/Linux 上用 which claude、在 Windows 上用 where.exe claude 查找可执行文件。通过 npm 安装的 CLI 找不到 Node.js 时，在 设置 → Claudian → General → Environment → Shared environment 中补充 Node 所在目录：
PATH=/path/to/node/bin若终端订阅可用但插件内报 authentication_failed，在 设置 → Claudian → Providers → Claude Code → Environment → Custom variables 中清空继承的凭据：
ANTHROPIC_API_KEY=这个 Agent 有哪些优点和局限？
- 模型目录由提供商运行时发现（Discover / Browse models），不在插件内硬编码模型列表，新模型无需改包。
- 同一插件覆盖 Claude Code、Codex、DeepSeek Harness、Grok Build、OpenCode、Pi 六种 harness，可在设置中按提供商切换。
- 内联编辑带词级 diff 预览、Zen 模式紧凑输入条、@mention 与跨会话消息，针对长时间写作场景做了具体交互设计。
- 隐私边界写明：无遥测探针，网络活动限于提供商调用、配置的 MCP 端点与仅监听 127.0.0.1 的会话工具监听器。
- 以 MIT 许可发布并在 Obsidian 社区插件市场可直接安装，无需自行打包。
- 仅支持桌面端（macOS/Linux/Windows），移动端无法使用。
- 必须自备至少一个外部 harness CLI 及订阅或 API，插件本身不含模型能力。
- macOS/Linux 从 Dock 启动时不继承终端 PATH，需要依赖登录 shell 解析或手动填写 CLI 路径，nvm/Volta 等版本管理器场景易出错。
- Windows 上不推荐
.cmd/.ps1包装器，需改用claude.exe或cli-wrapper.cjs，路径配置有额外门槛。 - 不接受新增提供商的 pull request，扩展生态受维护方边界限制；Collab 已拆为独立插件。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claudian 当前 | 49 · 缺口较多 | IDE 插件免费 + 模型费 | ★ 16k | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| IWE 知识图谱与智能体记忆 | 73 · 存在缺口 | 命令行工具免费 | ★ 1.8k | 2 天前 | Rust | Codex · Claude Code · Claude.ai |
| Cindy | 52 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 3.2k | 今天 | TypeScript | Codex · Claude Code |
| Memmy — 个人AI代理与本地记忆中枢 | 42 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 2.1k | 今天 | TypeScript | Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 的隐私章节明确列出会发送到 API 的数据（输入、附件、图片、工具输出）以及目的地（Anthropic/OpenAI/xAI 等），并声明无遥测、网络活动限于显式 provider 调用、配置的 MCP 端点与 127.0.0.1 监听，数据流透明度可给 2。但该插件把整个 vault 作为 agent 工作目录，具备文件读写、bash 与多步工作流能力，README 未说明默认权限模式、危险操作（删除/覆盖/执行命令）是否需用户确认，也未描述回滚或撤销机制，故 least_privilege、user_confirmation、rollback 仅 1。敏感数据处理方面仅提示“分享变量名而非密钥值”，未见密钥存储/加密说明，给 1。依赖安全有 npm audit、dependency-review、lockfile 校验与 overrides 固定版本，可给 2；但依赖大量外部 CLI 与 SDK，未做漏洞清单说明。外部副作用（bash、跨会话消息、MCP）缺乏边界约束说明，给 1。来源归属仅 README 与 LICENSE 署名 Yishen Tu，发布者身份未经验证，给 1。
仓库结构清晰（core/providers/features 分层），CI 含 typecheck、lint、架构边界测试、跨平台 smoke 与构建产物校验，自洽性可给 2。依赖可用性方面要求 Node >=24 <25、Obsidian v1.13.0+、桌面端且需外部 CLI（Claude Code/Codex 等），门槛较高且 CLI 缺失时依赖 PATH 探测，给 1。故障信息方面 README 的 Troubleshooting 覆盖 ENOENT、Node 缺失、认证冲突等具体错误与恢复步骤，给 2。
受众与场景明确（Obsidian 用户在 vault 内使用编码 agent），给 2。能力边界有说明（桌面端限定、provider 列表、PR 不接受新 provider），给 2。触发精度方面斜杠命令、@mention、跨会话消息等触发机制在 README 仅概述，未见冲突/歧义处理说明，给 1。环境适配覆盖 macOS/Linux/Windows 的 PATH 与 CLI 探测差异，给 2。
信息架构有目录树与功能列表，给 2。安装说明含社区插件与源码两种路径，给 2。命名稳定性方面版本号 2.3.26 且提及 OpenCode v1 将于 2026-10-30 停止支持，存在破坏性变更风险，给 1。示例与 FAQ 仅有 Troubleshooting，缺少使用示例与常见问题集，给 1。已知限制仅零散提及（桌面端、provider 兼容性），未集中列出，给 1。许可证为完整 MIT 文本，给 3。版本与变更日志仅有版本号与 preversion 脚本，无 CHANGELOG，给 1。维护责任方面 README 有贡献指南与联系方式，但发布者身份未验证，给 1。
输出可用性方面提供内联编辑 diff 预览、Zen 模式、标签页等，面向实际写作场景，给 2。边际价值在于将编码 agent 嵌入笔记库，具备差异化，给 2。成本效益方面需订阅/API 费用并依赖外部 CLI 与 Node 24，配置成本较高，README 未讨论成本，给 1。
README 的功能声明多无对应代码或测试引用，claim_traceability 给 1。测试文件（mock、harness）与 CI 可部分佐证工程实践，但无法交叉验证 README 的功能声明，给 1。README 中事实与推断（如“无遥测”）未标注证据来源，fact_inference_separation 给 1。
- 插件以整个 vault 为工作目录并具备 bash 与文件写入能力，README 未说明默认权限模式或危险操作的确认与回滚机制，使用前应自行限制权限并备份。
- 发布者身份未经验证，安装前应核对 Obsidian 社区插件来源与签名。
- 依赖外部 CLI 与 Node 24，环境配置门槛高，PATH 探测失败可能导致功能不可用。
- OpenCode v1 将于 2026-10-30 停止支持，存在破坏性升级风险。
- README 中“无遥测”等声明缺乏代码级证据，静态审查无法验证。
常见问题
插件本身收费吗？
我的笔记会被发到哪里？
为什么插件找不到我的代理 CLI？
spawn claude ENOENT 与 Claude Code CLI not found。macOS/Linux 下 Obsidian 不继承终端 PATH，插件会从登录 shell 读取一次 PATH；也可在提供商设置里手动指定 CLI 路径。