Win11 安装 Claude Code + CC-Switch 接入 DeepSeek V4 Pro 完整指南

www11664

1751人浏览 · 2026-05-20 10:15:51

www11664 · 2026-05-20 10:15:51 发布

Win11 安装 Claude Code + CC-Switch 接入 DeepSeek V4 Pro 完整指南

适用平台：Windows 11 | 最后更新：2026-05-20

1. 前置准备

组件	说明
操作系统	Windows 11（Win10 也可）
Node.js	v18+（推荐 v20 LTS 或 v22）
npm	随 Node.js 一起安装
终端	Git Bash / PowerShell / Windows Terminal
DeepSeek 账号	用于获取 API Key
网络	能正常访问 api.deepseek.com 和 github.com

1.1 安装 Node.js

方式一：官网安装（推荐）

打开 https://nodejs.org

下载 LTS 版本 的 Windows 安装包（.msi）
运行安装包，一路 Next，勾选「Automatically install the necessary tools」
安装完成后重启终端

方式二：使用 winget

 winget install OpenJS.NodeJS.LTS

验证安装：

 node --version   # 应输出 v20.x 或 v22.x
 npm --version    # 应输出 10.x

注意：如果使用 Git Bash，需要确保 C:\Program Files\nodejs 在 PATH 中。可在 ~/.bashrc 添加：
 export PATH="/c/Program Files/nodejs:$PATH"

2. 安装 Claude Code

在终端中执行：

 npm install -g @anthropic-ai/claude-code

安装完成后验证：

 claude --version
 # 应输出类似: 2.x.x (Claude Code)

Claude Code 会被安装到 %APPDATA%/npm/claude

3. 安装和配置 CC-Switch

CC-Switch 是一个图形化管理工具，用于在本地代理 Claude Code 的 API 请求到不同的模型提供商，支持一键切换 DeepSeek V4 Pro 等模型。

3.1 下载 CC-Switch

打开 CC-Switch GitHub 仓库：https://github.com/farion1231/cc-switch

进入 Releases 页面
下载最新版 Windows 安装包（.exe 或 .msi）
运行安装程序，完成安装

3.2 启动 CC-Switch

从开始菜单启动 CC-Switch
系统托盘会出现 CC-Switch 图标
右键图标可打开配置面板

4. 获取 DeepSeek API Key

打开
注册或登录账号
进入 API Keys 页面
点击 创建 API Key，复制生成的 key（格式：sk-xxxxxxxx）

注意：API Key 仅创建时显示一次，请妥善保存。

5. CC-Switch 接入 DeepSeek V4 Pro

5.1 推荐配置（本地路由模式）

在 CC-Switch 面板中配置：

配置项	值
Base URL	`https://api.deepseek.com/anthropic`
认证类型	`ANTHROPIC_AUTH_TOKEN`
API Key	`sk-你的DeepSeek密钥`
API 格式	`Anthropic Messages`
主模型	留空（让 Claude Code 自动选择）
Opus 模型	`deepseek-v4-pro`
Sonnet 模型	`deepseek-v4-pro`
Haiku 模型	`deepseek-v4-flash`
子代理模型	`deepseek-v4-flash`

5.2 模型映射说明

Claude Code 请求	实际调用模型	适用场景
Opus（默认）	`deepseek-v4-pro`	复杂推理、大型重构
Sonnet	`deepseek-v4-pro`	中等复杂度任务
Haiku	`deepseek-v4-flash`	日常编码、快速响应
Sub-agent	`deepseek-v4-flash`	子任务，节省 token

5.3 ⚠️ `[1m]` 后缀注意事项

CC-Switch 本地路由模式下：模型中不要加 [1m] 后缀，否则会回退到 Flash 模型
CC-Switch 会自动处理上下文窗口
如果手动配置 settings.json（不使用 CC-Switch），可以加 [1m] 后缀开启百万上下文：
```
 deepseek-v4-pro[1m]
```

5.4 启用 Think 模式

 # Claude Code 中切换模式
 /fast       # 快速模式（无 thinking，token 消耗少）
 /think      # 深度思考模式

6. 验证配置

6.1 检查 CC-Switch 代理状态

确保 CC-Switch 的状态为运行中，代理地址通常为 http://127.0.0.1:15721。

Claude Code 会自动通过 CC-Switch 转发请求，无需额外配置。

6.2 测试 Claude Code

在终端中运行：

 claude

输入一个简单测试：

 你好，请介绍一下你自己，你使用的是哪个模型？

/model 显示的是 → Claude Code 本地配置的模型名（Opus 4.7）
实际服务的模型是 → ccswitch 代理转发到的模型（DeepSeek V4）

6.3 查看 CC-Switch 日志

在 CC-Switch 面板中可以查看每次 API 请求的日志：

请求模型
Token 消耗
响应时间
错误信息

7. 手动配置方式（备选）

如果不想使用 CC-Switch GUI 工具，也可以直接修改 Claude Code 配置文件。

编辑 %USERPROFILE%\.claude\settings.local.json：

 {
   "env": {
     "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
     "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
     "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
     "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
     "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
     "CLAUDE_CODE_EFFORT_LEVEL": "max",
     "API_TIMEOUT_MS": "3000000",
     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
   }
 }

注意：手动配置模式下，模型中可以加 [1m] 后缀（$1M token 上下文），Claude Code 会在发请求时自动移除该后缀传给 DeepSeek。

保存后重启 Claude Code 即可生效。

8. 常见问题与排错

8.1 `claude` 命令找不到

 # 检查 npm 全局安装路径是否在 PATH 中
 npm config get prefix
 # 将输出路径添加到系统环境变量 PATH

8.2 返回 401 错误

确认 API Key 正确（以 sk- 开头）
确认 DeepSeek 账户余额充足
检查 Base URL 是否正确

8.3 响应很慢

将配置文件中的 API_TIMEOUT_MS 调大到 3000000（50 分钟）
DeepSeek V4 Pro 出 token 速度约为 20-30 t/s，属于正常范围

8.4 模型退化到 Flash

检查模型中是否在 CC-Switch 本地路由模式下错误添加了 [1m] 后缀
去掉 [1m] 后重试

8.5 CC-Switch 找不到

从 GitHub Releases 重新下载
检查防火墙是否拦截了 CC-Switch 的本地端口

8.6 模型使用策略建议

场景	推荐模型
日常编码、简单问答	`deepseek-v4-flash`
复杂重构、多文件改动	`deepseek-v4-pro`
深度分析、大型代码库理解	`deepseek-v4-pro` + Think 模式
超长上下文（10万+ tokens）	`deepseek-v4-pro[1m]`（手动模式）