本地部署 Claude Code 接入 DeepSeek V4 Pro 教程

本文详细介绍了如何在Windows系统上配置和使用DeepSeek V4 Pro模型替代Claude Code。主要内容包括：1) 环境准备（Node.js安装、API Key获取）；2) Claude Code安装与配置（跳过强制登录、设置DeepSeek API参数）；3) 两种配置方法（手动修改配置或使用CCSwitch工具）；4) VSCode集成方法；5) 常用命令与技巧；6) 常见问题

gangchuangangchu

627人浏览 · 2026-05-18 09:14:17

gangchuangangchu · 2026-05-18 09:14:17 发布

一、准备工作

1.1 环境要求

Windows 10/11 64 位系统
Node.js 18.0+（必须）
VS Code（推荐）
至少 4GB 可用内存

1.2 获取 DeepSeek API Key

访问 DeepSeek 开放平台：https://platform.deepseek.com/
使用手机号注册并登录
新用户赠送500 万免费 Token，足够使用很长时间
点击左侧 "API Keys" → "创建新的 API Key"
输入备注名称，点击 "创建"，立即复制并保存好你的 API Key（只显示一次）

二、安装 Claude Code

2.1 安装 Node.js

访问 Node.js 官网：https://nodejs.org/
下载 LTS 版本（推荐 20.x 或 22.x）
双击安装包，一路默认安装即可
验证安装：打开 CMD 或 PowerShell，输入以下命令

node -v
npm -v

如果显示版本号，说明安装成功。

2.2 全局安装 Claude Code

打开 CMD 或 PowerShell，执行以下命令：

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

安装完成后，验证：

claude --version

如果显示版本号，说明安装成功。

三、配置 DeepSeek V4 Pro（两种方法任选）

方法一：手动修改配置文件（推荐，最稳定）

这是最直接、最稳定的方法，不需要安装额外工具。

3.1.1 跳过 Claude Code 强制登录

Claude Code v2.0.65 + 版本强制要求完成初次引导，即使配置了第三方 API 也会被卡住。我们需要手动创建一个文件来跳过登录：

打开文件资源管理器，进入用户目录：C:\Users\你的用户名\
创建一个名为.claude.json的文件（注意前面有个点）
写入以下内容：

json

{
  "hasCompletedOnboarding": true
}

保存并关闭。

3.1.2 配置 DeepSeek API

在用户目录下创建.claude文件夹（如果不存在）
进入.claude文件夹，创建settings.json文件
写入以下完整配置（替换为你的 DeepSeek API Key）：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "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",
    "ANTHROPIC_REASONING_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "1200000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80"
  },
  "permissions": {
    "readFiles": true,
    "writeFiles": true,
    "runCommands": "ask",
    "useMcpServers": true,
    "browseWeb": true
  }
}

配置说明：

deepseek-v4-pro[1m]：开启 100 万 Token 上下文窗口
CLAUDE_CODE_EFFORT_LEVEL": "max"：开启 DeepSeek V4 的 Max 强推理模式
API_TIMEOUT_MS": "1200000"：将超时时间延长到 20 分钟，避免长任务中断

方法二：使用 CC Switch 工具（一键切换模型）

如果你需要经常在不同模型之间切换，可以使用 CC Switch 工具。

3.2.1 下载安装 CC Switch

访问 GitHub 项目地址：https://github.com/farion1231/cc-switch
点击 "Releases"，下载最新版 Windows 安装包（.msi文件）
双击安装包，一路默认安装即可

3.2.2 配置 DeepSeek

打开 CC Switch
点击右上角 "+ Add Provider"
选择 "DeepSeek"
粘贴你的 DeepSeek API Key
点击 "Add" 保存
回到主界面，选中刚添加的 DeepSeek 配置
点击 "Enable" 让配置生效

四、验证配置是否成功

打开 CMD 或 PowerShell
进入任意一个项目文件夹（重要！Claude Code 需要在项目目录下运行）
输入claude命令启动
如果看到类似下面的界面，说明配置成功：

🦙 Claude Code v2.1.0
Model: deepseek-v4-pro[1m]
Effort: max
Context: 1,000,000 tokens

Type /help for commands.

输入一个简单问题测试：

你好，帮我写一个Python的Hello World程序

如果能正常回复，说明一切正常！

五、VS Code 集成使用

5.1 安装 Claude Code 插件

打开 VS Code
点击左侧扩展图标（Extensions）
搜索 "Claude Code"
找到官方插件 "Claude Code for VS Code"，点击安装

5.2 配置 VS Code 插件

点击 Claude Code 插件的设置图标（⚙️）
选择 "Extension Settings"
点击 "Edit in settings.json"
添加以下配置：

json

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-你的DeepSeek-API-Key"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.deepseek.com/anthropic"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "deepseek-v4-pro[1m]"
    }
  ]
}