Windows 从零搭建 Claude Code + DeepSeek V4 开发环境

6 6月 2026
11 分钟阅读
标签:
Windows,
Claude,
DeepSeek,
Node.js,
Git,
教程

更新于 6 6月 2026

本文面向 Windows 用户，从零开始搭建一套完整的 AI 编程环境：安装 Git 和 Node.js 运行时，安装 Claude Code 命令行工具，通过 cc-switch 配置 DeepSeek V4 作为后端模型，最终在终端中启动 Claude Code 进行开发。

整体流程一览

安装 Git ──→ 安装 Node.js ──→ 安装 Claude Code
                                      │
                                      ▼
                             安装 cc-switch
                                      │
                                      ▼
                         购买 DeepSeek API Key
                                      │
                                      ▼
                     配置 cc-switch 使用 DeepSeek V4
                                      │
                                      ▼
                              启动 Claude Code

第一步：安装 Git

Git 是版本控制工具，也是 Claude Code 进行代码管理和上下文理解的基础。

1.1 下载 Git

访问 Git 官方下载页面：

下载地址：https://git-scm.com/download/win

系统会自动推荐 64 位版本，点击即可下载。

1.2 安装 Git

双击运行安装程序，关键配置步骤：

步骤	推荐选择	说明
选择组件	默认全选	建议勾选 "Git LFS" 和 "Add a Git Bash Profile to Windows Terminal"
默认编辑器	选你习惯的（VSCode 推荐）	后续 Claude Code 调用编辑器时使用
PATH 环境	Recommended: Git from the command line	确保在 CMD/PowerShell 中可直接使用 git 命令
行尾转换	Checkout as-is, commit as-is	Windows 环境下推荐此选项，避免换行符问题
终端模拟器	Use MinTTY	更好的终端体验
额外选项	默认即可

1.3 验证安装

安装完成后，打开 CMD 或 PowerShell，输入：

git --version

输出类似：

git version 2.48.1.windows.1

配置 Git 用户信息（后续 Claude Code 操作 Git 时需要）：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

第二步：安装 Node.js

Claude Code 通过 npm（Node.js 包管理器）安装，因此需要先安装 Node.js 运行环境。

2.1 下载 Node.js

下载地址：https://nodejs.org/

建议选择 LTS（长期支持）版本，稳定可靠。下载 Windows 安装包（.msi 文件）。

2.2 安装 Node.js

双击 .msi 安装包，关键步骤：

许可协议 → 勾选同意
安装路径 → 默认 C:\Program Files\nodejs\ 即可
自定义设置 → 保持默认全选
⚠️ 务必勾选："Automatically install the necessary tools" — 这会自动安装编译原生模块所需的工具链

2.3 验证安装

node --version
npm --version

输出示例：

v22.14.0
11.2.0

2.4 配置 npm 镜像（重要）

由于网络原因，从 npm 官方源下载包可能很慢。我们配置为国内镜像源，后续安装 Claude Code 时可以大幅提速：

# 查看当前配置
npm config get registry

# 设置为淘宝 npm 镜像
npm config set registry https://registry.npmmirror.com

验证：

npm config get registry

输出应为：https://registry.npmmirror.com

说明：npmmirror.com 是淘宝 NPM 镜像的官方域名，与 cnpmjs.org 同一团队维护，同步频率高、稳定性好。

第三步：安装 Claude Code

Node.js 和镜像配置完成后，就可以安装 Claude Code 了。

3.1 全局安装 Claude Code

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

这里的 -g 表示全局安装，--registry 指定使用国内镜像源加速下载。

安装过程可能需要 1-3 分钟，输出类似：

npm notice
npm notice New major version of npm available! 11.2.0 -> 11.3.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.3.0
npm notice Run npm install -g npm@11.3.0 to update
npm notice
added 1 package in 25s

3.2 验证安装

claude --version

如果正常输出版本号，说明安装成功。

💡 提示：如果 claude 命令找不到，请检查 npm 全局安装目录是否在 PATH 中：
npm config get prefix
默认是 C:\Users\<你的用户名>\AppData\Roaming\npm，将该路径添加到系统 PATH 即可。

3.3 关于 `--registry` 参数说明

安装命令中使用了 --registry=https://registry.npmmirror.com，它的作用是：

临时生效：仅本次安装使用该镜像源，不影响已配置的全局 registry
加速下载：npmmirror 每 10 分钟与官方源同步一次，下载速度远快于官方源
安全可靠：npm 官方推荐的镜像使用方法，不会引入恶意包

如果你已经像第二步那样配置了全局 registry，可以省略该参数：

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

第四步：安装 cc-switch

cc-switch 是一款社区工具，用于在 Claude Code 中切换不同的 AI 模型供应商，让我们可以使用 DeepSeek V4 替代默认的 Claude 模型。

4.1 什么是 cc-switch？

cc-switch 本质上是一个配置管理工具，作用包括：

🔄 一键切换模型供应商（Anthropic / OpenAI / DeepSeek / Moonshot 等）
🔧 自动配置 Claude Code 的环境变量和 settings.json
📋 管理多个 API Key，按需选择
🌐 支持 OpenAI 兼容接口的任意模型

4.2 安装 cc-switch

npm install -g cc-switch --registry=https://registry.npmmirror.com

验证安装：

cc-switch --version

4.3 cc-switch 常用命令速览

# 查看支持的供应商列表
cc-switch list

# 查看当前配置
cc-switch status

# 设置供应商
cc-switch set <供应商名称>

# 配置 API Key
cc-switch config --api-key <你的Key>

# 查看帮助
cc-switch --help

第五步：购买 DeepSeek API Key

要使用 DeepSeek V4 模型，需要先获取 API 访问权限。

5.1 注册 DeepSeek 账号

访问 DeepSeek 开放平台：

官网：https://platform.deepseek.com/

点击注册，支持邮箱或手机号注册
完成邮箱/手机验证
登录控制台

5.2 充值

DeepSeek API 采用预付费按量计费模式：

项目	说明
计费方式	按 Token 计费（输入 + 输出分别计费）
充值门槛	通常最低充值 10 元起
支付方式	支付宝、微信支付
费用预估	日常编程辅助，月均几十元即可满足需求

在控制台中找到 "充值" 或 "财务管理"，按需充值即可。

5.3 创建 API Key

进入 "API Keys" 管理页面
点击 "创建 API Key"
给 Key 取个名字（如 "claude-code"）
复制生成的 Key 字符串（格式类似 sk-xxxxxxxxxxxx）

⚠️ 安全提示：

API Key 仅在创建时显示一次，务必立即复制保存

不要将 Key 提交到 Git 仓库或分享给他人

建议在 DeepSeek 控制台中设置用量限额，防止意外超额

第六步：配置 cc-switch 使用 DeepSeek V4

拿到 API Key 后，就可以配置 cc-switch 了。

6.1 设置供应商

cc-switch set deepseek

或者如果你知道具体的模型版本：

cc-switch set deepseek-v4

6.2 配置 API Key

cc-switch config --api-key sk-你的DeepSeekKey

6.3 确认配置

cc-switch status

输出示例如下：

当前供应商: deepseek
模型名称: deepseek-chat
API 端点: https://api.deepseek.com/v1
API Key: sk-xxx...xxx ✅ 已配置

6.4 cc-switch 做了什么？

执行 cc-switch set deepseek 后，它会自动帮你：

设置环境变量（写入配置文件，使其持久化）
修改 Claude Code 的 settings.json，指向 DeepSeek 的 API 端点
下次启动 Claude Code 时自动使用 DeepSeek V4 模型

相当于自动执行了这些手动配置：

// ~/.claude/settings.json
{
  "model": "deepseek-chat",
  "modelBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-你的DeepSeekKey"
}

第七步：启动 Claude Code

一切就绪，现在可以启动 Claude Code 了。

7.1 启动

在 CMD 或 PowerShell 中直接输入：

claude

首次启动会显示欢迎信息和终端 UI：

╭──────────────────────────────────────────────╮
│                                              │
│   Welcome to Claude Code!                    │
│                                              │
╰──────────────────────────────────────────────╯

Type /help for available commands.
Type /exit to quit.
>

7.2 验证模型

在 Claude Code 中输入：

你当前使用的是哪个模型？API 供应商是谁？

如果 cc-switch 配置正确，它会回答当前使用的是 DeepSeek 模型。

7.3 测试编程能力

可以试一个实际编程问题来验证：

帮我写一个 Python 脚本，递归遍历当前目录下所有 .log 文件，统计每个文件的行数和总行数。

DeepSeek V4 在代码生成方面表现优秀，应该能给出完整可用的代码。

7.4 在已有项目中工作

进入项目目录后再启动 Claude Code：

cd C:\Users\你的用户名\Projects\my-project
claude

这样 Claude Code 会自动读取项目上下文，包括 Git 历史、项目结构等，提供更精准的帮助。

完整命令速查（一键操作回顾）

以下是从头到尾的完整命令序列，方便你快速重现：

:: 1. 安装 Git（需手动下载安装）
::    https://git-scm.com/download/win
::
:: 2. 安装 Node.js（需手动下载安装）
::    https://nodejs.org/

:: 3. 配置 npm 镜像
npm config set registry https://registry.npmmirror.com

:: 4. 安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

:: 5. 安装 cc-switch
npm install -g cc-switch --registry=https://registry.npmmirror.com

:: 6. 配置 DeepSeek（先充值获取 API Key）
cc-switch set deepseek
cc-switch config --api-key sk-你的DeepSeekKey

:: 7. 启动
claude

常见问题

Q1: `claude` 命令找不到

npm list -g --depth=0

查看 @anthropic-ai/claude-code 是否在列表中。如果不存在，重新安装：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果存在但命令找不到，将 npm 全局目录添加到 PATH：

运行 npm config get prefix，记下路径（如 C:\Users\<用户名>\AppData\Roaming\npm）
系统环境变量 → Path → 新增该路径

Q2: npm install 报错 "ERR! code ECONNRESET"

网络问题，重试即可：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

或者切换其他镜像源试试：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Q3: cc-switch 提示 "供应商不存在"

确保 cc-switch 版本支持 DeepSeek V4：

cc-switch --version
cc-switch list

如果列表中没有 deepseek，尝试更新 cc-switch：

npm update -g cc-switch --registry=https://registry.npmmirror.com

Q4: cc-switch 配置后 Claude Code 仍使用 Claude 模型

手动检查配置是否生效：

:: 查看环境变量
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_API_KEY%
echo %CLAUDE_MODEL%

如果为空，说明环境变量未正确设置。可以手动设置：

setx ANTHROPIC_BASE_URL "https://api.deepseek.com/v1"
setx ANTHROPIC_API_KEY "sk-你的Key"
setx CLAUDE_MODEL "deepseek-chat"

设置后重新打开终端再启动 claude。

Q5: 启动后自动退出或无响应

可能是 Node.js 版本过低或内存不足：

:: 检查 Node.js 版本（需 v18+）
node --version

:: 检查内存使用
wmic OS get FreePhysicalMemory

建议 Node.js ≥ 18.x，空闲内存 ≥ 4GB。

写在最后

通过以上七个步骤，你已经在 Windows 上成功搭建了：

组件	用途
✅ Git	版本控制与代码管理
✅ Node.js + npm	JavaScript 运行时与包管理
✅ Claude Code	AI 编程命令行工具
✅ cc-switch	模型供应商切换工具
✅ DeepSeek V4	API 已配置，可正常调用

这套环境搭配的优势在于：

低成本：DeepSeek V4 的 API 费用远低于 Claude 官方
国内友好：全部使用国内镜像源，下载安装无网络障碍
灵活切换：通过 cc-switch 可随时切换回 Claude 或其他模型
生产可用：Git + Node.js 本身就是开发者标配，不留冗余

祝你在 Windows 上 AI 编程愉快！🎉

相关阅读：

Git 官方文档

Node.js 官方指南

Claude Code 文档

cc-switch GitHub

DeepSeek 开放平台