Claudian把 Claude Code 搬进 Obsidian 侧边栏5 分钟让 AI 直接读写你的整个笔记库【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudianClaudian 是一款 Obsidian 插件把 Claude Code、Codex 等 AI 编程智能体嵌入你的笔记库让库目录变成 AI 的工作目录。选中文字改稿、 引用文件、多标签并行会话读、写、搜索、跑命令全都开箱即用适合想把笔记从只读收藏变成可产出素材库的人。一个真实场景把散落的素材拼成一篇初稿假设你库里攒了 40 篇读书笔记、十几条会议纪要现在要写一篇复盘文章。以前的流程是这样的翻标签找笔记把有用的段落复制进一个新文档自己改句式、补过渡、统一语气再回头检查有没有漏掉哪篇关键素材。光搬运这一步就要花掉半小时还经常漏。现在你只需要在 Obsidian 里打开 Claudian 侧边栏说一句在库里找所有提到「时间管理」的笔记把要点整理成一篇 800 字初稿写到drafts/2026-复盘.md引用处用 标注来源文件。AI 会自己全文搜索、读文件、拼稿、写盘你只需要在结果出现后挑出不满意的地方让它改。整个过程不用离开编辑器不用复制粘贴路径。原理速读它为什么能看懂你的库打个比方终端里的 Claude Code 就像一个被锁在毛坯房里的装修工你给他什么图纸他就改什么。而 Claudian 做的事是把整个毛坯房——也就是你的 Obsidian 库目录——直接交给这位装修工当工地。他手里有钥匙文件读写、有图纸目录全文搜索、还有施工队的多步协作能力bash 与多步工作流。项目结构也印证了这一点看 README.md 里的目录说明即可src/core/跨智能体的统一运行时、权限审批、类型契约是工地管理处src/providers/每个智能体一个适配层claude、codex、grok、opencode、pi是不同工种的班组src/features/侧边栏聊天、行内编辑、设置三大 UI 入口新增一个智能体只需要写一个新的 provider 适配层核心和界面不动这也是它替换后端很干净的原因。快速上手三步跑通第一个对话第一步 · 安装插件打开 Obsidian → 设置 → 社区插件 → 浏览搜索 Claudian 安装并启用。如果要从源码尝鲜最新版把仓库克隆进你的库目录再构建git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build这相当于把整个插件的源码车间搬到本地装依赖再打包成可运行的插件文件。验证Obsidian 设置里能搜到 Claudian 且开关亮起。排错如果提示版本不兼容先确认 Obsidian 已升到 1.13.0 以上manifest.json 里写的就是minAppVersion: 1.13.0且你用的是桌面端不是手机。第二步 · 准备一个智能体 CLIClaudian 是壳底层要有一个真正干活的智能体。装下面任意一个即可Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi。同时你需要对应的订阅或 API 服务OpenRouter、Kimi、GLM、DeepSeek 这类兼容 Claude Code 协议的接入方式都能用。验证在终端跑which claudemacOS/Linux或where.exe claudeWindows能返回路径。排错如果 GUI 应用找不到 CLI报错spawn claude ENOENT多半是 nvm/fnm 这类版本管理器没把 PATH 带给图形界面去 设置 → 高级 → Claude CLI path 手动填上绝对路径即可详见 README.md 的 Troubleshooting 章节。第三步 · 发起第一次对话点左侧 ribbon 图标或从命令面板打开对话侧边栏输入一句自然语言任务比如打开当前这篇笔记用三句话总结我的观点并列出 5 个可补充的论据。验证侧边栏能看到 AI 逐步调用读文件 / 搜索 / 写文件的工具动作笔记内容被修改。排错如果权限弹窗频繁打断你这是正常的审批机制下文能力速览讲先放行观察一次再决定要不要给白名单。能力速览按你要干的活分组看改稿与写作行内编辑是最直观的一个选中一段文字按热键AI 直接在笔记里动笔改动以词级 diff 预览呈现删了哪些词、加了哪些词一目了然不满意一键回退。实现集中在 src/features/inline-edit/ui/InlineEditModal.ts对中文润色、扩写、翻译都很友好。检索与引用输入可以引用库内文件、文件夹输入#还能引用 Collab 工单。写长文时直接那篇参考文献笔记让它按你要的格式重新组织不用自己贴路径。沉淀与复用输入框敲/弹出可复用的提示词模板敲$调用 Skills 技能并区分用户级和库级两种作用域。把团队常用的审稿标准、术语表固化成 Skill任何人一条$就能调用。命令的发现与存储由 src/core/providers/commands/ 统一管理。控制与并行智能体支持plan先出计划再执行、acceptEdits、default等多种权限模式见 src/providers/claude/types/agent.ts。配合权限规则bash 支持git *、npm:*这类显式通配文件工具支持路径前缀匹配见 src/core/security/approvalRules.ts——把高频安全命令设为免审批把写库操作设为每次确认安全感拉满。同时开多个标签页并行处理不同任务或用双栏模式让常驻会话管理器贴着对话放随时回来接续上下文。协作实验特性Collab Mode 可以让其他 Claudian 用户围绕同一个共享项目协作项目数据通过局域网在受邀设备间直传不经过任何 Claudian 云服务。需要本地装好 Git。对比与取舍维度终端裸跑 CLIObsidian 里用 Claudian上下文从哪来手动粘贴路径、手动贴内容自动关联当前笔记与整个库产出落点终端里的纯文本要再复制回笔记直接写入笔记带词级 diff适合谁重度脚本化、要接 CI 的人以知识库为工作中心、想边写边改的人适合把 Obsidian 当第二大脑、素材多产出少、需要 AI 读全库再动手的写作/研究场景。不适合纯手机端用户插件仅桌面端以及不想为 AI 准备第二份资料但又不愿意把库整体开放给智能体的人——Claudian 的设计前提就是库即工作目录。避坑指南如果插件页面显示大插件警告就别慌最新的 Claude Agent SDK 让包体超过 5 MB官方 Obsidian Sync 也同步不了这个主文件多设备使用时请在每台设备上单独安装更新不要指望 Sync 自动复制。如果提示Claude CLI not found或spawn claude ENOENT就先用which claude确认终端能找到再检查图形界面能否继承同一 PATHnvm、fnm、volta 用户最容易踩这个坑手动填绝对路径最稳。如果用 npm 装的 CLI 时 Obsidian 找不到 Node.js就对比dirname $(which claude)和dirname $(which node)两个路径不一致就在 设置 → 环境 里补上PATH/path/to/node/bin或者直接装原生二进制。如果Windows 上一直报错就避开.cmd和.ps1包装脚本原生安装用claude.exe包管理器安装用cli-wrapper.cjs。如果你只想让它读不想让它写就把权限模式切到plan或default并给文件工具配路径前缀白名单写操作逐次确认。现在就可以做的一步打开你的 Obsidian进 设置 → 社区插件 搜 Claudian 安装并启用然后随便开一篇长笔记说一句用三句话总结这篇笔记并列出 3 处可以补充论据的位置。30 秒内你就会看到它真的在读你的库。用起来遇到问题或者想分享更野的玩法可以去项目仓库提 Issue 或在 CONTRIBUTING.md 指的路径下讨论——Issues 是官方建议的起点把复现步骤和环境写清楚排查会快很多。【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考