【OpenClaw】通过 Nanobot 源码学习架构：从入口到消息总线的总体设计拆解
2026/10/2 6:37:51
1. 为什么要在 Claude Code 里接入 DeepSeek
Claude Code 是 Anthropic 推出的终端编程助手，本身默认走官方服务。但很多开发者手里已经有 DeepSeek 的 Key，或者希望用 DeepSeek 的长上下文、低成本来做代码补全、重构、写测试。问题在于：Claude Code 的配置项和环境变量都围绕 Anthropic 协议设计，直接换 Key 会报 401，或者卡在Not logged in · Run /login。
我试过把 DeepSeek 直接塞进 Claude Code，核心思路其实就一句话：Claude Code 认的是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN，只要把这两个指向兼容 Anthropic 协议的通道，模型就能换成 DeepSeek。而 TaoToken 在这里扮演的角色，是提供一个统一的 Key 和 API 通道，让你不用在多个平台之间反复切换 Key，也不用改代码逻辑，只改配置就能把后端模型从 Claude 换成 DeepSeek。
这篇教程面向的是已经有 Claude Code 环境、想新增或切换 DeepSeek 作为后端模型的开发者。你会拿到三样东西：可复制的 Base URL 与 Key 配置片段、settings.json的完整修改示例、以及一次真实对话调用的验证动作。全程不需要动 Claude Code 的源码，也不需要理解 Anthropic 的协议细节，照着改配置就能跑通。
先说清楚适用人群：如果你只是偶尔用网页版问问题，这篇对你意义不大；但如果你每天在终端里跑claude做代码审查、批量改文件、写单元测试，那把后端换成 DeepSeek 能明显压低成本，同时保留 Claude Code 的交互体验。下面从环境准备开始，一步步来。
2. TaoToken 前置准备与 Claude Code 环境确认
在改配置之前，先把两件事确认好：Claude Code 是否装好、TaoToken 的 Key 是否拿到。这两步任何一步缺失，后面都会报错。
2.1 确认 Claude Code 已安装
如果你还没装 Claude Code，用 npm 全局安装即可：
npm install -g @anthropic-ai/claude-code装完后验证版本：
claude -v能打印出版本号就说明命令可用。如果提示command not found，检查 npm 全局 bin 目录是否在 PATH 里。Windows 用户可以用npm config get prefix看全局路径，把它加到系统环境变量。
2.2 获取 TaoToken 的 API Key
TaoToken 的定位是统一 Key 通道，你只需要一个 Key 就能调用包括 DeepSeek 在内的多个模型。获取入口在控制台的 API Keys 页面：
https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite登录后创建一个新 Key，复制出来。注意 Key 只在创建时完整显示一次，关掉页面就看不到了，建议先存到密码管理器里。
2.3 确认 Base URL 与模型 ID
TaoToken 的 API 根地址是：
https://taotoken.net/api注意这个地址不带 UTM 参数，是纯 API 端点。Claude Code 需要的是 Anthropic 兼容路径，所以实际填进配置的 Base URL 要指向兼容层。模型 ID 方面，DeepSeek 常用的有deepseek-chat、deepseek-reasoner等，具体以 TaoToken 控制台模型列表为准。你可以在模型对话页面先试一下模型是否可用：
https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite提示：Base URL 和 Key 是两回事。Base URL 决定请求发到哪个通道，Key 决定你有没有权限。两者都配对，请求才能成功路由到 DeepSeek。
环境确认完，接下来进入真正的配置环节。这里分两种方式：临时环境变量和持久化settings.json。前者适合快速验证，后者适合长期使用。
3. 可复制配置：settings.json 与环境变量双写法
配置 Claude Code 接入 DeepSeek，本质是告诉它三件事：请求发到哪（Base URL）、用什么身份（Key）、用哪个模型（Model ID）。这三件套缺一不可。下面给出两种写法，你可以按场景选。
3.1 方式一：临时环境变量（适合快速验证）
在 PowerShell 里执行下面这组命令，把占位符换成你自己的 Key：
$env:ANTHROPIC_BASE_URL="https://taotoken.net/api" $env:ANTHROPIC_AUTH_TOKEN="<你的 TaoToken API Key>" $env:ANTHROPIC_MODEL="deepseek-chat" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-chat"macOS 或 Linux 用户用export：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="<你的 TaoToken API Key>" export ANTHROPIC_MODEL="deepseek-chat"这种写法只在当前终端会话有效，关掉窗口就失效。好处是不污染全局配置，适合先跑通再固化。
3.2 方式二：settings.json 持久化（推荐长期使用）
Claude Code 会读取用户目录下的.claude/settings.json。Windows 路径通常是C:\Users\你的用户名\.claude\settings.json，macOS/Linux 是~/.claude/settings.json。如果文件不存在就新建一个，内容如下：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "<你的 TaoToken API Key>", "ANTHROPIC_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat" }, "model": "deepseek-chat" }这里有几个字段值得说明。ANTHROPIC_BASE_URL指向 TaoToken 的 API 根地址，Claude Code 会把请求拼到这个地址后面。ANTHROPIC_AUTH_TOKEN就是你的 TaoToken Key。ANTHROPIC_MODEL是主模型，ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL分别对应 Claude Code 内部按档位调用的模型，统一指向 DeepSeek 可以避免它偷偷去调官方模型。CLAUDE_CODE_SUBAGENT_MODEL是子代理用的模型，也一并指过去。
注意：JSON 里不能写注释，Key 要用英文双引号包住。改完保存后，重新打开终端执行
claude，配置才会生效。
3.3 三件套对照表
| 配置项 | 作用 | 示例值 |
|---|---|---|
| Base URL | 请求发往的通道地址 | https://taotoken.net/api |
| API Key | 身份鉴权 | <你的 TaoToken API Key> |
| Model ID | 指定后端模型 | deepseek-chat |
这三者必须同时正确。只改 Base URL 不改 Key，会 401；只改 Key 不改 Model，可能仍走默认模型；三者都对，请求才会正确路由到 DeepSeek。
配置写完后，别急着下结论，先做一次实际调用验证。
4. 验证请求：一次真实对话确认路由到 DeepSeek
配置改完不代表生效，必须用一次真实请求来确认。验证分两步：先看 Claude Code 能否正常启动，再发一条消息看返回是否来自 DeepSeek。
4.1 启动并检查登录状态
进入你的项目目录：
cd /path/to/your-project claude如果之前一直卡在Not logged in · Run /login，改完settings.json后这个提示应该消失。因为 Claude Code 默认要连官方服务，而我们把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN指到了 TaoToken 通道，它就跳过了官方登录流程。
如果仍然提示未登录，先检查settings.json的路径对不对，再确认 JSON 格式没有语法错误。可以用cat ~/.claude/settings.json看一眼内容是否完整。
4.2 发一条验证消息
在 Claude Code 交互界面里输入一句简单的话，比如：
用一句话说明这个项目是做什么的观察返回。如果配置正确，Claude Code 会把请求发到 TaoToken，再由 TaoToken 路由到 DeepSeek，返回内容会正常显示在终端里。你可以再问一个带代码的问题，比如让它解释某个函数，确认多轮对话也正常。
4.3 用 curl 直接验证通道
如果想更直接地确认通道可用，可以绕过 Claude Code，用 curl 打一次 TaoToken 的接口：
curl https://taotoken.net/api/v1/messages \ -H "Authorization: Bearer <你的 TaoToken API Key>" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-chat", "max_tokens": 128, "messages": [ {"role": "user", "content": "回复一句：通道正常"} ] }'如果返回里有正常的文本内容，说明 Base URL、Key、Model 三件套都没问题。这一步能帮你把「Claude Code 配置问题」和「通道本身问题」区分开。curl 通、Claude Code 不通，那就是settings.json的问题；curl 也不通，那就是 Key 或模型 ID 的问题。
验证通过后，你就可以在日常项目里正常用 Claude Code 调 DeepSeek 了。但实际配置过程中，报错几乎不可避免，下面把常见错列出来。
5. 常见报错排查：401、local proxy failed 与 reading choices
配置 Claude Code 接入 DeepSeek，最容易踩的坑集中在鉴权、网络和响应解析三类。下面按真实报错逐条拆。
5.1 401 Unauthorized
这是最常见的报错，意思是鉴权失败。原因通常有三个：Key 写错、Key 过期、Key 没带上。
先检查settings.json里ANTHROPIC_AUTH_TOKEN的值，确认没有多余空格、没有把<>占位符一起复制进去。再确认这个 Key 在 TaoToken 控制台里是启用状态。如果 Key 是刚创建的，等几秒再试，有时候有同步延迟。
还有一种情况：你只改了环境变量，但settings.json里还留着旧的 Key，Claude Code 优先读文件，导致环境变量被覆盖。两边保持一致最稳妥。
5.2 local proxy failed
这个报错通常出现在请求发不出去的时候。检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api，注意不要多写或少写路径段。有些教程会让你填/anthropic后缀，但 TaoToken 的兼容层路径以控制台文档为准，填错就会 404 或连接失败。
另外确认本机网络能正常访问taotoken.net。如果公司网络有出口限制，可能需要走内网代理，但这里不展开代理配置，建议先换网络环境验证。
5.3 reading choices 相关报错
这类报错说明请求发出去了，但返回的响应结构不符合 Claude Code 的预期。常见原因是模型 ID 写错，或者通道返回的不是 Anthropic 兼容格式。检查ANTHROPIC_MODEL和几个DEFAULT_*_MODEL字段，确认模型 ID 在 TaoToken 控制台里存在且可用。
如果模型 ID 对但还报错，可能是max_tokens或请求体格式问题。Claude Code 会自动构造请求，一般不用手动改，但如果你在settings.json里加了额外字段，可能干扰解析。建议先用最小配置跑通，再逐步加字段。
5.4 OAuth 相关提示
如果看到 OAuth 或登录相关的提示，说明 Claude Code 还在尝试走官方鉴权。回到settings.json，确认env块里的ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN都正确写入，并且model字段也指向了 DeepSeek。改完保存后完全退出终端再重开，避免旧进程缓存。
提示：排查顺序建议是「先 curl 验证通道，再查 settings.json，最后看 Claude Code 版本」。版本太旧可能不认某些字段，用
claude -v确认，必要时升级。
把这几类报错处理完，基本就能稳定使用了。下面给出长期使用的入口和进一步配置的方向。
6. 长期使用与统一 Key 的接入入口
跑通一次之后，接下来要考虑的是长期使用。如果你每天都要在多个项目里切换模型，手动改settings.json会很烦。TaoToken 的统一 Key 通道在这里的价值就体现出来了：一个 Key 管多个模型，切换后端只改一个 Model ID 字段，不用重新申请 Key，也不用改代码。
对于长期编码和 Agent 场景，可以关注 Coding Plan，它更适合高频调用：
https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite如果你还想在网页端直接对比不同模型的输出，用模型对话页面更直观：
https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite需要管理多个 Key、查看调用量或轮换 Key 时，控制台是入口：
https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite配置文档里有更细的字段说明和不同客户端的接入示例，遇到不确定的字段可以先查文档：
https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite如果你用的是 Claude Code 的 Anthropic 兼容模式，专门的接入页有对应说明：
https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=deepseek_claude_code&utm_campaign=rewrite最后提醒一个实操细节：settings.json里的 Key 是明文存储的，如果多人共用一台机器，建议用环境变量方式注入，或者定期在控制台轮换 Key。另外，模型 ID 会随平台更新，隔一段时间回控制台确认一下当前可用的 DeepSeek 模型名，避免因为模型下线导致请求失败。把配置固化下来之后，你基本不用再管它，终端里敲claude就能直接用 DeepSeek 干活了。