Claude Code + Obsidian：让 AI 自动化知识管理

你有没有过这种体验：用 Claude Code 写了一天代码，debug 了 3 个小时，好不容易搞定了，第二天打开项目——完全想不起来昨天到底改了啥、为什么这么改。

翻 git log？只有干巴巴的 commit message。开 Notion 记？手动来回切换太麻烦，写了两天就放弃了。至于那些"项目文档"——说实话，大部分人的文档从写完那天起就再也没更新过。

今天推荐的这个工具，直接让 Claude Code 帮你自动写项目笔记。

项目地址：https://github.com/nemocake/claude-obsidian-assistant

它是什么

一句话总结：一个预配置好的 Obsidian 模板库，让 Claude Code 能直接读写你的笔记。

和手动记笔记比，它的核心区别是——你只需要在终端敲一个命令 /obsidian，Claude 就会自动帮你：

• 读取当前项目的代码结构、技术栈、git 记录
• 在 Obsidian 里创建/更新对应的项目文件
• 自动生成开发日志（Dev Log）
• 还能画出代码架构图（直接生成 Obsidian Canvas 文件）

不需要任何 Obsidian 插件，不需要额外的 CLI 工具。纯粹就是 Claude Code 直接读写 Markdown 和 JSON 文件。

和 Notion、语雀这类在线文档比，Obsidian 的优势在于：文件就是本地 Markdown，Claude Code 可以像读写代码一样操作它们，没有 API 限制，没有格式转换的问题。这波操作，还得是本地优先的 Obsidian。

核心亮点

1. Johnny Decimal 文件系统 — 一眼看懂整个知识库

项目采用了 Johnny Decimal 的编号系统来组织文件夹：

00-09 System      — 系统配置、模板、看板
10-19 Projects    — 项目管理（重点！）
20-29 Writing     — 写作、日记
30-39 Knowledge   — 知识库、阅读清单
40-49 Tracking    — 待办、习惯追踪
50-59 Creative    — 创意、绘画、实验

每个项目文件自动编号（11.01, 11.02...），不用你操心命名和归类的问题。这个设计其实很聪明——它让 Claude 能用确定性的规则来定位和创建文件，而不是靠模糊匹配瞎猜。

2. /obsidian Skill — 一键同步的核心命令

这是整个项目的灵魂。一条 /obsidian 命令，Claude 会走完 5 个阶段：

如果你的项目已经在 Obsidian 里有记录，Claude 会增量更新——只添加新内容，不会覆盖你之前写的东西。开发日志是 append-only 的，最新的排在最前面。这个设计比较稳，不用担心 Claude 把你之前的笔记搞丢。

3. 自动生成架构 Canvas — 代码可视化

这个功能有点意思。Claude 会分析你的代码库，按层把组件分类：

• 🔴 入口文件（红色）
• 🟠 状态管理/配置（橙色）
• 🟡 数据层/持久化（黄色）
• 🟢 UI/视图/输出（绿色）
• 🔵 API 层/外部服务（青色）
• 🟣 标签/分组名（紫色）

生成的 .canvas 文件是 Obsidian 原生格式，你可以直接在 Obsidian 里拖拽、编辑、添加注释。如果你之前苦于画架构图，这功能直接帮你省了。

4. 五套主题 — 颜值即正义

项目还贴心地准备了 5 套 CSS 主题：

Base Theme

Base Theme

CRT Terminal

CRT Terminal

Y2K Web 1.0

Y2K Web 1.0

RuneScape

RuneScape

Coquette

Coquette

每个主题都是独立的 CSS 文件，在 Obsidian 设置 → 外观 → CSS 代码片段里一键切换。不喜欢？直接让 Claude 帮你改配色，或者从零做一个新的。

安装部署

环境要求很简单：

• Obsidian（免费个人使用）
• Claude Code（需要订阅，也可以用第三方 API，甚至是 Ollama 云模型）

# 1. 克隆仓库
git clone https://github.com/nemocake/claude-obsidian-assistant.git

# 2. 用 Obsidian 打开这个文件夹作为 Vault

# 3. 把 skill 文件复制到 Claude Code 的命令目录
cp claude-code/obsidian-sync.md ~/.claude/commands/obsidian.md

# 4. 编辑复制后的文件，设置你的 Vault 路径
# 找到 VAULT_PATH，改成你的 Obsidian Vault 绝对路径

然后在任意项目目录里运行：

/obsidian

搞定。Claude 会自动检测项目、提供操作菜单，你选一个就行了。

可选步骤： 安装 Dataview 插件（社区插件搜索 "Dataview"），首页看板需要它来统计项目数据。

CLAUDE.md — 给 Claude 的说明书

项目根目录有个 CLAUDE.md 文件，这个设计很关键。它告诉 Claude：

• Vault 的文件结构是什么样的
• 每种文件格式的规范（Markdown、Canvas、YAML frontmatter）
• 编辑规则（不能删已有内容、日志只能追加、Canvas 必须是合法 JSON）
• Canvas 颜色代码的含义

本质上就是 Claude Code 的 Memory 文件，但专门针对 Obsidian 使用场景做了优化。如果你用过 Claude Code 的 Skills 系统，就知道这东西有多重要——一个好的 CLAUDE.md 能让 Claude 少犯很多错。

进阶玩法

作者在 README 里列了几个扩展方向，我觉得每个都挺实用：

• Session Memory：让 Claude 每次开工前先读 Vault 里的项目笔记，前一次的 debug 记录、架构决策都还在，不用每次重新解释上下文
• 自动文档更新：用 Claude Code Hooks 在每次 commit 后自动触发 Vault 更新，开发日志自己写自己
• GitHub 集成：把 Issue、PR 状态、CI 信息拉到 Vault 里，一个地方看完所有项目状态
• 跨项目查询：建一个 /vault-query skill，随时问"哪个项目用了 Redis？"、"上一个 App 用的什么认证方案？"
• 决策日志：记录架构决策的来龙去脉——考虑了什么方案、最终选了哪个、为什么

这些扩展如果你有空折腾，每一个都能显著提升开发体验。特别是 Session Memory，配合 Claude Code 的 Skill 系统使用，基本等于给 AI 装上了"长期记忆"。

One More Thing

说到 Claude Code Skills，我自己也在深度使用这套体系。事实上，我公众号里很多文章的配图、知识卡片，都是通过自定义 Skills 自动生成的。