ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Windows 上安装 Claude Code 桌面端并通过 cc-switch 接入 DeepSeek 教程:TaoToken 统一 Key 配置与验证

Windows 上安装 Claude Code 桌面端并通过 cc-switch 接入 DeepSeek 教程:TaoToken 统一 Key 配置与验证 1. Windows 上跑 Claude Code 桌面端为什么还要折腾 cc-switchClaude Code 桌面端在 Windows 上的体验其实已经不错但很多人卡在同一个地方官方通道的额度和计费方式对只想拿它写写脚本、改改配置的普通开发者来说不太友好。于是就有了「用 DeepSeek 这类模型来驱动 Claude Code 界面」的需求——界面还是那个界面底层换成更划算的模型。问题在于Claude Code 桌面端默认只认 Anthropic 的接口格式而 DeepSeek 走的是自己的 API。两者协议不一样直接改配置是接不上的。这时候就需要一个中间层把桌面端发出的 Anthropic 格式请求翻译成 DeepSeek 能听懂的格式再把结果翻译回来。cc-switch 就是干这个的一个跑在本地的小代理负责协议转换和模型路由。但光有 cc-switch 还不够。如果你同时想接 DeepSeek、又想留一条备用通道或者以后想换别的模型每个提供商都要单独配 Key、单独记 Base URL管理起来很乱。所以我更推荐用 TaoToken 做统一入口一个 Key 管所有模型cc-switch 里只填一个地址就行。这篇就按这个思路把 Windows 桌面端 Claude Code cc-switch TaoToken 接入 DeepSeek 的完整流程走一遍包括可复制的配置骨架和连通性验证动作。适合谁看已经在 Windows 上装了 Claude Code 桌面端、想换成 DeepSeek 驱动、又不想每次手动改一堆配置的人。全程不需要额外装什么重型依赖Node.js 和 Git 备好就行。2. 前置准备Node.js、TaoToken Key 与 cc-switch 安装2.1 确认 Node.js 和 GitClaude Code 桌面端和 cc-switch 都依赖 Node 运行时。打开 PowerShell先验证node --version npm --version版本低于 18 的话去 nodejs.org 下 LTS 版20.x 或 22.x装上。Git 可选但后面拉配置方便一条命令搞定winget install --id Git.Git -e --source winget2.2 拿一个 TaoToken 统一 KeyTaoToken 的作用是把多个模型的接入收敛成一个 Key。你不需要分别去 DeepSeek、Anthropic 各注册一遍只要在 TaoToken 控制台创建一个 Key后面 cc-switch 里填这一个就行。操作路径打开控制台进 API Keys 页面新建一个 Key复制保存。这个 Key 就是后面配置里的sk-xxx。如果你还没账号先注册再建 Key整个过程两三分钟。注意Key 只在创建时完整显示一次记得先存到密码管理器或本地文本里别关掉页面才想起来没复制。2.3 安装 cc-switchcc-switch 是 Rust 写的本地代理工具Windows 上推荐用 MSI 安装包支持自动更新。去它的 GitHub Releases 页面下载对应版本装到默认路径即可。装完后系统托盘会出现 cc-switch 图标说明主程序已经在跑了。它的数据目录默认在C:\Users\你的用户名\.cc-switch\里面有几个关键文件文件/目录作用cc-switch.dbSQLite 数据库存提供商和路由配置logs/cc-switch.log运行日志排障主要看这个config.json全局设置端口、自启等工作原理一句话说清Claude Code 桌面端把请求发到本地代理端口cc-switch 拦截后按模型映射表重写目标模型再转发到 TaoToken 的接口返回时原路送回。整个过程对桌面端透明它以为自己一直在跟 Anthropic 说话。3. 可复制配置cc-switch 接入 TaoToken 与 DeepSeek3.1 在 cc-switch 里添加提供商托盘图标双击打开 cc-switch 主界面点「添加提供商」类型选自定义或 Anthropic 兼容填这几项参数值名称TaoTokenAPI Base URLhttps://taotoken.net/apiAPI Key你刚才建的sk-xxxAPI 格式anthropic桌面端模式proxy本地代理这里 Base URL 用 TaoToken 的 API 地址不要带任何多余路径。cc-switch 会自动在这个地址后面拼接对应模型的端点。3.2 配置模型路由映射cc-switch 的核心是模型映射表桌面端请求的是 Claude 的模型名cc-switch 把它改写成 DeepSeek 的模型名再发出去。在「模型路由」页添加三条映射{ claude-haiku-4-5: deepseek-v4-flash, claude-sonnet-4-6: deepseek-v4-pro, claude-opus-4-8: deepseek-v4-pro }含义是桌面端日常快速任务走 Haiku映射到 DeepSeek 的 flash 模型复杂任务走 Sonnet 或 Opus映射到 pro 模型。这样你在桌面端切换模型时实际调用的 DeepSeek 模型也跟着变不用手动改配置。3.3 配置 Claude Code 桌面端的 3p 模式桌面端要主动走本地代理得开 3p 模式。找到配置文件C:\Users\你的用户名\AppData\Local\Claude\claude_desktop_config.json写入{ deploymentMode: 3p }设为3p后桌面端不再直连 Anthropic而是把请求发给 cc-switch 的本地代理。改完保存重启桌面端生效。3.4 settings.json 片段如果你用的是 Claude Code CLI 形态配置在settings.json里加一段环境变量指向本地代理{ env: { ANTHROPIC_BASE_URL: http://127.0.0.1:你的cc-switch端口, ANTHROPIC_API_KEY: sk-你的TaoToken-Key } }端口号在 cc-switch 设置页能看到默认一般是 8787 之类。桌面端和 CLI 两种形态的配置不要混用按你实际装的那个来。4. 验证请求确认 DeepSeek 真的在响应配置写完不算完得验证请求确实走到了 DeepSeek。分三步。第一步确认 cc-switch 在跑。托盘图标右键看状态或者直接看日志文件尾部Get-Content $env:USERPROFILE\.cc-switch\logs\cc-switch.log -Tail 20第二步在 Claude Code 桌面端发一条最简单的消息比如「用一句话解释什么是递归」。发送后立刻回到日志看有没有新的转发记录正常会看到类似forwarding request to https://taotoken.net/api的行以及目标模型被改写成deepseek-v4-pro或flash。第三步用 curl 直接打 TaoToken 接口排除桌面端本身的干扰curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken-Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: deepseek-v4-pro, max_tokens: 64, messages: [{role: user, content: ping}] }返回里有正常的content字段和文本说明 Key 和通道都没问题。如果这一步通了但桌面端不通问题就在 cc-switch 或桌面端配置不在 Key。成功的结果长这样桌面端能正常出字日志里有转发记录curl 能拿到响应。三者都满足链路就通了。5. 本篇常见报错排查cc-switch 代理起不来。最常见是端口被占。看日志里有没有address already in use有的话去设置页换个端口或者用netstat -ano | findstr 端口号找到占用进程处理掉。DeepSeek 返回 401 或 403。九成是 Key 问题。检查 cc-switch 里填的 Key 有没有多余空格是不是复制时截断了。TaoToken 控制台里确认这个 Key 还在启用状态、额度没耗尽。桌面端连不上 cc-switch。先确认claude_desktop_config.json里deploymentMode确实是3p拼写别错。再看 cc-switch 是不是真的在监听日志里有没有收到请求。如果桌面端完全没发请求过来多半是配置文件路径不对——注意是AppData\Local\Claude\不是AppData\Roaming\。模型映射不生效还是报 Claude 模型不存在。检查映射表里的模型名拼写claude-sonnet-4-6这类名字要和桌面端实际请求的一致。可以在日志里看桌面端请求的原始模型名照着填。想切回官方通道。在 cc-switch 界面把当前提供商切回 Claude Official或者把deploymentMode改回默认值重启桌面端即可。不用卸载重装。6. 把 Key 和通道固定下来后面就省心了跑通之后你会发现真正麻烦的从来不是装软件而是 Key 和地址散落在各个配置文件里换一次模型就要翻一遍。用 TaoToken 做统一入口的好处就在这cc-switch 里只维护一个 Base URL 和一个 Key模型路由在映射表里改桌面端和 CLI 共用同一套通道。如果你后面要长期用 Claude Code 写代码、跑 Agent 任务建议直接上 Coding Plan额度和模型调度都帮你规划好了不用每次手动切。想先验证模型效果可以去模型对话页面直接试不用装任何东西。Key 管理和接入文档都在控制台和文档页遇到报错先翻日志再对照文档里的字段说明基本能自己解决。我自己的习惯是配置改完先跑一遍 curl通了再动桌面端。这样出问题时能立刻分清是通道问题还是客户端问题省掉一半排查时间。
返回列表