HoRain云--Obsidian + Claude Code 配 TaoToken：settings.json 骨架与连通性验证

1. 为什么要在 Obsidian 里接 Claude CodeObsidian 的核心卖点是本地 Markdown 笔记库文件全在你自己的磁盘上配合双向链接和插件生态很适合程序员做长期知识沉淀。Claude Code 则是 Anthropic 的编程助手能读代码、改代码、查问题。把两者拼在一起笔记库就变成了一个能对话、能自动整理、能批量改文档的智能工作空间。问题出在接入环节。Claude Code 默认走 Anthropic 官方通道国内直连经常超时而且账号和计费是分开的。如果你同时在 Obsidian、终端、编辑器里用 Claude Code每个地方都要单独配一遍 Key改起来很烦。TaoToken 在这里的作用是提供一个统一的 Key 和 API 通道base_url 指向https://taotoken.net/apiClaude Code 的settings.json里改一处所有调用都走同一条路。这篇聚焦的是 Obsidian 笔记库场景下通过 Claude Code 接入 TaoToken 的settings.json骨架以及一次最小对话请求的连通性验证。适合已经在用 Obsidian、想给笔记库加 AI 能力、但不想在每个工具里重复配 Key 的人。下面从环境准备开始一步步给可复制的配置。2. TaoToken 前置拿 Key 和确认通道在写settings.json之前先把两件事做完拿到 API Key确认 base_url 和模型名。2.1 获取 API Key打开 TaoToken 控制台进入 API Keys 页面创建一个新 Key。创建时建议按用途命名比如obsidian-claude-code方便以后区分是哪个工具在用。Key 只在创建时完整显示一次复制后先存到安全的地方。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite2.2 确认 base_url 和模型TaoToken 的 API 根地址是https://taotoken.net/api注意这里不带任何 UTM 参数配置里写干净地址就行。模型名以控制台或文档里列出的为准Claude Code 场景下通常用 Claude 系列模型标识。如果你不确定当前可用哪些模型可以在模型对话页面先试一次确认模型名拼写正确。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite注意Key 不要直接提交到 Git 仓库也不要写进笔记正文。settings.json里用占位符真实 Key 通过环境变量注入后面会给具体做法。3. 可复制配置settings.json 骨架Claude Code 读取配置的位置和优先级决定了你把settings.json放在哪。下面给一个最小可用骨架再解释每个字段。3.1 配置文件位置Claude Code 的用户级配置通常放在~/.claude/settings.jsonWindows 是%USERPROFILE%\.claude\settings.json。如果你只想让 Obsidian 库单独走一套配置也可以在库目录下放项目级配置但用户级更省事所有调用共享同一份。先建目录mkdir -p ~/.claude3.2 settings.json 骨架把下面内容写入~/.claude/settings.json。ANTHROPIC_AUTH_TOKEN先用占位符下一步用环境变量替换。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-your-taotoken-key-here, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Write, Edit, Bash(git status), Bash(git diff) ] } }字段说明字段作用取值ANTHROPIC_BASE_URLAPI 根地址https://taotoken.net/apiANTHROPIC_AUTH_TOKEN鉴权 Key你的 TaoToken KeyANTHROPIC_MODEL默认模型控制台确认的模型名permissions.allow允许的工具调用按需增减3.3 用环境变量注入 Key直接把 Key 写进 JSON 有泄露风险。更稳的做法是在 shell 里导出环境变量settings.json里引用。编辑~/.zshrc或~/.bashrcexport ANTHROPIC_AUTH_TOKENsk-your-taotoken-key-here export ANTHROPIC_BASE_URLhttps://taotoken.net/api然后source ~/.zshrc生效。这样settings.json里可以只保留 base_url 和模型Key 从环境变量读。如果你用的是 Obsidian 的 Claudian 插件插件启动时会继承 shell 环境前提是从终端启动 Obsidian或者系统级环境变量已配置。3.4 Obsidian 侧的插件配置Obsidian 里通过 Claudian 插件调用 Claude Code。插件安装后在设置里把模型通道指向同一套配置。如果你在插件里看到自定义 base_url 或 API Key 输入框填https://taotoken.net/api和你的 Key如果插件直接复用 Claude Code 的settings.json那上面配好就不用重复填。插件安装路径示例.obsidian/ └── plugins/ └── claudian/ ├── main.js ├── manifest.json └── styles.css启用插件后左侧边栏会出现聊天入口命令面板输入Claudian: Open Chat也能打开。4. 验证请求一次最小对话配置写完先别急着在 Obsidian 里跑复杂任务。用终端做一次最小请求确认通道通。4.1 用 curl 验证curl -s https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: $ANTHROPIC_AUTH_TOKEN \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [ {role: user, content: 只回复两个字连通} ] }如果返回 JSON 里content字段有文本说明 Key、base_url、模型名三者都对。如果返回 401检查 Key返回 404检查 base_url 是否多了斜杠或少了/v1返回模型不存在检查模型名拼写。4.2 用 Claude Code CLI 验证终端直接跑claude -p 只回复两个字连通-p是单次执行模式不进入交互。如果这条命令能返回结果说明settings.json已被正确读取。这一步通过后Obsidian 里的 Claudian 插件基本也能通因为插件底层调的是同一套 Claude Code 配置。4.3 在 Obsidian 里跑一次打开任意笔记调出 Claudian 聊天输入帮我在这篇笔记末尾追加一行「连通性验证通过」不要改动其他内容。观察它是否只追加一行、是否用了正确的文件路径。如果它读到了你的库文件并成功写入说明整条链路——Obsidian → Claudian → Claude Code → TaoToken → 模型——已经打通。5. 本篇常见错排查配置过程中最容易卡在几个地方下面按现象给排查路径。5.1 401 鉴权失败最常见的原因是 Key 没生效。先确认环境变量是否导出echo $ANTHROPIC_AUTH_TOKEN如果输出为空说明 shell 没加载。检查~/.zshrc或~/.bashrc是否 source 过或者 Obsidian 是不是从图形界面启动、没继承终端环境。这种情况把 Key 直接写进settings.json的env字段可以临时绕过但记得之后换成环境变量。5.2 连接超时或 DNS 失败如果 curl 卡住不动先确认网络能解析taotoken.netnslookup taotoken.net能解析但连接超时检查是否有本地防火墙拦截。注意不要使用任何非正规的网络加速手段这类工具本身有合规风险而且会干扰 API 请求的证书校验。5.3 模型名不匹配报错里出现model not found或类似字样说明ANTHROPIC_MODEL写的名字当前通道不支持。回到模型对话页面确认可用模型列表把名字原样复制进配置。模型名大小写和版本后缀都要一致。5.4 Obsidian 插件读不到配置Claudian 插件如果独立维护自己的配置可能不会读~/.claude/settings.json。这时在插件设置里手动填 base_url 和 Key。如果插件设置里没有这些字段检查插件版本是否支持自定义通道必要时更新插件。5.5 权限被拒Claude Code 默认会询问文件写入权限。如果你在permissions.allow里没放Write或Edit插件里让它改笔记会被拒。按需把Read、Write、Edit加进 allow 列表但不要无脑放开Bash全部命令尤其是涉及删除的操作。6. 长期使用与入口汇总配置跑通之后日常使用就是打开 Obsidian、调出 Claudian、让它读写笔记。如果你打算长期在编码和 Agent 场景里用可以考虑 Coding Plan它更适合高频调用和批量任务。如果只是偶尔验证模型效果模型对话页面就够用。Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteClaude Code 接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content一个实用习惯把settings.json里的模型名和 base_url 当成「通道配置」Key 当成「凭证」两者分开管理。通道配置可以提交到你的 dotfiles 仓库凭证永远走环境变量或密钥管理工具。这样换机器、换笔记库、换插件时只需要重新注入一次 Key通道配置直接复用。