Win10 系统安装 Claude Code 并接入 DeepSeek 教程：用 cc-switch 把 Base URL 改到 TaoToken

1. Win10 装 Claude Code 到底卡在哪Node.js 环境与 cc-switch 多通道管理Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯用 CLI 干活的开发者。但它在 Win10 上装完之后默认走的是官方通道国内网络环境下经常连不上而且每次换模型都要手动改环境变量重启终端就丢。这篇教程解决的就是这件事在 Win10 上把 Claude Code 装好用 cc-switch 这个多通道管理工具把 Base URL 改到 TaoToken 的统一 API 通道再接入 DeepSeek 模型让终端里的配置持久化、可切换。适合谁看用 Win10 做开发、想用 Claude Code 但被网络和配置折腾过的同学已经在用 DeepSeek 但想把 Claude Code 当客户端的同学以及想用 cc-switch 管理多个模型通道、不想每次手敲set命令的同学。整条链路是这样的Node.js 提供运行环境 → npm 装 Claude Code → cc-switch 负责管理 Base URL 和 Key → TaoToken 提供统一 API 通道 → DeepSeek 作为实际模型。你只需要在 cc-switch 里填一次之后切换通道点一下就行。我试过在没配 cc-switch 之前每次开新终端都要重新set ANTHROPIC_BASE_URL和set ANTHROPIC_AUTH_TOKEN忘了哪一条就报 401非常烦。cc-switch 的价值就在于把这些配置落到文件里Claude Code 启动时自动读取。先说清楚一个概念Claude Code 本身是个客户端它不绑定必须用哪个模型。只要对方提供 Anthropic 兼容的 API 格式把 Base URL 指过去、Key 填对就能跑。TaoToken 的 API 地址是https://taotoken.net/api它对外提供统一的 Key 和通道你拿到的 Key 在模型对话、Coding Plan、API Keys 各个入口是打通的。DeepSeek 的模型 ID 在 TaoToken 通道里可以直接指定不用你去 DeepSeek 官网单独注册。这里要区分两个东西一个是 DeepSeek 官方的 API Key一个是 TaoToken 的 Key。这篇教程走的是 TaoToken 统一通道所以你只需要一个 TaoToken 的 KeyBase URL 填 TaoToken 的地址模型 ID 填 DeepSeek 对应的名称。这样好处是以后想换别的模型只改模型 ID 就行Base URL 和 Key 不用动。Win10 上还有个坑是 Bun 运行时。Claude Code 底层用 Bun某些老 CPU 不支持 AVX 指令集启动时会直接崩报CPU lacks AVX support。这个后面排障章节会讲怎么处理先记着有这回事。2. TaoToken 前置准备拿 Key、认通道、装 cc-switch在动手改配置之前先把三样东西准备好TaoToken 的 API Key、cc-switch 安装包、以及确认 Node.js 环境正常。第一步拿 TaoToken 的 Key。打开https://taotoken.net/api-keys登录后创建一个新的 API Key复制保存。这个 Key 就是后面填进 cc-switch 的凭证。注意 Key 只在创建时完整显示一次关掉页面就看不到了先存到记事本里。第二步确认你要用的模型 ID。TaoToken 通道里 DeepSeek 对应的模型 ID 一般是deepseek-chat这类名称具体以你账号里模型列表显示的为准。你可以在https://taotoken.net/models或者模型对话页面确认一下当前可用的模型标识。填错模型 ID 会报model not found这个后面排障会讲。第三步装 cc-switch。cc-switch 是一个开源的 Claude Code 配置切换工具在它的 GitHub Releases 页面下载 Windows 版安装包一般是.exe或.msi双击安装。装完之后任务栏或开始菜单能找到它。它的作用是图形化管理 Claude Code 的settings.json你不用手动去改 JSON 文件。第四步确认 Node.js 环境。如果你还没装 Node.js去官网下载 LTS 版本安装安装时勾选「Add to PATH」。装完用管理员身份打开 PowerShell输入node -v npm -v两条都能输出版本号就说明环境 OK。如果node -v报「无法识别命令」说明 PATH 没配上手动加一下按Win R输入sysdm.cpl→ 「高级」→「环境变量」→ 在「系统变量」里找到Path→ 编辑 → 新建添加C:\Program Files\nodejs\ %APPDATA%\npm保存后关掉所有 PowerShell 窗口重新开一个再验证。这一步别偷懒PATH 没配对后面 npm 装包全失败。关于 TaoToken 的定位这里说清楚它是一个统一的 API 接入通道把不同模型的调用收敛到一个 Base URL 和一套 Key 上。对 Claude Code 来说你只需要把ANTHROPIC_BASE_URL指向https://taotoken.net/api把ANTHROPIC_AUTH_TOKEN填成你的 TaoToken Key剩下的模型选择在请求里指定。这样你就不用为每个模型单独维护一套环境变量。如果你后面想长期用 Claude Code 做编码或者跑 Agent 任务可以了解一下 Coding Plan它在调用额度和通道稳定性上更适合高频使用场景。入口在https://taotoken.net/coding-plan。不过这篇教程先用按量 Key 把链路跑通跑通之后再考虑要不要升级。3. 可复制配置cc-switch 里填 Base URL、Key 和 Model ID这一节是核心把 cc-switch 的配置项和 Claude Code 的 settings.json 对应关系讲清楚你照着填就行。先装 Claude Code。管理员身份打开 PowerShell用国内镜像装速度快很多npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证claude --version能输出版本号就说明装好了。以后更新用npm install -g anthropic-ai/claude-codelatest --registryhttps://registry.npmmirror.com接下来打开 cc-switch。它的界面里一般有「新增配置」或「Add Provider」的按钮需要填三个关键字段配置项填写内容说明Base URLhttps://taotoken.net/apiTaoToken 统一 API 地址不加 UTMAPI Key / Token你的 TaoToken Key从 api-keys 页面复制的那串Model IDdeepseek-chat以实际为准指定走 DeepSeek 模型cc-switch 保存后实际写入的是 Claude Code 的配置文件。Win10 上这个文件路径是C:\Users\你的用户名\.claude\settings.json你可以打开这个文件确认内容正常长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_MODEL: deepseek-chat } }如果你不用 cc-switch手动创建这个文件也行效果一样。但 cc-switch 的好处是可以在多个通道之间切换比如你同时有 TaoToken 通道和别的通道点一下就能换不用手动改 JSON。这里有个细节要注意ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是两个不同的变量。Claude Code 读的是ANTHROPIC_AUTH_TOKEN填错了会报 401。cc-switch 一般会帮你写对但如果你手动改文件认准AUTH_TOKEN。另外如果你之前手动设过系统环境变量比如在 PowerShell 里set ANTHROPIC_BASE_URL...那些是临时的关窗口就没了。cc-switch 写的是文件持久生效。两者如果冲突以文件为准还是以环境变量为准要看 Claude Code 的读取顺序保险做法是把系统里手动设的删掉只留文件里的。配置写完后建议在 cc-switch 里点一下「应用」或「切换」确保它把配置同步到了 settings.json。有些版本需要你手动指定 Claude Code 的配置目录如果 cc-switch 找不到就在设置里把路径指到C:\Users\你的用户名\.claude。关于模型 ID如果你在 TaoToken 通道里想用别的 DeepSeek 版本把ANTHROPIC_MODEL改成对应的 ID 即可。Base URL 和 Key 不用动这就是统一通道的好处。你可以在模型对话页面先测一下模型 ID 是否可用确认了再填进配置。4. 验证请求一条 curl 确认通道生效配置填完不代表通了得实际发一条请求验证。这一步用 curl 直接打 TaoToken 的 API确认 Base URL、Key、Model ID 三件套都对。打开 PowerShell执行下面这条命令把 Key 换成你自己的curl -X POST https://taotoken.net/api/v1/messages -H Content-Type: application/json -H x-api-key: 你的TaoToken Key -H anthropic-version: 2023-06-01 -d { model: deepseek-chat, max_tokens: 100, messages: [ {role: user, content: 用一句话说明什么是递归} ] }注意 PowerShell 里换行符是反引号不是反斜杠\。如果你在 CMD 里跑换行符不一样建议直接用 PowerShell。正常返回会长这样内容因模型而异{ id: msg_xxx, type: message, role: assistant, content: [ {type: text, text: 递归是指一个函数在其定义中调用自身...} ], model: deepseek-chat, usage: {input_tokens: 15, output_tokens: 30} }看到content里有文本返回说明通道通了。如果返回 401说明 Key 不对返回 404说明 Base URL 或路径不对返回model not found说明模型 ID 写错了。curl 验证通过后再验证 Claude Code 本身。进你的项目目录cd D:\你的项目 claudeClaude Code 启动后它会读取~/.claude/settings.json里的配置。你在里面输入一句话比如「帮我看看当前目录有哪些文件」如果它能正常调用模型并返回结果说明整条链路打通了。如果 Claude Code 启动后报连接错误但 curl 是通的那问题多半在 settings.json 的字段名或者 cc-switch 没同步。打开C:\Users\你的用户名\.claude\settings.json核对一遍确认ANTHROPIC_BASE_URL是https://taotoken.net/apiANTHROPIC_AUTH_TOKEN是你的 KeyANTHROPIC_MODEL是deepseek-chat。还有一点Claude Code 启动时会检查当前目录如果你在一个空目录或者没有权限的目录里启动可能会有额外报错。建议在一个正常的代码项目目录里测试。验证通过之后你可以在 cc-switch 里再建一个配置指向别的模型测试切换是否生效。切换后重新启动 Claude Code看它用的模型是不是变了。这样你就有了一个可切换的多通道环境。5. 常见报错排查401、local proxy failed、Bun 崩溃、OAuth 失败这一节把 Win10 上装 Claude Code 接 TaoToken 最常遇到的几个报错列出来对照着查。报错一401 UnauthorizedAPI Error: 401 {error:{type:authentication_error,message:invalid x-api-key}}原因Key 填错、Key 过期、或者字段名写成了ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。排查打开 settings.json 确认字段名重新从https://taotoken.net/api-keys复制 Key注意前后不要有空格。如果 Key 是在别的通道创建的确认它在 TaoToken 通道里有效。报错二local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx原因Claude Code 尝试走本地代理但代理没启动或者端口不对。排查检查系统里有没有设HTTP_PROXY/HTTPS_PROXY环境变量如果有先清掉。在 PowerShell 里Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue然后重启 Claude Code。如果你确实需要代理才能上网那是另一回事但接 TaoToken 通道本身不需要额外代理配置。报错三reading choices 相关错误TypeError: Cannot read properties of undefined (reading choices)原因返回的数据结构不是 Claude Code 预期的格式通常是 Base URL 指错了地方或者模型 ID 不对导致返回了错误结构。排查确认 Base URL 是https://taotoken.net/api不是别的路径确认模型 ID 在 TaoToken 通道里存在。用第 4 节的 curl 命令先测curl 通了再跑 Claude Code。报错四CPU lacks AVX support / Bun has crashedpanic(main thread): Segmentation fault at address 0x... oh no: Bun has crashed.原因你的 CPU 不支持 AVX 指令集Claude Code 底层用的 Bun 运行时跑不起来。这是硬件限制不是配置问题。解决方案有两个推荐方案是用 WSL 2 跑 Claude Code在 WSL 里装 Node.js 和 Claude Code绕开 Windows 原生 Bun 的限制。临时方案是降级到旧版本npm uninstall -g anthropic-ai/claude-code npm install -g anthropic-ai/claude-code2.1.17然后在~/.claude/settings.json里禁用自动更新{ env: { DISABLE_AUTOUPDATER: 1 } }注意这个降级方案只是临时绕过新版本功能用不了能用 WSL 还是用 WSL。报错五OAuth 相关失败OAuth error: invalid_grant / token exchange failed原因Claude Code 尝试走官方 OAuth 登录流程但你用的是第三方通道不需要 OAuth。排查确认 settings.json 里没有残留的 OAuth 配置确认ANTHROPIC_AUTH_TOKEN已设置。如果 Claude Code 启动时弹登录界面说明它没读到你的 Token检查文件路径和字段名。报错六cc-switch 切换后不生效原因cc-switch 写的配置文件和 Claude Code 读的路径不一致。排查在 cc-switch 设置里确认 Claude Code 配置目录指向C:\Users\你的用户名\.claude切换后打开 settings.json 看内容有没有变。如果没变手动在 cc-switch 里点「应用」或重启 cc-switch。排查顺序建议先 curl 测通道 → 再查 settings.json 字段 → 再看 Claude Code 启动日志。这样能快速定位是通道问题还是客户端问题。6. 把配置固化下来多通道切换与长期使用建议链路跑通之后最后一步是让这套配置稳定下来别每次重启终端又出问题。首先确认 cc-switch 的配置已经写入文件而不是只存在内存里。打开C:\Users\你的用户名\.claude\settings.json确认三个字段都在。如果你在 cc-switch 里建了多个通道每个通道对应一组 Base URL Key Model ID切换时它会重写这个文件。你可以给通道起好记的名字比如「TaoToken-DeepSeek」「TaoToken-其他模型」切换时不容易搞混。其次把系统里手动设的临时环境变量清掉避免和文件配置冲突。在 PowerShell 里检查Get-ChildItem Env: | Where-Object { $_.Name -like *ANTHROPIC* }如果有输出说明系统级或用户级环境变量里有残留去「环境变量」设置里删掉。只保留 settings.json 里的配置。第三如果你经常在多个项目之间切换可以在每个项目目录下放一个.claude文件夹做局部配置但一般没必要全局配置够用。Claude Code 会优先读当前目录的配置没有再读全局的。第四关于 Key 的安全。settings.json 里存的是明文 Key别把这个文件提交到 Git 仓库。如果你要把配置分享给别人把 Key 换成占位符。cc-switch 一般会把配置存在用户目录下不会进项目仓库但你自己手动改的时候注意。第五长期用的话关注一下 Coding Plan。如果你每天都要用 Claude Code 跑不少任务按量计费可能不如套餐划算。Coding Plan 的入口在https://taotoken.net/coding-plan具体额度看你自己的使用频率决定。接入文档在https://taotoken.net/doc里面有各个客户端的配置示例遇到新工具不知道怎么填的时候可以查。最后说一个实际经验cc-switch 的版本更新比较快有时候新版本改了配置文件的格式或者路径升级后如果发现 Claude Code 读不到配置先回退 cc-switch 版本或者手动核对 settings.json。别一上来就怀疑 TaoToken 通道有问题大部分时候是本地配置文件的事。整套流程走下来你在 Win10 上就有了一个可切换、可持久化的 Claude Code 环境Base URL 指向 TaoToken 统一通道模型可以随时换成 DeepSeek 或其他。以后想加新模型只在 cc-switch 里改 Model ID 就行不用动 Key 和地址。