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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。它的价值在于：你不需要在 Claude Code、CC Switch、其他 CLI 工具里各填一套不同的 Key，而是用统一的 Key 和 Base URL 去对接，切换后端时只改一处。

具体到这条链路，你需要准备两样东西：一个是 DeepSeek 官方的 API Key（sk-开头），在 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/11；Git Bash（推荐，winget install Git.Git）；DeepSeek 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 Switch

CC Switch 是一个桌面 GUI 工具，用来管理 Claude Code 的多套后端配置。去它的 GitHub Releases 页面下载最新 Windows 版本，当前是 v3.14.1。两个选择：

安装版双击.msi一路下一步；便携版解压到任意目录，运行CC-Switch.exe。我一般用便携版，换机器直接拷目录，不留注册表垃圾。

3.3 用 CC Switch 配置 DeepSeek

启动 CC Switch，点「添加供应商」，选择 DeepSeek 预设，然后填下面这张表：

主模型写成deepseek-v4-pro[1m]可以开启 100 万 Token 上下文，处理超大文件或项目级分析时有用。填完保存，在主界面选中刚创建的 DeepSeek 配置，点「激活」。CC Switch 会自动把对应的环境变量写进~/.claude/settings.json。

如果你走 TaoToken 统一 Key，Base 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结尾是/anthropic，API 格式选的是 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 工作环境。