企业官网建设流程全解析

1. 为什么要在 Obsidian 里接入 Claude Code 和 DeepSeek V4

Obsidian 是一款基于本地 Markdown 文件的笔记软件，所有数据都存在你自己的硬盘上，支持双向链接、标签体系和插件扩展。它适合谁？适合那些把知识库当成长期资产、不愿意把笔记托管在别人服务器上的知识工作者、学习者和开发者。但 Obsidian 原生只处理文本，遇到需要 AI 推理、翻译、总结、格式化的场景，就得靠外部工具补位。

Claude Code 是命令行形态的 AI 执行工具，能读写文件、执行指令、按项目规范处理文档。DeepSeek V4 是推理引擎，通过 API 调用，成本低、响应快。把这两个接进 Obsidian，你就能在笔记软件内部完成“选中文档 → 提问 → AI 处理 → 结果写回”的闭环，不用来回切换窗口。

我试过直接在 Obsidian 里用 Terminal 插件跑 Claude Code，再通过统一 API 通道把请求转发到 DeepSeek V4，整个过程数据不出本地仓库，只有推理请求走 API。这套方案的核心难点不在 Obsidian，而在 Claude Code 的 API 配置——默认它只认官方通道，要接第三方模型必须改 Base URL 和 Key。下面按步骤拆开讲，每一步都给可复制的配置片段。

2. TaoToken 前置准备：统一 Key 与 API 通道

TaoToken 在这里的角色是统一 API 通道。你不需要为 Claude Code 和 DeepSeek V4 分别维护两套 Key 和两套 Base URL，而是用同一个 Key 走同一个入口，模型 ID 区分调用哪个模型。对 Obsidian 场景来说，这意味着插件侧只需要填一次配置。

先拿到 Key。打开 TaoToken 官网，注册后进入控制台，在 API Keys 页面创建一个新 Key。建议命名成obsidian-kb方便识别。创建后立即复制保存，页面刷新后不再显示完整 Key。

Base URL 用https://taotoken.net/api，注意不要加 UTM 参数，这是给程序调用的地址。模型 ID 方面，Claude Code 场景填claude-code或对应的 Anthropic 模型标识，DeepSeek V4 场景填deepseek-v4。具体可用模型列表在文档页有对照表。

注意：Key 只显示一次，建议创建后直接粘贴到 Obsidian 插件的配置框里，不要先存到聊天记录或临时文件。

如果你打算长期在 Obsidian 里跑编码类、Agent 类任务，可以顺带看一下 Coding Plan 页面，它针对高频调用场景做了额度优化。只是偶尔问答的话，按量计费就够。

前置准备清单：

• TaoToken 账号 + API Key（控制台 → API Keys）
• Base URL：https://taotoken.net/api
• 模型 ID：claude-code（执行桥接）、deepseek-v4（推理）
• Obsidian 仓库路径（本地文件夹，确认有读写权限）

3. 可复制配置：Claude Code 与 Obsidian 插件侧填写

这一节是全文操作密度最高的部分。Claude Code 的配置走settings.json，Obsidian 插件侧走插件设置面板，两边都要填 Base URL、Key、Model ID 三件套。

3.1 Claude Code 的 settings.json 配置

Claude Code 读取用户级配置文件，路径按操作系统区分：

• macOS / Linux：~/.claude/settings.json
• Windows：C:\Users\你的用户名\.claude\settings.json

如果文件不存在就新建。写入以下内容：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoTokenKey", "ANTHROPIC_MODEL": "claude-code" } }

三个字段的作用：ANTHROPIC_BASE_URL把请求指向 TaoToken 通道；ANTHROPIC_API_KEY填你刚创建的 Key；ANTHROPIC_MODEL指定默认模型 ID。保存后重启终端，运行claude命令，如果不再提示登录官方账号，说明配置生效。

3.2 用 CC Switch 做多模型切换

如果你同时要用 Claude Code 和 DeepSeek V4，手动改settings.json太麻烦。CC Switch 是开源的多配置切换工具，安装后在界面里点右上角加号，新增一个供应商配置：

• 名称：TaoToken
• Base URL：https://taotoken.net/api
• API Key：你的 TaoToken Key
• 模型：claude-code或deepseek-v4

保存后点“测试连接”，显示正常就点启用。之后在终端里跑claude，请求会走 CC Switch 当前选中的配置。切换模型只需要在 CC Switch 里点一下，不用改文件。

3.3 Obsidian 插件侧填写

Obsidian 里推荐用 Terminal 插件或 Claude Code 插件。Terminal 插件在第三方插件市场搜索安装，安装后左侧出现终端图标，选“整合式模式”，终端工作目录就是当前仓库根目录。在终端里输入claude即可调用。

Claude Code 插件如果市场上线了直接搜装；没上线就去 GitHub Release 下载main.js、manifest.json、styles.css三个文件，放进.obsidian/plugins/claude-code/目录，重启 Obsidian 后在设置里启用。

插件设置面板里需要填的字段：

三件套缺一不可。只填 Key 不填 Base URL，请求会打到官方通道然后 401；只填 Base URL 不填 Model ID，插件不知道调哪个模型，会报reading choices之类的解析错误。

4. 验证请求：一次对话连通性测试

配置写完必须验证，不然你不知道是 Key 错了、Base URL 错了还是模型 ID 错了。验证分两步：先在终端里验 Claude Code，再在 Obsidian 里验插件。

4.1 终端侧验证

打开终端，进入你的 Obsidian 仓库目录：

cd /path/to/your/obsidian-vault claude

进入交互界面后输入一句测试：

请读取当前目录下的 README.md，用一句话总结它的内容。

如果返回了总结，说明 Claude Code 已经通过 TaoToken 通道调到了模型。如果报401，检查 Key 是否复制完整；如果报local proxy failed，检查 Base URL 是否写成了带 UTM 的地址，程序调用必须用https://taotoken.net/api。

4.2 Obsidian 插件侧验证

打开 Obsidian，按Ctrl+P（macOS 是Cmd+P）调出命令面板，搜索 Claude Code 插件对应的命令，比如“Open Claude Code Chat”。在对话框里输入：

当前文档的标题是什么？请只回答标题。

插件默认会选中你正在查看的文档。如果它正确返回了标题，说明插件侧的 Base URL、Key、Model ID 三件套都通了。返回内容为空或报reading choices，多半是 Model ID 填错，回插件设置里改成claude-code再试。

4.3 验证 DeepSeek V4 通道

把 CC Switch 或插件设置里的 Model ID 改成deepseek-v4，重复上面的对话测试。DeepSeek V4 在中文总结和格式化任务上表现稳定，适合处理笔记里的长文档。如果切换后报模型不存在，去 TaoToken 文档页核对当前可用的模型 ID 列表，不同时间上线的模型标识可能有调整。

验证通过后，你就有了一条完整的链路：Obsidian 选中文档 → 插件发请求 → TaoToken 通道 → Claude Code 或 DeepSeek V4 → 结果写回笔记。

5. 本篇常见错误排查

配置过程中最容易卡在几个固定报错上，逐个对照。

401 Unauthorized：Key 无效或没带上。检查settings.json里ANTHROPIC_API_KEY是否完整，有没有多余空格。Obsidian 插件侧检查 Key 输入框是否粘贴完整。如果 Key 是在控制台创建后过了很久才用，确认没有在控制台里误删。

local proxy failed / connection refused：Base URL 写错。常见错误是写成了https://taotoken.net/api?utm_source=...，程序调用不能带查询参数。正确写法就是https://taotoken.net/api。另一个可能是本地网络需要配置，但这里不展开。

reading choices / unexpected response：模型返回格式和插件预期不符。多数情况是 Model ID 填错，比如填了deepseek而不是deepseek-v4。回插件设置或settings.json核对模型 ID，确保和文档页一致。

OAuth 相关报错：Claude Code 仍在尝试走官方登录流程。说明ANTHROPIC_BASE_URL没生效。检查settings.json的路径对不对，Windows 用户注意是C:\Users\用户名\.claude\settings.json，不是C:\Users\用户名\AppData\...。改完必须重启终端。

插件加载失败：手动安装 Claude Code 插件时，三个文件必须放在.obsidian/plugins/claude-code/目录下，目录名要和manifest.json里的id一致。放错位置 Obsidian 不会识别，重启也没用。

终端里 claude 命令找不到：Claude Code 没装好或没加进 PATH。重新跑一遍安装命令，安装完关闭终端再开一个新窗口。

排查顺序建议：先确认 Key 有效 → 再确认 Base URL 无参数 → 再确认 Model ID 正确 → 最后确认配置文件路径。四步走完基本能定位问题。

6. 在 Obsidian 里跑通 AI 问答闭环

配置和验证都过了之后，日常使用其实很简单。打开一篇笔记，调出 Claude Code 插件对话框，直接提问。插件默认选中当前文档，AI 能读到全文。你可以让它翻译、总结、格式化、提取待办，结果直接写回笔记或新建文档。

如果要做更复杂的自动化，比如批量处理剪藏下来的网页、把英文文档翻译后归档到指定目录，可以在仓库根目录放一个claude.md文件，写明项目定位、目录结构、输出格式和语言规范。Claude Code 每次启动会读这个文件，按你的规范执行。比如你写“翻译后的文档放到translated/目录，原文档移到archive/”，它就会照做。

需要长期跑编码类或 Agent 类任务的话，Coding Plan 的额度模型比按量计费更划算。只是日常问答和文档处理，按量计费足够。模型对话页面可以用来单独验证某个模型 ID 是否可用，接入文档页有完整的参数说明和模型列表。

最后给一个实用技巧：Obsidian 的 Terminal 插件和 Claude Code 插件可以同时装。Terminal 适合跑需要看完整输出的命令，Claude Code 插件适合快速对话。两个都指向同一个 TaoToken Key，互不冲突。配置改一处，两边都生效。