1. Windows 下 Claude Code 安装与 CC Switch 配置 DeepSeek 的完整链路Claude Code 是 Anthropic 推出的终端 AI 编码工具能在命令行里直接读写项目文件、跑测试、改配置适合习惯在终端里干活的后端和全栈开发者。但官方默认走 Anthropic 自家后端国内直连体验一般很多人想换成 DeepSeek 这类兼容 Anthropic Message 格式的服务。问题在于Claude Code 本身没有图形化的多后端切换界面手动改settings.json又容易写错字段尤其是同时维护 DeepSeek、其他模型好几套 Key 的时候来回改文件非常烦。这篇就聚焦 Windows 10/11 环境把「winget 装 Claude Code → 装 CC Switch → 用 CC Switch 配置 DeepSeek → 验证连通性」这条链路一次跑通。核心思路是用 TaoToken 统一 Key 管理把分散的 API Key 收敛到一处再通过 CC Switch 这个 GUI 工具往~/.claude/settings.json写环境变量避免手抖写错 JSON。读完你能拿到可直接复制的 CC Switch 配置骨架、settings.json片段以及验证 API 是否真的通了的命令。适合谁Windows 上想用 Claude Code 但不想折腾 Anthropic 官方账号的开发者手里已经有 DeepSeek API Key、想把它接进 Claude Code 的人以及被多工具 Key 分散折磨、想统一管理的同学。下面按步骤来每步都有命令和结果说明。2. TaoToken 前置准备与统一 Key 接入思路在动手装工具之前先把「Key 从哪来、怎么统一」这件事理清楚否则后面配置会反复返工。TaoToken 的定位是统一 API 接入层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于你不需要在 Claude Code、CC Switch、其他 CLI 工具里各填一套不同的 Key而是用统一的 Key 和 Base URL 去对接切换后端时只改一处。具体到这条链路你需要准备两样东西一个是 DeepSeek 官方的 API Keysk-开头在 DeepSeek 平台申请并充值几块钱就能跑很久另一个是 TaoToken 的统一 Key用来在 CC Switch 里做集中管理。如果你只用 DeepSeek 一个后端其实手动写settings.json也行但一旦要加第二个、第三个模型CC Switch 的图形化切换就省事很多。这里要强调一个概念Claude Code 读取配置的优先级是「环境变量 settings.json」。CC Switch 做的事情本质就是帮你把环境变量写进~/.claude/settings.json的env字段里。所以理解了这个文件的结构你手动改也不会错。下面先给出手动版的settings.json骨架路径是C:\Users\你的用户名\.claude\settings.json{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek-API-Key, ANTHROPIC_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro } }注意ANTHROPIC_AUTH_TOKEN填的是 DeepSeek 的 Key不是 Anthropic 的。ANTHROPIC_BASE_URL指向 DeepSeek 的 Anthropic 兼容端点。这几个字段名一个都不能错写错就会报 401 或者连接失败。如果你走 TaoToken 统一接入Base URL 换成 TaoToken 的 API 地址Key 换成 TaoToken 的统一 Key其余字段结构不变。这样切换后端时只动两个值其他工具不用改。前置条件清单Windows 10/11Git Bash推荐winget install Git.GitDeepSeek API Key 已充值TaoToken 账号已注册并拿到统一 Key。把这些准备好后面装工具就是几分钟的事。3. 可复制配置winget 安装 Claude Code 与 CC Switch 配置 DeepSeek这一节是全文的操作核心每一步都给完整命令和配置片段照着敲就行。3.1 winget 安装 Claude Code打开 PowerShell管理员或普通都行执行winget install Anthropic.ClaudeCode装完后新开一个终端窗口验证claude --version如果提示找不到命令重启终端或重启电脑让 PATH 生效。实测下来 winget 装的路径一般会自动进 PATH重启终端就够了。版本号能打印出来就说明 CLI 装好了。3.2 安装 CC SwitchCC Switch 是一个桌面 GUI 工具用来管理 Claude Code 的多套后端配置。去它的 GitHub Releases 页面下载最新 Windows 版本当前是 v3.14.1。两个选择版本文件说明安装版CC-Switch-v3.14.1-Windows.msi双击安装有开始菜单和卸载入口便携版CC-Switch-v3.14.1-Windows-Portable.zip解压即用无需安装安装版双击.msi一路下一步便携版解压到任意目录运行CC-Switch.exe。我一般用便携版换机器直接拷目录不留注册表垃圾。3.3 用 CC Switch 配置 DeepSeek启动 CC Switch点「添加供应商」选择 DeepSeek 预设然后填下面这张表配置项值Base URLhttps://api.deepseek.com/anthropic认证类型ANTHROPIC_AUTH_TOKENAPI Keysk- 开头的 DeepSeek API KeyAPI 格式Anthropic Message主模型deepseek-v4-pro快速模型deepseek-v4-flash标准模型deepseek-v4-pro顶级模型deepseek-v4-pro主模型写成deepseek-v4-pro[1m]可以开启 100 万 Token 上下文处理超大文件或项目级分析时有用。填完保存在主界面选中刚创建的 DeepSeek 配置点「激活」。CC Switch 会自动把对应的环境变量写进~/.claude/settings.json。如果你走 TaoToken 统一 KeyBase URL 填 TaoToken 的 API 地址API Key 填 TaoToken 统一 Key模型 ID 按 TaoToken 文档里对应的 DeepSeek 模型名填。这样一套 Key 可以同时给 Claude Code、Cline、Codex 等工具用切换时只改 CC Switch 里的激活项。3.4 手动配置版不用 CC Switch如果你只用 DeepSeek 一个后端直接手动创建C:\Users\你的用户名\.claude\settings.json内容就是第 2 节给的那段 JSON。注意 JSON 不能有注释、不能有多余逗号否则 Claude Code 解析会失败。用 VS Code 打开这个文件右下角会提示 JSON 格式是否合法绿色勾就对了。4. 验证请求确认 Claude Code 真的连上了 DeepSeek配置写完不算完得验证 API 真的通了。这一步很多人跳过结果用的时候才发现 Key 没生效。4.1 交互式验证终端输入claude进入交互界面后输入你当前使用的是什么模型如果返回deepseek-v4-pro或类似 DeepSeek 模型名说明配置成功。如果返回 Anthropic 的模型名说明settings.json没被读到检查文件路径和 JSON 格式。4.2 命令行直接验证 API 连通性更硬核的方式是直接用 curl 打 DeepSeek 的 Anthropic 兼容端点确认 Key 和 Base URL 都对curl https://api.deepseek.com/anthropic/v1/messages \ -H x-api-key: sk-你的DeepSeek-API-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 有效、端点可达。如果返回 401是 Key 问题返回 404是 Base URL 路径写错返回连接超时是网络或端点地址问题。这个 curl 命令的好处是把 Claude Code 这一层剥掉直接测后端排障时能快速定位是工具配置问题还是 API 本身问题。4.3 在项目里跑一次真实请求进一个你的代码项目目录运行claude然后让它做点实际的事比如读一下当前目录的 package.json告诉我用了哪些依赖如果它能正确读文件并回答说明文件读写权限和 API 都正常。这一步能验证的不只是连通性还有 Claude Code 的工具调用链路。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易踩的坑集中在这几个报错逐个说清楚原因和解法。401 Unauthorized / API Key 无效最常见。原因通常是Key 没充值、Key 复制时带了空格、ANTHROPIC_AUTH_TOKEN字段名写成了ANTHROPIC_API_KEY。DeepSeek 的 Anthropic 兼容端点认的是ANTHROPIC_AUTH_TOKEN写错字段名就会 401。另外确认 Key 是sk-开头且 DeepSeek 账户里至少有少量余额。用第 4.2 节的 curl 命令单独测一下能快速区分是 Key 问题还是 Claude Code 配置问题。local proxy failed / 连接本地代理失败这个报错通常出现在系统里配了 HTTP 代理但代理没启动或端口不对。Claude Code 会读取系统代理环境变量。检查HTTP_PROXY、HTTPS_PROXY这两个环境变量如果指向一个不存在的本地端口就会报 local proxy failed。解法是清掉这两个变量或者确保代理服务真的在跑。注意这里说的是系统环境变量层面的排查不涉及任何具体代理工具。reading choices / 响应解析失败这个报错一般是后端返回的 JSON 结构不符合 Anthropic Message 格式Claude Code 解析choices字段时失败。原因可能是 Base URL 指向了一个 OpenAI 格式的端点而不是 Anthropic 兼容端点。确认ANTHROPIC_BASE_URL结尾是/anthropicAPI 格式选的是 Anthropic Message 而不是 OpenAI。如果走 TaoToken确认用的是 TaoToken 文档里标注的 Anthropic 兼容地址。OAuth 相关报错 / 登录失败Claude Code 首次启动可能会尝试 OAuth 登录 Anthropic 账号。如果你已经用settings.json配了ANTHROPIC_AUTH_TOKEN它应该跳过 OAuth。如果还在报 OAuth 错误检查是不是有旧的登录态缓存。删掉~/.claude下的缓存文件保留settings.json重新启动。另外确认没有同时设置ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN两个同时存在会冲突。claude 命令找不到winget 装完后 PATH 没刷新。重启终端或者手动把 winget 的安装路径加进系统 PATH。用where claude确认命令位置。CC Switch 激活后不生效CC Switch 写的是~/.claude/settings.json但如果你同时在系统环境变量里设了ANTHROPIC_BASE_URL环境变量优先级更高会覆盖文件配置。检查系统环境变量里有没有残留的 Anthropic 相关变量有就删掉。排障时建议按「curl 测后端 → 检查 settings.json → 检查环境变量 → 重启终端」的顺序来从底层往上排查比盲目改配置快得多。接入相关的文档和 API Key 管理可以在 TaoToken 的 API Keys 页面和接入文档里找到对应说明。6. 长期编码与 Agent 场景用 TaoToken 统一 Key 管理多后端跑通单次配置只是开始。如果你打算长期用 Claude Code 做日常编码或者跑 Agent 类任务Key 管理会变成一个持续的成本。多个工具各配一套 Key改一次要动好几个文件还容易漏。TaoToken 的统一 Key 思路就是把这些收敛到一处Claude Code、Cline、Codex 这些工具都指向同一个 Base URL 和 Key切换后端时只改 CC Switch 里的激活项其他工具不用动。对于长期编码场景建议把模型选择也固定下来日常改配置、写脚本用deepseek-v4-flash快且便宜复杂重构、疑难 Bug 用deepseek-v4-pro推理能力强超长文件或项目级分析用deepseek-v4-pro[1m]100 万 Token 上下文能塞下整个中型项目。这套组合在 CC Switch 里配一次之后切换就是点一下的事。如果你要跑 Agent 类任务比如自动改多个文件、跑测试循环Coding Plan 这类长期方案比按量计费更划算适合高频使用的开发者。模型对话页面可以用来快速验证某个模型 ID 是否可用不用每次都进终端。接入文档里有完整的字段说明和示例配置卡住时对照着看。最后给一个实用技巧把~/.claude/settings.json纳入你的 dotfiles 管理换机器时直接同步。但注意这个文件里有 API Key别提交到公开仓库。用 CC Switch 的好处是它帮你管理多套配置切换时不用手动改文件也就减少了 Key 泄露到版本控制里的风险。整套链路跑通后你得到的是一套可复制、可切换、可长期维护的 Claude Code 工作环境。 Windows 端安装 Claude Code 并用 CC Switch 配置 DeepSeek：TaoToken 统一 Key 接入实战
1. Windows 下 Claude Code 安装与 CC Switch 配置 DeepSeek 的完整链路Claude Code 是 Anthropic 推出的终端 AI 编码工具能在命令行里直接读写项目文件、跑测试、改配置适合习惯在终端里干活的后端和全栈开发者。但官方默认走 Anthropic 自家后端国内直连体验一般很多人想换成 DeepSeek 这类兼容 Anthropic Message 格式的服务。问题在于Claude Code 本身没有图形化的多后端切换界面手动改settings.json又容易写错字段尤其是同时维护 DeepSeek、其他模型好几套 Key 的时候来回改文件非常烦。这篇就聚焦 Windows 10/11 环境把「winget 装 Claude Code → 装 CC Switch → 用 CC Switch 配置 DeepSeek → 验证连通性」这条链路一次跑通。核心思路是用 TaoToken 统一 Key 管理把分散的 API Key 收敛到一处再通过 CC Switch 这个 GUI 工具往~/.claude/settings.json写环境变量避免手抖写错 JSON。读完你能拿到可直接复制的 CC Switch 配置骨架、settings.json片段以及验证 API 是否真的通了的命令。适合谁Windows 上想用 Claude Code 但不想折腾 Anthropic 官方账号的开发者手里已经有 DeepSeek API Key、想把它接进 Claude Code 的人以及被多工具 Key 分散折磨、想统一管理的同学。下面按步骤来每步都有命令和结果说明。2. TaoToken 前置准备与统一 Key 接入思路在动手装工具之前先把「Key 从哪来、怎么统一」这件事理清楚否则后面配置会反复返工。TaoToken 的定位是统一 API 接入层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于你不需要在 Claude Code、CC Switch、其他 CLI 工具里各填一套不同的 Key而是用统一的 Key 和 Base URL 去对接切换后端时只改一处。具体到这条链路你需要准备两样东西一个是 DeepSeek 官方的 API Keysk-开头在 DeepSeek 平台申请并充值几块钱就能跑很久另一个是 TaoToken 的统一 Key用来在 CC Switch 里做集中管理。如果你只用 DeepSeek 一个后端其实手动写settings.json也行但一旦要加第二个、第三个模型CC Switch 的图形化切换就省事很多。这里要强调一个概念Claude Code 读取配置的优先级是「环境变量 settings.json」。CC Switch 做的事情本质就是帮你把环境变量写进~/.claude/settings.json的env字段里。所以理解了这个文件的结构你手动改也不会错。下面先给出手动版的settings.json骨架路径是C:\Users\你的用户名\.claude\settings.json{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek-API-Key, ANTHROPIC_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro } }注意ANTHROPIC_AUTH_TOKEN填的是 DeepSeek 的 Key不是 Anthropic 的。ANTHROPIC_BASE_URL指向 DeepSeek 的 Anthropic 兼容端点。这几个字段名一个都不能错写错就会报 401 或者连接失败。如果你走 TaoToken 统一接入Base URL 换成 TaoToken 的 API 地址Key 换成 TaoToken 的统一 Key其余字段结构不变。这样切换后端时只动两个值其他工具不用改。前置条件清单Windows 10/11Git Bash推荐winget install Git.GitDeepSeek API Key 已充值TaoToken 账号已注册并拿到统一 Key。把这些准备好后面装工具就是几分钟的事。3. 可复制配置winget 安装 Claude Code 与 CC Switch 配置 DeepSeek这一节是全文的操作核心每一步都给完整命令和配置片段照着敲就行。3.1 winget 安装 Claude Code打开 PowerShell管理员或普通都行执行winget install Anthropic.ClaudeCode装完后新开一个终端窗口验证claude --version如果提示找不到命令重启终端或重启电脑让 PATH 生效。实测下来 winget 装的路径一般会自动进 PATH重启终端就够了。版本号能打印出来就说明 CLI 装好了。3.2 安装 CC SwitchCC Switch 是一个桌面 GUI 工具用来管理 Claude Code 的多套后端配置。去它的 GitHub Releases 页面下载最新 Windows 版本当前是 v3.14.1。两个选择版本文件说明安装版CC-Switch-v3.14.1-Windows.msi双击安装有开始菜单和卸载入口便携版CC-Switch-v3.14.1-Windows-Portable.zip解压即用无需安装安装版双击.msi一路下一步便携版解压到任意目录运行CC-Switch.exe。我一般用便携版换机器直接拷目录不留注册表垃圾。3.3 用 CC Switch 配置 DeepSeek启动 CC Switch点「添加供应商」选择 DeepSeek 预设然后填下面这张表配置项值Base URLhttps://api.deepseek.com/anthropic认证类型ANTHROPIC_AUTH_TOKENAPI Keysk- 开头的 DeepSeek API KeyAPI 格式Anthropic Message主模型deepseek-v4-pro快速模型deepseek-v4-flash标准模型deepseek-v4-pro顶级模型deepseek-v4-pro主模型写成deepseek-v4-pro[1m]可以开启 100 万 Token 上下文处理超大文件或项目级分析时有用。填完保存在主界面选中刚创建的 DeepSeek 配置点「激活」。CC Switch 会自动把对应的环境变量写进~/.claude/settings.json。如果你走 TaoToken 统一 KeyBase URL 填 TaoToken 的 API 地址API Key 填 TaoToken 统一 Key模型 ID 按 TaoToken 文档里对应的 DeepSeek 模型名填。这样一套 Key 可以同时给 Claude Code、Cline、Codex 等工具用切换时只改 CC Switch 里的激活项。3.4 手动配置版不用 CC Switch如果你只用 DeepSeek 一个后端直接手动创建C:\Users\你的用户名\.claude\settings.json内容就是第 2 节给的那段 JSON。注意 JSON 不能有注释、不能有多余逗号否则 Claude Code 解析会失败。用 VS Code 打开这个文件右下角会提示 JSON 格式是否合法绿色勾就对了。4. 验证请求确认 Claude Code 真的连上了 DeepSeek配置写完不算完得验证 API 真的通了。这一步很多人跳过结果用的时候才发现 Key 没生效。4.1 交互式验证终端输入claude进入交互界面后输入你当前使用的是什么模型如果返回deepseek-v4-pro或类似 DeepSeek 模型名说明配置成功。如果返回 Anthropic 的模型名说明settings.json没被读到检查文件路径和 JSON 格式。4.2 命令行直接验证 API 连通性更硬核的方式是直接用 curl 打 DeepSeek 的 Anthropic 兼容端点确认 Key 和 Base URL 都对curl https://api.deepseek.com/anthropic/v1/messages \ -H x-api-key: sk-你的DeepSeek-API-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 有效、端点可达。如果返回 401是 Key 问题返回 404是 Base URL 路径写错返回连接超时是网络或端点地址问题。这个 curl 命令的好处是把 Claude Code 这一层剥掉直接测后端排障时能快速定位是工具配置问题还是 API 本身问题。4.3 在项目里跑一次真实请求进一个你的代码项目目录运行claude然后让它做点实际的事比如读一下当前目录的 package.json告诉我用了哪些依赖如果它能正确读文件并回答说明文件读写权限和 API 都正常。这一步能验证的不只是连通性还有 Claude Code 的工具调用链路。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易踩的坑集中在这几个报错逐个说清楚原因和解法。401 Unauthorized / API Key 无效最常见。原因通常是Key 没充值、Key 复制时带了空格、ANTHROPIC_AUTH_TOKEN字段名写成了ANTHROPIC_API_KEY。DeepSeek 的 Anthropic 兼容端点认的是ANTHROPIC_AUTH_TOKEN写错字段名就会 401。另外确认 Key 是sk-开头且 DeepSeek 账户里至少有少量余额。用第 4.2 节的 curl 命令单独测一下能快速区分是 Key 问题还是 Claude Code 配置问题。local proxy failed / 连接本地代理失败这个报错通常出现在系统里配了 HTTP 代理但代理没启动或端口不对。Claude Code 会读取系统代理环境变量。检查HTTP_PROXY、HTTPS_PROXY这两个环境变量如果指向一个不存在的本地端口就会报 local proxy failed。解法是清掉这两个变量或者确保代理服务真的在跑。注意这里说的是系统环境变量层面的排查不涉及任何具体代理工具。reading choices / 响应解析失败这个报错一般是后端返回的 JSON 结构不符合 Anthropic Message 格式Claude Code 解析choices字段时失败。原因可能是 Base URL 指向了一个 OpenAI 格式的端点而不是 Anthropic 兼容端点。确认ANTHROPIC_BASE_URL结尾是/anthropicAPI 格式选的是 Anthropic Message 而不是 OpenAI。如果走 TaoToken确认用的是 TaoToken 文档里标注的 Anthropic 兼容地址。OAuth 相关报错 / 登录失败Claude Code 首次启动可能会尝试 OAuth 登录 Anthropic 账号。如果你已经用settings.json配了ANTHROPIC_AUTH_TOKEN它应该跳过 OAuth。如果还在报 OAuth 错误检查是不是有旧的登录态缓存。删掉~/.claude下的缓存文件保留settings.json重新启动。另外确认没有同时设置ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN两个同时存在会冲突。claude 命令找不到winget 装完后 PATH 没刷新。重启终端或者手动把 winget 的安装路径加进系统 PATH。用where claude确认命令位置。CC Switch 激活后不生效CC Switch 写的是~/.claude/settings.json但如果你同时在系统环境变量里设了ANTHROPIC_BASE_URL环境变量优先级更高会覆盖文件配置。检查系统环境变量里有没有残留的 Anthropic 相关变量有就删掉。排障时建议按「curl 测后端 → 检查 settings.json → 检查环境变量 → 重启终端」的顺序来从底层往上排查比盲目改配置快得多。接入相关的文档和 API Key 管理可以在 TaoToken 的 API Keys 页面和接入文档里找到对应说明。6. 长期编码与 Agent 场景用 TaoToken 统一 Key 管理多后端跑通单次配置只是开始。如果你打算长期用 Claude Code 做日常编码或者跑 Agent 类任务Key 管理会变成一个持续的成本。多个工具各配一套 Key改一次要动好几个文件还容易漏。TaoToken 的统一 Key 思路就是把这些收敛到一处Claude Code、Cline、Codex 这些工具都指向同一个 Base URL 和 Key切换后端时只改 CC Switch 里的激活项其他工具不用动。对于长期编码场景建议把模型选择也固定下来日常改配置、写脚本用deepseek-v4-flash快且便宜复杂重构、疑难 Bug 用deepseek-v4-pro推理能力强超长文件或项目级分析用deepseek-v4-pro[1m]100 万 Token 上下文能塞下整个中型项目。这套组合在 CC Switch 里配一次之后切换就是点一下的事。如果你要跑 Agent 类任务比如自动改多个文件、跑测试循环Coding Plan 这类长期方案比按量计费更划算适合高频使用的开发者。模型对话页面可以用来快速验证某个模型 ID 是否可用不用每次都进终端。接入文档里有完整的字段说明和示例配置卡住时对照着看。最后给一个实用技巧把~/.claude/settings.json纳入你的 dotfiles 管理换机器时直接同步。但注意这个文件里有 API Key别提交到公开仓库。用 CC Switch 的好处是它帮你管理多套配置切换时不用手动改文件也就减少了 Key 泄露到版本控制里的风险。整套链路跑通后你得到的是一套可复制、可切换、可长期维护的 Claude Code 工作环境。