1. 从“翻遍笔记找不到”到把 Claude 接进 Obsidian“想找之前记录的知识翻遍所有笔记却找不到”——这句话几乎是每个笔记用户的共同经历。Obsidian 把 Markdown 存在本地Git 负责给笔记上版本控制Claude 负责把散落的笔记整理出结构这三样组合起来确实能终结笔记混乱。但真正卡住多数人的往往不是笔记本身而是 Claude 的接入官方 API Key 要绑定支付方式额度用起来心里没数想在多个工具里切换模型还得反复改环境变量。TaoToken 把这一步统一成“一个 Key 一个 Base URL”的接入方式注册入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 。本文沿着 Obsidian Git Claude 这套工具链往下走把原文里列为进阶使用的 CC Switch 当作配置入口把 Claude 的 API 地址改到 TaoToken让 AI 辅助整理这件事真正落地。先交代一下整套工具链里每个角色的分工。Obsidian 是知识库本体所有笔记都是本地 Markdown 文件数据不依赖任何云服务Git 负责每次修改的历史记录误删了、改坏了都能回滚VSCode 是可选编辑器批量改笔记时比 Obsidian 自带编辑顺手Claude 负责“读笔记并给出整理建议”比如自动归拢主题、生成 MOC 索引CC Switch 则是管理 Claude 接入地址的小工具官方 API 要填 official 地址换成 TaoToken 后填 https://taotoken.net/api 就行。工具清单如下工具作用是否必须Obsidian本地 Markdown 笔记库必须Git版本控制、历史回滚必须VSCode批量编辑、正则替换可选ClaudeAI 辅助整理笔记进阶使用CC Switch切换 Claude API 接入地址进阶使用TaoToken统一 Claude API Key 与接入通道建议使用1.1 Obsidian 安装Mac 与 Windows 两条路Obsidian 的安装很简单。Mac 用户如果装了 Homebrew终端里执行brew install --cask obsidian不想用命令行的直接访问官网下载 macOS 版。Windows 用户同样有两个选择官网下载.exe安装包或者用 Scoop 执行scoop bucket add extras再scoop install obsidian。装完打开Obsidian 会要求你选择一个文件夹作为 Vault仓库这就是后面知识库的根目录。1.2 Git 安装给笔记上后悔药Git 的安装同样不复杂。Mac 上先git --version检查是否已装没装就brew install gitWindows 去 git-scm.com 下载安装包安装时保持默认选项即可但“PATH 配置”一定要选 “Git from the command line”否则后面 Git Bash 里找不到命令。装完以后先配置身份信息git config --global user.name 你的名字 git config --global user.email 你的邮箱这一步不做后面 commit 会提示缺用户名和邮箱还得回头补。2. 创建 Obsidian 仓库先让笔记有个家知识库本质上就是一个文件夹。原文建议的位置是 Mac 的~/Documents/my-knowledge-baseWindows 的D:\my-knowledge-base如果你用 Dropbox 或 OneDrive直接把文件夹放进同步目录就免费实现了跨设备同步。打开 Obsidian 点“创建新仓库”输入名称、选择位置、点创建主界面就出现了左侧是文件列表中间是编辑区右侧可以开预览。2.1 基础设置外观与编辑器点左下角齿轮进入设置。外观建议先把界面语言改成中文主题选 Default 或 Minimal 都行字体大小看你屏幕。编辑器设置里把“自动配对括号”“智能缩进”“显示行号”打开这些对写 Markdown 很友好。文件设置里把“附件默认位置”指向attachments文件夹以后粘贴图片不会四处乱飞。2.2 第一篇笔记欢迎与链接示例按 Cmd/Ctrl N 新建笔记先写几行熟悉一下 Markdown# 欢迎 这是我的第一篇 Obsidian 笔记 ## 我为什么选择 Obsidian - 本地存储数据自己掌控 - Markdown 通用性强迁移成本低 - 双向链接建立知识网络 - 插件生态丰富 ## 相关笔记 [[读书笔记/如何阅读一本书]]写完后在编辑模式点住[[读书笔记/如何阅读一本书]]按住 Cmd/Ctrl 点击Obsidian 会直接创建对应笔记。这一步是后面所有 AI 整理动作的基础——笔记之间先有链接Claude 才能顺着链接找出结构。3. 双向链接、标签与 MOC让笔记产生关联Obsidian 的核心不是文件夹而是链接和标签。[[笔记名]]是双向链接在 A 笔记里链到 B打开 B 时右侧会显示“哪些笔记链到了我”。标签则是纵向分类比如#编程/Python、#学习笔记。两者的区别在于标签适合粗粒度过滤链接适合表达笔记之间真正的关系。文件夹不是不能用而是别当唯一分类手段。推荐的结构是my-knowledge-base/ ├── 00-索引与模板/ │ ├── MOC-主页.md │ └── 模板-日记.md ├── 01-日记/ ├── 02-读书笔记/ ├── 03-技术文档/ ├── 04-项目管理/ ├── 05-归档/ ├── attachments/ └── .gitignoreMOCMap of Content是整个知识库的导航入口。它本身也是一篇笔记内容全是指向其他笔记的链接相当于“目录页”。MOC 做得越好AI 整理时就越容易从一团笔记里找出主线。4. Git 版本控制每次改动都可回滚知识库有了初始内容就该让 Git 接管。在终端或 Git Bash 里进入知识库目录cd ~/Documents/my-knowledge-base # Mac cd D:\my-knowledge-base # Windows git init4.1 配置 .gitignoreObsidian 的工作区配置窗口位置、最近打开的标签页不需要同步写入.gitignore排除掉.obsidian/workspace.json .obsidian/workspace-mobile.json .trash/ .DS_Store Thumbs.db *.tmp *.temp4.2 首次提交与远程仓库git add . git commit -m 初始化知识库 git remote add origin https://github.com/你的用户名/my-knowledge-base.git git push -u origin main推送到 GitHub/GitLab 之后笔记就真正“永不丢失”了本地一份、远程一份每次 commit 都是一次快照。这一套流程跟 Claude 没关系但它是 AI 整理的地基——Claude 不需要自己去 Git 历史里找数据而是基于当前这个结构清晰的 Vault 做归纳。5. CC Switch 里把 Claude 的 API 地址指到 TaoToken原文把 Claude 和 CC Switch 列为“进阶使用”并预告进阶篇会介绍工具管理。这里直接把这块补完CC Switch 是个 macOS 菜单栏小工具用来快速切换 Claude 客户端的 API 地址和 Key。官方 API 默认地址是https://api.anthropic.com而我们要改成 TaoToken 的接入地址。5.1 先去 TaoToken 创建 API Key在配置 CC Switch 之前需要先有一把 TaoToken 的 Key。流程是打开 TaoToken 注册账号登录后进入控制台的 API Keys 页面点创建 Key复制保存好。Key 形如一长串随机字符只显示一次记得立刻存在密码管理器里。5.2 CC Switch 自定义供应商参数打开 CC Switch选择“添加自定义供应商”或类似入口填写以下参数配置项填写内容供应商名称TaoTokenBase URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场列表为准三个容易踩的细节Base URL 末尾不要加/v1。很多人在 Anthropic 官方文档里看到的是https://api.anthropic.com/v1顺手就带上/v1结果请求直接 404。TaoToken 的接入地址是https://taotoken.net/api后面不带任何路径后缀。API Key 是占位符。上面表格里的YOUR_API_KEY只是示例实际要粘贴的是第 5.1 节在控制台创建的那串 Key。模型 ID 简洁化。有些模型 ID 很长包含日期版本号。CC Switch 这类工具吃模型 ID 时如果和模型广场列出的不一致会报 model not found。最保险的做法是打开模型广场页面对着当时的列表复制不要凭记忆手打。5.3 启用 TaoToken 并重启相关工具在 CC Switch 里选中刚添加的 TaoToken 供应商点击启用。此时需要重启正在运行的 Claude 客户端或 Obsidian 里调用 Claude 的插件让新配置生效。CC Switch 的原理是改写系统环境变量或本机配置不重启的话已运行的进程可能还记着旧的 API 地址。6. 回到 Obsidian 验证 AI 整理是否跑通配置完成后的验证方式很简单不需要写代码。回到 Obsidian在接入 Claude 的对话框或插件里输入一句把最近一周的笔记整理成 MOC如果 Claude 能正常返回一份结构化的 MOC 大纲比如按主题分组、列出相关笔记的链接说明整条链路已经走通Obsidian 里的文本被发送到 ClaudeClaude 处理后返回结果Token 在 TaoToken 侧正常消耗。你可以在 TaoToken 模型对话 里再验证一次——用同一把 YOUR_API_KEY 发一条测试消息确认模型 ID 和 Base URL 没有填错。这里有一个值得养成的习惯第一次验证通过后去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台看这次调用的计量记录。正常的话上方会多出一条和 Obsidian 发送时间对应的请求记录包含模型名、输入 Token、输出 Token 和耗时。看到这条记录就说明 Claude 确实在通过 TaoToken 消耗 Token而不是走了其他通道或本地兜底。7. 常见问题改完地址后最可能碰到的三个错401 Unauthorized / Invalid API Key。检查 CC Switch 里填的 Key 是否和 TaoToken 控制台创建的一致。复制时容易多复制一个空格或换行符。重新到控制台创建一把新 Key确认YOUR_API_KEY替换干净后粘贴。不要两边共用 Key 的地方改一半留一半。404 Not Found / 路径不存在。绝大多数原因是 Base URL 多了/v1。TaoToken 的接入地址是https://taotoken.net/api不是https://taotoken.net/api/v1。在 CC Switch 里重新检查供应商配置把 Base URL 改干净。Model not found。模型 ID 填错了。去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场复制当前列表里的准确 ID。不要凭记忆填带日期后缀的旧格式模型 ID 可能随版本更新变化以广场实时列表为准。改完配置后 Obsidian 里的 AI 面板还是报错关掉 Obsidian 和 CC Switch重新打开一次。CC Switch 切换的是环境变量进程不重启不会重新读取。若仍报错把报错原文贴回对话绝大多数情况在排查这三项后都能解决。整个工具链里Obsidian 负责存Git 负责守Claude 负责整理TaoToken 负责把 Claude 的接入变得干净利落。数据始终在你的本地文件夹和 Git 仓库里AI 只是那个帮你把 MOC 搭好的助手。下一步想把整理能力用得更重可以打开 Coding Plan 看看长期跑 AI 整理的套餐是否够用Key 需要重新创建或轮换时去 控制台 API Keys 操作如果之后要用 Claude Code 做更重的代码类笔记整理环境变量对照可以参考 Claude Code 接入文档。