时间：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. 获取 API Key

硅基流动，注册实名认证即可领取16元抵用券，免费使用

1. 注册硅基流动账号：https://cloud.siliconflow.cn/i/QDEbCdOU
2. 登录后进入 API Key 管理页
3. 点击「新建 API Key」，复制生成的 Key（密钥名称随便取）
   

3. 安装 CC Switch 一键切换 API

前往 GitHub Releases: https://github.com/farion1231/cc-switch/releases/latest 下载对应平台的安装包。
拉到网页最底部，资源包部分，下载对应平台的安装包，拉到网页最底部，资源包部分，下载对应平台的安装包。
安装后，点“+”添加， 选择“SiliconFlow”, 填入API Key

点击“启用”

4. 配置模型

在 VSCode 设置中指定 DeepSeek V4 作为使用的模型：
VS Code 正确配置（settings.json）
打开 VS Code → Ctrl+Shift+P → 输入 Preferences: Open Settings (JSON)，把下面完整覆盖进去：

{
    // Claude Code + DeepSeek V4 核心配置
    "claudeCode.environmentVariables": [
        {
            "name": "ANTHROPIC_BASE_URL",
            "value": "https://api.deepseek.com/anthropic"
        },
        {
            "name": "ANTHROPIC_AUTH_TOKEN",
            "value": "sk-你的DeepSeek密钥" // 替换成你自己的 sk-xxx
        },
        {
            "name": "ANTHROPIC_MODEL",
            "value": "deepseek-v4-pro" // 默认用 V4-Pro
        },
        {
            "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
            "value": "deepseek-v4-pro"
        },
        {
            "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
            "value": "deepseek-v4-pro"
        },
        {
            "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
            "value": "deepseek-v4-flash" // 轻量用 V4-Flash
        },
        {
            "name": "API_TIMEOUT_MS",
            "value": "600000" // 10分钟超时，避免长输出中断
        }
    ],
    // 跳过 Claude 官方登录，必须开启
    "claudeCode.disableLoginPrompt": true,
    // 可选：禁用非必要流量，更稳定
    "claudeCode.disableNonEssentialTraffic": true
}

全局配置（可选，所有项目生效）
如果想终端和 VS Code 共用，创建 / 编辑 ~/.claude/settings.json：

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
        "ANTHROPIC_MODEL": "deepseek-v4-pro",
        "API_TIMEOUT_MS": "600000"
    }
}

生效步骤（必做）
保存 settings.json
完全关闭并重启 VS Code
打开 Claude Code 面板 → 右下角显示 deepseek-v4-pro 即成功

---

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 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 用户使用插件方式，开发体验更流畅。

---

参考链接

• Claude Code 官方文档
• DeepSeek 开放平台
• 硅基流动（赠代金券）
• 硅基流动 API 文档
• 硅基流动模型列表