1. 为什么要把 Obsidian CLI 和 Claude Code 接在一起Obsidian 1.12.4 之后官方 CLI 把笔记库从「需要点开的应用」变成了「随时可调用的基础设施」。你可以在终端里obsidian daily打开今日日记用obsidian search queryPKM全文检索甚至obsidian daily:append content...直接追加想法。但 CLI 本身只解决「读写」不解决「理解」——它不会帮你总结 30 篇日记、不会把散落的会议记录整理成周报、也不会把一篇投资笔记改写成小红书文案。Claude Code 正好补上这一块。它是一个跑在终端里的编码 Agent能读文件、执行命令、多轮推理。把 Obsidian CLI 当作 Claude Code 的「手」让 Claude Code 当「大脑」你就能用一句自然语言驱动整个知识库搜索、读取、归纳、生成、回写全在终端里闭环。这个组合适合三类人一是笔记量已经上千、手动整理成本太高的 PKM 玩家二是想把日记、会议、项目笔记自动汇总成周报的职场人三是习惯终端工作流、不想在 GUI 和 AI 网页之间反复切换的开发者。核心检索词就是「Obsidian CLI Claude Code 本地知识库自动化」本文交付的是可复制的环境变量、Base URL 配置以及一次从检索到自动生成的端到端验证。难点在于 Claude Code 默认走 Anthropic 官方通道国内直连不稳定而且你可能有多个 AI 工具Claude Code、Cline、Codex需要各自配 Key管理起来很碎。TaoToken 的作用就是提供一个统一的 API 通道和统一 Key把 Base URL 收敛成一个模型 ID 也统一管理。下面从环境准备开始一步步把这条链路打通。2. TaoToken 统一 Key 与 Claude Code 接入前置先说清楚 TaoToken 在这里扮演什么角色。它是一个 API 聚合与转发服务对外暴露一个兼容 Anthropic 协议的 Base URL你用一把 Key 就能调用 Claude 系列模型。对 Claude Code 来说它只认ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量所以只要把这两个指向 TaoTokenClaude Code 就通过统一通道工作了。你需要先拿到两样东西API Key 和确认 Base URL。Key 在控制台的 API Keys 页面创建地址是https://taotoken.net/api-keys带 UTM 的完整链接见文末 CTA。Base URL 固定为https://taotoken.net/api注意这个地址后面不加 UTM 参数直接写进配置即可。模型 ID 方面Claude Code 场景常用的是claude-sonnet-4-5这类标识具体以控制台模型列表为准。这里有个容易踩的坑Claude Code 对模型名有校验如果你填了一个它不认识的 ID会在启动时报model not found。所以配置前先去模型对话页面确认一下当前可用的模型 ID地址是https://taotoken.net/models。环境变量配置分两种场景。临时验证用 shell 导出长期使用写进配置文件。Windows PowerShell 和 macOS/Linux 的写法不同下面分别给。注意不要把 Key 硬编码进脚本提交到 Git建议用.env或系统环境变量。还有一个前置动作确认 Obsidian CLI 已经可用。在终端运行obsidian version能输出Obsidian CLI 1.12.4就说明 PATH 配好了。如果提示 command not found手动把 Obsidian 安装目录加进当前会话 PATHWindows 下通常是$env:LOCALAPPDATA\Programs\Obsidian\。这一步不做后面 Claude Code 调用obsidian命令会直接失败。3. 可复制的环境变量与 settings 配置片段这一节是全文最核心的可复制部分。Claude Code 的配置入口是~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json同时环境变量会覆盖文件配置。我建议两者都配文件里放 Base URL 和模型环境变量里放 Key这样 Key 不进版本库。先看 settings.json 的完整片段路径和字段名保持和官方一致{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-5, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5 }, permissions: { allow: [ Bash(obsidian:*) ] } }这里permissions.allow里加了Bash(obsidian:*)意思是允许 Claude Code 执行所有以obsidian开头的命令。不加这一条Claude Code 每次想调用obsidian search都会弹权限确认自动化就断了。这是很多人第一次配完发现「AI 不动手」的原因。然后是环境变量。macOS/Linux 写进~/.zshrc或~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-5Windows PowerShell 写进$PROFILE$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY sk-你的TaoToken密钥 $env:ANTHROPIC_MODEL claude-sonnet-4-5如果你同时用 Cline 或 Codex它们的配置也要指向同一个 Base URL。Cline 在 VS Code 设置里填 API Provider 为 Anthropic CompatibleBase URL 填https://taotoken.net/apiKey 同一把。Codex 的auth.json里OPENAI_BASE_URL换成 TaoToken 的兼容地址Key 复用。这样三件套Base URL Key Model ID在多个工具间保持一致换工具不用重新申请。配完记得开新终端窗口让环境变量生效。可以用echo $env:ANTHROPIC_BASE_URLPowerShell或echo $ANTHROPIC_BASE_URLbash确认输出正确。如果输出为空说明配置文件没被加载检查 shell 的 profile 路径。4. 端到端验证从笔记检索到自动生成周报配置对不对跑一次真实任务就知道。这一节给一个完整动作让 Claude Code 先检索笔记库再生成一份周报最后写回 Obsidian。全程在终端完成。第一步确认 Claude Code 能启动并识别模型。运行claude进入交互模式输入/status看 Base URL 是否显示https://taotoken.net/api模型是否是你在 settings 里配的那个。如果显示的还是官方地址说明环境变量没生效回到上一节检查。第二步给 Claude Code 一个组合指令。在交互模式里输入先用 obsidian search query本周 formatjson 检索本周相关笔记 读取返回的文件路径总结出「本周完成事项、待办事项、学习收获」三部分 生成一份 Markdown 周报然后用 obsidian create 写入到 Weekly/ 目录。Claude Code 会先执行obsidian search拿到 JSON 结果解析出文件列表再逐个读取内容。这里依赖 Obsidian CLI 的formatjson输出它把搜索结果结构化Claude Code 解析起来比纯文本稳。如果搜索没结果检查你的笔记里是否真的有「本周」关键词或者换成query[tag:work]按标签搜。第三步观察执行过程。正常的话你会看到 Claude Code 依次调用obsidian search、读取文件、生成内容最后调用obsidian create name周报-2026-W09 content...。创建成功后去 Obsidian 里刷新Weekly 目录下应该出现新笔记。这一步成功说明「检索 → 理解 → 生成 → 回写」整条链路通了。第四步验证写入内容。打开生成的周报检查三部分是否都有内容。如果某部分为空可能是对应笔记没被检索到回到第二步调整 query。也可以手动跑一次obsidian search query完成 formatjson看原始返回确认数据源没问题。实测下来这个流程对 50 篇以内的笔记库响应很快超过 200 篇时建议先用标签或文件夹缩小检索范围否则 Claude Code 读取的文件太多token 消耗和耗时都会上去。一个实用技巧在指令里加「最多读取 20 篇」让它自己控制范围。5. 常见报错排查401、local proxy failed 与 reading choices配这套组合报错基本集中在四类。下面按真实错误信息对照排查。第一类401 Unauthorized或invalid api key。这是 Key 问题。先确认ANTHROPIC_API_KEY的值没有多余空格或换行PowerShell 里用$env:ANTHROPIC_API_KEY.Length看长度是否合理。再确认 Key 没有过期或被删去控制台 API Keys 页面核对。如果 Key 正确但仍 401检查 Base URL 是不是写成了带路径的https://taotoken.net/api/v1Claude Code 要求 Base URL 到/api为止多写路径会导致鉴权失败。第二类local proxy failed或连接超时。这通常是网络层问题不是配置问题。先ping taotoken.net看能否解析再用curl https://taotoken.net/api看是否返回。如果 curl 也超时说明当前网络到服务端不通换网络环境重试。注意不要用任何非正规的网络工具这类工具本身有合规风险且经常导致证书错误。如果 curl 返回 200 但 Claude Code 仍报 proxy failed检查系统代理设置是否干扰了 Claude Code 的请求。第三类reading choices或unexpected response format。这个错误说明 Claude Code 收到了响应但结构不符合预期。常见原因是模型 ID 填错比如填了一个 TaoToken 不支持的模型名服务端返回了错误结构。去模型对话页面确认可用模型 ID改成正确的再试。另一个原因是 Base URL 指向了非 Anthropic 兼容的端点确认你用的是https://taotoken.net/api而不是其他路径。第四类OAuth相关报错比如oauth token expired。Claude Code 某些版本会尝试走 OAuth 流程如果你已经用 API Key 认证需要在 settings 里禁用 OAuth。检查~/.claude/settings.json里是否有forceLoginMethod字段设为apiKey。如果报错里出现OAuth但你没主动用过多半是旧版配置残留清空~/.claude/下的缓存文件重试。排查顺序建议先看错误码401 查 Key超时查网络格式错查模型 IDOAuth 查认证方式。每次改完配置开新终端避免旧环境变量干扰。如果四类都排除了还不行去接入文档页面看最新的配置示例地址是https://taotoken.net/doc。6. 把统一 Key 用在长期编码与 Agent 工作流单次验证跑通只是开始。真正省事的地方在于TaoToken 的统一 Key 让你在多个 AI 工具之间共享同一套认证不用每个工具单独申请、单独配。Claude Code 用来做知识库自动化和终端编码Cline 用来在编辑器里补全和重构Codex 用来跑批量脚本三者 Base URL 和 Key 一致切换成本几乎为零。如果你打算把 Obsidian 自动化做成日常习惯建议固化几个指令模板。比如每天早上跑一次「检索昨日日记提取待办写入今日日记」每周五跑一次「汇总本周笔记生成周报」。这些模板可以存成 shell 脚本用claude -p 指令非交互模式执行配合系统定时任务知识库就真的变成「会自己整理的基础设施」了。长期高频使用的话Coding Plan 比按量计费更划算适合每天都要跑 Agent 任务的场景。模型对话页面可以用来快速验证某个模型 ID 是否可用接入文档页面有各工具的完整配置示例。这三个入口按需取用不用记收藏即可。最后留一个我自己的习惯所有 AI 生成的笔记在 frontmatter 里加一个generated: true属性。这样以后检索时可以排除或单独筛选 AI 产出避免人工笔记和自动内容混在一起。Obsidian CLI 的properties:set命令可以直接写这个属性配合 Claude Code 的指令生成时自动打标。这个小动作用久了会感谢自己。CTA 分流排障与接入配置API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc验证模型可用性模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodels长期编码与 Agent 工作流Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan