用途:把 Obsidian 笔记库(本质是 Markdown 文件构成的代码库)交给 Claude Code 读写与维护,无需专门插件即可由 Claude Code 导航文件结构、做精细的 Markdown 编辑。
主要能力与集成模式:A 直接访问——从库根目录启动 claude 即可读取、编辑、搜索笔记、添加双链、创建带 frontmatter 的新笔记。B 清单模式——在库根放置 CLAUDE.md,说明目录结构、frontmatter 约定、wikilink 规范与创建/编辑笔记规则。C MCP 插件——安装 obsidian-claude-code-mcp 实现实时双向通信,默认 WebSocket 端口 22360,提供 read_note、write_note、search、list_notes、get_backlinks、get_outlinks、get_tags 等能力。D COG 自演化模式——结合 Git、钩子与自动化,支持自动交叉引用、模式学习、孤立笔记检测与一致性检查。E Claudesidian——采用为 AI 交互预配置的库结构。
使用方式:必要时在 Claude Code 设置中添加 mcpServers 的 websocket 地址 ws://localhost:22360;可用 git post-commit 钩子调用 claude --print 执行维护检查。快速上手为进入库目录、创建 CLAUDE.md 清单后直接对话。
适用场景:笔记自动加双链、知识图谱维护、孤立笔记发现、研究综合归纳、每日笔记结构化。
限制与注意事项:路径含空格需加引号;MCP 服务崩溃后约 30 秒重试期间不报错;追加 frontmatter 可能重复键;CLAUDE.md 放库根可见、放 .obsidian/ 隐藏但可存活于重组;MCP 文件工具受库沙箱限制而原始 Bash 不受限。具体模板与参考文档细节暂未提供。