obsidian-claude-code

在 Obsidian 中嵌入 Claude AI 助手,直接读写和搜索你的知识库。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:obsidian-claude-code。
它的用途是:在 Obsidian 中嵌入 Claude AI 助手,直接读写和搜索你的知识库。
完整的 Skill 内容见:https://321skill.com/skills/obsidian-claude-code/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请总结我最近关于机器学习的所有笔记,并生成一个学习大纲。' 它会自动搜索你的知识库中相关笔记,提取关键信息并整理成结构化的文档。或者

对AI说:'帮我把 `@[[项目计划]]` 文件中的待办事项转换成表格格式。' 它会读取指定文件,理解内容并按要求重新格式化输出。

介绍

obsidian-claude-code 是一个 Obsidian 插件,它将 Claude AI 深度集成到你的笔记软件中,解决了在笔记应用内直接调用 AI 进行内容创作、分析和管理的需求。它让 Claude 能够像本地助手一样,直接读取、写入、搜索你的 Obsidian 知识库,并执行相关命令。

使用方式非常简单:安装插件并配置好 API 密钥后,通过侧边栏的聊天界面与 Claude 交互。你可以直接提问关于笔记内容的问题,要求总结、修改文件,或使用 @[[文件名]] 语法让 Claude 聚焦于特定笔记。Claude 的操作会以可折叠块的形式展示,确保透明可控。

这个插件非常适合深度使用 Obsidian 构建个人知识库的用户,特别是那些需要频繁对笔记内容进行总结、分析、重构或扩展写作的学术研究者、内容创作者和知识工作者。它让 AI 助手直接在你的知识上下文中工作,极大提升了信息处理效率。

需要注意的是,这是一个仅限桌面端使用的插件,因为它依赖于 Obsidian 的 Electron 环境来运行 Claude Agent SDK。首次使用需要配置 Anthropic API 密钥或 Claude Max 订阅进行身份验证。对于文件写入等操作,默认会弹出确认框,你可以在设置中开启自动批准以提升流畅度。

核心特点

与仅提供聊天功能的 Obsidian AI 插件不同,它基于 Claude Agent SDK,赋予 Claude 完整的文件系统工具(读、写、搜索、执行命令)和 Obsidian 专属操作能力(如打开文件、执行命令),使其能像在 IDE 中一样深度操作你的知识库。

注意事项

仅支持桌面端 Obsidian,无法在移动设备上使用。

常见问题

需要付费吗?如何认证?

需要 Anthropic API 密钥或 Claude Max 订阅。可在插件设置中直接填入 API 密钥,或通过终端运行 `claude setup-token` 使用订阅认证。

Claude 能修改我的笔记吗?安全吗?

可以,但默认会弹出确认框。所有文件操作都会以可查看的区块展示,确保透明。你可以在设置中控制自动批准权限。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/obsidian-claude-code/raw/index.md 读取 obsidian-claude-code 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。