Claude Code 走 Obsidian 的 MCP，模型认证改到 TaoToken 通道

Claude Code 走 Obsidian 的 MCP模型认证改到 TaoToken 通道本文处理 Claude Code 接 Obsidian MCP 时模型认证改到 TaoToken 通道的具体配置。先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并创建 Key模型 Base URL 使用 https://taotoken.net/api。很多人在安装 Claude Code 后卡在验证方式选择账号验证通常要求 Claude Pro/Max 订阅并配合全局代理如果你只想让 Claude Code 通过 obsidian-http-mcp 读写本地 VaultAPI 验证更直接。TaoToken 在这里只负责提供 Key 和 Base URL不替代 obsidian-http-mcp也不接管 MCP 服务器。配置完成后仍然要回到 claude mcp add 注册 Obsidian MCP再用 /ide 选择 Obsidian验证 Claude Code 能读 Vault。下面把流程拆成六段重点放在 settings.json、ANTHROPIC_* 环境变量、claude mcp add 和 /ide 验证。一、原问题与场景Claude Code 接 Obsidian 时为什么先改模型认证这个场景很明确Obsidian 负责本地 Markdown 知识库Claude Code 负责执行工作流obsidian-http-mcp 负责把 Vault 通过 HTTP MCP 暴露给 Claude Code。目标不是换掉 Obsidian也不是换掉 obsidian-http-mcp而是让 Claude Code 在启动后先能正常调用模型再去读取和整理笔记。原文第三、四节把 Claude Code 安装后的验证方式分成账号验证和 API 验证并在第四节用 obsidian-http-mcp claude mcp add 把 Obsidian Vault 接进 Claude Code。问题在于账号验证这条路对部分用户来说门槛偏高需要 Claude Pro/Max 订阅还可能需要全局代理环境。很多用户的实际需求只是让 Claude Code 读写本地笔记跑日报、会议纪要、批量标签、历史笔记检索等任务并不想为了模型认证再维护一套代理环境。所以更合理的拆法是模型认证走 API 通道MCP 接入继续走 obsidian-http-mcp。Claude Code 的模型认证决定它调用哪个大模型、请求发到哪个 Base URLMCP 认证决定它能否访问 obsidian-http-mcp 暴露出来的 Obsidian 工具。这两件事必须分开理解否则排查时会混乱。把模型认证改到 TaoToken 通道后Base URL 填 https://taotoken.net/api不带 /v1Key 使用你在官网创建的 YOUR_API_KEY。TaoToken 只提供 Key 和 Base URL不替代 obsidian-http-mcp也不接管 MCP 服务器。Obsidian Local REST API 的 Key、obsidian-http-mcp 的配置、Claude Code 的模型 Key 是三个独立环节。二、TaoToken 前置注册、创建 Key、确认 Base URL这一段只做前置准备不展开复杂配置。步骤很短打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号。进入控制台创建 API Key复制保存。本文统一写成 YOUR_API_KEY实际替换成你自己的 Key。确认模型 Base URL 为 https://taotoken.net/api。注意这里不要加 /v1不要写成 https://taotoken.net/api/v1。如果后续要排查接入问题可以同时打开接入文档和 API Keys 页面对照 Key 与 Base URL 是否一致。这里要特别提醒TaoToken 在本篇中的角色非常窄只负责 Claude Code 的模型通道也就是提供 Key 和 Base URL。它不替代 obsidian-http-mcp也不接管 MCP 服务器。obsidian-http-mcp 仍然负责和 Obsidian Local REST API 通信Claude Code 仍然通过 claude mcp add 去注册这个 MCP 服务器。你从官网拿到 Key 后先让 Claude Code 的模型通道配通再继续跑原文的日报、会议纪要等消耗 Token 的任务。另外不要把两个 Key 搞混。Obsidian Local REST API 插件会生成一个 API Key这个 Key 给 obsidian-http-mcp 使用用于访问你的 VaultTaoToken 的 Key 给 Claude Code 使用用于调用模型。前一个 Key 失效表现为 MCP 工具读不到笔记后一个 Key 失效表现为 Claude Code 请求模型时报 401 或认证失败。三、可复制配置settings.json 与 ANTHROPIC_* 改到 TaoToken 通道Claude Code 的模型认证可以走 settings.json也可以走环境变量。建议二选一改完后重开终端避免旧环境变量或旧登录态残留。方式一写入 Claude Code 的 settings.json。常见位置是用户目录下的 ~/.claude/settings.json也可以放在项目的 .claude/settings.json。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: MODEL_ID } }如果你不想在 settings.json 里写模型名可以先不写 ANTHROPIC_MODEL或留空使用默认模型。需要指定时把 MODEL_ID 换成你在 TaoToken 控制台或文档中确认的模型 ID。注意 ANTHROPIC_BASE_URL 的值必须是 https://taotoken.net/api不带 /v1。方式二使用环境变量。Linux 或 macOS 可以写在 shell 配置里也可以临时导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELMODEL_IDWindows PowerShell$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKENYOUR_API_KEY $env:ANTHROPIC_MODELMODEL_ID改完后关闭当前终端重新打开再启动 Claude Code。启动后如果仍然提示账号登录说明认证配置没有生效优先检查 settings.json 路径、变量名拼写、Key 是否替换、终端是否重启。模型通道配好后再处理 Obsidian MCP。先确保 Obsidian 里安装了 Local REST API 插件并开启 Non encrypted (HTTP) API复制它生成的 API Key。然后安装并配置 obsidian-http-mcpnpm install -g obsidian-http-mcp obsidian-http-mcp --setup在 --setup 过程中填入 Obsidian Local REST API 的 Key配置会保存到 ~/.obsidian-mcp/config.json。接着启动 MCP 服务器obsidian-http-mcp服务器默认运行在 http://localhost:3000/mcp。然后回到 Claude Code执行 claude mcp add。不同 Claude Code 版本命令可能略有差异常见写法claude mcp add obsidian --transport http http://localhost:3000/mcp如果当前版本不支持 --transport可以尝试claude mcp add obsidian http://localhost:3000/mcp也可以写入项目级 .mcp.json{ mcpServers: { obsidian: { type: http, url: http://localhost:3000/mcp } } }这里再次强调TaoToken 的配置写在 Claude Code 的 settings.json 或 ANTHROPIC_* 环境变量里obsidian-http-mcp 的配置写在 ~/.obsidian-mcp/config.json 里。两者不要混写。TaoToken 不替代 obsidian-http-mcp也不接管 MCP 服务器。四、验证请求与成功结果claude mcp list 与 /ide 能读到 Vault配置完成后不要直接上复杂任务先分两步验证。第一步验证模型通道。启动 Claude Codeclaude然后问一个简单问题例如“你好请回复当前连接正常”。如果模型能正常回复说明 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 基本生效请求已经走到 https://taotoken.net/api。若这里报 401 或 404先回到第三节检查 Key 和 Base URL不要急着排查 MCP。第二步验证 MCP 通道。保持 obsidian-http-mcp 在终端中运行另开一个终端执行claude mcp list如果配置正确你应该能看到类似obsidian: http://localhost:3000/mcp (HTTP) - Connected然后进入 Claude Code输入/ide选择 Obsidian。接着可以发一条实际读取请求列出我 Obsidian Vault 根目录下的 Markdown 文件并读取最近修改的一篇笔记的前 20 行。成功结果应该同时满足这几个条件Claude Code 正常调用模型不提示账号验证或登录。/ide 或 MCP 工具列表里能看到 Obsidian。Claude Code 返回 Vault 中的 Markdown 文件列表。读取到的笔记内容与你本地 Obsidian 中看到的一致。日报、会议纪要、批量标签等任务可以继续跑模型请求不再因为 API 认证失败而中断。如果模型能回复但读取笔记失败说明 TaoToken 模型通道已经通了问题集中在 obsidian-http-mcp、Local REST API 或 claude mcp add。如果模型本身报错说明问题在 Claude Code 的 settings.json 或 ANTHROPIC_* 环境变量。两类问题分开排查效率最高。五、本篇常见错排查401、404、/v1、localhost 与 MCP 未连接下面是本篇最容易遇到的错误和排查顺序。第一401 或认证失败。常见原因是 YOUR_API_KEY 没有替换成真实 Keysettings.json 放错目录环境变量没有重启终端生效或者 ANTHROPIC_AUTH_TOKEN 拼写错误。先确认 Claude Code 读取的是哪个配置文件再确认 Key 是否复制完整。第二404 或路径错误。最常见的是把 Base URL 写成 https://taotoken.net/api/v1。Claude Code 或 Anthropic SDK 可能自动追加 /v1/messages最后变成重复路径。正确写法是 https://taotoken.net/api不带 /v1。第三仍然提示账号登录。说明模型认证没有覆盖成功。检查 settings.json 是否在 ~/.claude/settings.json 或项目 .claude/settings.json检查 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否设置关闭终端重开再启动 claude。第四claude mcp list 里没有 obsidian 或状态不是 Connected。先确认 obsidian-http-mcp 是否正在运行再确认端口是不是 3000是否被其他程序占用。然后检查 Obsidian 是否打开Local REST API 插件是否启用Non encrypted (HTTP) API 是否开启obsidian-http-mcp --setup 时填的 Key 是否与插件中的一致。第五/ide 里看不到 Obsidian。常见原因是 claude mcp add 没有成功写入配置或者 Claude Code 没有重启。可以删除后重新添加也可以检查 .mcp.json 中的 mcpServers 配置。若 Claude Code 运行在 WSL 或远程服务器localhost 不一定指向运行 Obsidian 的主机需要把 localhost 换成实际可达的 IP 地址并检查防火墙和端口转发。第六BrokenPipeError 或笔记读写不稳定。原文提到直接文件访问方案存在稳定性问题若你遇到类似报错优先走 obsidian-http-mcp 的 HTTP MCP 方案而不是让 Claude Code 直接扫描 Vault 目录。第七模型名错误。如果你在 settings.json 里写了 ANTHROPIC_MODEL但 MODEL_ID 不存在或拼写错误也可能导致请求失败。可以先移除该字段让 Claude Code 使用默认模型或换成确认可用的模型 ID。第八混淆两个 Key。TaoToken Key 解决模型认证Obsidian Local REST API Key 解决 MCP 访问 Vault。401 多半看 TaoToken KeyMCP 读不到笔记多半看 Obsidian Local REST API Key。六、语义一致 CTA先把模型通道配通再跑日报与会议纪要把 Claude Code 的模型认证改到 TaoToken 通道不是为了替换 Obsidian也不是为了替换 obsidian-http-mcp。它只是把原来依赖账号验证和全局代理的那一步改成 Key Base URL 的接入方式。模型通道配通后你仍然按原流程执行 claude mcp add再用 /ide 选择 Obsidian验证 Claude Code 能读 Vault。之后就可以继续跑日报、会议纪要、批量标签、历史笔记整理等消耗 Token 的任务。如果你在 settings.json、ANTHROPIC_*、claude mcp add 或 /ide 这一步遇到报错优先查看 API Keys 和接入文档API Keyshttps://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/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话如果你准备把 Claude Code Obsidian 当成长期知识库 Agent持续跑日报、会议纪要和批量笔记任务可以了解 Coding PlanCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan需要查看 Key 状态和用量时进入控制台控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleClaude Code 的 Anthropic 接入说明可以看这里ClaudeCodeAnthropichttps://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentClaudeCodeAnthropic整个链路的关键顺序是先在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建 Key把 Claude Code 的 ANTHROPIC_BASE_URL 指向 https://taotoken.net/api确认模型能回复再启动 obsidian-http-mcp执行 claude mcp add最后用 /ide 选择 Obsidian让 Claude Code 真正读到你的 Vault。模型通道和 MCP 通道都验证通过后再让 Agent 去处理日报、会议纪要和知识库整理任务。