claude-obsidian 实战：Karpathy LLM Wiki 理念的装修老板落地版（GitHub 7200 Stars）

麦序子 maixuzi.cn｜CSDN 技术文｜2026 年 6 月

---

前言

最近上线了一个网站：https://maixuzi.cn ，本文分享 claude-obsidian 项目落地装修行业的实战。

2026 年 4 月，Karpathy 在 GitHub 贴了一条 LLM Wiki gist：

"理想的知识库，应该让 LLM 自己来读、自己来链接、自己来维护。"

这个理念催生了 GitHub 上 7200+ Stars 的 claude-obsidian 项目。本文讲怎么用它搭建装修老板的 AI 第二大脑。

技术栈选型

为什么选 claude-obsidian 不选其他方案：

方案	优势	劣势	选择
claude-obsidian	完全本地、零订阅、AI 自动建链接	需要 Claude Code 订阅	✅
Notion + AI	界面友好	96 元/年、依赖云端、数据在别人服务器	❌
印象笔记 + AI	即开即用	199 元/年、不能自动建双向链接	❌
自研 (类似 hermes-memory.py)	零依赖、可定制	维护成本高	✅ 已自用

我们最终方案：claude-obsidian + 自研 hermes-memory.py 互为备份。

目录结构

claude-obsidian/
├── .raw/                    # 丢资料进去的目录
│   ├── wechat-chats/
│   ├── pdf-quotes/
│   └── floorplans/
├── index.md                 # 索引
├── hot.md                   # 当前热点
├── log.md                   # 操作日志
├── dashboard.md             # 仪表盘
├── entities/                # 实体页（人物/机构/项目）
├── concepts/                # 概念页（理论/模式/方法）
├── sources/                 # 来源页（原始材料）
└── .obsidian/               # Obsidian 配置

核心代码

1. 安装（30 分钟）

git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh

2. 启动 Claude Code

cd ~/Documents/claude-obsidian
claude

在 Claude Code 会话里输入 /wiki，它会引导你搭出完整的 wiki 结构。

3. 丢资料 + 自动建网

把 PDF 报价单、微信聊天截图丢到 .raw/，跟 Claude 说：

吸收一下这些知识

Claude 自动读 → 自动建实体页/概念页/来源页 → 自动建双向链接。

4. 问问题

半包 120 平的报价，过去 3 年是怎么浮动的？

它会按 hot.md → index.md → 具体页面顺序读，给你带出处的答案。

Cloudflare Pages 配置

（这部分是 maixuzi.cn 站点的，不是 claude-obsidian 项目本身）

• Build command: npm run docs:build
• Build output directory: docs/.vitepress/dist

踩坑

坑 1：Anthropic API Key 没配

现象：Claude Code 启动后报 "API key not found" 修复：export ANTHROPIC_API_KEY=sk-ant-xxxxx

坑 2：Obsidian 不识别双向链接

现象：[[实体名]] 链接变红，不是蓝色 修复：在 Obsidian 设置 → Files & Links → 启用 "Detect file format when pasting"

坑 3：.raw/ 目录里的图片不被 Claude 读

现象：微信聊天截图丢进去，Claude 不识别 修复：把图片 base64 编码成 .md 文件，再丢进去

坑 4：中文文件名乱码

现象：客户档案文件名带中文，Obsidian 打不开 修复：批量 rename 成拼音或英文

收录效果

2026-06-26 部署到 maixuzi.cn/wechat/claude-obsidian-guide.html：

• Bing Webmaster 已提交 sitemap.xml
• 百度站长平台已提交 sitemap + llms.txt

参考

• 网站：https://maixuzi.cn
• 项目地址：https://github.com/AgriciDaniel/claude-obsidian
• Karpathy gist：https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
• 逛逛 GitHub 原文：https://mp.weixin.qq.com/s/kV7eDR0SxbhiYViT90GDiA

---

更多内容：https://maixuzi.cn 主理人微信：maixuzicn