1. 为什么你的 Obsidian 笔记库需要 LLM-Wiki如果你用 Obsidian 记了半年以上笔记大概率会遇到同一个尴尬笔记越攒越多真正回头翻的却没几篇。剪藏的文章躺在raw/里吃灰概念页写了开头就烂尾双链越连越乱最后整个 vault 变成一个只进不出的仓库。这不是你懒而是整理这件事本身没有即时反馈人很难长期坚持。LLM-Wiki 想解决的就是这个矛盾。它的核心思路不是让 AI 在你提问时临时检索一下而是把 Claude 变成知识库的常住管理员新内容进来时由它提取要点、更新概念页、补双向链接、写操作日志你提问时它先读 wiki 再回答好答案还能存回 wiki 变成新页面。整套流程围绕三种操作循环——Ingest摄入、Query查询、Lint健康检查。这篇教程聚焦落地怎么把 Obsidian 笔记库通过 CLAUDE.md 和 config.toml 接进 Claude Code怎么用 TaoToken 统一 Key 和 API 通道最后用一次真实问答验证知识库检索是否生效。适合已经在用 Obsidian、想给笔记库加一层 AI 养护能力的技术人。全程可跟做命令和配置都能直接复制。2. 前置准备TaoToken 通道与 Claude Code 环境在动手改 vault 之前先把AI 怎么连进来这件事解决掉。Claude Code 默认走 Anthropic 官方通道国内直连经常超时而且多项目共用时 Key 管理很乱。TaoToken 在这里扮演的是统一 API 网关的角色一个 Key 覆盖 Claude 系列模型base_url 指向https://taotoken.net/apiClaude Code、Claudian 插件、脚本调用都能复用同一套凭证。你需要准备三样东西第一一个 TaoToken 账号和 API Key。登录官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后进控制台创建 Key。建议给知识库项目单独建一个 Key方便后面按项目排查用量。第二安装 Claude Code。它是命令行 Agent能读文件、改多个文件、跑脚本LLM-Wiki 的 lint 和批量建链都靠它。安装命令npm install -g anthropic-ai/claude-code claude --version第三确认 Obsidian 已装好并且你的 vault 是本地 Markdown 存储不是同步到封闭云端的模式。LLM-Wiki 的前提就是 AI 能直接读写.md文件本地 vault 天然满足。环境变量配置是这一步的关键。Claude Code 读取ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两个变量把它们指向 TaoToken 即可export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥Windows 用户在 PowerShell 里用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api的写法或者直接写进系统环境变量。配完执行claude能正常进入对话说明通道通了。这一步别跳过后面 Claudian 插件和 Claude Code 都依赖它。3. 可复制配置CLAUDE.md 与 config.toml 骨架通道通了接下来给 AI 立规矩。LLM-Wiki 能不能跑顺八成取决于这两个文件写得好不好。3.1 目录结构先定下来在 vault 根目录建好这套结构AI 才知道什么能改、什么不能碰my-knowledge-base/ ├── inbox/ # 收集箱新内容先扔这 ├── raw/ # 原始来源只读AI 绝不修改 │ ├── articles/ │ ├── books/ │ └── papers/ ├── wiki/ # 维基站AI 维护 │ ├── concepts/ # 概念页 │ ├── entities/ # 实体页 │ ├── sources/ # 来源总结 │ ├── index.md # 内容索引 │ └── log.md # 操作日志 └── notes/ # 个人笔记共同维护raw/只读这条规则很重要。原始剪藏一旦被 AI 改写你就失去了溯源依据所以要在规范里明确写死。3.2 CLAUDE.md 骨架在 vault 根目录新建CLAUDE.md这是给 Claude 看的职责说明书# LLM Wiki Schema ## 角色 - 用户sourcing、提问、价值判断 - AI总结、关联、维护 bookkeeping ## 目录权限 - raw/只读禁止修改 - wiki/AI 全权维护 - notes/共同维护改动前先问 ## 三种操作 ### Ingest 1. 读取来源内容 2. 在 wiki/sources/ 建总结页 3. 更新相关 concept/entity 页 4. 在 wiki/index.md 加条目 5. 在 wiki/log.md 追加## [YYYY-MM-DD] ingest | 标题 ### Query 1. 先读 wiki/index.md 定位 2. 读相关 wiki 页 3. 综合回答并标注来源 4. 有价值的答案存回 wiki ### Lint 检查断链、孤立页、过时信息、缺 frontmatter 格式## [YYYY-MM-DD] lint | 摘要 ## 冲突处理 发现矛盾时先询问用户不擅自覆盖3.3 config.toml 骨架Claude Code 支持项目级配置。在 vault 根目录建.claude/config.toml把模型和通道固定下来避免每次手动 export[api] base_url https://taotoken.net/api model claude-sonnet-4-5 [project] name my-knowledge-base vault_root . [permissions] allow_write [wiki/**, notes/**] deny_write [raw/**]deny_write里锁死raw/等于给只读规则上了第二道保险。配置里的模型名按你 TaoToken 控制台实际可用的填别照抄。4. 验证请求跑通第一次 Ingest 与 Query配置写完必须验证知识库检索真的生效否则后面全是空中楼阁。4.1 启动并确认工作根cd ~/my-knowledge-base claudeClaude Code 会以当前目录为工作根。进去后先问一句你现在的工作目录是哪里能看到哪些文件夹确认它读到了 vault 结构。4.2 第一次 Ingest往inbox/丢一篇 Markdown 文章然后在 Claude Code 里说把 inbox/ 里的那篇文章 ingest 一下预期它执行读原文 → 在wiki/sources/生成总结页 → 更新相关概念页 → 在index.md加一行 → 在log.md追加带日期的记录。跑完你去 Obsidian 里刷新应该能看到新文件。4.3 用 Query 验证检索这是判断知识库检索是否生效的关键一步。问一个只有你笔记里才有的问题比如根据我的 wiki我之前对 RAG 和 LLM-Wiki 的区别是怎么记的如果它先读wiki/index.md定位再引用具体页面内容回答并标注来源文件说明检索链路通了。如果它凭空泛泛而谈、不引用你的文件那就是没读到 wiki回去检查 CLAUDE.md 里的 Query 流程和目录权限。4.4 跑一次 Lintlint 一下正常会输出分级报告断链几处、孤立页几个、缺 frontmatter 几页。看到这份报告整套 LLM-Wiki 就算立起来了。5. 本篇常见错排查报错一401 Unauthorized或invalid api key。九成是环境变量没生效或 Key 写错。先echo $ANTHROPIC_AUTH_TOKEN确认值在再确认ANTHROPIC_BASE_URL是https://taotoken.net/api注意结尾不要多加/v1。改完变量要重开终端。报错二Claude 读不到 vault 文件。检查是不是在 vault 根目录启动的claude。如果你在子目录启动工作根就错了。另外确认.claude/config.toml里vault_root .没写错。报错三AI 改了raw/里的原文。说明权限没锁死。回到config.toml确认deny_write包含raw/**并在 CLAUDE.md 里再强调一次只读。双保险缺一不可。报错四Query 不引用笔记直接编答案。通常是wiki/index.md是空的AI 定位不到内容。先跑一次 Ingest 把索引填起来再试 Query。报错五Claudian 插件连不上。插件依赖本机 Claude CLI 路径去插件设置里把 CLI 路径填对并确认终端里claude能正常跑。插件和 Claude Code 共用同一套 TaoToken 环境变量。报错六lint 报大量断链。别慌这是正常的。第一次 lint 就是照妖镜按报告逐条修断链补建页面或改链接孤立页加 inbound link缺字段补 frontmatter。修完再 lint 一次对比。6. 把通道和规范固定下来让知识库自己生长走到这里你已经有了一个能自己摄入、自己检索、自己体检的知识库。剩下的就是把它变成日常习惯读完一篇文章顺手 ingest每周跑一次 lint遇到好答案让 AI 存回 wiki。如果你还没配好 Key先去 TaoToken 控制台把 API Key 建出来接入文档里有各客户端的详细参数想先验证模型回答质量可以直接用模型对话试几轮如果你打算长期跑 Claude Code 做编码和 Agent 任务Coding Plan 的额度模型更适合高频调用。通道稳定了CLAUDE.md 和 config.toml 这两份骨架就能一直复用你的 Obsidian 笔记库也就真正从死海变成了会生长的活物。
