Claude Code + Obsidian:打造自我进化的 AI 知识库,越用越聪明
Karpathy 2026 年 4 月在 GitHub 上分享过一则 gist,标题为《LLM Wiki》。

他的核心理念是:理想的知识库应该交给大语言模型自己去阅读、去建立链接、去持续维护。你只需要把资料扔进去,模型会自动将碎片编织成一张互联的知识网。提问时,它直接从这张网络中提取答案,而不是从训练数据里凭空猜测。
这种想法当时引发了大量讨论,我也亲身体验过不少基于该思路的工具。那个 gist 帖子的评论区里就列出了很多方案。

近来我频繁使用的是一个名为 claude-obsidian 的项目,同样是对 Karpathy 理念的一次实践。强烈推荐,目前该项目已收获 7200+ Star。
项目解读:自动整理、监测矛盾的知识引擎
你可以将任何来源的资料——网页、PDF、代码、聊天记录、YouTube 视频笔记——扔进仓库,Claude 会自己去读完、抽取核心概念、建立双向链接,并归档为一套完整的 Markdown 知识图谱。每一次提问,它回答的并非训练数据中的记忆残片,而是它自己阅读、整理过的笔记。

作者反复强调一个词:compounding knowledge,即“知识复利”。每份新资料被纳入后,都会整合进现有的知识网络,让整个库越用越增值,越问越聪明。这种心智模型与常规的 AI 笔记插件完全不同。它继承了 Karpathy 的 LLM Wiki 构想,但 claude-obsidian 更像一部知识引擎。

它会自动整理笔记:为每份输入的资料自动生成实体页(人物、机构、项目)、概念页(理论、模式、方法)和来源页(原始材料),并建立双向交叉引用。
它会进行矛盾检测:能发现笔记中相互冲突的论点,标记出来并附上来源。
它具备会话记忆:每次会话结束前自动更新 hot.md,下次启动时无需重新交代背景。
它还提供 8 类健康检查:把孤儿笔记、死链、过期声明、缺失引用全部列出来。你的知识库会自行保持健康,免去每周手动清理的麻烦。
数据完全自主:全部为本地纯文本 Markdown 文件,无需数据库、云端或订阅费。
快速上手:两种安装方式,三分钟搭建
方式一:
git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh
然后用 Obsidian 打开该文件夹,再启动 Claude Code 进入同一目录,输入 /wiki,它会引导你逐步完成初始化。setup-vault.sh 会自动配置 graph view 的颜色、过滤规则及 CSS snippet,开箱即用。
方式二:作为 Claude Code 插件安装
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian
安装完成后,它会生成一个文件夹(一般是 claude-obsidian)。用 Obsidian 打开该文件夹,然后会弹出信任提示,点击“信任仓库作者并启用插件”即可。

接着会有一个弹窗,建议把预装的几个插件都开启:
- Calendar:在右侧栏提供月历视图,每个日期下显示当天字数与未完成任务,点击日期直接跳转至当天日记,便于回顾笔记产出节奏。
- Thin:类似 flomo 的快速备忘录面板,可随时呼出输入框记录灵感,自动归入统一笔记。后续可以让 Claude 将这些速记批量 ingest 进 wiki。
- Excalidraw:Obsidian 内置手绘画布,用于绘制流程图、白板或为图片添加批注。
- Banners:为笔记顶部添加横幅图,类似 Notion 的封面。

接着打开新终端,进入刚才创建的目录,运行 Claude Code:
cd ~/Documents/claude-obsidian
claude
在 Claude Code 会话中输入 /wiki。它会询问你知识库的用途,然后自动搭建完整的 wiki 结构,包括 index.md、hot.md、log.md 和 dashboard 等。


日常核心操作方式
- 资料摄入:将网页链接、PDF 或视频笔记放入
.raw/目录,告诉 Claude “吸收一下这些知识”。它会读完内容,自动生成实体页、概念页和来源页,更新索引与日志。 - 智能问答:直接追问“你对 X 怎么看?”,它会按照 hot.md → index.md → 具体页面的顺序读取,控制 token 成本,回答时引用具体笔记而非凭空编造。
- 自动健康检查:说一句 “lint 一下”,孤儿笔记、死链、过期信息和缺失引用都会被列出,知识库自动保持整洁。
- 可视化画布:使用
/canvas命令打开画布,可将图片、PDF、笔记卡片摆放成思维地图,该画布遵循 Obsidian 的 JSON Canvas 1.0 规范。 - 跨项目复用:在任何 Claude Code 项目的 CLAUDE.md 中加入一段引导,即可让该项目读取这个 vault 作为知识库。你的执行助理、编程项目、内容创作流水线共享同一份知识,这才是真正的第二大脑。
笔记越积累越有价值,越问越聪明,这种正反馈一旦跑起来就很难回头。如果你已经在使用 Obsidian,这个项目绝对值得花一个下午试一试。
开源地址:https://github.com/AgriciDaniel/claude-obsidian
作者博客深度文:https://agricidaniel.com/blog/claude-obsidian-ai-second-brain
Karpathy 原始 gist:https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f