VSCode 安装 Claude Code 插件,配置 DeepSeek V4 模型指南(Windows)
时间:2026-05-07
目的:在 Windows 上安装 Claude Code(VSCode 插件 / CLI),配置 DeepSeek V4 作为后端模型,享受高质量的 AI 编程体验。
为什么选择 Claude Code + DeepSeek V4?
Claude Code 是 Anthropic 官方出品的 AI 编程助手。通过配置兼容的 API 后端,你可以自由选择底层大模型,不再局限于 Anthropic 官方 API。
DeepSeek V4 是当前综合能力最强的开源模型之一,在编程场景中表现优异:
- 代码理解与生成能力强,适合复杂重构与日常开发
- 推理速度快,响应延迟低
- 支持工具调用(Tool Calling),可无缝对接 Claude Code
- 成本远低于 Anthropic 官方模型
后端接入方式有两种选择:
| 接入方式 | 说明 |
|---|---|
| DeepSeek 官方 API | 直接使用 DeepSeek 官方服务,稳定可靠 |
| 硅基流动(SiliconFlow) | 国内 MaaS 平台,提供 Anthropic 兼容端点,新用户赠代金券 |
两种方式都需要 API 兼容层:DeepSeek 官方 API 格式与 Anthropic 不同,需通过代理或兼容网关转换。硅基流动已内置 Anthropic 格式兼容,可直接使用。
核心原理
Claude Code 默认请求发送到 Anthropic 官方 API。通过设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量,可以将请求重定向到兼容端点:
Claude Code (VSCode / CLI) → 兼容 API 端点 (硅基流动 / 自定义代理)
(Anthropic 格式) → DeepSeek V4
方式一:VSCode 安装 Claude Code 插件(推荐)
1. 安装插件
在 VSCode 扩展商店搜索 Claude Code,安装官方插件。
需要设置一下,跳过claude登录
勾选上 “Disable Login”
2. 配置后端(以硅基流动为例)
打开 VSCode 设置(Ctrl + ,),搜索 claude code,找到以下配置项:
| 配置项 | 值 |
|---|---|
Claude Code: Base URL |
https://api.siliconflow.cn/v1 |
Claude Code: Auth Token |
sk-你的API Key |
Claude Code: API Key |
留空(必须置空!) |
或者直接在 settings.json 中添加:
{
"claude-code.baseUrl": "https://api.siliconflow.cn/v1",
"claude-code.authToken": "sk-你的API Key",
"claude-code.apiKey": ""
}
重要:
apiKey必须显式设为空字符串,否则 Claude Code 会尝试连接 Anthropic 官方 API 导致认证失败。
3. 获取 API Key
方案 A:硅基流动
- 注册硅基流动账号:https://cloud.siliconflow.cn/i/QDEbCdOU
- 登录后进入 API Key 管理页
- 点击「新建 API Key」,复制生成的 Key
方案 B:DeepSeek 官方
- 访问 DeepSeek 开放平台 注册并获取 API Key
- 注意:DeepSeek 官方 API 与 Anthropic 格式不完全兼容,需自行搭建兼容代理,或使用支持格式转换的中间层
4. 配置模型
在 VSCode 设置中指定 DeepSeek V4 作为使用的模型:
{
"claude-code.model": "deepseek-ai/DeepSeek-V4"
}
按 Ctrl + Shift + P,输入 Claude Code: Start 即可开始使用。
方式二:Windows 命令行安装 Claude Code
1. 安装 Node.js(前置条件)
Claude Code 需要 Node.js 18+ 环境。
- 前往 Node.js 官网 下载 Windows 安装包(推荐 LTS 版本)
- 运行安装程序,一路 Next 即可
- 验证安装:
node --version # 应显示 v18.x 或更高
npm --version
2. 安装 Claude Code CLI
打开 PowerShell(管理员模式),执行:
npm install -g @anthropic-ai/claude-code
验证安装:
claude --version
3. 配置环境变量
临时配置(当前终端窗口有效)
$env:ANTHROPIC_BASE_URL = "https://api.siliconflow.cn/v1"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的API Key"
$env:ANTHROPIC_API_KEY = ""
永久配置(推荐)
方法 A:通过系统设置
- 按
Win + R,输入sysdm.cpl,回车 - 选项卡「高级」→「环境变量」
- 新建以下用户变量(或系统变量):
| 变量名 | 变量值 |
|---|---|
ANTHROPIC_BASE_URL |
https://api.siliconflow.cn/v1 |
ANTHROPIC_AUTH_TOKEN |
sk-你的API Key |
ANTHROPIC_API_KEY |
(设为空) |
方法 B:通过 PowerShell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.siliconflow.cn/v1", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的API Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "", "User")
设置完成后,重启终端让环境变量生效。
4. 指定模型并启动
# 设置使用 DeepSeek V4
$env:ANTHROPIC_MODEL = "deepseek-ai/DeepSeek-V4"
# 启动 Claude Code
claude
或者一步到位:
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4"; $env:ANTHROPIC_BASE_URL="https://api.siliconflow.cn/v1"; $env:ANTHROPIC_AUTH_TOKEN="sk-你的Key"; $env:ANTHROPIC_API_KEY=""; claude
首次启动会进入 Claude Code 的交互式 REPL 界面,输入你的需求即可开始 AI 编程。
DeepSeek 系列模型推荐
通过硅基流动等兼容平台,你可以访问多款 DeepSeek 模型:
| 模型 | 模型 ID | 特点 | 推荐场景 |
|---|---|---|---|
| DeepSeek V4 | deepseek-ai/DeepSeek-V4 |
最强推理,速度较快 | 日常主力编程 |
| DeepSeek R1 0528 | deepseek-ai/DeepSeek-R1-0528 |
深度推理,工具调用优秀 | 复杂代码重构、调试 |
| DeepSeek V3 | deepseek-ai/DeepSeek-V3 |
稳定可靠,成本低 | 通用编程任务 |
在 Claude Code 中切换模型只需修改
ANTHROPIC_MODEL环境变量或设置claude-code.model。模型可用性以平台实际提供的列表为准。
验证配置是否生效
启动 Claude Code 后,输入以下命令验证后端配置:
/debug
查看输出中的 Base URL 和 Model 是否为你指定的配置。
也可以直接问:
“你现在用的是哪个模型?”
如果回答包含 DeepSeek V4,则配置成功。
常见问题
Q1:启动后报错 “Authentication failed”
原因:ANTHROPIC_API_KEY 没有显式置空。
解决:确保设置了 $env:ANTHROPIC_API_KEY = ""(空字符串,不是不设)。
Q2:提示 “Model not found”
原因:模型 ID 拼写错误或该模型在当前平台上不可用。
解决:登录对应平台控制台查看可用模型列表,确认模型 ID 准确无误。
Q3:工具调用(Tool Calling)不稳定
原因:非 Claude 模型在工具调用能力上与 Anthropic 官方模型有差距。
解决:
- 优先使用 DeepSeek R1 / V4 系列,工具调用能力较强
- 遇到编辑失败时,重新描述需求或拆分任务
- 频繁执行
/compact清理上下文,建议每 10-15 轮执行一次
Q4:VSCode 插件配置不生效
原因:环境变量和 VSCode 设置同时配置时可能冲突。
解决:建议只保留一种配置方式。推荐在 VSCode 的 settings.json 中配置,避免混用。
Q5:响应速度慢
原因:模型推理资源紧张或网络波动。
解决:
- 尝试切换模型(如 V3 系列通常比 V4 快)
- 检查网络连接,硅基流动国内直连通常延迟 < 500ms
总结
| 对比维度 | VSCode 插件方式 | Windows CLI 方式 |
|---|---|---|
| 上手难度 | 简单 | 中等 |
| 功能完整度 | 图形化交互 | 完整 CLI 能力 |
| 配置方式 | VSCode 设置面板 | 环境变量 |
| 适合人群 | VSCode 用户 | 终端用户 / CI/CD 集成 |
两种方式可以同时配置,互不冲突。最推荐 VSCode 用户使用插件方式,开发体验更流畅。
参考链接
更多推荐



所有评论(0)