时间: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_URLANTHROPIC_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:硅基流动

  1. 注册硅基流动账号:https://cloud.siliconflow.cn/i/QDEbCdOU
  2. 登录后进入 API Key 管理页
  3. 点击「新建 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+ 环境。

  1. 前往 Node.js 官网 下载 Windows 安装包(推荐 LTS 版本)
  2. 运行安装程序,一路 Next 即可
  3. 验证安装:
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:通过系统设置

  1. Win + R,输入 sysdm.cpl,回车
  2. 选项卡「高级」→「环境变量」
  3. 新建以下用户变量(或系统变量):
变量名 变量值
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 URLModel 是否为你指定的配置。

也可以直接问:

“你现在用的是哪个模型?”

如果回答包含 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 用户使用插件方式,开发体验更流畅。


参考链接

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐