纯小白教程:在 Windows 上安装 Claude Code + 配置 DeepSeek

适用：Windows 10 / Windows 11耗时：15-20 分钟费用：DeepSeek 注册送免费额度，先试后充，充值 10 元能用很久无需 VPN，全程国内网络

先看这张图：你需要做什么

┌─────────────┐                       ┌──────────────┐                       ┌──────────────┐
│  Claude Code │ ────────────────────→ │  本地代理      │ ────────────────────→ │ DeepSeek API  │
│  (你敲命令)   │ ←──────────────────── │  (转发请求)     │ ←──────────────────── │  (云端大模型)   │
└─────────────┘                       └──────────────┘                       └──────────────┘

一句话解释：Claude Code 是一个能帮你写代码的 AI 工具，但它本身不包含大模型。我们让它连接 DeepSeek 的大模型来干活。中间那个"本地代理"就是个传话的——你把话告诉 Claude Code，Claude Code 告诉代理，代理转给 DeepSeek，DeepSeek 回答后再原路返回。

第零步：先看看你电脑上有没有装过 Node.js

按 Win + R，输入 cmd，回车。在黑色窗口里输入：

node --version

•如果输出 v16.x.x或更高 → 你已经装了 Node.js，跳过第一步和第二步，直接从第三步开始。

•如果输出 v14.x.x或更低 → 版本太旧，需要重装。继续看第一步。

•如果提示「不是内部或外部命令」→ 没装过，从头开始。

第一步：判断你电脑是 64 位还是 ARM

按 Win + R，输入 msinfo32，回车。看「系统类型」那一行：

第二步：安装 Node.js

Node.js 是 Claude Code 运行的基础环境。如果第零步已经验证装过了，跳过这一步。

2.1 下载

打开浏览器，把下面这行复制到地址栏：

https://npmmirror.com/mirrors/node/v22.18.0/

页面会列出几十个文件。**按 Ctrl+F，搜索 x64.msi**（如果你是 ARM64 就搜 arm64.msi），点它下载（约 28MB）。

⚠️ 注意：下载 .msi文件，不要下载 .zip或 .7z——msi 是自动安装包，最简单。

如果上面地址打不开，用备用地址：https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/v22.18.0/

2.2 安装

1.双击下载的 .msi文件

2.如果弹出「是否允许此应用对你的设备进行更改」，点是（安装需要管理员权限）

3.一路点 Next（安装界面是英文的，Next = 下一步）

4.到 “Automatically install the necessary tools” 这一页时，**不要勾**——那个会额外下载 3GB 的编译工具，你用不上。直接点 Next 跳过。

5.点 Install，等进度条跑完

6.点 Finish

⚠️ 如果你在公司电脑或公用电脑上，没有管理员密码，到第 2 步就会卡住。只能找 IT 或换自己的电脑。

2.3 验证 — 成功长这样

关掉所有 cmd 窗口，重新打开一个（Win + R→ cmd→ 回车），输入：

node --version

✅ 成功：输出 v22.18.0

v22.18.0

再输入：

npm --version

✅ 成功：输出 10.x.x

10.9.2

❌ 如果还报「不是内部或外部命令」：重启电脑后再试。

第三步：配置 npm 国内镜像

npm 默认从国外下载，国内慢得让人想砸电脑。改到国内镜像，只需要做一次。

在 cmd 窗口里输入：

npm config set registry https://registry.npmmirror.com

验证是否生效：

npm config get registry

✅ 成功：输出 https://registry.npmmirror.com

https://registry.npmmirror.com

❌ 如果报 npm ERR!开头的红色错误：检查网络是否正常（打开浏览器试试能不能上网），能上网的话重试一次。

第四步：安装 Claude Code

在 cmd 窗口里输入：

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

等 1-3 分钟。✅ 成功：最后一行显示类似：

added 524 packages in 45s

数字可能不同，看到 added XXX packages就是装好了。

验证：

claude --version

✅ 成功：输出类似 2.x.x (Claude Code)

2.1.39 (Claude Code)

❌ 如果 npm install中途报红色错误：

•ETIMEDOUT或 network→ 网络超时，再试一次

•EACCES或 permission→ 权限不够，试试用管理员身份打开 cmd（右键 cmd → 以管理员身份运行）再装

❌ 如果 claude --version提示「不是内部或外部命令」：关掉 cmd 窗口重开再试。还不行的话回到第二步确认 Node.js 装好了。

第五步：注册 DeepSeek 并获取 API Key

5.1 注册

1.浏览器打开：https://platform.deepseek.com/

2.点右上角 登录/注册

3.用手机号注册（DeepSeek 是中国的公司，中文界面）

4.登录后进入控制台

新注册用户会送免费额度，可以先不充值，试通了再说。

5.2 充值（可先跳过）

1.左侧菜单点 充值

2.充 10 元就够日常用很久（用微信/支付宝）

3.一个月编程大概只需 3-8 元

价格参考：输入 1 元/百万 token，输出 2 元/百万 token。 写代码一天大概消耗几十万 token。

5.3 创建 API Key

1.左侧菜单点 API Keys

2.点 创建 API Key

3.起个名字（随便填，比如 claude-code）

4.点创建

5.立刻复制保存！这串 sk-xxx...只会显示这一次，关掉页面就看不到了

6.粘贴到记事本里暂存，后面要用

✅ 成功：你手里有一串以 sk-开头的字符，类似 sk-abc123def456...（真实 Key 更长）。这就是 DeepSeek 的钥匙。

第六步：安装代理

6.1 安装（一条命令）

在 cmd 窗口里输入：

npm install -g deepseek-claude-proxy

等 10 秒。✅ 成功：最后一行显示 added 1 package之类的，没有红色字就是成功了。

这个代理零外部依赖，体积很小（约 10KB），只负责把 Claude Code 的请求转发到 DeepSeek。

❌ 如果报网络错误：和第四步一样，再试一次。

6.2 设置环境变量

把下面三行逐行复制到 cmd 窗口里执行（**把 sk-xxx换成你在第五步保存的真实 Key**）：

setx DEEPSEEK_API_KEY "sk-你的真实Key"
setx ANTHROPIC_BASE_URL "http://localhost:8080"
setx ANTHROPIC_API_KEY "not-needed"

每执行一行，✅ 成功：会输出：

成功: 指定的值已得到保存。

三行都出现这个提示就对了。

注意：ANTHROPIC_API_KEY随便填什么都行，代理不校验它，真正用的是 DEEPSEEK_API_KEY。但 Claude Code 要求必须设置这个变量，所以要填一个占位值。

⚠️ 重要：执行完这三条命令后，**关掉当前 cmd 窗口**。setx设置的变量只在新打开的窗口里才生效。不关窗的话下一步会报错。

第七步：启动代理 + 运行 Claude Code

每次使用都需要两个 cmd 窗口同时开着（一个跑代理，一个跑 Claude Code）。

窗口 1：代理窗口（一直开着别关）

1.新开一个 cmd 窗口（Win + R→ cmd→ 回车）

2.输入：

deepseek-claude-proxy

✅ 成功：输出：

deepseek-claude-proxy listening on port 8080

光标停在那不动，就对了。这个窗口要一直开着，不要关。可以最小化。

❌ 如果报 Error: DEEPSEEK_API_KEY is required：回到第六步第 2 小节，确认 setx 执行过，且换了新窗口。

❌ 如果报 EADDRINUSE或「端口被占用」：说明 8080 端口被其他软件占了。换端口——关窗，执行 setx PROXY_PORT "8088"和 setx ANTHROPIC_BASE_URL "http://localhost:8088"，然后关窗重开，再敲 deepseek-claude-proxy。

窗口 2：Claude Code 工作窗口

再新开一个 cmd 窗口，输入：

cd %USERPROFILE%
claude

第一次运行时，Claude Code 会弹出一段英文提示，大意是「是否信任当前目录？」。**直接按回车**（默认就是信任）。

如果你看到的提示是 “You are using an API key” 之类的，也直接回车就行。

进入交互界面后，你会看到光标前面出现了一个 >，表示可以输入了。

试试输入：

用 Python 写一个猜数字游戏

✅ 最终成功标志：Claude Code 开始逐行输出 Python 代码，类似：

我来写一个猜数字游戏。
```python
import random
def guess_number():
    number = random.randint(1, 100)
    ...

如果你看到它在写代码了，**恭喜，全部搞定！** 🎉

❌ 如果 Claude Code 报 Authentication error：检查窗口 1 的代理是否在运行（listening on port 8080）。如果在运行，回到 FAQ 第 2 条排查。

❌ 如果 Claude Code 报 Connection refused：代理没启动。去打开窗口 1。

每次使用的三步走

① 打开窗口1 → 敲 deepseek-claude-proxy → 看到 listening on port 8080
② 打开窗口2 → 敲 claude → 看到 > 就可以对话了
③ 用完了 → 窗口2 输入 /exit 回车 → 关掉窗口1

第八步：创建桌面快捷方式（可选，做完更省事）

⚠️ 先做这件事：让电脑显示文件后缀名

Windows 默认会把文件后缀名（.bat.txt）藏起来，导致你创建的文件名变成 启动代理.bat.txt，表面上看不出来。先改了：

1.打开任意文件夹

2.顶部菜单点 查看

3.勾上 文件扩展名（Windows 11 是「查看」→「显示」→「文件扩展名」）

确认勾上后，再往下操作。

8.1 代理快捷方式

在桌面右键 → 新建 → 文本文档。重命名为 启动代理.bat。右键它 → 编辑，把下面内容粘贴进去，保存：

@echo off
deepseek-claude-proxy
pause

确认文件名是 启动代理.bat而不是 启动代理.bat.txt。图标应该从记事本变成齿轮⚙️。

以后双击这个图标就能启动代理了。

8.2 Claude Code 快捷方式

同理，新建文本文档 → 重命名为 Claude.bat→ 右键编辑，粘贴：

@echo off
cd /d %USERPROFILE%
claude
pause

保存后双击就能直接启动 Claude Code。

常见问题

Q1: 代理窗口报「DEEPSEEK_API_KEY is required」

原因：环境变量没生效。

解决：

1.关掉代理窗口

2.确认你执行过 setx DEEPSEEK_API_KEY "sk-..."（注意变量名里是下划线 _，不要写成横杠 -）

3.新开一个 cmd 窗口（必须是新的！旧窗口看不到 setx 设置的值）

4.输入 echo %DEEPSEEK_API_KEY%，看是否输出你的 Key

5.确认输出正确后，再敲 deepseek-claude-proxy

Q2: Claude Code 报「Authentication error」或 401/403

按顺序检查：

1.代理窗口是不是在运行？（看到 listening on port 8080）

2.DeepSeek Key 是否正确？（登录 platform.deepseek.com→ API Keys 确认）

3.DeepSeek 账户余额是否用完了？（看控制台余额）

4.echo %ANTHROPIC_BASE_URL%→ 应该输出 http://localhost:8080

Q3: Claude Code 报「Connection refused」

原因：代理没启动。

解决：确保窗口 1 的代理在运行，看到 listening on port 8080。如果代理窗口关了，重开。

Q4: 代理窗口能启动，但 Claude Code 回复很慢或没反应

1.DeepSeek API 偶尔繁忙，等一等就好

2.检查电脑网络是否正常（打开浏览器随便访问个网页试试）

3.如果超过两分钟没反应，关掉两个窗口，重来

Q5: 关掉代理窗口后 Claude Code 卡住了

正常现象。Claude Code 在等代理回复，代理没了它就一直等。

解决：在 Claude Code 窗口按 Ctrl+C退出，然后重开代理窗口，再重开 Claude Code。

Q6: 端口 8080 被占用

有些软件（如某些本地服务器）可能占用了 8080 端口。换一个端口：

setx PROXY_PORT "8088"
setx ANTHROPIC_BASE_URL "http://localhost:8088"

然后关掉当前 cmd 窗口，新开一个，再敲 deepseek-claude-proxy。

Q7: 不想用默认模型，想换

代理默认使用 DeepSeek V4-Pro。想切换，在启动代理前设置：

setx DEEPSEEK_MODEL "deepseek-chat"

然后关掉 cmd 重开再启动代理。可选模型：

•deepseek-chat— DeepSeek V3，日常够用

•deepseek-reasoner— DeepSeek R1，复杂推理更强但较慢

•deepseek-v4-pro— 默认，综合最好

•deepseek-v4-flash— 最快，适合简单任务

Q8: 公司网络用不了

如果你在公司电脑上操作，公司防火墙可能会拦：

•registry.npmmirror.com（npm 镜像）→ 试试把第三步的镜像换成 https://registry.npmjs.org（官方源，可能慢但不会被拦）

•api.deepseek.com（DeepSeek API）→ 被拦就没办法了，只能用手机热点或回家弄

Q9: 桌面快捷方式双击后一闪而过

原因：文件名实际是 启动代理.bat.txt（后缀名被隐藏了）。

解决：回到第八步开头，先让电脑显示文件后缀名，然后重命名，把 .txt删掉。

Q10: 想更新代理或 Claude Code

npm update -g deepseek-claude-proxy @anthropic-ai/claude-code

费用参考

总结

你做了什么：
  0. 检查是否已有 Node.js       ← 有就跳过一二步
  1. 装 Node.js                 ← 从国内镜像下载 msi，一路下一步（不勾额外工具）
  2. npm 配国内镜像              ← 一行命令，永久生效
  3. 装 Claude Code             ← npm install -g
  4. 注册 DeepSeek + 拿 Key     ← platform.deepseek.com，新用户送额度
  5. 装代理                     ← npm install -g，10秒搞定
  6. 设环境变量                 ← 三条 setx，记住换新窗口
  7. 开两个窗口                 ← 一个跑代理，一个跑 claude

你就拥有了一个由 DeepSeek 驱动的 Claude Code，能读代码、改文件、执行命令、搜索项目，月费几块钱。和 ChatGPT 的区别是：它能真正操作你的电脑和代码，不只是聊天。