1. 国内开发者用 Claude Code 接 DeepSeek 的真实痛点Claude Code 是 Anthropic 推出的终端编码助手能在命令行里直接读写项目文件、跑测试、改 bug对习惯 VSCode 终端的开发者来说体验很顺。但它默认只连 Anthropic 官方服务国内网络环境下经常卡在Unable to connect to Anthropic services而且官方计费对个人开发者不算友好。DeepSeek 的 V3 系列在代码补全和长上下文理解上表现不错价格也低于是「Claude Code 的交互体验 DeepSeek 的模型能力」就成了很多人的组合方案。问题在于Claude Code 本身不提供自定义模型入口你得靠 Claude Code Router简称 ccr在中间做一层转发把 Claude Code 发出的 Anthropic 格式请求翻译成 OpenAI 兼容格式再打到 DeepSeek 的接口上。这一层转发如果配置错了表现就是一直转圈、报 401、或者干脆回退到官方 Claude。这篇教程就按「装 Node.js → 装 Claude Code → 装 Router → 配 TaoToken 统一 Key → 用 ccr code 验证」的顺序走一遍每一步都给可复制的命令和配置骨架最后附上五个高频报错的排查路径。适合 Windows 10/11 或 macOS 上做 C/Qt、Python、前端项目的开发者只要你能跑 npm 就能跟下来。2. 前置准备Node.js、npm 镜像与 TaoToken 统一 KeyClaude Code 和 ccr 都是 npm 包所以第一步是把 Node.js 环境弄干净。去 Node.js 官网下 LTS 版本当前 20.x 或 22.x 都行安装时勾选「Add to PATH」。装完开一个新终端验证node -v npm -v能打印出版本号就说明环境通了。国内直连 npm 官方源经常超时先换镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该回显https://registry.npmmirror.com。这一步不做的话后面npm install -g可能卡在idealTree阶段十几分钟。接下来是 Key。TaoToken 提供统一的 API 通道一个 Key 可以走多家模型省得你在 ccr 里为每个 provider 单独配 key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进控制台在 API Keys 页面创建一个新 Key复制那串sk-开头的字符串。这个 Key 后面要填进 ccr 的配置文件里所以先存到记事本别弄丢。TaoToken 的 API 基址是https://taotoken.net/api注意这个地址不带任何查询参数配置时直接写死。提示Key 只在创建时完整显示一次关掉页面就看不到了。如果没存直接删掉重建一个比找回来快。3. 安装 Claude Code 与 Claude Code Router两个包都全局装npm install -g anthropic-ai/claude-code npm install -g musistudio/claude-code-router装完分别验证claude --version ccr --versionclaude --version正常输出类似2.1.148 (Claude Code)ccr --version输出 ccr 自己的版本号。如果ccr命令找不到说明 npm 全局 bin 目录没进 PATHWindows 上一般是%APPDATA%\npmmacOS 是/usr/local/bin或~/.npm-global/bin手动加一下。装好后先看一眼 ccr 支持哪些子命令ccr正常会列出start / stop / restart / status / code / model / ui这几项。ccr code是后面启动 Claude Code 的正确入口ccr ui是个网页版配置界面不想手写 JSON 的可以用它但本文走配置文件路线方便你版本化管理。4. 可复制配置config.json 与 settings.json 骨架ccr 的配置目录在用户主目录下的.claude-code-routerWindowsC:\Users\你的用户名\.claude-code-router\macOS/Linux~/.claude-code-router/目录不存在就手动建。在里面创建config.json把下面这段填进去把api_key换成你在 TaoToken 控制台拿到的那个{ Providers: [ { name: taotoken, api_base_url: https://taotoken.net/api/v1/chat/completions, api_key: sk-你的TaoToken密钥, models: [ deepseek-chat, deepseek-reasoner ], transformer: { use: [openai] } } ], Router: { default: taotoken,deepseek-chat, background: taotoken,deepseek-chat, think: taotoken,deepseek-reasoner, longContext: taotoken,deepseek-chat } }几个字段解释一下。api_base_url指向 TaoToken 的 OpenAI 兼容端点末尾的/v1/chat/completions不能省。transformer.use填openai意思是把 Anthropic 格式的请求体转成 OpenAI 格式再发出去这是 ccr 能接 DeepSeek 的关键。Router.default的写法是provider名,模型名中间用英文逗号不能有空格。think路由走deepseek-reasoner适合需要推理链的场景longContext走deepseek-chat长文件读取时用。如果你还想让 Claude Code 本身的行为更可控可以在项目根目录或用户目录放一个settings.json控制权限和模型别名{ permissions: { allow: [Read, Edit, Bash(npm run test:*)], deny: [Bash(rm -rf:*)] }, env: { ANTHROPIC_BASE_URL: http://127.0.0.1:3456, ANTHROPIC_API_KEY: dummy-key-for-router } }这里的ANTHROPIC_BASE_URL指向 ccr 本地起的转发端口默认 3456ANTHROPIC_API_KEY填什么都行因为真正的鉴权在 ccr 那层用 TaoToken 的 Key 完成。这样配的好处是 Claude Code 以为自己在跟官方说话实际请求全被 ccr 截走转给 DeepSeek。注意config.json里的api_key是敏感信息别提交到 Git。可以在.gitignore里加上.claude-code-router/。5. 启动与验证一次真实对话确认路由生效配置写完后启动 ccr 服务ccr start ccr statusccr status应该显示 running 和监听端口。然后关键一步——用ccr code启动 Claude Code而不是直接敲claudeccr code区别在于claude会直连 Anthropic 官方ccr code会先读你的 config.json把请求路由到 TaoToken 再到 DeepSeek。进到 Claude Code 交互界面后输入一句简单的话测试你好帮我看看当前目录下有哪些文件如果它能正常列出文件并回复说明路由通了。想更确定一点可以问一个 DeepSeek 特征明显的问题比如让它写一段快速排序并解释时间复杂度观察回复风格和速度。有个坑要提前说如果你问 Claude Code「你是什么模型」它很可能回答「我是 Claude Opus」或类似的话。这不是配置失败而是 Claude Code 的系统提示词里写死了身份描述模型只是照着提示词回答。判断路由是否生效看的是ccr status里有没有请求计数增长或者去 TaoToken 控制台的用量页面看有没有调用记录别靠模型自报身份。验证通过后日常使用就是ccr start起服务ccr code进项目。想换模型就改config.json里的Router.default然后ccr restart重启生效。6. 本篇常见报错排查报错一Unable to connect to Anthropic services/Failed to connect to api.anthropic.com原因是你用了claude而不是ccr code请求还在往官方发。解决退出当前会话改用ccr code启动。如果已经用了ccr code还报这个检查ccr status服务是否在跑没跑就ccr start。报错二Auth conflict提示ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY同时存在系统环境变量里残留了旧的鉴权变量跟 ccr 的配置打架。先claude logout然后去系统环境变量里删掉ANTHROPIC_AUTH_TOKEN只保留settings.json里那套。Windows 在「系统属性 → 环境变量」里删macOS 检查~/.zshrc或~/.bash_profile。报错三Please run /login说明 Router 没接管成功Claude Code 以为你没登录。先ccr status确认服务活着再确认settings.json里的ANTHROPIC_BASE_URL指向http://127.0.0.1:3456。如果端口被占用ccr 会换端口去ccr status看实际端口再改。报错四Missing model in request body模型名写错了。检查config.json里Router.default的值格式必须是taotoken,deepseek-chat逗号是英文的前后不能有空格模型名要跟Providers[].models数组里的一致。改完ccr restart。报错五PowerShell 报PSSecurityException无法加载ccr.ps1Windows 执行策略拦了脚本。以管理员身份开 PowerShell跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser提示确认时输入Y。这只影响当前用户不会动系统级策略。排查顺序建议固定成先ccr status看服务 → 再看config.json的模型名和 Key → 最后看环境变量有没有冲突。大部分问题出在前两步。7. 后续怎么用模型对话、Coding Plan 与文档入口路由跑通之后日常编码场景可以直接在终端里让 Claude Code 读项目、改代码、跑测试。如果你更想先在网页里试模型效果、对比 DeepSeek 和别的模型输出可以走模型对话入口https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 不用装任何东西就能发请求。长期做编码或搭 Agent 的话Coding Plan 比按量计费更划算入口在 https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合每天都要跑大量补全和重构的开发者。Key 的管理和新建在控制台https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入细节和参数说明看文档https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 Claude Code 的 Anthropic 兼容模式专门的接入页在 https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有针对 ccr 的配置示例跟本文的config.json可以对照着看。最后留一个我踩过的坑改完config.json一定要ccr restart光改文件不重启ccr 还是用旧配置跑你会以为配置没生效然后反复折腾。另外deepseek-reasoner的响应比deepseek-chat慢日常补全用 chat 就够需要它想清楚复杂逻辑时再切 reasoner别默认全走推理模型不然等得着急。