在Windows系统上配置Claude Code使用DeepSeek API的操作指南实践整理

作者：袖梨 2026-08-24

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“在Windows系统上配置Claude Code使用DeepSeek A……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

实际处理时，本文档详细说明如何在 Windows 系统上设置 Claude Code 采用 DeepSeek API。

环境要求

Windows 10/11 系统
PowerShell 5.0 或更高版本
Git（用来版本控制）

第一步：安装 Node.js

1.1 下载 Node.js

理解这一步时，访问 Node.js 官网下载 LTS 版本（建议 v18 或更高版本）。

1.2 安装 Node.js

运行下载的安装程序
勾选 "Automatically install necessary tools"
完成安装向导
重启终端

1.3 验证安装

node --version
npm --version

预期输出：

v18.x.x
9.x.x

第二步：安装 Claude Code

2.1 设置执行策略

如果遇到脚本执行错误，先运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2.2 安装 Claude Code

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

2.3 验证安装

claude --version

预期输出：2.1.152 或更高版本

第三步：设置 DeepSeek API

3.1 拿到 DeepSeek API Key

访问 DeepSeek 官网
注册/登录账号
在 API Keys 页面新建新的 API Key
复制生成的 Key（格式：sk-xxxxxxxx）

3.2 设置环境变量（永久生效）

实际处理时，打开 PowerShell，运行以下命令（将 YOUR_API_KEY 替换为你的实际 API Key）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-flash", "User")

3.3 手动设置（图形界面）

按 Win + R，输入 sysdm.cpl，回车
点击「高级」→「环境变量」
在「用户变量」中点击「新建」：
- 变量名：ANTHROPIC_BASE_URL
- 变量值：（链接已移除）
重复新建另外两个变量：
- ANTHROPIC_AUTH_TOKEN = YOUR_API_KEY
- ANTHROPIC_MODEL = deepseek-v4-flash
点击「确定」保存
重启终端

3.4 可用模型

模型	环境变量值	说明
DeepSeek-V4-Flash	`deepseek-v4-flash`	更快、经济实惠
DeepSeek-V4-Pro	`deepseek-v4-pro`	更强推理能力

3.5 验证设置

Get-ChildItem Env:ANTHROPIC*

应该看到三个环境变量。

第四步：启动 Claude Code

4.1 基本启动

claude

4.2 继续上次会话

claude --continue

4.3 常用命令

命令	说明
`claude`	启动新会话
`claude --continue`	继续上次会话
`claude --resume <session>`	恢复指定会话
`claude -n "项目名"`	命名当前会话
`/quit` 或 `Ctrl+D`	退出 Claude Code
`Ctrl+C`	强制中断当前操作

4.4 切换模型

临时切换（当前会话）：

$env:ANTHROPIC_MODEL="deepseek-v4-pro"
claude

永久切换：

[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")
# 重启终端生效

5.2 本地初始化 Git

在项目文件夹中打开 PowerShell：

# 初始化 Git 仓库
git init

# 配置用户信息（替换为你的信息）
git config user.name "Your Name"
git config user.email "[email protected]"

添加内容：

# Claude Code + DeepSeek 配置指南

本文档介绍如何在 Windows 上配置 Claude Code 使用 DeepSeek API。

## 快速开始

1. 安装 Node.js
2. 安装 Claude Code：`npm install -g @anthropic-ai/claude-code`
3. 配置 DeepSeek API 环境变量
4. 运行 `claude` 开始使用

详见 [完整配置指南](./CLAUDE-CODE-DEEPSEEK-SETUP.md)

常用问题

Q1: 出现 "Unable to connect to Anthropic services" 错误

原因： 环境变量未正确设置或未生效。

解决：

检查环境变量是否设置正确：

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN
$env:ANTHROPIC_MODEL

如果未显示值，重启终端
确认 API Key 正确且有效

Q2: npm 安装失败

解决：

# 清除 npm 缓存
npm cache clean --force

# 使用管理员权限重试
npm install -g @anthropic-ai/claude-code

Q3: 如何查看会话历史？

会话保存在：C:Users<用户名>.claudesessions

采用以下命令恢复：

claude --resume <session-id>

Q4: 可以采用其他模型吗？

可以，只需修改 ANTHROPIC_MODEL 环境变量：

[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")

Q5: VS Code 中如何采用？

在 VS Code 终端中运行：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "deepseek-v4-flash"
claude --ide

结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。