小白教程：从零开始安装 DeepSeek Harness，轻松调用 DeepSeek 大模型

kk44777

41人浏览 · 2026-08-23 12:43:10

kk44777 · 2026-08-23 12:43:10 发布

最近深度求索（DeepSeek）的大模型非常火，很多朋友都想体验一下，但官方网页版只能手动对话，如果想在命令行或脚本里调用，就需要一个趁手的工具。今天我就手把手教大家安装 DeepSeek Harness——一个基于 Node.js 的命令行工具，让你在终端里就能和 DeepSeek 大模型愉快聊天，还能方便地集成到自己的小项目里。

本教程面向完全零基础的小白，我会从安装 Node.js 开始讲起，每一步都解释清楚，保证你看完就能用。废话不多说，我们开始吧！

一、准备工作：安装 Node.js 和 npm

1.1 什么是 Node.js 和 npm？

简单来说，Node.js 是一个让 JavaScript 代码在电脑上运行的环境（平时 JavaScript 只能在浏览器里跑，有了 Node.js 就能在终端里跑）。而 npm（Node Package Manager）是 Node.js 自带的“软件管家”，用来安装各种别人写好的工具包。DeepSeek Harness 就是通过 npm 来安装的。

所以，第一步我们要安装 Node.js，安装完它会自动带上 npm。

1.2 下载安装 Node.js

Windows 用户：

打开浏览器，访问 Node.js 官网：Node.js — Run JavaScript Everywhere
你会看到两个版本：LTS（长期支持版，稳定）和 Current（最新版，可能不太稳定）。小白建议选择 LTS 版本，点击左边的绿色按钮下载。
下载完成后，双击安装包，一路点击“Next”，保持默认设置即可（安装路径可以自己改，但建议默认）。
安装完成后，点击“Finish”。

macOS 用户：

方法一（推荐）：同样去官网 Node.js — Run JavaScript Everywhere 下载 macOS 的 .pkg 安装包，双击运行，按提示安装即可。

方法二（用 Homebrew）：如果你已经安装了 Homebrew，可以在终端执行：

bash

brew install node

Linux 用户：

可以使用包管理器安装，例如 Ubuntu/Debian：

bash

sudo apt update
sudo apt install nodejs npm

或者参考 Node.js 官网的安装指引。

小贴士：安装过程中如果弹出权限请求，请允许。

1.3 验证安装是否成功

安装完成后，我们需要确认 Node.js 和 npm 是否可用。

打开终端：

Windows：按 Win + R，输入 cmd，回车。
macOS：按 Command + 空格，输入 Terminal，回车。
Linux：直接打开终端。

在终端里输入以下两个命令，分别查看版本号：

bash

node -v
npm -v

如果能看到类似 v18.17.0 和 9.6.7 这样的版本号，说明安装成功！如果提示“命令未找到”，请重新检查安装步骤，或重启终端再试。

二、获取 DeepSeek API Key

DeepSeek Harness 本身只是一个“外壳”，它需要连接 DeepSeek 的服务器才能工作，而连接凭证就是 API Key（可以理解为你的专属密码）。所以我们需要去 DeepSeek 开放平台申请一个。

2.1 注册并登录 DeepSeek 开放平台

打开浏览器，访问 DeepSeek 开放平台：DeepSeek
如果你还没有账号，点击“注册”，使用手机号或邮箱注册（可能需要接收验证码）。
注册完成后登录。

2.2 创建 API Key

登录后，进入控制台（通常首页就是）。
在左侧菜单栏找到 “API Keys”（或“密钥管理”）选项，点击进入。
点击 “创建 API Key” 按钮，系统可能会让你输入一个名称（随便填，比如 my-key）。
创建成功后，页面上会显示一串由字母和数字组成的密钥，形如 sk-xxxxxxxxxxxxxxxxxxxxxxxx。

⚠️ 重要提醒：这个 API Key 只显示一次！请立刻复制并保存到安全的地方（比如记事本、密码管理器）。如果丢失，只能重新创建一个。

2.3 了解 API Key 的计费

DeepSeek 的 API 是收费的，但价格非常便宜，注册新用户通常会有一定的免费额度。你可以在控制台查看余额和用量。作为学习测试，免费额度完全够用。

三、安装 DeepSeek Harness

现在万事俱备，我们来安装主角。

3.1 使用 npm 全局安装

在终端中执行以下命令（注意大小写）：

bash

npm install -g deepseek-harness

解释一下：

npm install：npm 的安装命令。
-g：表示全局安装，安装后可以在任何目录下使用该工具。
deepseek-harness：工具包的名称。

安装过程可能需要几十秒，请耐心等待。如果网络慢，可以尝试使用国内镜像源（例如 --registry=https://registry.npmmirror.com）。

3.2 验证安装

安装完成后，输入以下命令查看是否成功：

bash

deepseek --version

如果显示出版本号（例如 1.0.0），说明安装成功！如果提示 deepseek: command not found，可能是环境变量问题，重启终端再试，或者重新安装。

四、配置 API Key

现在需要把之前保存的 API Key 告诉 DeepSeek Harness。最常用的方法是通过环境变量来配置。

4.1 什么是环境变量？

环境变量是操作系统里保存的一些全局设置，程序可以读取它们。我们设置一个名为 DEEPSEEK_API_KEY 的环境变量，Harness 就会自动读取它。

4.2 在 Windows 上设置环境变量

临时设置（只在当前终端窗口有效）：

在终端（cmd 或 PowerShell）中执行：

bash

set DEEPSEEK_API_KEY=sk-你的密钥

（PowerShell 用 $env:DEEPSEEK_API_KEY="sk-你的密钥"）

永久设置（推荐）：

右键点击“此电脑”或“我的电脑”，选择“属性”。
点击“高级系统设置”。
在“高级”选项卡下，点击“环境变量”。
在“用户变量”区域，点击“新建”。
变量名填：DEEPSEEK_API_KEY，变量值填你的密钥（sk-...）。
点击“确定”保存所有窗口。
重新打开终端，使设置生效。

4.3 在 macOS / Linux 上设置环境变量

临时设置：

bash

export DEEPSEEK_API_KEY="sk-你的密钥"

永久设置：

编辑你的 shell 配置文件（根据你用的 shell 选择）：

Bash：~/.bashrc 或 ~/.bash_profile
Zsh：~/.zshrc

在文件末尾添加一行：

bash

export DEEPSEEK_API_KEY="sk-你的密钥"

保存文件后，执行 source ~/.bashrc（或对应的文件）让配置立即生效，或者重新打开终端。

4.4 测试配置是否成功

配置好后，可以在终端输入以下命令测试：

bash

deepseek chat "你好"

如果返回了 DeepSeek 的回复，说明一切正常！如果提示缺少 API Key 或认证失败，请检查环境变量是否设置正确，注意不要有多余的空格或引号。

五、使用 DeepSeek Harness 进行对话

现在你已经成功安装并配置好了，让我们来体验一下。

5.1 基础用法

最简单的用法就是直接在命令后面跟上你的问题：

bash

deepseek chat "用一句话介绍你自己"

Harness 会调用 DeepSeek 模型并打印回复。

5.2 进入交互模式

如果你想连续对话，可以输入：

bash

deepseek

或者

bash

deepseek repl

这样就进入了交互界面，你可以像聊天一样输入消息，输入 exit 或按 Ctrl+C 退出。

5.3 其他常用选项

指定模型：deepseek chat "问题" --model deepseek-chat（默认就是 deepseek-chat）
调整温度（控制随机性）：deepseek chat "问题" --temperature 0.7
查看帮助：deepseek --help

小贴士：不同的命令可能略有差异，请以 deepseek --help 的输出为准。

六、常见问题与解决方法

Q1：终端提示 `deepseek: command not found`

确认已经全局安装，可以运行 npm list -g --depth=0 查看是否包含 deepseek-harness。
检查 npm 的全局 bin 目录是否在 PATH 中。可以运行 npm bin -g 查看路径，然后手动添加到系统 PATH。
重启终端或电脑。

Q2：运行时报错 `401 Unauthorized` 或 `Invalid API key`

检查 API Key 是否复制完整，不要有多余空格。
确认环境变量名拼写正确：DEEPSEEK_API_KEY。
如果是在代码中配置，请确认没有把密钥写错。
尝试重新创建一个 API Key。

Q3：网络连接超时或无法访问

DeepSeek 的 API 服务器可能在国外，国内访问偶尔不稳定。可以尝试使用代理，或者稍后再试。
检查本地网络是否正常。

Q4：安装 npm 包时速度很慢或失败

使用国内镜像源：npm install -g deepseek-harness --registry=https://registry.npmmirror.com
或者先设置全局镜像：npm config set registry https://registry.npmmirror.com

结语

恭喜你！至此，你已经成功安装并配置好了 DeepSeek Harness，可以在终端里尽情调戏 DeepSeek 大模型了。这个工具非常适合开发者用来快速测试 prompt、编写自动化脚本，或者单纯体验大模型的乐趣。

如果你在安装过程中遇到其他问题，欢迎在评论区留言，我会尽力解答。如果这篇教程对你有帮助，别忘了点个赞、收藏一下，让更多朋友看到！

祝大家玩得开心！🚀

openEuler 社区

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐

Alpha云服务器购买教程指南（2026图文版）

AlphaVPS暂时不支持中文语言，对于很多新手用户来说，可能对其购买步骤还不太熟悉，包括优惠码使用方法，为此本文以图文结合形式进行简单说明。7、完成支付后，进入后台管理中心，在“Virtual”菜单栏中可以看到刚刚购买的云服务器，其开通信息也会发送至你的开通邮箱中，注意查收。以上Alpha云服务器购买流程，基本上都是很通用的步骤，相对来说比较简单，如果购买其它类型方案，均可以参考以上步骤。3、